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
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@ -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.
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
............................