EIE4-FYP/demo/README.md

94 lines
2.9 KiB
Markdown
Raw Permalink Normal View History

# Bare Metal Demo App
This directory provides a basic bare metal demo app that demonstrates how to communicate / drive the custom logic in this project.
## Build and Load over LiteX-Term
The project is built with: ``make -C demo``
The project board does not provide extra interfaces to connect to the board, so serial is used here: `$ litex_term --kernel demo/demo.bin /dev/ttyACMX` (ACM due to the use of `usb_acm` UART)
You should see the demo app running and should be able to interact with it:
```bash
$ litex_term --kernel demo/demo.bin /dev/ttyACM0
__ _ __ _ __
/ / (_) /____ | |/_/
/ /__/ / __/ -_)> <
/____/_/\__/\__/_/|_|
Build your hardware, easily!
(c) Copyright 2012-2022 Enjoy-Digital
(c) Copyright 2007-2015 M-Labs
BIOS built on Jun 5 2023 13:37:57
BIOS CRC passed (f2f2af2d)
LiteX git sha1: 310bc777
--=============== SoC ==================--
CPU: VexRiscv @ 48MHz
BUS: WISHBONE 32-bit @ 4GiB
CSR: 32-bit data
ROM: 128KiB
SRAM: 8KiB
L2: 8KiB
SDRAM: 131072KiB 16-bit @ 192MT/s (CL-6 CWL-5)
--========== Initialization ============--
Initializing SDRAM @0x40000000...
Switching SDRAM to software control.
Read leveling:
m0, b00: |01110000| delays: 02+-01
m0, b01: |00000000| delays: -
m0, b02: |00000000| delays: -
m0, b03: |00000000| delays: -
best: m0, b00 delays: 02+-01
m1, b00: |01110000| delays: 02+-01
m1, b01: |00000000| delays: -
m1, b02: |00000000| delays: -
m1, b03: |00000000| delays: -
best: m1, b00 delays: 02+-01
Switching SDRAM to hardware control.
Memtest at 0x40000000 (2.0MiB)...
Write: 0x40000000-0x40200000 2.0MiB
Read: 0x40000000-0x40200000 2.0MiB
Memtest OK
Memspeed at 0x40000000 (Sequential, 2.0MiB)...
Write speed: 11.7MiB/s
Read speed: 17.5MiB/s
--============== Boot ==================--
Booting from serial...
Press Q or ESC to abort boot completely.
sL5DdSMmkekro
[LITEX-TERM] Received firmware download request from the device.
[LITEX-TERM] Uploading kernel.bin to 0x40000000 (11248 bytes)...
[LITEX-TERM] Upload calibration... (inter-frame: 10.00us, length: 64)
[LITEX-TERM] Upload complete (54.1KB/s).
[LITEX-TERM] Booting the device.
[LITEX-TERM] Done.
Executing booted program at 0x40000000
--============= Liftoff! ===============--
LiteX custom demo app built Jun 5 2023 13:40:19
Available commands:
help - Show this command
reboot - Reboot CPU
donut - Spinning Donut demo
saw - Sawtooth Wave demo
square - Square Wave demo
triangle - Triangle Wave demo
sine - Sine Wave demo
imperial - Imperial March demo
roll - Music demo
can_id - Get / Set CAN ID
can_mask - Get / Set CAN Mask
can_read - Receive CAN Frames and print (delay in s)
can_watch - Watch CAN Frames at 2Hz
can_listen - Play CAN Frames as Audio
StackSynth>
```