Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/andelf/longan-nano-playground-rs
Longan Nano board(GD32VF103) examples, in Rust, under macOS. Bad Apple included.
https://github.com/andelf/longan-nano-playground-rs
longan-nano riscv rust-embedded
Last synced: 2 months ago
JSON representation
Longan Nano board(GD32VF103) examples, in Rust, under macOS. Bad Apple included.
- Host: GitHub
- URL: https://github.com/andelf/longan-nano-playground-rs
- Owner: andelf
- License: apache-2.0
- Created: 2020-11-10T02:11:32.000Z (about 4 years ago)
- Default Branch: master
- Last Pushed: 2020-12-15T18:03:24.000Z (about 4 years ago)
- Last Synced: 2024-10-03T10:45:39.354Z (3 months ago)
- Topics: longan-nano, riscv, rust-embedded
- Language: Rust
- Homepage:
- Size: 82 KB
- Stars: 12
- Watchers: 4
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# longan-nano-playground.rs
Longan Nano board examples, in Rust, under macOS. Bad Apple included.
A playground with [riscv-rust/longan-nano](https://github.com/riscv-rust/longan-nano).
## Environment setup
```console
$ # Download RISC-V gcc toolchains to PATH (both rv32 and rv64 will do)
$ riscv64-unknown-elf-objcopy --version
GNU objcopy (SiFive Binutils 2.32.0-2020.04.0) 2.32
...
$ # Install dfu-tool from brew (git HEAD required, including bugfix for GD32VF)
$ brew install dfu-util --HEAD
$ # List device (Hold BOOT0 and Press RESET, device reboot to DFU mode)
$ dfu-util -l
Found DFU: [28e9:0189] ver=0100, devnum=6, cfg=1, intf=0, path="20-1", alt=0, name="@Internal Flash /0x08000000/128*001Kg", serial="3CBJ"
$ # Add rust toolchain for riscv32imac
$ rustup target add riscv32imac-unknown-none-elf
```
Run on Longan Nano board:
```sh
# cargo build..
./build.sh
# Hold BOOT0 and Press RESET. reboot to DFU mode...
./flash.sh
# Press RESET on the board
```
## A writter for byte array
You cannot use `println!()` and `writeln!()` in a bare embedded device, since no alloc lib defined.
And `String`, `Vec` requires dynamic allocation on heap.
So a `ByteMutWriter` is defined for `core::fmt::Write`.
Usage:
```rust
let mut buf = [0u8; 20 * 5];
let mut buf = ByteMutWriter::new(&mut buf[..]);
buf.clear();
writeln!(buf, "Hello {}", "Rust");
write!(buf, "Val: 0x{:08x}", debug_val);
// buf.as_str();
```
## Steps for Bad Apple
- Prepare an SD card, format it to FAT32(FAT16)
- I use an outdated SD card, 4GB, Class4
- Download a Bad Apple video
- `youtube-dl` might help
- Convert video file to image sequences (scale to LCD screen resolution)
- Use `ffmpeg`
- Convert images to a `Rgb565` ImageRaw file, save it to the root directory of SD card
- I wrote a small python script using PIL(Pillow)
- WARN: must use a DOS style 8.3 filename
- Upload `bad_apple.rs` firmware to the board
- enjoy!
```sh
# Download video
youtube-dl https://....
# Video info
ffmpeg -i BadApple.mp4
# ....
# Stream #0:0(und): Video: h264 (High) (avc1 / 0x31637661), yuv420p(tv, bt709), 960x720 [SAR 1:1 DAR 4:3], 567 kb/s, 30 fps, 30 tbr, 15360 tbn, 60 tbc (default)
# ....
# Now you know it's a 960x720 resolution, 30 fps.
# To fit a Longan Nano's 160x80 screen, you will need to scale it to 106x80.
# NOTE: Lower fps might help.
# Now, convert to image sequences.
ffmpeg -i BadApple.mp4 -vf scale=106:80,fps=24 'out/%04d.png'
# Convert the image sequence to a `Rgb565` ImageRaw file. (requires python3-pillow)
python3 scripts/convert.py
```
Then copy the `badapple.raw` to your SD card. Reboot with new firmware. :)