How to change the settings of Proffieboard (Beta version)

Last updated: April 29, 2025 (ProffieOS 7.15)

Precautions

Changing the settings of your Proffieboard requires a certain level of technical knowledge. You are free to customize it yourself, but please note that any problems, malfunctions, or other issues caused by changing the settings may be subject to a repair fee even within the warranty period.

Before changing any settings, be sure to back up the files on the SD card.

Please note that as the requirements for computers, operating systems, versions, etc. vary from customer to customer, we are unable to provide individual support regarding environment construction and configuration.

The contents of this page are for reference only, and any changes to the settings are at your own risk. We are not responsible for any problems or damages that may arise from changing the settings.

What you need to change the settings

Below is a list of what you need to create a configuration change environment for Proffieboard V2.2 (V3.9).

  1. Lightsaber body or board: A Proffieboard v2.2 (V3.9) board or a custom lightsaber equipped with it is required.
  2. Computer: A PC with Windows 10 (or 11) installed. Macs are also supported, but these instructions are for Windows.
  3. Software: Arduino IDE (free download from the official Arduino website ). Zadig (free download from the official Zadig website ). The latest versions of both should be fine.
  4. USB Cable: A USB cable for connecting the Proffieboard to a PC (Proffieboard supports Micro USB).
  5. Internet connection: Required to download Arduino IDE and board definitions for Proffieboard, and to get the latest version of ProffieOS.
  6. ProffieOS software: Firmware for Proffieboard. The latest version of ProffieOS can be downloaded for free from ProffieOS (hubbe.net) . The latest version provided should be fine.
  7. Text editor (optional): Used to edit the configuration file. Here we will use Sakura Editor (sakura-editor.github.io) .

How to change the settings of Proffieboard

Step 1: Install Arduino IDE

  1. Download Arduino IDE: Download Arduino IDE from the official Arduino website . The image shows IDE 2.2.1, but the latest version available at the time of purchase should be fine.
    proffie_setteing1
  2. Installation: Run the downloaded file and follow the instructions to install Arduino IDE.

Step 2: Installing the board definition for Proffieboard

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

    proffie_setteing2
  3. To start the Boards Manager: From the Tools menu, select Board → Boards Manager...
  4. Search for and install Proffieboard: Search for "Proffieboard" in the board manager and click the "Install" button for Proffieboard by Fredrik Hubinette. The image shows version 3.6, but the latest version at the time of download is fine.
    proffie_setteing3

Step 3: Installing the driver (Pattern 1)

  1. Download ProffieDFU: Get and install ProffieOS DFU . Direct link: proffie-dfu-setup
    You can now skip the steps previously performed in Zadig (Step 3, Pattern 2).
    If you are unable to perform DFU due to your device or environment, please perform Pattern 2 in Step 3.

    Step 3: Installing the driver (Pattern 2)

    1. Download Zadig: Download Zadig from the official Zadig website .
      setting6
    2. Run Zadig: Run the downloaded Zadig.
    3. Connecting the Proffieboard: Connect the Proffieboard to your PC with a USB cable.
    4. Installing the driver: From the Zadig screen, select "Options" → "List All Devices" to display a list of connected devices. Select STM32 BOOTLOADER from the list, select "WinUSB", and click "Install Driver" or "Replace Driver".
      setting6

    Step 4: Edit the config file and write it to the board

    Preparing the config file:

    1. Download and extract ProffieOS: Download ProffieOS (hubbe.net) and extract it to a location of your choice.
    2. Selecting a config file: Save the config file in the "config" folder in the ProffieOS folder.
    3. Edit the config file: Use a text editor to edit the config file, which allows you to customize collision sensitivity, number of LEDs, font, LED lighting, and more.

    Operation in Arduino IDE:

    • Open the ProffieOS sketch (.ino file) in the ProffieOS folder.
      Proffieboardsetting
    1. Specifying the config file in the sketch: The first few lines of the ProffieOS sketch specify the config file to use, for example: #include "config/your_config_file.h" , which specifies the path to the config file you edited in the Preparing the config file section.
    2. Selecting the board and port: From the Arduino IDE's "Tools" menu, select "Board" and then "Proffieboard V2"*, then select the port to which the Proffieboard is connected from "Tools" → "Port". If the board is not displayed, click "Get Board Information" from "Tools". *If the board installed in the saver is Proffieboard V3.9, select Proffieboard V3.
    3. Uploading the sketch: Click the "Upload" button (red frame) in the upper left of the Arduino IDE to upload the settings to Proffieboard. Writing will take about a minute.
      proffie_setteing7

    Setting change Example 1: Changing blade LED parameters

    Example: To change the number of blade LEDs:
    Open the configuration file and change the red number in the BladeConfig blades[] section at the bottom.
    This number represents the number of LEDs on the main blade. If you set it to 115 as shown in the image, all 115 LEDs on the blade will be lit.
    115 LEDs is equivalent to a 32 inch (approximately 80cm) blade.

    32 inch

    If you are using a 90cm blade, set it to 132.

    36 inch

    After rewriting the configuration file, save it overwrite and upload it to the target saver using Arduino to reflect the settings.

    Reference Links

    Proffieboard V2 (hubbe.net) Proffieboard V2.2

    ProffieOS Documentation: Proffieboard Setup (hubbe.net) How to set up your Proffieboard

    Proffie V2.2 Setup Tutorial Proffie V2.2 Setup Tutorial