im-tomu.github.io

tomu.im website

View on GitHub

Tomu, I’m

I’m Tomu, a tiny ARM microprocessor which fits in your USB port. I have two buttons and two LEDs!

I’m fully open source and am buildable by hobbyists! Designed for 2-factor authentication, usb experiments, or anything else you can think of.

I’m also available on Crowd Supply, fully assembled and tested.




Getting Started!

Got a Tomu? Great! Here’s how to get started. First you need a case, then you need the drivers.

Because Tomu fits entirely inside your USB port, you need something to keep it from falling out. Early Tomu prototypes were held in place using a business card folded over and wedged in the USB port, but newer releases have support for 3D printed cases.

If you have a 3D printer, download the .stl file for the version of Tomu that you have. The version number is printed on the bottom side with the big USB connections. Depending on how thick your PCB is, you may need to adjust the FreeCAD file.

For software, Tomu currently uses the SiLabs serial bootloader. One of the Crowd Supply stretch goals is a universal bootloader based on DFU.

To use the seral bootloader, Windows users will need to install Silabs-CDC_Install.zip, e.g. from M-Pression. Linux and macOS users do not need to use any special drivers.

  1. Enter the bootloader.
    • v0.2 boards require you to connect the C pin to Vcc.
    • v0.3 boards always enter the bootloader
  2. Connect a terminal.
    • TeraTerm on Windows is a good choice
    • screen works on Linux and macOS
  3. Interact with the bootloader by sending one-character commands:
    • i – show the bootloader version
    • u – upload a new program - send the binary using XMODEM
    • b – boot the current program



Back Us!

Tomu is crowdfunding on Crowd Supply! While software is mostly easy to update, hardware is more challenging. There are several stretch goals as part of the campaign, if we get enough support:

DFU-compatible Bootloader

We would like a bootloader that gets out of the way and lets you run your normal application without needing to short out the C pin every time. We’d also like to not require drivers, or superuser access, or have to deal with other programs thinking Tomu is a GPS or modem (unless it’s behaving like one.) These are all shortcomings that the current bootloader suffers from.

If enough people back Tomu, we will get a bootloader that supports the standard DFU protocol for updating device firmware easily.

Injection-Molded Plastic Case

Tomu is tiny, and fits entirely inside your USB port. USB ports have metal shields around them, so Tomu requires a case both to fit snugly inside the port and to protect the components from shorting out against the shield.

The current solution is to 3D print your own case. However, with enough backers, we can afford to produce an injection-molded plastic case to include with every Tomu purchased.




U2F / FIDO Firmware

GNU Chopstx has been ported to Tomu, complete with U2F support. That means you can use Tomu like any U2F token to add a second authentication factor when you log in. Chrome supports U2F natively, and Firefox supports it via a flag (and will support it fully in a few months)

Source

The U2F firmware source is located on Github in im-tomu/chopstx/u2f.

Building

To build the U2F firmware, ensure you have an ARM compiler installed (e.g. sudo apt install gcc-arm-none-eabi) as well as Python pip (e.g. pip install –user –upgrade asn1crypto), then run:

  1. pip install –user –upgrade asn1crypto
  2. git clone https://github.com/im-tomu/chopstx.git tomu-u2f
  3. cd tomu-u2f/u2f
  4. make

Loading onto Tomu

The build system produces an output file build/u2f.bin. Upload this file to Tomu.




Presentations





Help us!

These are currently the top items which need to be done related to the Tomu. If you help out, @mithro will probably send you a Tomu device!

Creating (or porting) a FOSS USB stack to EFM32HG

To make it easy for people to develop new applications for the Tomu, we need a good USB stack which is compatible with the EFM32HG.

There are a couple of possible options:

QEmu Emulation of the EFM32HG

We would like to have good emulation of the features in the EFM32HG309 processor so that people can write software for the board without having to have the hardware.

The biggest part of this is the emulation of the USB stack.




Contact




Tomu Hardware

Built out of a 3d printed part + 2 layer “thin” PCB (0.4mm, 0.6mm or 0.8mm thick).

Boards have:

All Tomu boards have:

Tomu

Specs

Gerbers

The important thing to note is that you need a PCB that is 0.8mm thickness or less. The default thickness is normally 1.0mm and 1.0mm is too thick.

These gerbers should be possible with the following manufacturers:

License

The Tomu hardware is under your choice of:

Software for Tomu is under various licenses, please consult the license included with the code.

Open Source Hardware Certification AU0000001