add cautionary note about flashing from openwrt

h/t matthewcroughan, thank you for your service
This commit is contained in:
Daniel Barlow 2023-07-09 15:07:12 +01:00
parent a1dff5b92d
commit 2d05695d99

View file

@ -138,19 +138,6 @@ Flashing
======== ========
Flashing from OpenWrt (untested)
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
If your device is running OpenWrt then it probably has the
:command:`mtd` command installed and you can use it as follows:
.. code-block:: console
mtd -r write /tmp/firmware_image.bin firmware
For more information, please see the `OpenWrt manual <https://openwrt.org/docs/guide-user/installation/sysupgrade.cli>`_ which may also contain (hardware-dependent) instructions on how to flash an image using the vendor firmware - perhaps even from a web interface.
Flashing from the boot monitor Flashing from the boot monitor
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@ -170,6 +157,24 @@ works we can flash the image - and if it doesn't work we can reboot
the device again and it will boot from the old image. the device again and it will boot from the old image.
Flashing from OpenWrt (not currently advised!)
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.. CAUTION:: At your own risk! This may in some circumstances lead to
bricking the device: we think this flash method is currently
incompatible with use of a writeable (jffs2) filesystem.
If your device is running OpenWrt then it probably has the
:command:`mtd` command installed. After transferring the image onto the
device using e.g. :command:`ssh`, you can run it as follows:
.. code-block:: console
mtd -r write /tmp/firmware.bin firmware
For more information, please see the `OpenWrt manual <https://openwrt.org/docs/guide-user/installation/sysupgrade.cli>`_ which may also contain (hardware-dependent) instructions on how to flash an image using the vendor firmware - perhaps even from a web interface.
Building the RAM-based image Building the RAM-based image
............................ ............................