TeensySaber Bluetooth Control
Got Pike?
How to add bluetooth to your TeensySaber.

What you will need:

Installation steps

  1. Install BLE Nano 2 software
  2. Solder up the serial port and power
  3. Update TeensySaber software
  4. Run and/or install the app

Install BLE Nano 2 Software
If you bought a pre-programmed BLE Nano 2, you can skip this step and go directly to soldering. If not, follow these instructions to install the required add-on to the Arduino software. Then download NanoUART 1.2. Unzip NanoUART, start the Arduino software and select Tools->Board->BLE_Nano2. Make sure DAPLink v1.5 is plugged into an USB port, with the BLE nano inserted (the right way!) and and hit the upload arrow. If everything worked, you should be able to open the serial console, set it to 115200 baud, and it should repeatedly say "get_ble_config". If so, you should be good to go.

Solder up serial port and power
If your BLE Nano 2 has pins, you probably want to unsolder them, then solder the following:

Teensy PIN BLE Nano2 pin
That's it, here is a diagram that shows what it should look like:

Update TeensySaber software
You'll need to add these lines to your teensysaber config file:

// Max 20 characters
#define BLE_PASSWORD "your password"
// Max 32 characters.
#define BLE_NAME "Your Saber Name"
// Max 9 characters
#define BLE_SHORTNAME "Saber"
Then upload the new code to the saber. (instructions here)

Run and/or install the app
Click Here

Here is a screenshot of what the app looks like:

The app uses web-bluetooth, which is supported on many, but not all platforms on some platforms you'll need to make some configuration changes before it works, instructions for most platforms can be found here.

The app is of course open source and hosted on github, so if you want to make your own version, simply go to the github repository, clone the app and have a ball.

The NanoUart program will blink the LED on the BLE Nano 2 differently depending on what it's doing:

  • One quick blink on startup.
  • Five blinks after receiving the password and name from ProffieOS.
  • One brief blink every 2 seconds while waiting for something to connect.
  • Fast (twice per second) pulsing while waiting for a connected client to provide a password
  • Slow, dim pulsing (2 seconds per pulse) while connected, with bright flashes when data is sent or received
  • No blinks: It's frozen, unpowered or unprogrammed!

This page has been accessed 14,550 times since November 26th, 2017.
Last modified: November 6th, 2018 - Design by Monica & Fredrik Hübinette