Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

WIP: Add rb3gen2 flashing instructions. #721

Closed
wants to merge 1 commit into from
Closed

WIP: Add rb3gen2 flashing instructions. #721

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
52 changes: 52 additions & 0 deletions source/reference-manual/boards/rb3gen2.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,52 @@
Preparation
-----------

#. Download and extract the necessary files from ``https://app.foundries.io/factories/<factory>/targets``:

a. Click the latest Target with the :guilabel:`platform` trigger.

b. Expand the **run** in the :guilabel:`Runs` section which corresponds with the name of the board.
**Download the Factory image for that machine.**
For example::

lmp-factory-image-qcm6490.qcomflash.tar.gz

.. note::
The compressed archive contains the flashing tool ``qdl``.
The tool from the build has the interpretter set incorrectly.

c. Download and compile qdl tool for your platorm
The ``qdl`` tool from the buils is compiled for x86_64 architecture.
When trying to flash from the host running ARM64 it is necessary to compile the tool from sources

.. parsed-literal::

git clone https://github.com/linux-msm/qdl
cd qdl
make

d. On some host systems it might be necessary to disable ModemManager

Hardware Preparation
--------------------

#. Set up DIP_SW_0 positions 1 and 2 to ON. This enables serial output to the debug port.

#. Connect the USB debug cable to the host

#. Serial connection is based on FTDI chip. The device should appear as:

Check warning on line 37 in source/reference-manual/boards/rb3gen2.rst

View workflow job for this annotation

GitHub Actions / runner / vale 

[vale] reported by reviewdog 🐶
[Fio-docs.expand-acronyms] 'FTDI' has no definition, definition is missing capitalization, or is a variable name and should be written as a literal.

Raw Output:
{"message": "[Fio-docs.expand-acronyms] 'FTDI' has no definition, definition is missing capitalization, or is a variable name and should be written as a literal.", "location": {"path": "source/reference-manual/boards/rb3gen2.rst", "range": {"start": {"line": 37, "column": 34}}}, "severity": "WARNING"}

/dev/serial/by-id/usb-FTDI_FT230X_Basic_UART_<serial ID>-if00-port0

#. Connect the power cable

#. Press and hold F_DL button

#. When holding F_DL button, plug in USB-C cable from the host

Flashing
--------

Once EDL mode device is detected on the host system, flash the board using ``qdl`` tool

Check warning on line 50 in source/reference-manual/boards/rb3gen2.rst

View workflow job for this annotation

GitHub Actions / runner / vale 

[vale] reported by reviewdog 🐶
[Fio-docs.expand-acronyms] 'EDL' has no definition, definition is missing capitalization, or is a variable name and should be written as a literal.

Raw Output:
{"message": "[Fio-docs.expand-acronyms] 'EDL' has no definition, definition is missing capitalization, or is a variable name and should be written as a literal.", "location": {"path": "source/reference-manual/boards/rb3gen2.rst", "range": {"start": {"line": 50, "column": 6}}}, "severity": "WARNING"}

./qdl prog_firehose_ddr.elf rawprogram*.xml patch*.xml
Loading