If you only need to flash a new version of U-Boot onto the eMMC then follow
these instructions instead of running the ``librem5-devkit-flash-image`` script.
Flashing the eMMC
=================
Using SDP
~~~~~~~~~
The main purpose of the image included on the eMMC is factory testing, therefore it's strongly recommended to flash an up-to-date one immediately.
The version of U-Boot that gets flashed is ``files/u-boot-devkit-recovery.imx``.
Put the "Boot Mode" switch in the USB position::
The scripts mentioned in this section can be obtained from the `librem5-devkit-tools`_ repository.
.. _imx8_devkit_install_uuu:
Install uuu
-----------
.. note:: The ``uuu`` tool requires a 64-bit host to run and is packaged as an ``amd64`` binary.
The NXP mfgtool ``uuu`` is required to boot a board that has no bootloader
or is otherwise "bricked".
You can obtain a ``uuu`` package for Debian-based systems from `the Purism CI
server`_ or :ref:`build uuu from source <imx8_devkit_howto_building_uuu>`.
To install the package, run the ``dpkg`` tool in the following way::
sudo dpkg -i uuu_1.2.91_amd64.deb
The precise ``.deb`` package file name may differ from the one given above. Version 1.2.91 or later is recommended.
.. _`the Purism CI server`: https://arm01.puri.sm/job/debs/job/deb-mfgtools-buster-amd64/
Downloading Flashing Scripts
----------------------------
Files from the `librem5-devkit-tools`_ repository are responsible for the downloading of the image files, and for coordinating their transfers to the devkit. If you want to flash an image by hand instead of using the scripts, please consult the :ref:`imx8_devkit_howto_flash_with_uuu` guide.
Clone the `librem5-devkit-tools`_ repository before proceeding::
You should now have everything you need to download and flash a new image.
.. _imx8_devkit_flash_test_image:
Flash the Image
---------------
.. note:: If your workstation cannot provide the necessary power for this process you may need a USB 3 powered hub between the host and the development board.
Put the "Boot Mode" switch in the USB position. Attach the development board
to a USB C or USB 3 port on the host that is capable of providing 900mA of
current. The HID device should appear in the output of the ``lsusb`` command,
like this::
Bus 001 Device 005: ID 1fc9:012b NXP Semiconductors
The ``librem5-devkit-flash-image`` script will download and flash the newest
available rootfs and U-Boot images. You may need to install some Python modules
before running the script. On Debian 9 (Stretch), Ubuntu 18.04 LTS (Bionic
Beaver) and later, this command should install these modules::
@@ -84,7 +84,7 @@ See :ref:`hardware_reference` for information about the specific parts used
for the sockets, buttons and switches.
Setting up the Board
~~~~~~~~~~~~~~~~~~~~
--------------------
In its original factory state, the board is lacking some essential features. We
recommend that you consider :ref:`imx8_devkit_flashing_emmc` before using the
...
...
@@ -93,106 +93,10 @@ board for development.
It may also be useful to consult the :ref:`imx8_devkit_known_issues` page and
:ref:`imx8_devkit_troubleshooting` guide if problems occur.
.. _imx8_devkit_flashing_emmc:
Flashing the eMMC
-----------------
The main purpose of the image included on the eMMC is factory testing, therefore it's strongly recommended to flash an up-to-date one immediately.
The scripts mentioned in this section can be obtained from the `librem5-devkit-tools`_ repository.
.. _imx8_devkit_install_uuu:
Install uuu
~~~~~~~~~~~
.. note:: The ``uuu`` tool requires a 64-bit host to run and is packaged as an ``amd64`` binary.
The NXP mfgtool ``uuu`` is required to boot a board that has no bootloader
or is otherwise "bricked".
You can obtain a ``uuu`` package for Debian-based systems from `the Purism CI
server`_ or :ref:`build uuu from source <imx8_devkit_howto_building_uuu>`.
To install the package, run the ``dpkg`` tool in the following way::
sudo dpkg -i uuu_1.2.91_amd64.deb
The precise ``.deb`` package file name may differ from the one given above. Version 1.2.91 or later is recommended.
.. _`the Purism CI server`: https://arm01.puri.sm/job/debs/job/deb-mfgtools-buster-amd64/
Downloading Flashing Scripts
~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Files from the `librem5-devkit-tools`_ repository are responsible for the downloading of the image files, and for coordinating their transfers to the devkit. If you want to flash an image by hand instead of using the scripts, please consult the :ref:`imx8_devkit_howto_flash_with_uuu` guide.
Clone the `librem5-devkit-tools`_ repository before proceeding::
You should now have everything you need to download and flash a new image.
.. _imx8_devkit_flash_test_image:
Flash the Image
~~~~~~~~~~~~~~~
.. note:: If your workstation cannot provide the necessary power for this process you may need a USB 3 powered hub between the host and the development board.
Put the "Boot Mode" switch in the USB position. Attach the development board
to a USB C or USB 3 port on the host that is capable of providing 900mA of
current. The HID device should appear in the output of the ``lsusb`` command,
like this::
Bus 001 Device 005: ID 1fc9:012b NXP Semiconductors
The ``librem5-devkit-flash-image`` script will download and flash the newest
available rootfs and U-Boot images. You may need to install some Python modules
before running the script. On Debian 9 (Stretch), Ubuntu 18.04 LTS (Bionic
Beaver) and later, this command should install these modules::
