Proffieboard Setting Manual

Last Updated: September 20, 2026 (Compatible with ProffieOS 8.x)

Important Notes

Changing settings on a Proffieboard requires a certain level of technical knowledge. While you are free to perform customizations yourself, please be aware that any issues, malfunctions, or other problems resulting from these changes may incur repair costs, even if the device is still under warranty.

Before making any changes to the settings, please be sure to back up the files on your SD card.

How to remove the SD card | SYBER SABERS

Please note that because individual customer environments regarding computers, operating systems, and versions vary, we do not provide individual support or assistance for environment setup or configuration.

The content of this page is provided for reference purposes only, and you should perform any setting changes at your own risk. Our shop assumes no responsibility for any trouble or damage caused by changing the settings.

Requirements for Changing Settings

The list of items required to set up an environment for modifying Proffieboard V2.2 / V3.9 settings is as follows:

  1. Saber body or board: A Proffieboard V2.2 or V3.9 board, or a custom lightsaber equipped with one, is required.
  2. Computer: A PC running Windows 10 (or 11). While Mac is supported, these instructions are based on using Windows.
  3. Software: Arduino IDE (available for free download from the official Arduino website). Zadig may be required as needed (official Zadig website). You may use the latest version of either.
  4. USB Cable: A USB cable to connect the Proffieboard to the PC. Both the Proffieboard V2.2 / V3.9 use a Micro USB terminal. Please use a cable that supports data transfer (charging-only cables will not work). Recommended: Audio-fan Double-sided L-shaped Micro USB Cable
  5. Internet Connection: Required for downloading the Arduino IDE, the Proffieboard board definitions, and the latest version of ProffieOS.
  6. ProffieOS Software: Firmware for the Proffieboard. The latest version of ProffieOS can be downloaded for free from ProffieOS (hubbe.net). The provided latest version is fine (currently, the latest is ProffieOS 8.x).
  7. Text Editor (Optional): Used for editing configuration files. These instructions use Sakura Editor (sakura-editor.github.io).

Proffieboard Setting Modification Procedure

Step 1: Installing the Arduino IDE

  1. Download Arduino IDE: Download the Arduino IDE from the official Arduino website. The image shows IDE 2.2.1, but using the latest version available is fine.
    proffie_setting1
  2. Installation: Run the downloaded file and follow the instructions to install the Arduino IDE.

Step 2: Installing Proffieboard Board Definitions

  1. Launch Arduino IDE: Open the installed Arduino IDE.
  2. Set Additional Board Manager URL: Select "Preferences" from the "File" menu, and add the following URL to the "Additional Board Manager URLs" field:
    https://profezzorn.github.io/arduino-proffieboard/package_proffieboard_index.json

    proffie_setting2
  3. Launch Board Manager: From the "Tools" menu, select "Board" -> "Boards Manager...".
  4. Search and Install Proffieboard: Search for "Proffie" in the Board Manager, and click the "Install" button for Proffieboard by Fredrik Hubinette. Although the image shows version 3.6, using the latest version available is fine.
    proffie_setting3

Step 3: Configuring the Board and SD Card Access Method (DOSFS)

⚠ Important (Item added from previous procedures): With current Proffieboard plugins, you must configure "DOSFS" after selecting the board. If this is not set correctly, the SD card cannot be read and the board will not boot properly. The setting value differs depending on the board.
  1. Select Board: From the Arduino IDE, select your board via "Tools" -> "Board" -> "Proffieboard".
    • Proffieboard V2.2 → Proffieboard V2
    • Proffieboard V3.9 → Proffieboard V3
  2. Set DOSFS: Set "Tools" -> "DOSFS" according to your board.
    • Proffieboard V2 → "SDCARD (SPI)"
    • Proffieboard V3 → "SDCARD (SDIO High Speed)"

Step 4: Installing Drivers (Pattern 1 - Recommended)

In current Windows environments, this Pattern 1 (ProffieDFU) is usually sufficient on its own. Pattern 2 (Zadig) is generally unnecessary and serves as an alternative if DFU does not work properly.
  1. Download ProffieDFU: Get and install ProffieOS DFU. Direct link: proffie-dfu-setup
    This allows you to skip the process previously performed with Zadig (Pattern 2). Only proceed with Pattern 2 if DFU cannot be executed on your device or environment.

Step 4 (Alternative): Installing Drivers (Pattern 2 - Zadig)

※ If you can successfully upload using Pattern 1 (ProffieDFU), this step is unnecessary.

  1. Download Zadig: Download Zadig from the official Zadig website.
    setting_zadig1
  2. Run Zadig: Run the downloaded Zadig application.
  3. Connect Proffieboard: Connect the Proffieboard to the PC using a USB cable.
  4. Install Driver: Select "Options" -> "List All Devices" in the Zadig window to see a list of connected devices. Select STM32 BOOTLOADER from the list, select "WinUSB," and click "Install Driver" or "Replace Driver".
    setting_zadig2

Step 5: Editing the Configuration File and Uploading to the Board

Preparing the Configuration File

  1. Download and Unzip ProffieOS: Download ProffieOS (hubbe.net) and unzip it to your desired location.
  2. Placement of Configuration File: Save your configuration file in the "config" folder within the ProffieOS folder.
  3. Editing the Configuration File: Use a text editor to edit the configuration file. You can customize impact sensitivity, number of LEDs, fonts, LED lighting methods, and more.

Operation in Arduino IDE

  • Open the ProffieOS sketch (.ino file) inside the ProffieOS folder.
    Proffieboardsetting
  1. Specifying the Configuration File in the Sketch: The first few lines of the ProffieOS sketch contain code that specifies which configuration file to use. Specify the path to your prepared configuration file, such as #include "config/your_config_file.h".
  2. Select Board, DOSFS, and Port: Set the "Board" and "DOSFS" as described in Step 3, and additionally select the port to which the Proffieboard is connected via "Tools" -> "Port". If the board is not displayed, click "Tools" -> "Get Board Info".
  3. Upload Sketch: Click the "Upload" button (in the red box) at the top left of the Arduino IDE to upload the settings to the Proffieboard. Writing takes about one minute.
    proffie_setting_upload

Setting Change Example 1: Modifying Blade LED Parameters

Example) Changing the number of blade LED settings:
Open the configuration file and change the number indicated by the red line in the BladeConfig blades[] section near the bottom.
This number represents the number of LEDs in the main blade; if you set it to 115 as shown in the image, 115 LEDs within the blade will light up.
115 LEDs corresponds to a 32-inch (approx. 80cm) blade.

32inch

If you are using an approximately 90cm blade, please set it to 132.

36inch

After rewriting the configuration file, save the changes and upload them to your saber using Arduino to apply the settings.

Recommended USB Cable

Common for Proffieboard V2.2 / V3.9 (Micro USB)

Audio-fan Double-sided L-shaped Micro USB Cable
Features a small head, making it easy to use even in chassis with limited space for inserting USB.

A cable that supports data transfer is required. Uploading will not work with a charging-only cable. Because it cannot be distinguished by appearance alone, please suspect the cable first if uploading is unsuccessful.

Reference Links

Proffieboard V2 (hubbe.net) About board specifications and terminal layout for Proffieboard V2.2

Proffieboard V3 (hubbe.net) About board specifications and terminal layout for Proffieboard V3.9

ProffieOS Documentation: Proffieboard Setup (hubbe.net) About how to set up the Proffieboard

ProffieOS Documentation: Configuration (hubbe.net) How to write the various items in the configuration file

Proffie V2.2 Setup Tutorial Video of the setup procedure (English)