Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/jonlamb-gh/rpi4-rust-workspace
Rust workspace for Raspberry Pi 4 bare metal things
https://github.com/jonlamb-gh/rpi4-rust-workspace
bare-metal bounded-registers embedded-hal no-std raspberry-pi rpi4 rust rust-no-std smoltcp tcp-ip
Last synced: 14 days ago
JSON representation
Rust workspace for Raspberry Pi 4 bare metal things
- Host: GitHub
- URL: https://github.com/jonlamb-gh/rpi4-rust-workspace
- Owner: jonlamb-gh
- Created: 2019-09-22T14:09:35.000Z (about 5 years ago)
- Default Branch: master
- Last Pushed: 2022-06-17T01:37:34.000Z (over 2 years ago)
- Last Synced: 2023-03-04T09:39:19.417Z (over 1 year ago)
- Topics: bare-metal, bounded-registers, embedded-hal, no-std, raspberry-pi, rpi4, rust, rust-no-std, smoltcp, tcp-ip
- Language: Rust
- Homepage:
- Size: 311 KB
- Stars: 15
- Watchers: 2
- Forks: 3
- Open Issues: 11
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# rpi4-rust-workspace
Rust workspace for RPi4 bare metal things
A lot of the things in here were inspired by [rust-raspi3-OS-tutorials](https://github.com/rust-embedded/rust-raspi3-OS-tutorials) and [circle](https://github.com/rsta2/circle).
## Crates
* [bcm2711](bcm2711/) : Device crate, registers defined via [bounded-registers](https://github.com/auxoncorp/bounded-registers)
* [bcm2711-hal](bcm2711-hal/) : [embedded-hal](https://github.com/rust-embedded/embedded-hal) trait impls
* [display](display/) : Double buffered DMA graphics/display library
* [rtsp](rtsp/) : RTSP library
* [rtp](rtp/) : RTP library
* [smoltcp-phy](smoltcp-phy/) : [smoltcp](https://github.com/smoltcp-rs/smoltcp) Phy
* [rtp-jpeg-decoder](rtp-jpeg-decoder/) : RTP JPEG decoder library
* [uplot](uplot/) : Small plotting library using `embedded-graphics` primitives
* [raspi3_boot](raspi3_boot/) : Mostly copied from [rust-raspi3-OS-tutorials](https://github.com/rust-embedded/rust-raspi3-OS-tutorials)
## Examples
* [analog-clock](examples/analog-clock/src/main.rs) : Port of the [embedded-graphics](https://github.com/jamwaffles/embedded-graphics) `analog-clock` example
* [embedded-graphics](examples/embedded-graphics/src/main.rs) : Simple [embedded-graphics](https://github.com/jamwaffles/embedded-graphics) example
* [eth](examples/eth/src/main.rs) : On-board GENET Ethernet example
* [ip](examples/ip/src/main.rs) : [smoltcp](https://github.com/smoltcp-rs/smoltcp) IP stack / TCP server example
* [mbox](examples/mbox/src/main.rs) : Reads various things using the [Mailbox property interface](https://github.com/raspberrypi/firmware/wiki/Mailbox-property-interface)
* [mem2mem-dma](examples/mem2mem-dma/src/main.rs) : Simple DMA transfer example
* [uart1](examples/uart1/src/main.rs) : UART1 example
* [ipcam-viewer](examples/ipcam-viewer/src/main.rs) : ip-camera RTSP client and image display
* [temperature-plot](examples/temperature-plot/src/main.rs) : Plots the internal temperature
## Building
`rustc 1.44.0-nightly (94d346360 2020-04-09)`
```rust
cargo xbuild
```
Copy elf to binary:
```bash
cargo objcopy -- -O binary target/$(TARGET)/release/img /tmp/img.bin
```
## Simulating
[Comming soon?](https://lists.gnu.org/archive/html/qemu-devel/2019-09/msg00681.html)
https://gitlab.com/philmd/qemu/commits/raspi4_wip
```bash
# For output on UART1
qemu-system-aarch64 -M raspi4 -nographic -serial null -serial mon:stdio -kernel /path/to/binary
```
TODO - cusomer runner / `cargo xrun` support:
```toml
[target.'cfg(target_os = "none")']
runner = "tools/qemu-runner"
```
## U-boot
Using 64 bit U-boot:
```bash
git clone --depth 1 https://github.com/u-boot/u-boot.git u-boot
ARCH=arm64 CROSS_COMPILE=aarch64-linux-gnu- make rpi_4_defconfig
ARCH=arm64 CROSS_COMPILE=aarch64-linux-gnu- make
```
```bash
U-Boot 2020.04-rc2-00048-gf2a73d6867 (Feb 16 2020 - 08:29:41 -0800)
aarch64-linux-gnu-gcc (Ubuntu/Linaro 8.3.0-6ubuntu1) 8.3.0
GNU ld (GNU Binutils for Ubuntu) 2.32
```
Environment:
```bash
setenv imgname img.bin
# Normally for bare metal
#setenv loadaddr 0x80000
# Put it somewhere else, so we don't overwrite u-boot
setenv loadaddr 0x01000000
# Make sure the caches are on
setenv bootimg 'tftp ${loadaddr} ${serverip}:${imgname}; dcache flush; dcache on; go ${loadaddr}'
```
## SD Card
Files:
```bash
/card
├── config.txt
├── fixup4.dat
├── start4.elf
├── u-boot.bin
└── uboot.env
```
Contents of `config.txt`:
```bash
enable_uart=1
arm_64bit=1
kernel=u-boot.bin
```
## Links
- [BCM2711](https://www.raspberrypi.org/documentation/hardware/raspberrypi/bcm2711/README.md)
- [RPi4 datasheet](https://github.com/raspberrypi/documentation/raw/master/hardware/raspberrypi/bcm2711/rpi_DATA_2711_1p0.pdf)
- [Revised BCM2837 doc](https://github.com/raspberrypi/documentation/files/1888662/BCM2837-ARM-Peripherals.-.Revised.-.V2-1.pdf)
- [bcm2711-rpi-4-b.dtb](https://github.com/Hexxeh/rpi-firmware/blob/master/bcm2711-rpi-4-b.dtb)