summaryrefslogtreecommitdiff
path: root/source/microcontrollers/inkplate/index.rst
diff options
context:
space:
mode:
Diffstat (limited to 'source/microcontrollers/inkplate/index.rst')
-rw-r--r--source/microcontrollers/inkplate/index.rst42
1 files changed, 40 insertions, 2 deletions
diff --git a/source/microcontrollers/inkplate/index.rst b/source/microcontrollers/inkplate/index.rst
index 7ac7ab7..04ed972 100644
--- a/source/microcontrollers/inkplate/index.rst
+++ b/source/microcontrollers/inkplate/index.rst
@@ -17,17 +17,18 @@ the repository::
then the firmware can be flashed directly with esptool::
+ $ esptool --port /dev/ttyUSB0 erase_flash
$ esptool --port /dev/ttyUSB0 --chip esp32 --baud 115200 write_flash \
--flash_mode keep --flash_size keep --erase-all 0x1000 \
Inkplate-firmware.bin
-under Debian, you may need to use ``--no-stub``, because of #1043168_::
+under Debian, you may need to use ``--no-stub``, because of `#1043168`_::
$ esptool --port /dev/ttyUSB0 --chip esp32 --baud 115200 --no-stub \
write_flash --flash_mode keep --flash_size keep 0x1000 \
Inkplate-firmware.bin
-.. _1043168: https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=1043168
+.. _`#1043168`: https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=1043168
Then the libraries can be copied to the board from the local copy::
@@ -36,6 +37,43 @@ Then the libraries can be copied to the board from the local copy::
$ mpremote fs cp <board>/<board>/*.py :lib/
$ mpremote fs cp Dependencies/*.py :lib/
+e-radionica / crowdfunding models
+---------------------------------
+
+The old inkplate6 models from e-radionica / the crowdfunding are `not
+supported yet by the current version of the Inkplate module
+<https://github.com/SolderedElectronics/Inkplate-micropython/issues/47>`_,
+but they can run the old version in the ``legacy`` branch::
+
+ $ esptool --port /dev/ttyUSB0 erase_flash
+ $ esptool --port /dev/ttyUSB0 --chip esp32 --baud 115200 write_flash \
+ --flash_mode keep --flash_size keep --erase-all 0x1000 \
+ esp32spiram-20220117-v1.18.bin
+
+ $ mpremote fs mkdir lib
+ $ mpremote fs cp mcp23017.py inkplate6.py image.py shapes.py gfx.py gfx_standard_font_01.py soldered_logo.py :lib/
+
+Recovering from corrupted storage
+---------------------------------
+
+Because of `#1043168`_, at the moment Debian is missing the
+(json-encoded binary) file
+``/usr/lib/python3/dist-packages/esptool/targets/stub_flasher/stub_flasher_32.json``:
+the option ``--no-stub`` may be used to perform *most* operations
+(possibly at a slower speed), but ``erase-flash`` is not among the
+supported ones.
+
+In that case you may need to clone the upstream repository::
+
+ $ git clone https://github.com/espressif/esptool.git
+
+and copy or link the correct file in the esptool package files::
+
+ # cd /usr/lib/python3/dist-packages/esptool/targets/stub_flasher
+ # ln -s /<path/to/repo>/esptool/esptool/targets/stub_flasher/1/esp32.json stub_flasher_32.json
+
+and then regular commands, including ``erase_flash`` can be run.
+
See also
========