/solo2

Solo 2 firmware in Rust

Primary LanguageRustApache License 2.0Apache-2.0

🐝

Documentation

SoloKeys Solo 2 monorepo.

WARNING WARNING WARNING

  • EARLY PRERELEASE.
  • NOT FOR PUBLIC USE.
  • PULL REQUESTS / ISSUES ONLY AFTER INITIAL CONSULTATION WITH THE TEAM.

For technical questions and discussions: https://github.com/solokeys/solo2/discussions

For product / crowdfunding questions and discussions: https://github.com/solokeys/kickstarter2021/discussions

For general discussion:

To repeat: Please do not open issues/PRs that are not technical issues / firmware bugs

To make pcsclite on Linux work with the Bee, on Debian copy Info.plist to /etc/libccid_Info.plist.

Getting Started

Prerequisites

  • Install Rust and Cargo for your system.

  • Install dependencies such as clang, llvm, arm-none-eabi-gdb, flip-link

  • Get and prepare hardware

  • Run make build-dev.

For more information: https://hackmd.io/@solokeys/solo2-getting-started. Please do not send PRs to expand on getting started generalities, just edit the linked HackMD directly.

Boards

Head to runnners/lpc55/board for an overview on the possible embedded platforms the firmware currently supports.

Compiling

Head to runners/lpc55 to get started, and try make build-dev, which compiles the entire firmware bundle using features convenient for getting started.

With make run-dev, it will try to connect to a GDB server to flash and run the firmware. One way to run a GDB server is JLinkGDBServer -strict -device LPC55S69 -if SWD -vd

To enable logs, you can change the feature flags on each crate. Then logs will be output via semihosting to your SWD debugger.

# Enable logs on the root crate and a few of the local crate dependencies.
cargo run --release --features board-lpcxpresso55,log-all,fido-authenticator/log-all,ctaphid-dispatch/log-info,ctap-types/log-all

License

Solo is fully open source.

All software, unless otherwise noted, is dual licensed under Apache 2.0 and MIT. You may use Solo software under the terms of either the Apache 2.0 license or MIT license.

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.

All hardware, unless otherwise noted, is licensed under CERN-OHL-S. You may use Solo hardware under the terms of the CERN-OHL-S license.

All documentation, unless otherwise noted, is licensed under CC-BY-SA. You may use Solo documentation under the terms of the CC-BY-SA 4.0 license.