Tomu Quickstart Guide
This guide describes everything you need to set up your system to develop for Tomu.
This quickstart guide is designed to be used on Mac, Windows, Linux, and anything else that can run GCC and Make.
Overview of Requirements
To build and load sample code, you will need three things:
- An ARM toolchain
- Make
- dfu-utils
Installation varies depending on your platform:
| Platform | ARM Toolchain | Make | dfu-util |
|---|---|---|---|
| Windows | GNU Arm Embedded Toolchain | GNU Win32 Make | precompiled binaries |
| macOS | GNU Arm Embedded Toolchain | Xcode | Homebrew brew install dfu-utils |
| Debian/Ubuntu | sudo apt-get install gcc-arm-none-eabi libnewlib-arm-none-eabi |
sudo apt-get install make |
sudo apt-get install dfu-util |
| Fedora | sudo dnf install arm-none-eabi-newlib arm-none-eabi-gcc |
sudo dnf install make |
sudo dnf install dfu-util |
| Arch | sudo pacman -S arm-none-eabi-gcc arm-none-eabi-newlib |
sudo pacman -S make |
sudo pacman -S dfu-util |
This quickstart repo differs from the samples repo in that it has a prebuilt version of libopencm3, which normally requires various command line programs to compile. This cuts down on compile time, and enables building on platforms that don't have commands like grep, printf, or cat.
Building Examples
To build an example, go into the directory and type make.
Loading Examples
To load examples onto Tomu, ensure it is in DFU mode by verifying that the red and green LEDs are alternately blinkinking, and that it shows up if you run dfu-util --list. Then, load the sample you want using dfu-util --download.
To load another program, unplug Tomu and plug it back in.
Creating a new Project
To create a new project, simply copy an existing project. The [bare-minimum](./bare-minimum) project is a good example if you want to start from scratch.
The new project's .dfu file will be based on the directory name.