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

Minor manual fixes #87

Merged
merged 3 commits into from
Jan 11, 2024
Merged

Minor manual fixes #87

Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
127624d
manual: fix typo
Ivan-Velickovic Jan 11, 2024
7a94b9b
manual: spell U-Boot properly
Ivan-Velickovic Jan 11, 2024
7e7899d
manual: add command for booting ZCU102 hardware
Ivan-Velickovic Jan 11, 2024
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
16 changes: 11 additions & 5 deletions docs/manual.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -527,7 +527,7 @@ The MBa8Xx provides access to the TQMa8XQP UART via UART-USB bridge.
To access the UART connect a USB micro cable to port **X13**.
The UART-USB bridge supports 4 individual UARTs; the UART is connected to the 2nd port.

By default the SoM will autoboot using U-boot.
By default the SoM will autoboot using U-Boot.
Hit any key during the boot process to stop the autoboot.

A new board will autoboot to Linux.
Expand All @@ -539,8 +539,8 @@ You will likely want to disable autoboot:
The board can be reset by pressing switch **S4** (located next to the Ethernet port).
Alternatively, you can use the `reset` command from the U-Boot prompt.

During development the most convenient way to boot an Microkit image is via network booting.
U-boot support booting via the *tftp* protocol.
During development the most convenient way to boot a Microkit image is via network booting.
U-Boot support booting via the *tftp* protocol.
To support this you'll want to configure the network.
U-Boot supports DHCP, however it is often more reliable to explicitly set an IP address.
For example:
Expand Down Expand Up @@ -576,13 +576,19 @@ When debugging is enabled the kernel will use the same UART as U-Boot.

## ZCU102

Initial support is available for the ZCU102.
Initial support is available for the Xilinx ZCU102.

**FIXME:** Additional documentation required here.

The ZCU102 can run on a physical board or on an appropriate QEMU based emulator.

An QEMU command line:
Microkit produces a raw binary file, so when using U-Boot you must execute the image using:

=> go 0x40000000

Note that the loading address must be `0x40000000`.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

If you add this note, you should also say, why it must be this address? The note's wording feels a bit odd now to me.

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I can remove the note or say something like 'The image expects to be loaded at 0x40000000'. I added the note because I wanted to make it clear that it's a fixed address. The reasoning for the fixed address is explained in the section about adding platform support, it will also be explained once #49 is resolved.

I think I will probably just remove the note to make it consistent with the TQMa8XQP documentation.

Thanks.


For simulating the ZCU102 using QEMU, use the following command:

$ qemu-system-aarch64 \
-m 4G \
Expand Down