A quicker way to get started building samples
Switch branches/tags
Nothing to show
Clone or download
Pull request Compare This branch is 23 commits behind im-tomu:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
bare-minimum
bin
captouch
cbmbasic
include
libopencm3-upstream @ dc64929
libopencm3
miniblink
opticspy
prebuilt
usb-cdcacm
usb-hid
usb-midi
usb-msc
.gitignore
.gitmodules
LICENSE
Makefile.common
README.md
generate-libopencm3.sh
tomu-efm32hg309.ld

README.md

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:

  1. An ARM toolchain
  2. Make
  3. 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-util
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-cs-c++ 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.