1 unstable release
0.0.3 | Mar 12, 2019 |
---|
#436 in No standard library
9KB
solo-bsc
This is a (WIP!) Rust board support package for the open source Solo security key.
This key consists of:
- an STM32L432KC microcontroller
- either a USB-A or USB-C connector
- a clicky dome button
- 3 LEDs
- an NCP114 voltage regulator
- and various resistors, capacitors, and Zener diodes
One specialty is that it has a custom USB bootloader, allowing easy updates. To use it, FLASH ORIGIN
in memory.x needs to be set to 0x800_5000
instead of the conventional 0x800_0000
.
Alternatively, the ST DFU bootloader can be used.
Additionally, serial TX/RX and all SWD pins (SWDIO, SWCLK, SWO) are kind of broken out.
Quickstart
You need stable Rust 2018 edition, for details see the embedded book, in short:
curl https://sh.rustup.rs -sSf | sh
rustup target add thumbv7em-none-eabihf
cargo install cargo-binutils
rustup component add llvm-tools-preview
To build blinky, run make blinky
. You end up with a blinky.hex
file.
To flash it to your Solo Hacker:
- insert Solo and boot to Solo bootloader by pressing the button for ~2 seconds (it starts to blink)
- setup Solotool and make sure you can flash the original
solo.hex
- run
tools/solotool.py /path/to/blinky.hex
- watch the green LED blink 🎉
License
Licensed under either of
- Apache License, Version 2.0 (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
- MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT)
at your option.
Contribution
Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.
Dependencies
~57MB
~1.5M SLoC