diff --git a/doc/user.rst b/doc/user.rst index c2a16874..667dd034 100644 --- a/doc/user.rst +++ b/doc/user.rst @@ -157,23 +157,6 @@ 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 `_ 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 ............................ @@ -258,10 +241,28 @@ crash in surprising ways. +Flashing from OpenWrt (not currently advised!) +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +.. CAUTION:: At your own risk! This will (at least 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 `_ which may also contain (hardware-dependent) instructions on how to flash an image using the vendor firmware - perhaps even from a web interface. + + Updating an installed system (JFFS2) ************************************ - Adding packages ===============