The ProffieOS Workbench

Project maintained by profezzorn Hosted on GitHub Pages — Theme by mattgraham

The ProffieOS Workbench is a WebApp that uses WebUSB to talk to your Proffieboard and lets you control basic settings and edit fonts and presets. This page will show you how to use it. If you're wondering how to set it up, see the webusb page.

Making the connection 🔗

If the Proffieboard is currently connected to your computer or phone, and the SD card is mounted, make sure to eject it or the app will not work properly. Click HERE to start the ProffieOS Workbench. You should see something like this:


Depending on the capabilities of your browser, you may see only one or none of these buttons. See the end of this page for how to get it working. Pick USB or BLE (bluetooth). Note that using BLE is only possible if your saber has a bluetooth module. To use the USB button, make sure that the computer/phone is connected to the proffieboard with a data-capable USB cable. Your browser will now ask you to select the proffieboard you want to connect to. Usually there is only one:

connect screen

At this point you should be connected.

Control interaface 🔗

Once connected, you should see something like this:

first page

On the top left you'll see a slider for adjusting the volume and the current battery voltage. On the top right you'll see a pen button which takes you to the editing interface. Below those you'll see three columns:

Editing interaface 🔗

editing view

On the left you'll see all your presets, a plus and a trash can. You can re-order the presets by dragging them. You can delete presets by clicking the trash can or dragging presets onto the trash can. You can create new presets by clicking the plus button or dragging presets onto the plus icon. On the right you can see all the individual fields that make up a preset:

All changes you make are saved immediately. When done, click the pen icon in the top right corner again to return to the control interface.

How to add a new font 🔗

  1. Upload the font to the SD card. Assuming that your saber is configured with mass storage support, plug the USB cable into your saber and wait for the SD card to show on your desktop. Drag the font folder to the SD card, and then eject the drive from your computer safely. Please note that this can take a couple of minutes to complete.
  2. Now start from the top of this page and navigate to the Editing Interface.
  3. Pick a preset that may match the font you are adding.
  4. Press the "+" button. This will duplicate the preset you had selected.
  5. Now select the newly added font from the "font" dropdown in the right column.
  6. Done, although you may optionally change other parts of the preset like blade color and style.

How do I reset it back to factory settings? 🔗

  1. Plug in the USB cable and wait for the SD card to show up on your desktop.
  2. Open up the drive and delete "presets.ini" and "presets.tmp".
  3. Eject the SD card drive from your computer.
  4. Unplug the USB cable and insert your kill key, flip your kill switch or press the reset button on the proffieboard.

Troubleshooting 🔗

I get this message"This browser supports neither webusb nor web bluetooth." 🔗

See "No USB button" below.

No USB button 🔗

Make sure to select a browser that supports WebUSB..

No BLE button. 🔗

Make sure you use a a browser that supports Web-bluetooth. Note that it seems that with chrome on linux you have to enable "experimental web platform features" in about:flags. On IOS, you need to install an app called "Bluefly" to use Web-bluetooth.

Board doesn't show up after clicking USB button 🔗

Board doesn't show up after clicking the BLE button 🔗

I want more options! 🔗

Proffieboards can be programmed to do just about anything from Arduino. While not immensly complicated it does require more work than the methods described on this page. If you're still interested, check out the ProffieOS page.