User Manual - thesaberarmory.com · 02 | ProfieBoardTeensySaber user manual by Fredrik Hubinette...

50
by Fredrik Hubinette and Dmitry Shtok 2018 User Manual ProffieBoard and TeensySaber Open-Source advanced saber sound boards

Transcript of User Manual - thesaberarmory.com · 02 | ProfieBoardTeensySaber user manual by Fredrik Hubinette...

by Fredrik Hubinette and Dmitry Shtok

2018

User Manual

ProffieBoard and TeensySaber

Open-Source advanced saber sound boards

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 01

Contents

Introduction (P ndash 2)Features (P ndash 3)1 Helpful instructions and tutorials links ndash Where to buy (P ndash 4) ndash Tutorials and instructions (P ndash 5)

2 TeensySaber V3 instructions 1) Wiring diagrams ndash Board pinout (P ndash 6) ndash Board assembling (P ndash 7) ndash Basic Tri-Cree wiring diagram (P ndash 8-9) ndash Basic Neopixel wiring diagram (P ndash 10-11) ndash Basic Segmented string wiring diagram (P ndash 12-13) ndash Accent LEDs wiring diagram (P ndash 14) ndash OLED display wiring diagram (P ndash 15) ndash Bluetooth module wiring and setup (P ndash 16) ndash Blade ID resistor functions (P ndash 17) ndash More wiring diagrams (P ndash 18) ndash How to use it (P ndash 20) 2) Firmware upload and update ndash Software installation and setup (P ndash 21) ndash Uploading firmware (P ndash 22) 3) Changing sound board parameters (P ndash 23)

3 ProffieBoard instructions 1) Wiring diagrams ndash Whatrsquos needed (P ndash 24) ndash Board pinout (P ndash 25) ndash Basic Tri-Cree wiring diagram (P ndash 26-27) ndash Basic Neopixel wiring diagram (P ndash 28-29) ndash Basic Segmented string wiring diagram (P ndash 30-31) ndash Accent LEDs wiring diagram (P ndash 32) ndash Neopixel Accent LEDs wiring diagram (Sub-blades) (P ndash 33-34) ndash OLED display wiring diagram (P ndash 35) ndash Bluetooth module wiring and setup (P ndash 36) ndash Blade ID resistor functions (P ndash 37) ndash More wiring diagrams (P ndash 38) ndash How to use it (P ndash 39) 2) Firmware upload and update ndash Software installation and setup (P ndash 40) ndash Uploading firmware (P ndash 41) 3) Changing sound board parameters ndash configh file structure editing (P ndash 42) ndash Blade Styles (P ndash 43)

4 SD card recommendations (P ndash 44-45)5 Wire gauge and current rating tests (P ndash 46-48)6 Troubleshooting (P ndash 49)

updated19122018

02 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

It really just started with a trip to Disneyland I was really just disappointed with the cheap plastic lightsabers they had available I had hoped to pick something more display-worthy or at least in the ldquotoys for grownupsrdquo category but did not find anything So when I got home I went and ordered an FX ldquoblack seriesrdquo Luke lightsaber which looks quite nice but the sound light and interactivity was still pretty disappointing At this point I started to think about how I would make a lightsaber I had already done things with neopixels before so that was kind of a no-brainer for making a better blade but I really wanted to do was to make the sound react fluidly to motion At this point I joined a bunch of forums and came across the NEC and Plecter boards but there didnrsquot seem to be a way to alter how they produced sounds so I picked up a teensy and a PJRC prop shield and started building from there The Teensy 32 + PJRC prop + SD card reader + voltage booster + FETs I ended up with was fairly large Luckily the Graflex lightsabers are also fairly large so I purchased a Graflex 21 and barely managed to squeeze everything in there Around this time I got kind of stuck with how to synthesize all the sounds a lightsaber makes so I decided to imple-ment support for Plecter and NEC sound fonts to get the saber I built make some sounds There are some amazing sound fonts out there but even so the interactivity I craved was still missing Since I didnrsquot really have a good idea for how to make that interactivity happen I took on a different challenge instead Make it smaller For the TeensySaber V2 I decided to try to make my own circuit board That meant integrating some components from the prop shield the sd card reader the voltage booster and the FETs into a single board To make things interesting I bought a Korbanth OWK which has an inner diameter of 78 inches and my goal was to fit everything in there It took a while to do but the result was the TeensySaber V2 board The V2 fits really great inside an OWK without cutting into the inner chassis parts and was generally a great success but the sound quality wasnrsquot as good as I wanted it to be so eventually I designed he TeensySaber V3 which is mostly the same as the V2 but uses a digital 3W amplifier As I was working on the TeensySaber V3 this guy Thexter showed up on a couple of forums with some great videos showing off an algorithm for better swing sounds Since this was what I wanted all along I couldnrsquot wait until he provided a description of his algorithm so that I could implement it Lucky for me he didnrsquot mind describing his algorithm so I imple-mented it My implementation never really sounded as good as his videos though but thatrsquos probably because Irsquom not really a font designer Later Thexter came back with an improved version which is what we now call ldquoSmoothSwing V2rdquo With SmoothSwing V3 TeensySaber V3 was getting some attention from people but a lot of people still thought it was too big since itrsquos made out of two boards sandwiched together The sandwiching also creates extra work for installers and extra complications for hobbyists so it was time to try to put everything together into one board At first I was thinking of using the same components that make up a Teensy to make the all-in-one board but it turned out to be complicated and expensive Instead I found another board called a ldquoButterflyrdquo which had nearly identical capabilities and an already functional arduino plugin Even better the Butterfly was 100 open source (the teensy is only mostly open source) I spent most of the Christmas vacation last year designing the Proffieboard and it took another couple of months of

testing to get a working prototype but itrsquos been a lot of fun

- Fredrik Hubinette

Read full interview on SaberSourcingProffieboard lightsaber controller developer Fredrik Hubinette interview

INTRODUCTION

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 03

Specifications and features

ndash ProffieBoard specific ndash Dimensions 179x346x57mm (with micro USB port and micro SD card)

ndash ProffieBoard specific ndash Single pcb board design

ndash TeensySaber V3 specific ndash Dimensions 18x395x9mm (with micro USB port and micro SD card)

ndash TeensySaber V3 specific ndash 2-pcb boards stack design

ndash 100 Open-Source you may add any feature you like (GPLv3)

ndash Power supply 26-45 Volts up to 10A per LED output 1-6 single Li-Ion 36-37V (low 26V full 42V) battery recommended

ndash Speaker 4 ohm or 8 ohm 2W (with lower volume) or 3-5W (recommended)

ndash Unlimited amount of sound banksfonts supports regular (Plecter NEC) and ldquoSmoothswingrdquo sound fonts

ndash Sound FX (WAV sound files) boot blaster blocking lockup hum swing clash drag font force ingnition retraction

ndash Light FX blade flickering pulsing flash on clash drag stab blaster blocking lockup and other

ndash Music tracks (WAV sound files) playback in idle mode and saber sound effects background

ndash Micro SD card 4-16Gb Class 4-10 by SanDisk brand recommended

ndash Support for remote control via bluetooth (with external bluetooth module addon)

ndash Speedy 32-bit processor for advanced features like sound filters synthesizing and mp3 playback

ndash 3 Watts sound amplifier 16-bit digital output (12-bit for TeensySaber V1 and V2)

ndash Sample rate is 44kHz (default) 22kHz and 11kHz are supported and upsampled to 44kHz automatically

ndash Gapless playback with 25ms cross-fade when you interrupt one sample to go to another

ndash Polyphonic playback currently configured for up to 5 simultaneous samples

ndash ldquoSmoothswingrdquo algorithm support (a new more natural swing motion sounds playback)

ndash PL9823 (RGB) WS2812B (GRB) SK6812 (GRB WWA) Neopixel support

ndash 1234-color LED stars (Tri-Cree and Quad (also RGBA) LED modules)

ndash Segmented (6 segments + Flash string) classic string blades support

ndash Multi-blade support for dual and crossguard setups

ndash Blade LED type Presets and Blade Styles selection by different values of a resistor (Blade ID functions)

ndash Crystal chamber support

ndash Power-level indicator with neopixel blade

ndash OLED PLI and FONT animations display

ndash sound files upload to SD card via USB cable directly from PC (only from firmware version 1291 and up)

ndash POV (persistance of vision) mode support

ndash Accent LEDs support (also implemented as additional ldquobladesrdquo)

ndash Spoken error and low battery messages

ndash Easy and free firmware updates by user

Demonstration videos

Link to the demonstration video by K-SithLink to the demonstration video by Megtooth Sith SabersLink to the demonstration video by Zimmer LabsLink to the demonstration video by ShtokCustomWorx

FEATURES

04 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

1HELPFUL LINKS

TeensySaber V3 boards

Send a message to this guy

Other parts links

RGB Neopixel strips (they are SK6812 though sellers list them as WS2812b)WWA (WhiteWhiteAmber) Neopixel strips SK6812 Source 1WWA (WhiteWhiteAmber) Neopixel strips SK6812 Source 2Individual Neopixel LEDsNeopixel stripsconnectorsother supplies (UK) ndash TheSaberArmoryTri-Cree high power LEDs (CanadaUSA) ndash TheCustomSaberShopTri-Cree high power LEDs (UK) ndash TheSaberArmoryVarious Accent LEDs (UK) ndash TheSaberArmoryVarious Batteries (UK) ndash TheSaberArmoryProtected KeepPower 18650 10A 3500mAh batteryProtected KeepPower 18650 15A 3120mAh batteryUnprotected Vapcell 21700 15A 5000mAh battery ndash requires external PCMUnprotected KeepPower 26650 15A 6000mAh battery ndash requires external PCM15A Protection Circuit Module (PCM)18650 Protected Battery holderHigh Power 13mm Recharge PortRecharge Ports (UK) ndash TheSaberArmoryHigh Power Kill SwitchVarious Switches (UK) ndash TheSaberArmorySCW Neopixel blade Pogo connectorTCSS Neopixel blade Pogo connectorGX16 Neopixelstring blade connectorsVarious Speakers (UK) ndash TheSaberArmory Various Speakers (UK) ndash JQ-sabersVarious Speakers (CanadaUSA) ndash TheCustomSaberShop2W and 3W Speakers ndash Saber Essentials4W Speakers ndash ebay

3D-printed chassis links

ShtokCustomWorx on ShapewaysGOTH-3Designs on Shapeways

Where to buy

ProffieBoards

TheSaberArmory (KR-sabers) UK storeJQ-sabers UK storeSaberBay Etsy USA storeShtokCustomWorx Etsy RUS store (not opened yet)

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 05

1HELPFUL LINKS

Video tutorials by Megtooth Sith Sabers

Video tutorials by Megtooth Sith Sabers on youtubeLED Resistor Calculator

For more information please check these links

TeensySaber V3 sound board instructionsProffieBoard sound board instructionsrdquoBlade style sharingrdquo - here you can find and share custom blade stylesWeb Blade Style Editor 1 (default)Web Blade Style Editor 2 (restyle)Here you can get regular (Plecter NEC) or ldquoSmoothswingrdquo sound fontsProffieOSProffieBoardTeensySaber wiki on GitHubProfezzornrsquos Lab on The Rebel Armory forumsProfezzornrsquos Lab on FX-sabers forumsAsk your question in facebook group

Get latest ProffieOS firmware

Tutorials and instructions

06 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

Board pinout

used pads

Battery + ndash 26 to 45 volt input drives everything except the LEDs

Battery - ndash negative pad for LEDs needs to be at same level as GND when both are connected

GND ndash ground for electronics except LEDs Note that GND is also available on short edge of the teensy (See the teensy pinout for details)

Speaker +- ndash hooks up to speaker

Activation Aux Aux2 button ndash hook up to closing buttons or potentially touch buttons

Blade ID Neopixel Data 1 ndash normally used to measure the blade ID restor and if itrsquos a neopixel blade feed out neopixel data

LED 1 2 3 ndash hooks up to negative side of LED (positive side of LED hooks up directly to battery) These pads can handle

up to 30 volts

LED 4 5 6 ndash like LED123 but requires FETs to be placed on the bottom of the board to function Voltage is limited by

selection of FETs

Power 1 Power 2 Power 3 ndash these control the FETs which drive LED 1 2 3

AUX LED 1 2 3 ndash these are hooked up to pads on the bottom which can be populated with FETs and used to drive additional LEDs If the

bottom FETs are not populated these pins are free and can be used for any purpose

RX3 TX3 ndash these pins are used for wiring a bluetooth module for wireless control or additional Neopixel Data out

SDA SCL ndash these pins are used to wire OLED display

+33V 250mA max ndash generated by the Teensy for powering OLED display or Bluetooth module

micro USB port ndash micro USB port used only for firmware upload and can be used for sound files upload to SD card

THIS PORT ISNrsquoT USED FOR CHARGING THE BATTERY

LED output 1 2 3

Battery - Speaker + (red dot or ldquo+rdquo mark on speaker)Battery +

Data in (SD) SCK (SD)

Battery Volt SenseAux button

Activation buttonAux2 button

SDA

SCL

Blade ID Neopixel Data 1Audio data

Audio LRClock

Power 3+33VAudio GND (not used)+5V

Data out (SD)

Power 2

Audio clock

TX3Neopixel Data 2

RX3Neopixel Data 3

Power 1AUX3 LEDAUX2 LEDAUX1 LED

Motion InterruptAmplifier enable

SD card selectGND

Speaker -

LED output 4 5 6

micro USB port on Teensy 32

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 07

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

Board assembling

1 IMPORTANT

Cut the tiny trace with a knife between VIN and VUSB as shown

Teensy 32 bottom view

2 Solder 254mm header pins (gold plated recommended) to

TeensySaber V3 board on the top or on the bottom depending

on where you want to put Teensy 32 board

(please see next step)

3 Solder Teensy 32 board on top

(A ndash micro USB port on top SD card between boards) or on the bottom (B ndash SD card on top micro USB port between boards)

A B

+

08 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

Basic Tri-Cree wiring diagram(In-hilt LED)

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

+

+

+

-

-

-

26 A

WG

26 AWG

30-32 AWG

28-30 AWG

28-30 AWG

30-32 AWG

Protected 36-37V (42V max at full charge) 10A 3500mAh battery recommended+18650 battery holder (optional)Keystone 1042P

AV switch with accent led(constantly ON no effects)

accent leds run mostly at10-15mA so resistors for them must be calculated accordingly

Main RGB led

additional RGB leds(optional)

In case no additional high power leds are needed LED channels 4 5 6can be used for 3 controllable (programmable for different effects) accent leds So AV switch led can be wired to one of these channelsby adding 1 MOSFET

LED Resistor Calculator

solder 3x FETs

solder 1 FET

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 09

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

Basic Tri-Cree wiring (In-hilt LED)ldquoconfighrdquo file setup

Use a given or build your wiring diagram on THIS PAGE then open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text

Editor (Notepad - to see code correctly in Notepad Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all

text) and Delete it then Copy-and-Paste (Ctrl+C Ctrl+V) your wiring diagram config code (example below) into empty _configh file and

Save it under new name Follow the instructions on page 22 to upload it to the board

ldquov3_confighrdquoNUM_BLADES 2NUM_BUTTONS 2VOLUME 1000CLASH_THRESHOLD_G 10StyleNormalPtrltCYAN WHITE 300 800gt()StyleNormalPtrltCYAN WHITE 300 800gt()

CreeXPE2RedTemplatelt1000gtCreeXPE2GreenTemplatelt0gtCreeXPE2BlueTemplatelt240gtNoLED

TeensySaber V3 config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)Volume level (0-3000)Clash sensitivity (adjust lower or higher with 01 step)ldquoBlade 1rdquo styleldquoBlade 2rdquo style (in case only 1 blade is used you donrsquot need this line)LED configuration (use these XP-E2 LED templatesto define your LED If other LED resistors are used change these values to match Ohm1000=ltvaluegt)

where 1000 is 1 Ohm resistor 0 is no resistor240 is 024 Ohm resistorNoLED ndash no 4th led used

Preset 1

LED 1 configuration

LED 2 configuration

Preset 2 etc

10 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

Basic Neopixel wiring diagram

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

+

+

+

-

-

-

22 A

WG

22 AWG

26 AWG

30 AWG

x2 28 AWG

x2 26 AWG

22 A

WG

30-32 AWG

30-32 AWG

Protected 36-37V (42V max at full charge) 10A 3500mAh or 15A 3120mAhbattery recommended+18650 battery holder (optional)Keystone 1042P

AV switch with accent led(constantly ON no effects)

accent leds run mostly at10-15mA so resistors for them must be calculated accordingly

Main Neopixel strip

additional Neopixelstrips(optional)

Neopixel bladeconnector

330 Ohm on the Blade pcb side

x3 28 AWGor x1 22 AWGfor Negative

330 Ohm on the Blade pcb side

arrows up

330 Ohm on the Blade pcb side

In case no additional Neopixel strips are needed LED channels 4 5 6can be used for 3 controllable (programmable for different effects) accent leds So AV switch led can be wired to one of these channelsby adding 1 MOSFETRecommended power wire gauges (22 AWG) are given for 2-strip blade For 3-strip blade you gonna need at least 20 AWG wires

solder 2x FETs

solder 1 FET

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 11

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

Basic Neopixel wiringldquoconfighrdquo file setup

ldquov3_confighrdquoNUM_BLADES 3NUM_BUTTONS 2VOLUME 1000CLASH_THRESHOLD_G 10IgnitionDelaylt0 any blade stylegtIgnitionDelaylt800 any blade stylegtIgnitionDelaylt800 any blade stylegtWS2811BladePtrlt118 WS2811 800kHz | WS2811 GRBgt()WS2811BladePtrlt26 7 ltbladePowerPin4gtgt()WS2811BladePtrlt26 8 ltbladePowerPin5gtgt()

TeensySaber V3 config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)Volume level (0-3000)Clash sensitivity (adjust lower or higher with 01 step)ldquoBlade 1rdquo style (main blade with IgnitionDelay 0)ldquoBlade 2rdquo style (CG blade 1 with IgnitionDelay 800)ldquoBlade 3rdquo style (CG blade 2 with IgnitionDelay 800)

strip configuration (defines how many pixels it has and to which LED output and pin is wired)

Preset 1

any blade style

strip (blade) 1 configuration

strip (blade) 2 configuration

strip (blade) 3 configuration

Preset 2 etc

Use a given or build your wiring diagram on THIS PAGE then open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text

Editor (Notepad - to see code correctly in Notepad Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all

text) and Delete it then Copy-and-Paste (Ctrl+C Ctrl+V) your wiring diagram config code (example below) into empty _configh file and

Save it under new name Follow the instructions on page 22 to upload it to the board

12 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

Basic Segmented string wiring diagram

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

+

+

-

-

24 A

WG

28 AWG

30-32 AWG

30-32 AWG

Protected 36-37V (42V max at full charge) 10A 3500mAh battery recommended+18650 battery holder (optional)Keystone 1042P

AV switch with accent led(constantly ON no effects)

accent leds run mostly at10-15mA so resistors for them must be calculated accordingly

6-segments string blade

FoC string

N-channel FET3A minimum

1

1 46 523

23456

Calculate resistors for each led segment of the blade string depending on which leds are used 5mm leds have max drive current around 25mA per led when 10mm leds can be 100mA and 200mA per ledSo pay attention to your led max current and Forward Voltage (Vf) when calculating a segment resistor resistence as well as its wattage Also choose wire gauges accordingly to meet segments and total blade max current draw level

LED Resistor Calculator

solder 3x FETs

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 13

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

Basic Segmented string wiringldquoconfighrdquo file setup

ldquov3_confighrdquoNUM_BLADES 1NUM_BUTTONS 2VOLUME 1000CLASH_THRESHOLD_G 10StyleNormalPtrltCYAN WHITE 300 800gt()ltBlue3mmLED 20 White3mmLEDgt

TeensySaber V3 config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)Volume level (0-3000)Clash sensitivity (adjust lower or higher with 01 step)Blade styleLED string configuration(here you mention the color and type of leds usedin the main blade string segments and FoC string20 is the FoC signal pin (Blade ID pin))

Preset

LED string configuration

Use a given or build your wiring diagram on THIS PAGE then open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text

Editor (Notepad - to see code correctly in Notepad Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all

text) and Delete it then Copy-and-Paste (Ctrl+C Ctrl+V) your wiring diagram config code (example below) into empty _configh file and

Save it under new name Follow the instructions on page 22 to upload it to the board

14 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

Accent LEDs wiring diagram(optional)

Accent LEDs work with TeensySaber board as additional ldquobladesrdquo when powered by LED outputs 4 5 6 with FETs So they can have any effect

that blade can have If no effects needed accent led can be powered just by a 33V output pad (power-on led indication)

30-32 AWGRGB ledcommon-anode

4 ldquobladesrdquo1 main and 3 accent leds

main blade style (effects) main blade style (effects)

3 accent leds style (effects)accent led style (effects)

3 accent leds configurations

RGB accent led configuration

2 ldquobladesrdquo1 main and 1 RGB accent led

ldquoPower-onrdquo indicationaccent leds (no effects)

3 accent leds withindependent effects

+ 1 or more simple accent leds without effects

1 RGB accent led+ 1 or more simple accent leds

without effects

a) b)

b)

c)

c)

solder 3x FETs solder 3x FETs

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 15

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

OLED display wiring diagram(optional)

SSD1306 128x32 pixels OLED display allows to show battery level current preset name play different animations and even simple games It

can be wired to any blade configuration and requires just one additional line in the code to work You can get monochrome display in white

or blue color

SSD1306128x32OLED

SSD1306 ndash with blue or white display color selectSSD1306 ndash cheaper priceSSD1306 just screen ndash blue or white select

30-32 AWG

30-32 AWG

add this line to enable OLED display

display shows a preset name written in these quotes ldquoldquo

16 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

Bluetooth module wiring diagram(optional)

SOON

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 17

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

Blade ID resistor functions(optional)

SOON

18 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

website TeensySaber V3 FULL wiring diagrams link

Scroll the page down till you see the interactive diagram Above the diagram there are components selection options Build your saber setup

with it and follow diagram to wire your board Then you need to copy the configuration code below and paste it into your _configh file

Choose components you want

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

More wiring diagrams

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 19

20 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

How to use it

Blade ignitionretraction ndash assuming you have at least one button pressing it briefly should turn the saber on or off If you have an AUX button pressing it briefly should also turn the saber on and off If you have no buttons you can turn the saber on and off by twisting your wrist back and forth Note that the motion has to be done long enough to count so a very quick flick of the wrist will not workTurn On muted ndash double-click power buttonNext preset ndash while saber is off click the AUX buttonPrevious preset ndash hold AUX button and click the Activation buttonTrigger Clash ndash while saber is on hit the bladeTrigger Lockup ndash while saber is on hold Activation button then trigger a clash Lockup releases when you let go of the Acti-vation buttonTrigger Drag ndash like lockup but point saber mostly down before holding Activation buttonTrigger Force ndash long-click AUX buttonStart soundtrack ndash long-click the Activation buttonTrigger Blaster Block ndash while saber is on short-click AUX button

Serial Monitor commands

battery_voltage ndash gets current battery voltage valueget_volume ndash get current volume valuepow ndash power OnOff the saberon ndash power On the saberoff ndash power Off the saberset_volume lt0-3000gt ndash set volume value (example set_volume 500)play ndash play the default preset trackplay trackslttrack namegt ndash play a specific track from tracks folder (example play tracksvenuswav)stop ndash stop the playing trackforce ndash play ldquoforcerdquo sound effectsdrag ndash play ldquodragrdquo sound effectsblast ndash play ldquoblasterrdquo sound effectslock ndash play ldquolockuprdquo sound effectsclash ndash play ldquoclashrdquo sound effectsreset ndash reboot the boardn ndash switch to next presetp ndash switch to previous presetlist_presets ndash show all presetssdtest ndash test SD card speed

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 21

2TEENSYSABER V3 INSTRUCTIONS

FIRMWARE UPLOAD AND UPDATE2

Software installation and setup

To upload firmware to TeensySaber board Arduino IDE program is required Follow these steps to install it to your PC

1 Install latest Arduino IDE software (donrsquot use BETA)

Installing as Windows app also is not recommended

because it will be installed in a specific protected folder that

wonrsquot allow you to install Teensyduino software in it

If TeensySaber wonrsquot show up in COM port use

Arduino IDE 186 version

2 Install latest Teensyduino software in same directory

usually itrsquos CProgram Files (x86)Arduino on Windows

Follow installation instructions for your system

3 Select Teensy 32 31 in Tools -gt Board

USB Type ndash Serial CPU Speed ndash 96 MHz (overclock) Optimize ndash Smallest Code Port ndash COM(the number your PC assigned) (Teensy 32) Serial

Connect TeensySaber via USB cable to PC to be able to select

the Port donrsquot forget to connect battery first

22 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

1 Download the TeensySaber firmware and SD card content

Unzip lightsaber-1286zip to your Documents directory or to

Desktop but not to Arduino program folder or anywhere in

Programs directory where all programs are installed You will

see a lightsaber folder and files inside it Donrsquot move any of

these files to any other location outside the lightsaber folder

and donrsquot reorganize them Unzip ProffieOS_SD_Cardzip to the

folder where you keep lightsaber-1286 folder Copy all files

from ProffieOS_SD_Card folder to your SD card

2 Unhide file extensions in File Explorer settings to see h ending

of config files Donrsquot add ldquohrdquo to the config file name

Go to config folder and create you own configh file (see page

23 for how-to)

Double-click the lightsaberino file

3 Add the name of your configh file as shown and Save this

lightsaberino file Make sure the other config files are

commented out there should be only one CONFIG_FILE

without You can have multiple config files

in lightsabergtconfig folder and just define the one you need

in lightsaberino file and upload it again to TeensySaber board

4 Connect battery to TeensySaber board and hook up to your PC

with a data transfer micro-USB-to-USB cable

Press arrow button it will compile and upload firmware to the

board Wait for your PC to make a sound or TeensySaber will

play boot sound if speaker is connected Now you can unplug

the USB cable Done

If it gives an error instead this means your configh file has

issues define CONFIG_FILE name has mistakes configh file

is out of config folder your PC user name is non-latin

2TEENSYSABER V3 INSTRUCTIONS

FIRMWARE UPLOAD AND UPDATE2

Uploading firmware

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 23

2TEENSYSABER V3 INSTRUCTIONS

CHANGING PARAMETERS3

Changing sound board parameters

All sound files (sound fonts music tracks) are stored on the micro SD card Add required sound fonts folders (Plecter NEC and Smoothswing

fonts are supported no need to change WAV files names just copy and paste) to SD card root directory as itrsquos done in the default

ProffieOS_SD_Card content folder and music tracks to the tracks folder

Make sure to name all music tracks and sound fonts folders with latin characters and only up to 8 characters long without using any special

characters (like |[- etc)

Make sure you have a configini file in each sound font folder if there is none - copy one from some default TeensySaberProffieBoard sound

font and paste into newly added sound font folder It has only one parameter that you can modify - humstart It helps to match hum sound

start with blade ignition 1000 usually works fine

All blade effects LED configuration volume level clash sensitivity etc are changed in the configh file located in lightsabergtconfig folder

To do that open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text Editor (Notepad - to see code correctly in Notepad

Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all text) and Delete it then Copy-and-Paste (Ctrl+C

Ctrl+V) your wiring diagram config code into empty _configh file and Save it under new name Follow the instructions on page 22 to

upload it to the board

TeensySaber V3 config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)

volume level (0-3000)

clash sensitivity (adjust lower or higher with 01 step)

sound font folder nametrack name

Preset name

Blade style

LED configuration (use these XP-E2 LED templatesto define your LED)

for Red use 1 Ohm resistor for Green - no resistor for Blue use 024 Ohm

NoLED ndash no 4th led used

Preset 1

24 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

31

PROFFIEBOARD INSTRUCTIONS

Whatrsquos needed

ndash ProffieBoard

ndash micro SD-card (see page 44 for recommendations)

ndash a USB micro SD-card reader (to load sound files from PC to micro SD card)

ndash micro USB data transfer cable (CABLES THAT SUPPORT ONLY CHARGING WONrsquoT WORK)

ndash wires of different gauges (32-20 AWG) (PTFE coated copper stranded wires recommended) heat shrink

ndash ESD safe soldering station solder wire flux etc

ndash pliers helping hands etc

ndash isopropyl alcohol to clean pads before soldering (helps solder to stick better)

ndash Digital Multimeter (VERY USEFUL)

ndash computer running Windows Linux or Mac OS with internet access

ndash 37V Li-Ion Protected rechargeable battery switches recharge port speaker LEDs resistors chassis etc

ndash Smart Li-Ion CC-CV (Constant Current - Constant Voltage mode) battery charger for 37V (42V) cells

ndash patience

WIRING DIAGRAMS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 25

31

PROFFIEBOARD INSTRUCTIONS

Board pinout

Battery + ndash 26 to 45 volt input drives everything except the LEDs

Battery - ndash negative pad for LEDs needs to be at same level as GND when both are connected Both pads are internally connected

GND ndash ground for electronics except LEDs Note that there are two GND pads on the board that are internally connected

Speaker +- ndash hooks up to speaker

Activation (1) Aux (2) Aux2 button (3) ndash hook up to closing buttons or potentially touch buttons

Blade ID Neopixel Data 1 ndash normally used to measure the blade ID restor and if itrsquos a neopixel blade feed out neopixel data

Data 2 3 4 5 ndash additional neopixel data outputs or free for other purposes

LED 1 2 3 4 5 6 ndash hooks up to negative side of LED (positive side of LED hooks up directly to battery) These pads can handle

up to 30 volts

SDA SCL ndash these pins are used to wire OLED display or to communicate with the gyro and accelerometer chip

RX TX ndash these pins are used for wiring a bluetooth module for wireless control

SWDCLK SWDIO ndash can be hooked up to a ST-LINK device and lets you debug programs running on the ProffieBoard

+5V ndash generated by the ProffieBoard normally itrsquos only ON when sound is playing

+33V ndash generated by the ProffieBoard for powering OLED display Bluetooth module or some accent leds

BOOT RESET ndash buttons to put the ProffieBoard in bootloader mode if uploading doesnrsquot work

micro USB port ndash micro USB port used only for firmware upload and can be used for sound files upload to SD card (from firmware version

1291 and up) THIS PORT ISNrsquoT USED FOR CHARGING THE BATTERY

LED 4LED 3

LED 2

LED 1

LED 5

LED 6

RESETBOOT

Battery - Battery -

Speaker + (red dot or ldquo+rdquo mark on speaker)

Battery +

Aux button (2)Activation button (1)

Aux2 button (3)

Blade ID Neopixel Data 1

Data 5

Data 4Data 3Data 2

+33V

SWDIO

SWDCLK

+5V

TXRX

GND

GND

Reset

Speaker -

SCLSDA

micro USB port

WIRING DIAGRAMS

26 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Basic Tri-Cree wiring diagram(In-hilt LED)

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

+

+

-

-

26 AWG

26 A

WG

30-32 AWG

28-30 AWG

28-3

0 A

WG

30-32 AWG

Protected 36-37V (42V max at full charge) 10A 3500mAh battery recommended+18650 battery holder (optional)Keystone 1042P

AV switch with accent led(constantly ON no effects)

accent leds run mostly at10-15mA so resistors for them must be calculated accordingly

Main RGB led

additional RGB leds(optional)

In case no additional high power leds are needed LED channels 4 5 6 can be used for 3 controllable(programmable for different effects) accent leds So AV switch led can be wired to one of these channelsAccent leds also can be wired to Data pads 1-5 please see ldquoAccent LEDs wiring and setuprdquo page

LED Resistor Calculator

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 27

3WIRING DIAGRAMS1

Basic Tri-Cree wiring (In-hilt LED)ldquoconfighrdquo file setup

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

Use a given or build your wiring diagram on THIS PAGE then open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text

Editor (Notepad - to see code correctly in Notepad Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all

text) and Delete it then Copy-and-Paste (Ctrl+C Ctrl+V) your wiring diagram config code (example below) into empty _configh file and

Save it under new name Follow the instructions on page 22 to upload it to the board

ldquoproffieboard_v1_confighrdquoNUM_BLADES 2NUM_BUTTONS 2VOLUME 1000CLASH_THRESHOLD_G 10StyleNormalPtrltCYAN WHITE 300 800gt()StyleNormalPtrltCYAN WHITE 300 800gt()

CreeXPE2RedTemplatelt1000gtCreeXPE2GreenTemplatelt0gtCreeXPE2BlueTemplatelt240gtNoLED

ProffieBoard config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)Volume level (0-3000)Clash sensitivity (adjust lower or higher with 01 step)ldquoBlade 1rdquo styleldquoBlade 2rdquo style (in case only 1 blade is used you donrsquot need this line)LED configuration (use these XP-E2 LED templatesto define your LED If other LED resistors are used change these values to match Ohm1000=ltvaluegt)

where 1000 is 1 Ohm resistor 0 is no resistor240 is 024 Ohm resistorNoLED ndash no 4th led used

Preset 1

LED 1 configuration

LED 2 configuration

Preset 2 etc

PROFFIEBOARD INSTRUCTIONS

28 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Basic Neopixel wiring diagram

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

+

+

-

-

22 A

WG

22 AWG

x2 28 AWG

x2 26 AWG

22 A

WG

30-32 AWG30-32 AWG

Protected 36-37V (42V max at full charge) 10A 3500mAh or 15A 3120mAhbattery recommended+18650 battery holder (optional)Keystone 1042P

AV switch with accent led(constantly ON no effects)

accent leds run mostly at10-15mA so resistors for them must be calculated accordingly

Main Neopixel strip

additional Neopixelstrips(optional)

Neopixel bladeconnector

330 Ohm on the Blade pcb side

x3 28 AWGor x1 22 AWGfor Negative

330 Ohm on the Blade pcb side

arrows up

330 Ohm on the Blade pcb side

In case no additional Neopixel strips are needed LED channels 4 5 6 can be used for 3 controllable(programmable for different effects) accent leds So AV switch led can be wired to one of these channelsAccent leds also can be wired to Data pads 2-5 please see ldquoAccent LEDs wiring and setuprdquo page

Recommended power wire gauges (22 AWG) are given for 2-strip blade For 3-strip blade you gonna need at least 20 AWG wires

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 29

ldquoproffieboard_v1_confighrdquo

3WIRING DIAGRAMS1

Basic Neopixel wiringldquoconfighrdquo file setup

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

NUM_BLADES 3NUM_BUTTONS 2VOLUME 1000CLASH_THRESHOLD_G 10IgnitionDelaylt0 any blade stylegtIgnitionDelaylt800 any blade stylegtIgnitionDelaylt800 any blade stylegtWS2811BladePtrlt118 WS2811 800kHz | WS2811 GRBgt()WS2811BladePtrlt26 blade2Pin ltbladePowerPin4gtgt()WS2811BladePtrlt26 blade3Pin ltbladePowerPin5gtgt()

ProffieBoard config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)Volume level (0-3000)Clash sensitivity (adjust lower or higher with 01 step)ldquoBlade 1rdquo style (main blade with IgnitionDelay 0)ldquoBlade 2rdquo style (CG blade 1 with IgnitionDelay 800)ldquoBlade 3rdquo style (CG blade 2 with IgnitionDelay 800)

strip configuration (defines how many pixels it has and to which LED output and pin is wired)

Preset 1

any blade style

strip (blade) 1 configuration

adjust this number to match your strips leds count

strip (blade) 2 configuration

strip (blade) 3 configuration

Preset 2 etc

Use a given or build your wiring diagram on THIS PAGE then open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text

Editor (Notepad - to see code correctly in Notepad Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all

text) and Delete it then Copy-and-Paste (Ctrl+C Ctrl+V) your wiring diagram config code (example below) into empty _configh file and

Save it under new name Follow the instructions on page 22 to upload it to the board

PROFFIEBOARD INSTRUCTIONS

30 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Basic Segmented string wiring diagram

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

+

+

-

-

24 A

WG

28 AWG

30-32 AWG30-32 AWG

Protected 36-37V (42V max at full charge) 10A 3500mAh battery recommended+18650 battery holder (optional)Keystone 1042P

AV switch with accent led(constantly ON no effects)

accent leds run mostly at10-15mA so resistors for them must be calculated accordingly

6-segments string blade

FoC string

N-channel FET3A minimum

123456

Calculate resistors for each led segment of the blade string depending on which leds are used 5mm leds have max drive current around 25mA per led when 10mm leds can be 100mA and 200mA per ledSo pay attention to your led max current and Forward Voltage (Vf) when calculating a segment resistor resistence as well as its wattage Also choose wire gauges accordingly to meet segments and total blade max current draw level

LED Resistor Calculator

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 31

ldquoproffieboard_v1_confighrdquo

3WIRING DIAGRAMS1

Basic Segmented string wiringldquoconfighrdquo file setup

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

NUM_BLADES 1NUM_BUTTONS 2VOLUME 1000CLASH_THRESHOLD_G 10StyleNormalPtrltCYAN WHITE 300 800gt()ltBlue3mmLED BladePin White3mmLEDgt

ProffieBoard config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)Volume level (0-3000)Clash sensitivity (adjust lower or higher with 01 step)Blade styleLED string configuration(here you mention the color and type of leds usedin the main blade string segments and FoC stringBladePin is the FoC signal pin (Blade ID pin))

Preset

LED string configuration

Use a given or build your wiring diagram on THIS PAGE then open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text

Editor (Notepad - to see code correctly in Notepad Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all

text) and Delete it then Copy-and-Paste (Ctrl+C Ctrl+V) your wiring diagram config code (example below) into empty _configh file and

Save it under new name Follow the instructions on page 22 to upload it to the board

PROFFIEBOARD INSTRUCTIONS

32 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Accent LEDs wiring diagram(optional)

Accent LEDs work with ProffieBoard as additional ldquobladesrdquo when powered by LED outputs 4 5 6 or Data pads 1 2 3 5 as PWM So they can

have any effect that blade can have If no effects needed accent led can be powered just by a 33V output pad (power-on led indication)

30-32 AWG

with Neopixel blade setup these 4 outputsdonrsquot work for regular accent leds

Recommended resistors to use for accent leds at 33V power source and 15mA drive

ndash 100 Ohm for Red (lt100000gt value in the code)ndash 13 Ohm for Green (lt13000gt value in the code)ndash 13 Ohm for Blue (lt13000gt value in the code)ndash 100 Ohm for Yellow (lt100000gt value in the code)ndash 20 Ohm for White (lt20000gt value in the code)

RGB ledcommon-anode

8 ldquobladesrdquo1 main and 7 accent leds

main blade style (effects) main blade style (effects)

7 accent leds style (effects)accent led style (effects)

7 accent leds configurations

RGB accent led configuration

2 ldquobladesrdquo1 main and 1 RGB accent led

ldquoPower-onrdquo indicationaccent leds (no effects)

7 accent leds withindependent effects

RGB accent led

a) b)

b)

c)

c)

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 33

3WIRING DIAGRAMS1

Neopixel Accent LEDs wiring diagram(optional)

With Neopixel setup additional neopixel leds or arrays can be used as accent leds There are 2 ways to wire them using additional Data

pins 2 3 4 5 or ldquoSub-bladesrdquo wiring with just 1 Data output pin Same way Neopixel connectors with on-board leds ca be wired

Option 1 ndash with extra Data pins

Main Blade

some accent leds

D1

D2

crystal leds

330 Ohm

330 Ohm

330 Ohm

main blade style (effects)

main blade 144 leds Data pin 1

accent leds blade style (effects)

accent leds ldquobladerdquo 4 leds Data pin 2

crystal leds blade style (effects)

crystal leds ldquobladerdquo 2 leds Data pin 3

3 ldquobladesrdquo1 main 1 accent leds array and 1 crystal leds array

PROFFIEBOARD INSTRUCTIONS

D3

follow arrows direction

34 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Neopixel Accent LEDs wiring diagram(optional)

PROFFIEBOARD INSTRUCTIONS

Main Blade

some accent leds

1

3

5678

2

4

D1

crystal leds

follow arrows direction

330 Ohm

330 OhmData signal

With this setup a single array of neopixel leds is separated into a couple of sub-blades with their own style configuration and behaviour This

is really usefull when you want to use only one data pin More about ldquoSub-bladesrdquo on ProffieOS wiki page

Option 2 ndash with ldquoSub-bladesrdquo

main blade style (effects)

main blade sub-blade 140 leds (7-146) but from 6 to 145 in the code

accent leds blade style (effects)

accent leds sub-blade 4 leds (1-4) but from 0 to 3 in the code

crystal leds blade style (effects)

146 leds total used

crystal leds sub-blade 2 leds (5-6) but from 4 to 5 in the code

update default 144 to a higher total value if you get all accent leds +Main blade gt 144 Example update to 146 if you have 2 crystal leds +4 accent leds + 140 Main blade leds = 146

3 ldquobladesrdquo 1 main 1 accent leds array and 1 crystal leds array

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 35

3WIRING DIAGRAMS1

OLED display wiring diagram(optional)

SSD1306 128x32 pixels OLED display allows to show battery level current preset name play different animations and even simple games It

can be wired to any blade configuration and requires just one additional line in the code to work You can get monochrome display in white

or blue color

SSD1306128x32OLED

SSD1306 ndash with blue or white display color selectSSD1306 ndash cheaper priceSSD1306 just screen ndash blue or white select

30-32 AWG

30-32 AWG

add this line to enable OLED display

display shows a preset name written in these quotes ldquoldquo

PROFFIEBOARD INSTRUCTIONS

36 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Bluetooth module wiring diagram(optional)

SOON

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 37

3WIRING DIAGRAMS1

Blade ID resistor functions(optional)

SOON

PROFFIEBOARD INSTRUCTIONS

38 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

website ProffieBoard FULL wiring diagrams link

Scroll the page down till you see the interactive diagram Above the diagram there are components selection options Build your saber setup

with it and follow diagram to wire your board Then you need to copy the configuration code below and paste it into your _configh file

Choose components you want

3WIRING DIAGRAMS1

More wiring diagrams

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 39

3WIRING DIAGRAMS1

How to use it

PROFFIEBOARD INSTRUCTIONS

Blade ignitionretraction ndash assuming you have at least one button pressing it briefly should turn the saber on or off If you have an AUX button pressing it briefly should also turn the saber on and off If you have no buttons you can turn the saber on and off by twisting your wrist back and forth Note that the motion has to be done long enough to count so a very quick flick of the wrist will not workTurn On muted ndash double-click power buttonNext preset ndash while saber is off click the AUX buttonPrevious preset ndash hold AUX button and click the Activation buttonTrigger Clash ndash while saber is on hit the bladeTrigger Lockup ndash while saber is on hold Activation button then trigger a clash Lockup releases when you let go of the Acti-vation buttonTrigger Drag ndash like lockup but point saber mostly down before holding Activation buttonTrigger Force ndash long-click AUX buttonStart soundtrack ndash long-click the Activation buttonTrigger Blaster Block ndash while saber is on short-click AUX button

Serial Monitor commands

battery_voltage ndash gets current battery voltage valueget_volume ndash get current volume valuepow ndash power OnOff the saberon ndash power On the saberoff ndash power Off the saberset_volume lt0-3000gt ndash set volume value (example set_volume 500)play ndash play the default preset trackplay trackslttrack namegt ndash play a specific track from tracks folder (example play tracksvenuswav)stop ndash stop the playing trackforce ndash play ldquoforcerdquo sound effectsdrag ndash play ldquodragrdquo sound effectsblast ndash play ldquoblasterrdquo sound effectslock ndash play ldquolockuprdquo sound effectsclash ndash play ldquoclashrdquo sound effectsreset ndash reboot the boardn ndash switch to next presetp ndash switch to previous presetlist_presets ndash show all presetssdtest ndash test SD card speed

40 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3FIRMWARE UPLOAD AND UPDATE2

Software installation and setup

PROFFIEBOARD INSTRUCTIONS

To upload firmware to ProffieBoard Arduino IDE program is required Follow these steps to install it to your PC

1 Install latest Arduino IDE software (donrsquot use BETA)

Installing as Windows app also is not recommended

because it will be installed in a specific protected folder that

wonrsquot allow you to install any additional softwareplugin in it

If ProffieBoard wonrsquot show up in COM port use

Arduino IDE 186 version

2 Install the Proffieboard Arduino Plugin and Zadig software

Follow installation instructions

3 Select Proffieboard-STM32L433 in Tools -gt Board

USB Type ndash Serial CPU Speed ndash 80 MHz Optimize ndash Smallest Code DOSFS ndash SDCARD (SPI) Port ndash COM(the number your PC assigned) (Butterfly-L433CC)

Connect Proffieboard via USB cable to PC to be able to select

the Port

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 41

3FIRMWARE UPLOAD AND UPDATE2

Uploading firmware

PROFFIEBOARD INSTRUCTIONS

1 Download the ProffieBoard firmware and SD card content

Unzip lightsaber-1286zip to your Documents directory or to

Desktop but not to Arduino program folder or anywhere in

Programs directory where all programs are installed You will

see a lightsaber folder and files inside it Donrsquot move any of

these files to any other location outside the lightsaber folder

and donrsquot reorganize them Unzip ProffieOS_SD_Cardzip to the

folder where you keep lightsaber-1286 folder Copy all files

from ProffieOS_SD_Card folder to your SD card

2 Unhide file extensions in File Explorer settings to see h ending

of config files Donrsquot add ldquohrdquo to the config file name Go to config folder and create you own configh file (see page

42 for how-to)

Double-click the lightsaberino file

3 Add the name of your configh file as shown and Save this

lightsaberino file Make sure the other config files are

commented out there should be only one CONFIG_FILE

without You can have multiple config files

in lightsabergtconfig folder and just define the one you need

in lightsaberino file and upload it again to ProffieBoard

4 Connect battery to ProffieBoard and hook up to your PC

with a data transfer micro-USB-to-USB cable

Press arrow button it will compile and upload firmware to the

board Wait for red text progress bars to stop at 100

ProffieBoard will play boot sound if speaker is connected

Now you can unplug the USB cable Done

If it gives an error instead this means your configh file has

issues define CONFIG_FILE name has mistakes configh file

is out of config folder your PC user name is non-latin

42 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

33

configh file structure editing

PROFFIEBOARD INSTRUCTIONS

CHANGING PARAMETERS

All sound files (sound fonts music tracks) are stored on the micro SD card Add required sound fonts folders (Plecter NEC and Smoothswing

fonts are supported no need to change WAV files names just copy and paste) to SD card root directory as itrsquos done in the default

ProffieOS_SD_Card content folder and music tracks to the tracks folder

Make sure to name all music tracks and sound fonts folders with latin characters and only up to 8 characters long without using any special

characters (like |[- etc)

Make sure you have a configini file in each sound font folder if there is none - copy one from some default TeensySaberProffieBoard sound

font and paste into newly added sound font folder It has only one parameter that you can modify - humstart It helps to match hum sound

start with blade ignition 1000 usually works fine

All blade effects LED configuration volume level clash sensitivity etc are changed in the configh file located in lightsabergtconfig folder

To do that open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text Editor (Notepad - to see code correctly in Notepad

Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all text) and Delete it then Copy-and-Paste (Ctrl+C

Ctrl+V) your wiring diagram config code into empty _configh file and Save it under new name Follow the instructions on page 39 to

upload it to the board

Proffieboard config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)

volume level (0-3000)

clash sensitivity (adjust lower or higher with 01 step)

sound font folder nametrack name

Preset name

Blade style

LED configuration (use these XP-E2 LED templatesto define your LED)

for Red use 1 Ohm resistor for Green - no resistor for Blue use 024 Ohm

NoLED ndash no 4th led used

Preset 1

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 43

33

Blade Styles

StylePtrltInOutHelperltSimpleClashltLockupltBlastltOnSparkltAudioFlickerltRgblt02550gtRgblt501000gtgtRgblt2552550gt150gtRgblt255500gtgtAudioFlickerltRgblt1002550gtRgblt2550150gtgtgtRgblt255100150gt40gt200300Blackgtgt

ndash this is how the Blade Style code looks pasted in the configh file Preset (it sits inside a StylePtrltgt container)

ndash this is how the Blade Style code looks when editing it inside a Blade Style Editor

Each Blade Style is made of a variety of Effects each added effect goes instead of a base color in the previous effect

PROFFIEBOARD INSTRUCTIONS

CHANGING PARAMETERS

ProffieBoard and TeensySaber use Blade Styles for the main saber blade and any other accent leds to define all light effects (color changing

flashes flickering delays ignitionretraction timing etc)

Use Blade Style Editor to create and adjust Blade Styles Megtooth Sith Sabers did a great video tutorial where he shows and explains

how to use Blade Style Editor Also you can grab some pre-made Blade Styles or share yours here on TRA forums

A Blade Style example of simple flickering Green blade with Spark on start Clash Blaster Lockup and Drag IgnitionRetraction effects

InOutHelperltSimpleClashltLockupltBlastltOnSparkltAudioFlickerltRgblt02550gtRgblt501000gtgtRgblt2552550gt150gtRgblt255500gtgtAudioFlickerltRgblt1002550gtRgblt2550150gtgtgtRgblt255100150gt40gt200300Blackgt

InOutHelperltbase color200300Blackgt ndash base color can be defined by words (WHITE RED GREEN PURPLE etc) or by Rgblt0-2550-2550-255gt values for more

custom shades 200 is extension length in milliseconds 300 is retraction length in milliseconds Black is color when retracted (also can be any other color)

SimpleClashltbase colorclash color40gt ndash clash effect 40 is clash duration in milliseconds

Lockupltbase colorlockup colorgt ndash lockup effect

Blastltbase colorblast colorgt ndash blaster effect

OnSparkltbase colorspark color150gt ndash spark on ignition effect 150 is spark duration in milliseconds

AudioFlickerltrdquoArdquo colorrdquoBrdquo colorgt ndash flickering effect (blade flickers to the actual saber hum sound) the more difference between ldquoArdquo and ldquoBrdquo colors - the more

abrupt is flickering

Rgblt255500gt ndash actual color in RGB format (0 is no light 255 is the maximum brightness value for Red Green or Blue channel)

44 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

ndash SanDisk 4GB microSDHC Class 4 (Genuine) ndash SanDisk 4GB microSDHC Class 4 (Genuine)

130238 kbs = 1477 simultaneous audio streams 137812 kbs = 1562 simultaneous audio streams

ndash Patriot LX Series 16GB microSDHC UHS-IU1 Class 10 ndash Patriot LX Series 16GB microSDHC UHS-IU1 Class 10

133005 kbs = 1508 simultaneous audio streams

ndash GSkill 16GB microSDHC UHS-IU1 Class 10 ndash GSkill 16GB microSDHC UHS-IU1 Class 10

129534 kbs = 1469 simultaneous audio streams

ndash Kingston 16GB microSDHC UHS-IU1 Class 10 ndash Kingston 16GB microSDHC UHS-IU1 Class 10

128090 kbs = 1452 simultaneous audio streams

ndash SanDisk Ultra 16GB microSDHC UHS-IU1 A1 Class 10 ndash SanDisk Ultra 16GB microSDHC UHS-IU1 A1 Class 10

102663 kbs = 1164 simultaneous audio streams 11124 kbs = 1261 simultaneous audio streams

ndash SanDisk 8GB microSDHC Class 4 ndash SanDisk 8GB microSDHC Class 4

108506 kbs = 1230 simultaneous audio streams

ndash SanDisk 16GB microSDHC Class 4 ndash SanDisk 16GB microSDHC Class 4

102663 kbs = 1164 simultaneous audio streams 106957 kbs = 1213 simultaneous audio streams

ndash SanDisk Ultra 16GB microSDHC UHS-IU1 Class 10 ndash SanDisk Ultra 16GB microSDHC UHS-IU1 Class 10

102663 kbs = 1164 simultaneous audio streams 103909 kbs = 1178 simultaneous audio streams

ndash Smartbuy 4GB microSDHC Class 4 ndash Smartbuy 4GB microSDHC Class 4

75437 kbs = 855 simultaneous audio streams

ndash Kingston 8GB microSDHC Class 4 ndash Kingston 8GB microSDHC Class 4

75209 kbs = 822 simultaneous audio streams

ndash SanDisk 4GB microSDHC Class 4 (Fake) ndash SanDisk 4GB microSDHC Class 4 (Fake)

677 kbs = 769 simultaneous audio streams

Here is a list of tested micro SD cards speed with TeensySaber V3 and ProffieBoard Any card with speed over 900 kbs is recommended the

higher the speed is ndash the better Memory size of 4-16Gb is more than enough Cards were tested with a default firmware (1291) compiled

with ldquoSmallest Coderdquo under Optimize ldquodefault_proffieboard_confighrdquo file and default ProffieOS SD card sound files (7 folders)

To test your SD card speed simply hook up ProffieBoard to PC open Arduino IDE go to Tools and open Serial Monitor make sure you have

New Line and 9600 baud rate selected on the bottom of Serial Monitor window type and send sdtest command wait for the test result

4Recommended micro SD cards

BEST

TEENSYSABER PROFFIEBOARD

GOOD

BAD

PROFFIEBOARD INSTRUCTIONS

SD CARD RECOMMENDATIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 45

There are a lot of fake (chinese copies) microSD cards on the market from aliexpress ebay amazon etc They look very similar to genuine

cards but are a bit different though and have a twice lower writingreading speed Here is an example of a SanDisk 4Gb Class 4 card one is

genuine with 137812 kbs speed and the other one is fake with 677 kbs speed I got from ebay seller

Be carefull and pay attention to how the actual card looks if you are not sure ask seller for the real photo of SD card he sells

4Genuine and Fake SanDisk 4Gb Class 4 microSD

PROFFIEBOARD INSTRUCTIONS

SD CARD RECOMMENDATIONS

46 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

WIRE GAUGE GUIDE

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 47

RECHARGE PORTS AND KILL SWITCHES

48 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

NEOPIXEL STRIPS CURRENT DRAW

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 49

6TROUBLESHOOTING

For more help please check these linksProffieOSProffieBoardTeensySaber wiki on GitHubAsk your question on The Rebel Armory forumsAsk your question on FX-sabers forumsAsk your question in facebook group

How to solve most common issues

Quick troubleshooting tips

TeensySaber board or Proffieboard is not recognized by computer (nothing under Port selection in Arduino)

ndash Make sure a charged 37V battery is connected to the board micro-USB cable is a data transfer cable all plugins and drivers are installed ndash

check again pages 21 for TeensySaber or 40 for Proffieboard Try a different USB port on your computer

Sketch (code) compile error in Arduino IDE

ndash Check your define CONFIG_FILE ldquoconfig_confighrdquo line in opened lightsaberino file if itrsquos written correctly with config in it

Sketch (code) compile error in Arduino IDE

ndash Check if the _configh file you defined in the lightsaberino sketch file is same name as in the lightsaber-rdquofirmware versionrdquolightsaber

config folder and is located in this folder

Sketch (code) compile error in Arduino IDE

ndash Check your settings under Tools tab in Arduino IDE program Check again pages 21 for TeensySaber or 40 for Proffieboard

Sketch (code) compile error in Arduino IDE

ndash Check if your _configh file is correct Blade Styles Presets const unsigned int maxLedsPerStrip = 144 if BladeConfig blades[] = is correct

Sketch (code) compile error in Arduino IDE

ndash If nothing helps install Arduino IDE version 186 and try to compile and upload the firmware again

Sound doesnrsquot play

ndash Remove SD card and insert again check speaker wiring Make sure all sound files on SD card are correctly named (8 characters max long)

Re-format SD card in FAT32 load sound files and try again try another SD card

Board says ldquoLOW POWERrdquo

ndash Charge the battery

Serial Monitor shows info sent by the board but your commands donrsquot work

ndash In the bottom right corner of Serial Monitor window make sure the Line Ending drop down is set to New Line

Sound is weird and distorted

ndash Check your SD card speed (see page 44) Check speaker wiring try another good speaker

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 01

Contents

Introduction (P ndash 2)Features (P ndash 3)1 Helpful instructions and tutorials links ndash Where to buy (P ndash 4) ndash Tutorials and instructions (P ndash 5)

2 TeensySaber V3 instructions 1) Wiring diagrams ndash Board pinout (P ndash 6) ndash Board assembling (P ndash 7) ndash Basic Tri-Cree wiring diagram (P ndash 8-9) ndash Basic Neopixel wiring diagram (P ndash 10-11) ndash Basic Segmented string wiring diagram (P ndash 12-13) ndash Accent LEDs wiring diagram (P ndash 14) ndash OLED display wiring diagram (P ndash 15) ndash Bluetooth module wiring and setup (P ndash 16) ndash Blade ID resistor functions (P ndash 17) ndash More wiring diagrams (P ndash 18) ndash How to use it (P ndash 20) 2) Firmware upload and update ndash Software installation and setup (P ndash 21) ndash Uploading firmware (P ndash 22) 3) Changing sound board parameters (P ndash 23)

3 ProffieBoard instructions 1) Wiring diagrams ndash Whatrsquos needed (P ndash 24) ndash Board pinout (P ndash 25) ndash Basic Tri-Cree wiring diagram (P ndash 26-27) ndash Basic Neopixel wiring diagram (P ndash 28-29) ndash Basic Segmented string wiring diagram (P ndash 30-31) ndash Accent LEDs wiring diagram (P ndash 32) ndash Neopixel Accent LEDs wiring diagram (Sub-blades) (P ndash 33-34) ndash OLED display wiring diagram (P ndash 35) ndash Bluetooth module wiring and setup (P ndash 36) ndash Blade ID resistor functions (P ndash 37) ndash More wiring diagrams (P ndash 38) ndash How to use it (P ndash 39) 2) Firmware upload and update ndash Software installation and setup (P ndash 40) ndash Uploading firmware (P ndash 41) 3) Changing sound board parameters ndash configh file structure editing (P ndash 42) ndash Blade Styles (P ndash 43)

4 SD card recommendations (P ndash 44-45)5 Wire gauge and current rating tests (P ndash 46-48)6 Troubleshooting (P ndash 49)

updated19122018

02 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

It really just started with a trip to Disneyland I was really just disappointed with the cheap plastic lightsabers they had available I had hoped to pick something more display-worthy or at least in the ldquotoys for grownupsrdquo category but did not find anything So when I got home I went and ordered an FX ldquoblack seriesrdquo Luke lightsaber which looks quite nice but the sound light and interactivity was still pretty disappointing At this point I started to think about how I would make a lightsaber I had already done things with neopixels before so that was kind of a no-brainer for making a better blade but I really wanted to do was to make the sound react fluidly to motion At this point I joined a bunch of forums and came across the NEC and Plecter boards but there didnrsquot seem to be a way to alter how they produced sounds so I picked up a teensy and a PJRC prop shield and started building from there The Teensy 32 + PJRC prop + SD card reader + voltage booster + FETs I ended up with was fairly large Luckily the Graflex lightsabers are also fairly large so I purchased a Graflex 21 and barely managed to squeeze everything in there Around this time I got kind of stuck with how to synthesize all the sounds a lightsaber makes so I decided to imple-ment support for Plecter and NEC sound fonts to get the saber I built make some sounds There are some amazing sound fonts out there but even so the interactivity I craved was still missing Since I didnrsquot really have a good idea for how to make that interactivity happen I took on a different challenge instead Make it smaller For the TeensySaber V2 I decided to try to make my own circuit board That meant integrating some components from the prop shield the sd card reader the voltage booster and the FETs into a single board To make things interesting I bought a Korbanth OWK which has an inner diameter of 78 inches and my goal was to fit everything in there It took a while to do but the result was the TeensySaber V2 board The V2 fits really great inside an OWK without cutting into the inner chassis parts and was generally a great success but the sound quality wasnrsquot as good as I wanted it to be so eventually I designed he TeensySaber V3 which is mostly the same as the V2 but uses a digital 3W amplifier As I was working on the TeensySaber V3 this guy Thexter showed up on a couple of forums with some great videos showing off an algorithm for better swing sounds Since this was what I wanted all along I couldnrsquot wait until he provided a description of his algorithm so that I could implement it Lucky for me he didnrsquot mind describing his algorithm so I imple-mented it My implementation never really sounded as good as his videos though but thatrsquos probably because Irsquom not really a font designer Later Thexter came back with an improved version which is what we now call ldquoSmoothSwing V2rdquo With SmoothSwing V3 TeensySaber V3 was getting some attention from people but a lot of people still thought it was too big since itrsquos made out of two boards sandwiched together The sandwiching also creates extra work for installers and extra complications for hobbyists so it was time to try to put everything together into one board At first I was thinking of using the same components that make up a Teensy to make the all-in-one board but it turned out to be complicated and expensive Instead I found another board called a ldquoButterflyrdquo which had nearly identical capabilities and an already functional arduino plugin Even better the Butterfly was 100 open source (the teensy is only mostly open source) I spent most of the Christmas vacation last year designing the Proffieboard and it took another couple of months of

testing to get a working prototype but itrsquos been a lot of fun

- Fredrik Hubinette

Read full interview on SaberSourcingProffieboard lightsaber controller developer Fredrik Hubinette interview

INTRODUCTION

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 03

Specifications and features

ndash ProffieBoard specific ndash Dimensions 179x346x57mm (with micro USB port and micro SD card)

ndash ProffieBoard specific ndash Single pcb board design

ndash TeensySaber V3 specific ndash Dimensions 18x395x9mm (with micro USB port and micro SD card)

ndash TeensySaber V3 specific ndash 2-pcb boards stack design

ndash 100 Open-Source you may add any feature you like (GPLv3)

ndash Power supply 26-45 Volts up to 10A per LED output 1-6 single Li-Ion 36-37V (low 26V full 42V) battery recommended

ndash Speaker 4 ohm or 8 ohm 2W (with lower volume) or 3-5W (recommended)

ndash Unlimited amount of sound banksfonts supports regular (Plecter NEC) and ldquoSmoothswingrdquo sound fonts

ndash Sound FX (WAV sound files) boot blaster blocking lockup hum swing clash drag font force ingnition retraction

ndash Light FX blade flickering pulsing flash on clash drag stab blaster blocking lockup and other

ndash Music tracks (WAV sound files) playback in idle mode and saber sound effects background

ndash Micro SD card 4-16Gb Class 4-10 by SanDisk brand recommended

ndash Support for remote control via bluetooth (with external bluetooth module addon)

ndash Speedy 32-bit processor for advanced features like sound filters synthesizing and mp3 playback

ndash 3 Watts sound amplifier 16-bit digital output (12-bit for TeensySaber V1 and V2)

ndash Sample rate is 44kHz (default) 22kHz and 11kHz are supported and upsampled to 44kHz automatically

ndash Gapless playback with 25ms cross-fade when you interrupt one sample to go to another

ndash Polyphonic playback currently configured for up to 5 simultaneous samples

ndash ldquoSmoothswingrdquo algorithm support (a new more natural swing motion sounds playback)

ndash PL9823 (RGB) WS2812B (GRB) SK6812 (GRB WWA) Neopixel support

ndash 1234-color LED stars (Tri-Cree and Quad (also RGBA) LED modules)

ndash Segmented (6 segments + Flash string) classic string blades support

ndash Multi-blade support for dual and crossguard setups

ndash Blade LED type Presets and Blade Styles selection by different values of a resistor (Blade ID functions)

ndash Crystal chamber support

ndash Power-level indicator with neopixel blade

ndash OLED PLI and FONT animations display

ndash sound files upload to SD card via USB cable directly from PC (only from firmware version 1291 and up)

ndash POV (persistance of vision) mode support

ndash Accent LEDs support (also implemented as additional ldquobladesrdquo)

ndash Spoken error and low battery messages

ndash Easy and free firmware updates by user

Demonstration videos

Link to the demonstration video by K-SithLink to the demonstration video by Megtooth Sith SabersLink to the demonstration video by Zimmer LabsLink to the demonstration video by ShtokCustomWorx

FEATURES

04 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

1HELPFUL LINKS

TeensySaber V3 boards

Send a message to this guy

Other parts links

RGB Neopixel strips (they are SK6812 though sellers list them as WS2812b)WWA (WhiteWhiteAmber) Neopixel strips SK6812 Source 1WWA (WhiteWhiteAmber) Neopixel strips SK6812 Source 2Individual Neopixel LEDsNeopixel stripsconnectorsother supplies (UK) ndash TheSaberArmoryTri-Cree high power LEDs (CanadaUSA) ndash TheCustomSaberShopTri-Cree high power LEDs (UK) ndash TheSaberArmoryVarious Accent LEDs (UK) ndash TheSaberArmoryVarious Batteries (UK) ndash TheSaberArmoryProtected KeepPower 18650 10A 3500mAh batteryProtected KeepPower 18650 15A 3120mAh batteryUnprotected Vapcell 21700 15A 5000mAh battery ndash requires external PCMUnprotected KeepPower 26650 15A 6000mAh battery ndash requires external PCM15A Protection Circuit Module (PCM)18650 Protected Battery holderHigh Power 13mm Recharge PortRecharge Ports (UK) ndash TheSaberArmoryHigh Power Kill SwitchVarious Switches (UK) ndash TheSaberArmorySCW Neopixel blade Pogo connectorTCSS Neopixel blade Pogo connectorGX16 Neopixelstring blade connectorsVarious Speakers (UK) ndash TheSaberArmory Various Speakers (UK) ndash JQ-sabersVarious Speakers (CanadaUSA) ndash TheCustomSaberShop2W and 3W Speakers ndash Saber Essentials4W Speakers ndash ebay

3D-printed chassis links

ShtokCustomWorx on ShapewaysGOTH-3Designs on Shapeways

Where to buy

ProffieBoards

TheSaberArmory (KR-sabers) UK storeJQ-sabers UK storeSaberBay Etsy USA storeShtokCustomWorx Etsy RUS store (not opened yet)

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 05

1HELPFUL LINKS

Video tutorials by Megtooth Sith Sabers

Video tutorials by Megtooth Sith Sabers on youtubeLED Resistor Calculator

For more information please check these links

TeensySaber V3 sound board instructionsProffieBoard sound board instructionsrdquoBlade style sharingrdquo - here you can find and share custom blade stylesWeb Blade Style Editor 1 (default)Web Blade Style Editor 2 (restyle)Here you can get regular (Plecter NEC) or ldquoSmoothswingrdquo sound fontsProffieOSProffieBoardTeensySaber wiki on GitHubProfezzornrsquos Lab on The Rebel Armory forumsProfezzornrsquos Lab on FX-sabers forumsAsk your question in facebook group

Get latest ProffieOS firmware

Tutorials and instructions

06 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

Board pinout

used pads

Battery + ndash 26 to 45 volt input drives everything except the LEDs

Battery - ndash negative pad for LEDs needs to be at same level as GND when both are connected

GND ndash ground for electronics except LEDs Note that GND is also available on short edge of the teensy (See the teensy pinout for details)

Speaker +- ndash hooks up to speaker

Activation Aux Aux2 button ndash hook up to closing buttons or potentially touch buttons

Blade ID Neopixel Data 1 ndash normally used to measure the blade ID restor and if itrsquos a neopixel blade feed out neopixel data

LED 1 2 3 ndash hooks up to negative side of LED (positive side of LED hooks up directly to battery) These pads can handle

up to 30 volts

LED 4 5 6 ndash like LED123 but requires FETs to be placed on the bottom of the board to function Voltage is limited by

selection of FETs

Power 1 Power 2 Power 3 ndash these control the FETs which drive LED 1 2 3

AUX LED 1 2 3 ndash these are hooked up to pads on the bottom which can be populated with FETs and used to drive additional LEDs If the

bottom FETs are not populated these pins are free and can be used for any purpose

RX3 TX3 ndash these pins are used for wiring a bluetooth module for wireless control or additional Neopixel Data out

SDA SCL ndash these pins are used to wire OLED display

+33V 250mA max ndash generated by the Teensy for powering OLED display or Bluetooth module

micro USB port ndash micro USB port used only for firmware upload and can be used for sound files upload to SD card

THIS PORT ISNrsquoT USED FOR CHARGING THE BATTERY

LED output 1 2 3

Battery - Speaker + (red dot or ldquo+rdquo mark on speaker)Battery +

Data in (SD) SCK (SD)

Battery Volt SenseAux button

Activation buttonAux2 button

SDA

SCL

Blade ID Neopixel Data 1Audio data

Audio LRClock

Power 3+33VAudio GND (not used)+5V

Data out (SD)

Power 2

Audio clock

TX3Neopixel Data 2

RX3Neopixel Data 3

Power 1AUX3 LEDAUX2 LEDAUX1 LED

Motion InterruptAmplifier enable

SD card selectGND

Speaker -

LED output 4 5 6

micro USB port on Teensy 32

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 07

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

Board assembling

1 IMPORTANT

Cut the tiny trace with a knife between VIN and VUSB as shown

Teensy 32 bottom view

2 Solder 254mm header pins (gold plated recommended) to

TeensySaber V3 board on the top or on the bottom depending

on where you want to put Teensy 32 board

(please see next step)

3 Solder Teensy 32 board on top

(A ndash micro USB port on top SD card between boards) or on the bottom (B ndash SD card on top micro USB port between boards)

A B

+

08 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

Basic Tri-Cree wiring diagram(In-hilt LED)

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

+

+

+

-

-

-

26 A

WG

26 AWG

30-32 AWG

28-30 AWG

28-30 AWG

30-32 AWG

Protected 36-37V (42V max at full charge) 10A 3500mAh battery recommended+18650 battery holder (optional)Keystone 1042P

AV switch with accent led(constantly ON no effects)

accent leds run mostly at10-15mA so resistors for them must be calculated accordingly

Main RGB led

additional RGB leds(optional)

In case no additional high power leds are needed LED channels 4 5 6can be used for 3 controllable (programmable for different effects) accent leds So AV switch led can be wired to one of these channelsby adding 1 MOSFET

LED Resistor Calculator

solder 3x FETs

solder 1 FET

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 09

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

Basic Tri-Cree wiring (In-hilt LED)ldquoconfighrdquo file setup

Use a given or build your wiring diagram on THIS PAGE then open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text

Editor (Notepad - to see code correctly in Notepad Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all

text) and Delete it then Copy-and-Paste (Ctrl+C Ctrl+V) your wiring diagram config code (example below) into empty _configh file and

Save it under new name Follow the instructions on page 22 to upload it to the board

ldquov3_confighrdquoNUM_BLADES 2NUM_BUTTONS 2VOLUME 1000CLASH_THRESHOLD_G 10StyleNormalPtrltCYAN WHITE 300 800gt()StyleNormalPtrltCYAN WHITE 300 800gt()

CreeXPE2RedTemplatelt1000gtCreeXPE2GreenTemplatelt0gtCreeXPE2BlueTemplatelt240gtNoLED

TeensySaber V3 config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)Volume level (0-3000)Clash sensitivity (adjust lower or higher with 01 step)ldquoBlade 1rdquo styleldquoBlade 2rdquo style (in case only 1 blade is used you donrsquot need this line)LED configuration (use these XP-E2 LED templatesto define your LED If other LED resistors are used change these values to match Ohm1000=ltvaluegt)

where 1000 is 1 Ohm resistor 0 is no resistor240 is 024 Ohm resistorNoLED ndash no 4th led used

Preset 1

LED 1 configuration

LED 2 configuration

Preset 2 etc

10 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

Basic Neopixel wiring diagram

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

+

+

+

-

-

-

22 A

WG

22 AWG

26 AWG

30 AWG

x2 28 AWG

x2 26 AWG

22 A

WG

30-32 AWG

30-32 AWG

Protected 36-37V (42V max at full charge) 10A 3500mAh or 15A 3120mAhbattery recommended+18650 battery holder (optional)Keystone 1042P

AV switch with accent led(constantly ON no effects)

accent leds run mostly at10-15mA so resistors for them must be calculated accordingly

Main Neopixel strip

additional Neopixelstrips(optional)

Neopixel bladeconnector

330 Ohm on the Blade pcb side

x3 28 AWGor x1 22 AWGfor Negative

330 Ohm on the Blade pcb side

arrows up

330 Ohm on the Blade pcb side

In case no additional Neopixel strips are needed LED channels 4 5 6can be used for 3 controllable (programmable for different effects) accent leds So AV switch led can be wired to one of these channelsby adding 1 MOSFETRecommended power wire gauges (22 AWG) are given for 2-strip blade For 3-strip blade you gonna need at least 20 AWG wires

solder 2x FETs

solder 1 FET

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 11

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

Basic Neopixel wiringldquoconfighrdquo file setup

ldquov3_confighrdquoNUM_BLADES 3NUM_BUTTONS 2VOLUME 1000CLASH_THRESHOLD_G 10IgnitionDelaylt0 any blade stylegtIgnitionDelaylt800 any blade stylegtIgnitionDelaylt800 any blade stylegtWS2811BladePtrlt118 WS2811 800kHz | WS2811 GRBgt()WS2811BladePtrlt26 7 ltbladePowerPin4gtgt()WS2811BladePtrlt26 8 ltbladePowerPin5gtgt()

TeensySaber V3 config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)Volume level (0-3000)Clash sensitivity (adjust lower or higher with 01 step)ldquoBlade 1rdquo style (main blade with IgnitionDelay 0)ldquoBlade 2rdquo style (CG blade 1 with IgnitionDelay 800)ldquoBlade 3rdquo style (CG blade 2 with IgnitionDelay 800)

strip configuration (defines how many pixels it has and to which LED output and pin is wired)

Preset 1

any blade style

strip (blade) 1 configuration

strip (blade) 2 configuration

strip (blade) 3 configuration

Preset 2 etc

Use a given or build your wiring diagram on THIS PAGE then open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text

Editor (Notepad - to see code correctly in Notepad Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all

text) and Delete it then Copy-and-Paste (Ctrl+C Ctrl+V) your wiring diagram config code (example below) into empty _configh file and

Save it under new name Follow the instructions on page 22 to upload it to the board

12 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

Basic Segmented string wiring diagram

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

+

+

-

-

24 A

WG

28 AWG

30-32 AWG

30-32 AWG

Protected 36-37V (42V max at full charge) 10A 3500mAh battery recommended+18650 battery holder (optional)Keystone 1042P

AV switch with accent led(constantly ON no effects)

accent leds run mostly at10-15mA so resistors for them must be calculated accordingly

6-segments string blade

FoC string

N-channel FET3A minimum

1

1 46 523

23456

Calculate resistors for each led segment of the blade string depending on which leds are used 5mm leds have max drive current around 25mA per led when 10mm leds can be 100mA and 200mA per ledSo pay attention to your led max current and Forward Voltage (Vf) when calculating a segment resistor resistence as well as its wattage Also choose wire gauges accordingly to meet segments and total blade max current draw level

LED Resistor Calculator

solder 3x FETs

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 13

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

Basic Segmented string wiringldquoconfighrdquo file setup

ldquov3_confighrdquoNUM_BLADES 1NUM_BUTTONS 2VOLUME 1000CLASH_THRESHOLD_G 10StyleNormalPtrltCYAN WHITE 300 800gt()ltBlue3mmLED 20 White3mmLEDgt

TeensySaber V3 config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)Volume level (0-3000)Clash sensitivity (adjust lower or higher with 01 step)Blade styleLED string configuration(here you mention the color and type of leds usedin the main blade string segments and FoC string20 is the FoC signal pin (Blade ID pin))

Preset

LED string configuration

Use a given or build your wiring diagram on THIS PAGE then open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text

Editor (Notepad - to see code correctly in Notepad Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all

text) and Delete it then Copy-and-Paste (Ctrl+C Ctrl+V) your wiring diagram config code (example below) into empty _configh file and

Save it under new name Follow the instructions on page 22 to upload it to the board

14 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

Accent LEDs wiring diagram(optional)

Accent LEDs work with TeensySaber board as additional ldquobladesrdquo when powered by LED outputs 4 5 6 with FETs So they can have any effect

that blade can have If no effects needed accent led can be powered just by a 33V output pad (power-on led indication)

30-32 AWGRGB ledcommon-anode

4 ldquobladesrdquo1 main and 3 accent leds

main blade style (effects) main blade style (effects)

3 accent leds style (effects)accent led style (effects)

3 accent leds configurations

RGB accent led configuration

2 ldquobladesrdquo1 main and 1 RGB accent led

ldquoPower-onrdquo indicationaccent leds (no effects)

3 accent leds withindependent effects

+ 1 or more simple accent leds without effects

1 RGB accent led+ 1 or more simple accent leds

without effects

a) b)

b)

c)

c)

solder 3x FETs solder 3x FETs

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 15

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

OLED display wiring diagram(optional)

SSD1306 128x32 pixels OLED display allows to show battery level current preset name play different animations and even simple games It

can be wired to any blade configuration and requires just one additional line in the code to work You can get monochrome display in white

or blue color

SSD1306128x32OLED

SSD1306 ndash with blue or white display color selectSSD1306 ndash cheaper priceSSD1306 just screen ndash blue or white select

30-32 AWG

30-32 AWG

add this line to enable OLED display

display shows a preset name written in these quotes ldquoldquo

16 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

Bluetooth module wiring diagram(optional)

SOON

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 17

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

Blade ID resistor functions(optional)

SOON

18 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

website TeensySaber V3 FULL wiring diagrams link

Scroll the page down till you see the interactive diagram Above the diagram there are components selection options Build your saber setup

with it and follow diagram to wire your board Then you need to copy the configuration code below and paste it into your _configh file

Choose components you want

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

More wiring diagrams

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 19

20 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

How to use it

Blade ignitionretraction ndash assuming you have at least one button pressing it briefly should turn the saber on or off If you have an AUX button pressing it briefly should also turn the saber on and off If you have no buttons you can turn the saber on and off by twisting your wrist back and forth Note that the motion has to be done long enough to count so a very quick flick of the wrist will not workTurn On muted ndash double-click power buttonNext preset ndash while saber is off click the AUX buttonPrevious preset ndash hold AUX button and click the Activation buttonTrigger Clash ndash while saber is on hit the bladeTrigger Lockup ndash while saber is on hold Activation button then trigger a clash Lockup releases when you let go of the Acti-vation buttonTrigger Drag ndash like lockup but point saber mostly down before holding Activation buttonTrigger Force ndash long-click AUX buttonStart soundtrack ndash long-click the Activation buttonTrigger Blaster Block ndash while saber is on short-click AUX button

Serial Monitor commands

battery_voltage ndash gets current battery voltage valueget_volume ndash get current volume valuepow ndash power OnOff the saberon ndash power On the saberoff ndash power Off the saberset_volume lt0-3000gt ndash set volume value (example set_volume 500)play ndash play the default preset trackplay trackslttrack namegt ndash play a specific track from tracks folder (example play tracksvenuswav)stop ndash stop the playing trackforce ndash play ldquoforcerdquo sound effectsdrag ndash play ldquodragrdquo sound effectsblast ndash play ldquoblasterrdquo sound effectslock ndash play ldquolockuprdquo sound effectsclash ndash play ldquoclashrdquo sound effectsreset ndash reboot the boardn ndash switch to next presetp ndash switch to previous presetlist_presets ndash show all presetssdtest ndash test SD card speed

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 21

2TEENSYSABER V3 INSTRUCTIONS

FIRMWARE UPLOAD AND UPDATE2

Software installation and setup

To upload firmware to TeensySaber board Arduino IDE program is required Follow these steps to install it to your PC

1 Install latest Arduino IDE software (donrsquot use BETA)

Installing as Windows app also is not recommended

because it will be installed in a specific protected folder that

wonrsquot allow you to install Teensyduino software in it

If TeensySaber wonrsquot show up in COM port use

Arduino IDE 186 version

2 Install latest Teensyduino software in same directory

usually itrsquos CProgram Files (x86)Arduino on Windows

Follow installation instructions for your system

3 Select Teensy 32 31 in Tools -gt Board

USB Type ndash Serial CPU Speed ndash 96 MHz (overclock) Optimize ndash Smallest Code Port ndash COM(the number your PC assigned) (Teensy 32) Serial

Connect TeensySaber via USB cable to PC to be able to select

the Port donrsquot forget to connect battery first

22 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

1 Download the TeensySaber firmware and SD card content

Unzip lightsaber-1286zip to your Documents directory or to

Desktop but not to Arduino program folder or anywhere in

Programs directory where all programs are installed You will

see a lightsaber folder and files inside it Donrsquot move any of

these files to any other location outside the lightsaber folder

and donrsquot reorganize them Unzip ProffieOS_SD_Cardzip to the

folder where you keep lightsaber-1286 folder Copy all files

from ProffieOS_SD_Card folder to your SD card

2 Unhide file extensions in File Explorer settings to see h ending

of config files Donrsquot add ldquohrdquo to the config file name

Go to config folder and create you own configh file (see page

23 for how-to)

Double-click the lightsaberino file

3 Add the name of your configh file as shown and Save this

lightsaberino file Make sure the other config files are

commented out there should be only one CONFIG_FILE

without You can have multiple config files

in lightsabergtconfig folder and just define the one you need

in lightsaberino file and upload it again to TeensySaber board

4 Connect battery to TeensySaber board and hook up to your PC

with a data transfer micro-USB-to-USB cable

Press arrow button it will compile and upload firmware to the

board Wait for your PC to make a sound or TeensySaber will

play boot sound if speaker is connected Now you can unplug

the USB cable Done

If it gives an error instead this means your configh file has

issues define CONFIG_FILE name has mistakes configh file

is out of config folder your PC user name is non-latin

2TEENSYSABER V3 INSTRUCTIONS

FIRMWARE UPLOAD AND UPDATE2

Uploading firmware

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 23

2TEENSYSABER V3 INSTRUCTIONS

CHANGING PARAMETERS3

Changing sound board parameters

All sound files (sound fonts music tracks) are stored on the micro SD card Add required sound fonts folders (Plecter NEC and Smoothswing

fonts are supported no need to change WAV files names just copy and paste) to SD card root directory as itrsquos done in the default

ProffieOS_SD_Card content folder and music tracks to the tracks folder

Make sure to name all music tracks and sound fonts folders with latin characters and only up to 8 characters long without using any special

characters (like |[- etc)

Make sure you have a configini file in each sound font folder if there is none - copy one from some default TeensySaberProffieBoard sound

font and paste into newly added sound font folder It has only one parameter that you can modify - humstart It helps to match hum sound

start with blade ignition 1000 usually works fine

All blade effects LED configuration volume level clash sensitivity etc are changed in the configh file located in lightsabergtconfig folder

To do that open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text Editor (Notepad - to see code correctly in Notepad

Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all text) and Delete it then Copy-and-Paste (Ctrl+C

Ctrl+V) your wiring diagram config code into empty _configh file and Save it under new name Follow the instructions on page 22 to

upload it to the board

TeensySaber V3 config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)

volume level (0-3000)

clash sensitivity (adjust lower or higher with 01 step)

sound font folder nametrack name

Preset name

Blade style

LED configuration (use these XP-E2 LED templatesto define your LED)

for Red use 1 Ohm resistor for Green - no resistor for Blue use 024 Ohm

NoLED ndash no 4th led used

Preset 1

24 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

31

PROFFIEBOARD INSTRUCTIONS

Whatrsquos needed

ndash ProffieBoard

ndash micro SD-card (see page 44 for recommendations)

ndash a USB micro SD-card reader (to load sound files from PC to micro SD card)

ndash micro USB data transfer cable (CABLES THAT SUPPORT ONLY CHARGING WONrsquoT WORK)

ndash wires of different gauges (32-20 AWG) (PTFE coated copper stranded wires recommended) heat shrink

ndash ESD safe soldering station solder wire flux etc

ndash pliers helping hands etc

ndash isopropyl alcohol to clean pads before soldering (helps solder to stick better)

ndash Digital Multimeter (VERY USEFUL)

ndash computer running Windows Linux or Mac OS with internet access

ndash 37V Li-Ion Protected rechargeable battery switches recharge port speaker LEDs resistors chassis etc

ndash Smart Li-Ion CC-CV (Constant Current - Constant Voltage mode) battery charger for 37V (42V) cells

ndash patience

WIRING DIAGRAMS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 25

31

PROFFIEBOARD INSTRUCTIONS

Board pinout

Battery + ndash 26 to 45 volt input drives everything except the LEDs

Battery - ndash negative pad for LEDs needs to be at same level as GND when both are connected Both pads are internally connected

GND ndash ground for electronics except LEDs Note that there are two GND pads on the board that are internally connected

Speaker +- ndash hooks up to speaker

Activation (1) Aux (2) Aux2 button (3) ndash hook up to closing buttons or potentially touch buttons

Blade ID Neopixel Data 1 ndash normally used to measure the blade ID restor and if itrsquos a neopixel blade feed out neopixel data

Data 2 3 4 5 ndash additional neopixel data outputs or free for other purposes

LED 1 2 3 4 5 6 ndash hooks up to negative side of LED (positive side of LED hooks up directly to battery) These pads can handle

up to 30 volts

SDA SCL ndash these pins are used to wire OLED display or to communicate with the gyro and accelerometer chip

RX TX ndash these pins are used for wiring a bluetooth module for wireless control

SWDCLK SWDIO ndash can be hooked up to a ST-LINK device and lets you debug programs running on the ProffieBoard

+5V ndash generated by the ProffieBoard normally itrsquos only ON when sound is playing

+33V ndash generated by the ProffieBoard for powering OLED display Bluetooth module or some accent leds

BOOT RESET ndash buttons to put the ProffieBoard in bootloader mode if uploading doesnrsquot work

micro USB port ndash micro USB port used only for firmware upload and can be used for sound files upload to SD card (from firmware version

1291 and up) THIS PORT ISNrsquoT USED FOR CHARGING THE BATTERY

LED 4LED 3

LED 2

LED 1

LED 5

LED 6

RESETBOOT

Battery - Battery -

Speaker + (red dot or ldquo+rdquo mark on speaker)

Battery +

Aux button (2)Activation button (1)

Aux2 button (3)

Blade ID Neopixel Data 1

Data 5

Data 4Data 3Data 2

+33V

SWDIO

SWDCLK

+5V

TXRX

GND

GND

Reset

Speaker -

SCLSDA

micro USB port

WIRING DIAGRAMS

26 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Basic Tri-Cree wiring diagram(In-hilt LED)

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

+

+

-

-

26 AWG

26 A

WG

30-32 AWG

28-30 AWG

28-3

0 A

WG

30-32 AWG

Protected 36-37V (42V max at full charge) 10A 3500mAh battery recommended+18650 battery holder (optional)Keystone 1042P

AV switch with accent led(constantly ON no effects)

accent leds run mostly at10-15mA so resistors for them must be calculated accordingly

Main RGB led

additional RGB leds(optional)

In case no additional high power leds are needed LED channels 4 5 6 can be used for 3 controllable(programmable for different effects) accent leds So AV switch led can be wired to one of these channelsAccent leds also can be wired to Data pads 1-5 please see ldquoAccent LEDs wiring and setuprdquo page

LED Resistor Calculator

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 27

3WIRING DIAGRAMS1

Basic Tri-Cree wiring (In-hilt LED)ldquoconfighrdquo file setup

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

Use a given or build your wiring diagram on THIS PAGE then open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text

Editor (Notepad - to see code correctly in Notepad Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all

text) and Delete it then Copy-and-Paste (Ctrl+C Ctrl+V) your wiring diagram config code (example below) into empty _configh file and

Save it under new name Follow the instructions on page 22 to upload it to the board

ldquoproffieboard_v1_confighrdquoNUM_BLADES 2NUM_BUTTONS 2VOLUME 1000CLASH_THRESHOLD_G 10StyleNormalPtrltCYAN WHITE 300 800gt()StyleNormalPtrltCYAN WHITE 300 800gt()

CreeXPE2RedTemplatelt1000gtCreeXPE2GreenTemplatelt0gtCreeXPE2BlueTemplatelt240gtNoLED

ProffieBoard config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)Volume level (0-3000)Clash sensitivity (adjust lower or higher with 01 step)ldquoBlade 1rdquo styleldquoBlade 2rdquo style (in case only 1 blade is used you donrsquot need this line)LED configuration (use these XP-E2 LED templatesto define your LED If other LED resistors are used change these values to match Ohm1000=ltvaluegt)

where 1000 is 1 Ohm resistor 0 is no resistor240 is 024 Ohm resistorNoLED ndash no 4th led used

Preset 1

LED 1 configuration

LED 2 configuration

Preset 2 etc

PROFFIEBOARD INSTRUCTIONS

28 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Basic Neopixel wiring diagram

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

+

+

-

-

22 A

WG

22 AWG

x2 28 AWG

x2 26 AWG

22 A

WG

30-32 AWG30-32 AWG

Protected 36-37V (42V max at full charge) 10A 3500mAh or 15A 3120mAhbattery recommended+18650 battery holder (optional)Keystone 1042P

AV switch with accent led(constantly ON no effects)

accent leds run mostly at10-15mA so resistors for them must be calculated accordingly

Main Neopixel strip

additional Neopixelstrips(optional)

Neopixel bladeconnector

330 Ohm on the Blade pcb side

x3 28 AWGor x1 22 AWGfor Negative

330 Ohm on the Blade pcb side

arrows up

330 Ohm on the Blade pcb side

In case no additional Neopixel strips are needed LED channels 4 5 6 can be used for 3 controllable(programmable for different effects) accent leds So AV switch led can be wired to one of these channelsAccent leds also can be wired to Data pads 2-5 please see ldquoAccent LEDs wiring and setuprdquo page

Recommended power wire gauges (22 AWG) are given for 2-strip blade For 3-strip blade you gonna need at least 20 AWG wires

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 29

ldquoproffieboard_v1_confighrdquo

3WIRING DIAGRAMS1

Basic Neopixel wiringldquoconfighrdquo file setup

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

NUM_BLADES 3NUM_BUTTONS 2VOLUME 1000CLASH_THRESHOLD_G 10IgnitionDelaylt0 any blade stylegtIgnitionDelaylt800 any blade stylegtIgnitionDelaylt800 any blade stylegtWS2811BladePtrlt118 WS2811 800kHz | WS2811 GRBgt()WS2811BladePtrlt26 blade2Pin ltbladePowerPin4gtgt()WS2811BladePtrlt26 blade3Pin ltbladePowerPin5gtgt()

ProffieBoard config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)Volume level (0-3000)Clash sensitivity (adjust lower or higher with 01 step)ldquoBlade 1rdquo style (main blade with IgnitionDelay 0)ldquoBlade 2rdquo style (CG blade 1 with IgnitionDelay 800)ldquoBlade 3rdquo style (CG blade 2 with IgnitionDelay 800)

strip configuration (defines how many pixels it has and to which LED output and pin is wired)

Preset 1

any blade style

strip (blade) 1 configuration

adjust this number to match your strips leds count

strip (blade) 2 configuration

strip (blade) 3 configuration

Preset 2 etc

Use a given or build your wiring diagram on THIS PAGE then open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text

Editor (Notepad - to see code correctly in Notepad Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all

text) and Delete it then Copy-and-Paste (Ctrl+C Ctrl+V) your wiring diagram config code (example below) into empty _configh file and

Save it under new name Follow the instructions on page 22 to upload it to the board

PROFFIEBOARD INSTRUCTIONS

30 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Basic Segmented string wiring diagram

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

+

+

-

-

24 A

WG

28 AWG

30-32 AWG30-32 AWG

Protected 36-37V (42V max at full charge) 10A 3500mAh battery recommended+18650 battery holder (optional)Keystone 1042P

AV switch with accent led(constantly ON no effects)

accent leds run mostly at10-15mA so resistors for them must be calculated accordingly

6-segments string blade

FoC string

N-channel FET3A minimum

123456

Calculate resistors for each led segment of the blade string depending on which leds are used 5mm leds have max drive current around 25mA per led when 10mm leds can be 100mA and 200mA per ledSo pay attention to your led max current and Forward Voltage (Vf) when calculating a segment resistor resistence as well as its wattage Also choose wire gauges accordingly to meet segments and total blade max current draw level

LED Resistor Calculator

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 31

ldquoproffieboard_v1_confighrdquo

3WIRING DIAGRAMS1

Basic Segmented string wiringldquoconfighrdquo file setup

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

NUM_BLADES 1NUM_BUTTONS 2VOLUME 1000CLASH_THRESHOLD_G 10StyleNormalPtrltCYAN WHITE 300 800gt()ltBlue3mmLED BladePin White3mmLEDgt

ProffieBoard config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)Volume level (0-3000)Clash sensitivity (adjust lower or higher with 01 step)Blade styleLED string configuration(here you mention the color and type of leds usedin the main blade string segments and FoC stringBladePin is the FoC signal pin (Blade ID pin))

Preset

LED string configuration

Use a given or build your wiring diagram on THIS PAGE then open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text

Editor (Notepad - to see code correctly in Notepad Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all

text) and Delete it then Copy-and-Paste (Ctrl+C Ctrl+V) your wiring diagram config code (example below) into empty _configh file and

Save it under new name Follow the instructions on page 22 to upload it to the board

PROFFIEBOARD INSTRUCTIONS

32 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Accent LEDs wiring diagram(optional)

Accent LEDs work with ProffieBoard as additional ldquobladesrdquo when powered by LED outputs 4 5 6 or Data pads 1 2 3 5 as PWM So they can

have any effect that blade can have If no effects needed accent led can be powered just by a 33V output pad (power-on led indication)

30-32 AWG

with Neopixel blade setup these 4 outputsdonrsquot work for regular accent leds

Recommended resistors to use for accent leds at 33V power source and 15mA drive

ndash 100 Ohm for Red (lt100000gt value in the code)ndash 13 Ohm for Green (lt13000gt value in the code)ndash 13 Ohm for Blue (lt13000gt value in the code)ndash 100 Ohm for Yellow (lt100000gt value in the code)ndash 20 Ohm for White (lt20000gt value in the code)

RGB ledcommon-anode

8 ldquobladesrdquo1 main and 7 accent leds

main blade style (effects) main blade style (effects)

7 accent leds style (effects)accent led style (effects)

7 accent leds configurations

RGB accent led configuration

2 ldquobladesrdquo1 main and 1 RGB accent led

ldquoPower-onrdquo indicationaccent leds (no effects)

7 accent leds withindependent effects

RGB accent led

a) b)

b)

c)

c)

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 33

3WIRING DIAGRAMS1

Neopixel Accent LEDs wiring diagram(optional)

With Neopixel setup additional neopixel leds or arrays can be used as accent leds There are 2 ways to wire them using additional Data

pins 2 3 4 5 or ldquoSub-bladesrdquo wiring with just 1 Data output pin Same way Neopixel connectors with on-board leds ca be wired

Option 1 ndash with extra Data pins

Main Blade

some accent leds

D1

D2

crystal leds

330 Ohm

330 Ohm

330 Ohm

main blade style (effects)

main blade 144 leds Data pin 1

accent leds blade style (effects)

accent leds ldquobladerdquo 4 leds Data pin 2

crystal leds blade style (effects)

crystal leds ldquobladerdquo 2 leds Data pin 3

3 ldquobladesrdquo1 main 1 accent leds array and 1 crystal leds array

PROFFIEBOARD INSTRUCTIONS

D3

follow arrows direction

34 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Neopixel Accent LEDs wiring diagram(optional)

PROFFIEBOARD INSTRUCTIONS

Main Blade

some accent leds

1

3

5678

2

4

D1

crystal leds

follow arrows direction

330 Ohm

330 OhmData signal

With this setup a single array of neopixel leds is separated into a couple of sub-blades with their own style configuration and behaviour This

is really usefull when you want to use only one data pin More about ldquoSub-bladesrdquo on ProffieOS wiki page

Option 2 ndash with ldquoSub-bladesrdquo

main blade style (effects)

main blade sub-blade 140 leds (7-146) but from 6 to 145 in the code

accent leds blade style (effects)

accent leds sub-blade 4 leds (1-4) but from 0 to 3 in the code

crystal leds blade style (effects)

146 leds total used

crystal leds sub-blade 2 leds (5-6) but from 4 to 5 in the code

update default 144 to a higher total value if you get all accent leds +Main blade gt 144 Example update to 146 if you have 2 crystal leds +4 accent leds + 140 Main blade leds = 146

3 ldquobladesrdquo 1 main 1 accent leds array and 1 crystal leds array

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 35

3WIRING DIAGRAMS1

OLED display wiring diagram(optional)

SSD1306 128x32 pixels OLED display allows to show battery level current preset name play different animations and even simple games It

can be wired to any blade configuration and requires just one additional line in the code to work You can get monochrome display in white

or blue color

SSD1306128x32OLED

SSD1306 ndash with blue or white display color selectSSD1306 ndash cheaper priceSSD1306 just screen ndash blue or white select

30-32 AWG

30-32 AWG

add this line to enable OLED display

display shows a preset name written in these quotes ldquoldquo

PROFFIEBOARD INSTRUCTIONS

36 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Bluetooth module wiring diagram(optional)

SOON

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 37

3WIRING DIAGRAMS1

Blade ID resistor functions(optional)

SOON

PROFFIEBOARD INSTRUCTIONS

38 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

website ProffieBoard FULL wiring diagrams link

Scroll the page down till you see the interactive diagram Above the diagram there are components selection options Build your saber setup

with it and follow diagram to wire your board Then you need to copy the configuration code below and paste it into your _configh file

Choose components you want

3WIRING DIAGRAMS1

More wiring diagrams

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 39

3WIRING DIAGRAMS1

How to use it

PROFFIEBOARD INSTRUCTIONS

Blade ignitionretraction ndash assuming you have at least one button pressing it briefly should turn the saber on or off If you have an AUX button pressing it briefly should also turn the saber on and off If you have no buttons you can turn the saber on and off by twisting your wrist back and forth Note that the motion has to be done long enough to count so a very quick flick of the wrist will not workTurn On muted ndash double-click power buttonNext preset ndash while saber is off click the AUX buttonPrevious preset ndash hold AUX button and click the Activation buttonTrigger Clash ndash while saber is on hit the bladeTrigger Lockup ndash while saber is on hold Activation button then trigger a clash Lockup releases when you let go of the Acti-vation buttonTrigger Drag ndash like lockup but point saber mostly down before holding Activation buttonTrigger Force ndash long-click AUX buttonStart soundtrack ndash long-click the Activation buttonTrigger Blaster Block ndash while saber is on short-click AUX button

Serial Monitor commands

battery_voltage ndash gets current battery voltage valueget_volume ndash get current volume valuepow ndash power OnOff the saberon ndash power On the saberoff ndash power Off the saberset_volume lt0-3000gt ndash set volume value (example set_volume 500)play ndash play the default preset trackplay trackslttrack namegt ndash play a specific track from tracks folder (example play tracksvenuswav)stop ndash stop the playing trackforce ndash play ldquoforcerdquo sound effectsdrag ndash play ldquodragrdquo sound effectsblast ndash play ldquoblasterrdquo sound effectslock ndash play ldquolockuprdquo sound effectsclash ndash play ldquoclashrdquo sound effectsreset ndash reboot the boardn ndash switch to next presetp ndash switch to previous presetlist_presets ndash show all presetssdtest ndash test SD card speed

40 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3FIRMWARE UPLOAD AND UPDATE2

Software installation and setup

PROFFIEBOARD INSTRUCTIONS

To upload firmware to ProffieBoard Arduino IDE program is required Follow these steps to install it to your PC

1 Install latest Arduino IDE software (donrsquot use BETA)

Installing as Windows app also is not recommended

because it will be installed in a specific protected folder that

wonrsquot allow you to install any additional softwareplugin in it

If ProffieBoard wonrsquot show up in COM port use

Arduino IDE 186 version

2 Install the Proffieboard Arduino Plugin and Zadig software

Follow installation instructions

3 Select Proffieboard-STM32L433 in Tools -gt Board

USB Type ndash Serial CPU Speed ndash 80 MHz Optimize ndash Smallest Code DOSFS ndash SDCARD (SPI) Port ndash COM(the number your PC assigned) (Butterfly-L433CC)

Connect Proffieboard via USB cable to PC to be able to select

the Port

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 41

3FIRMWARE UPLOAD AND UPDATE2

Uploading firmware

PROFFIEBOARD INSTRUCTIONS

1 Download the ProffieBoard firmware and SD card content

Unzip lightsaber-1286zip to your Documents directory or to

Desktop but not to Arduino program folder or anywhere in

Programs directory where all programs are installed You will

see a lightsaber folder and files inside it Donrsquot move any of

these files to any other location outside the lightsaber folder

and donrsquot reorganize them Unzip ProffieOS_SD_Cardzip to the

folder where you keep lightsaber-1286 folder Copy all files

from ProffieOS_SD_Card folder to your SD card

2 Unhide file extensions in File Explorer settings to see h ending

of config files Donrsquot add ldquohrdquo to the config file name Go to config folder and create you own configh file (see page

42 for how-to)

Double-click the lightsaberino file

3 Add the name of your configh file as shown and Save this

lightsaberino file Make sure the other config files are

commented out there should be only one CONFIG_FILE

without You can have multiple config files

in lightsabergtconfig folder and just define the one you need

in lightsaberino file and upload it again to ProffieBoard

4 Connect battery to ProffieBoard and hook up to your PC

with a data transfer micro-USB-to-USB cable

Press arrow button it will compile and upload firmware to the

board Wait for red text progress bars to stop at 100

ProffieBoard will play boot sound if speaker is connected

Now you can unplug the USB cable Done

If it gives an error instead this means your configh file has

issues define CONFIG_FILE name has mistakes configh file

is out of config folder your PC user name is non-latin

42 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

33

configh file structure editing

PROFFIEBOARD INSTRUCTIONS

CHANGING PARAMETERS

All sound files (sound fonts music tracks) are stored on the micro SD card Add required sound fonts folders (Plecter NEC and Smoothswing

fonts are supported no need to change WAV files names just copy and paste) to SD card root directory as itrsquos done in the default

ProffieOS_SD_Card content folder and music tracks to the tracks folder

Make sure to name all music tracks and sound fonts folders with latin characters and only up to 8 characters long without using any special

characters (like |[- etc)

Make sure you have a configini file in each sound font folder if there is none - copy one from some default TeensySaberProffieBoard sound

font and paste into newly added sound font folder It has only one parameter that you can modify - humstart It helps to match hum sound

start with blade ignition 1000 usually works fine

All blade effects LED configuration volume level clash sensitivity etc are changed in the configh file located in lightsabergtconfig folder

To do that open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text Editor (Notepad - to see code correctly in Notepad

Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all text) and Delete it then Copy-and-Paste (Ctrl+C

Ctrl+V) your wiring diagram config code into empty _configh file and Save it under new name Follow the instructions on page 39 to

upload it to the board

Proffieboard config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)

volume level (0-3000)

clash sensitivity (adjust lower or higher with 01 step)

sound font folder nametrack name

Preset name

Blade style

LED configuration (use these XP-E2 LED templatesto define your LED)

for Red use 1 Ohm resistor for Green - no resistor for Blue use 024 Ohm

NoLED ndash no 4th led used

Preset 1

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 43

33

Blade Styles

StylePtrltInOutHelperltSimpleClashltLockupltBlastltOnSparkltAudioFlickerltRgblt02550gtRgblt501000gtgtRgblt2552550gt150gtRgblt255500gtgtAudioFlickerltRgblt1002550gtRgblt2550150gtgtgtRgblt255100150gt40gt200300Blackgtgt

ndash this is how the Blade Style code looks pasted in the configh file Preset (it sits inside a StylePtrltgt container)

ndash this is how the Blade Style code looks when editing it inside a Blade Style Editor

Each Blade Style is made of a variety of Effects each added effect goes instead of a base color in the previous effect

PROFFIEBOARD INSTRUCTIONS

CHANGING PARAMETERS

ProffieBoard and TeensySaber use Blade Styles for the main saber blade and any other accent leds to define all light effects (color changing

flashes flickering delays ignitionretraction timing etc)

Use Blade Style Editor to create and adjust Blade Styles Megtooth Sith Sabers did a great video tutorial where he shows and explains

how to use Blade Style Editor Also you can grab some pre-made Blade Styles or share yours here on TRA forums

A Blade Style example of simple flickering Green blade with Spark on start Clash Blaster Lockup and Drag IgnitionRetraction effects

InOutHelperltSimpleClashltLockupltBlastltOnSparkltAudioFlickerltRgblt02550gtRgblt501000gtgtRgblt2552550gt150gtRgblt255500gtgtAudioFlickerltRgblt1002550gtRgblt2550150gtgtgtRgblt255100150gt40gt200300Blackgt

InOutHelperltbase color200300Blackgt ndash base color can be defined by words (WHITE RED GREEN PURPLE etc) or by Rgblt0-2550-2550-255gt values for more

custom shades 200 is extension length in milliseconds 300 is retraction length in milliseconds Black is color when retracted (also can be any other color)

SimpleClashltbase colorclash color40gt ndash clash effect 40 is clash duration in milliseconds

Lockupltbase colorlockup colorgt ndash lockup effect

Blastltbase colorblast colorgt ndash blaster effect

OnSparkltbase colorspark color150gt ndash spark on ignition effect 150 is spark duration in milliseconds

AudioFlickerltrdquoArdquo colorrdquoBrdquo colorgt ndash flickering effect (blade flickers to the actual saber hum sound) the more difference between ldquoArdquo and ldquoBrdquo colors - the more

abrupt is flickering

Rgblt255500gt ndash actual color in RGB format (0 is no light 255 is the maximum brightness value for Red Green or Blue channel)

44 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

ndash SanDisk 4GB microSDHC Class 4 (Genuine) ndash SanDisk 4GB microSDHC Class 4 (Genuine)

130238 kbs = 1477 simultaneous audio streams 137812 kbs = 1562 simultaneous audio streams

ndash Patriot LX Series 16GB microSDHC UHS-IU1 Class 10 ndash Patriot LX Series 16GB microSDHC UHS-IU1 Class 10

133005 kbs = 1508 simultaneous audio streams

ndash GSkill 16GB microSDHC UHS-IU1 Class 10 ndash GSkill 16GB microSDHC UHS-IU1 Class 10

129534 kbs = 1469 simultaneous audio streams

ndash Kingston 16GB microSDHC UHS-IU1 Class 10 ndash Kingston 16GB microSDHC UHS-IU1 Class 10

128090 kbs = 1452 simultaneous audio streams

ndash SanDisk Ultra 16GB microSDHC UHS-IU1 A1 Class 10 ndash SanDisk Ultra 16GB microSDHC UHS-IU1 A1 Class 10

102663 kbs = 1164 simultaneous audio streams 11124 kbs = 1261 simultaneous audio streams

ndash SanDisk 8GB microSDHC Class 4 ndash SanDisk 8GB microSDHC Class 4

108506 kbs = 1230 simultaneous audio streams

ndash SanDisk 16GB microSDHC Class 4 ndash SanDisk 16GB microSDHC Class 4

102663 kbs = 1164 simultaneous audio streams 106957 kbs = 1213 simultaneous audio streams

ndash SanDisk Ultra 16GB microSDHC UHS-IU1 Class 10 ndash SanDisk Ultra 16GB microSDHC UHS-IU1 Class 10

102663 kbs = 1164 simultaneous audio streams 103909 kbs = 1178 simultaneous audio streams

ndash Smartbuy 4GB microSDHC Class 4 ndash Smartbuy 4GB microSDHC Class 4

75437 kbs = 855 simultaneous audio streams

ndash Kingston 8GB microSDHC Class 4 ndash Kingston 8GB microSDHC Class 4

75209 kbs = 822 simultaneous audio streams

ndash SanDisk 4GB microSDHC Class 4 (Fake) ndash SanDisk 4GB microSDHC Class 4 (Fake)

677 kbs = 769 simultaneous audio streams

Here is a list of tested micro SD cards speed with TeensySaber V3 and ProffieBoard Any card with speed over 900 kbs is recommended the

higher the speed is ndash the better Memory size of 4-16Gb is more than enough Cards were tested with a default firmware (1291) compiled

with ldquoSmallest Coderdquo under Optimize ldquodefault_proffieboard_confighrdquo file and default ProffieOS SD card sound files (7 folders)

To test your SD card speed simply hook up ProffieBoard to PC open Arduino IDE go to Tools and open Serial Monitor make sure you have

New Line and 9600 baud rate selected on the bottom of Serial Monitor window type and send sdtest command wait for the test result

4Recommended micro SD cards

BEST

TEENSYSABER PROFFIEBOARD

GOOD

BAD

PROFFIEBOARD INSTRUCTIONS

SD CARD RECOMMENDATIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 45

There are a lot of fake (chinese copies) microSD cards on the market from aliexpress ebay amazon etc They look very similar to genuine

cards but are a bit different though and have a twice lower writingreading speed Here is an example of a SanDisk 4Gb Class 4 card one is

genuine with 137812 kbs speed and the other one is fake with 677 kbs speed I got from ebay seller

Be carefull and pay attention to how the actual card looks if you are not sure ask seller for the real photo of SD card he sells

4Genuine and Fake SanDisk 4Gb Class 4 microSD

PROFFIEBOARD INSTRUCTIONS

SD CARD RECOMMENDATIONS

46 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

WIRE GAUGE GUIDE

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 47

RECHARGE PORTS AND KILL SWITCHES

48 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

NEOPIXEL STRIPS CURRENT DRAW

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 49

6TROUBLESHOOTING

For more help please check these linksProffieOSProffieBoardTeensySaber wiki on GitHubAsk your question on The Rebel Armory forumsAsk your question on FX-sabers forumsAsk your question in facebook group

How to solve most common issues

Quick troubleshooting tips

TeensySaber board or Proffieboard is not recognized by computer (nothing under Port selection in Arduino)

ndash Make sure a charged 37V battery is connected to the board micro-USB cable is a data transfer cable all plugins and drivers are installed ndash

check again pages 21 for TeensySaber or 40 for Proffieboard Try a different USB port on your computer

Sketch (code) compile error in Arduino IDE

ndash Check your define CONFIG_FILE ldquoconfig_confighrdquo line in opened lightsaberino file if itrsquos written correctly with config in it

Sketch (code) compile error in Arduino IDE

ndash Check if the _configh file you defined in the lightsaberino sketch file is same name as in the lightsaber-rdquofirmware versionrdquolightsaber

config folder and is located in this folder

Sketch (code) compile error in Arduino IDE

ndash Check your settings under Tools tab in Arduino IDE program Check again pages 21 for TeensySaber or 40 for Proffieboard

Sketch (code) compile error in Arduino IDE

ndash Check if your _configh file is correct Blade Styles Presets const unsigned int maxLedsPerStrip = 144 if BladeConfig blades[] = is correct

Sketch (code) compile error in Arduino IDE

ndash If nothing helps install Arduino IDE version 186 and try to compile and upload the firmware again

Sound doesnrsquot play

ndash Remove SD card and insert again check speaker wiring Make sure all sound files on SD card are correctly named (8 characters max long)

Re-format SD card in FAT32 load sound files and try again try another SD card

Board says ldquoLOW POWERrdquo

ndash Charge the battery

Serial Monitor shows info sent by the board but your commands donrsquot work

ndash In the bottom right corner of Serial Monitor window make sure the Line Ending drop down is set to New Line

Sound is weird and distorted

ndash Check your SD card speed (see page 44) Check speaker wiring try another good speaker

02 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

It really just started with a trip to Disneyland I was really just disappointed with the cheap plastic lightsabers they had available I had hoped to pick something more display-worthy or at least in the ldquotoys for grownupsrdquo category but did not find anything So when I got home I went and ordered an FX ldquoblack seriesrdquo Luke lightsaber which looks quite nice but the sound light and interactivity was still pretty disappointing At this point I started to think about how I would make a lightsaber I had already done things with neopixels before so that was kind of a no-brainer for making a better blade but I really wanted to do was to make the sound react fluidly to motion At this point I joined a bunch of forums and came across the NEC and Plecter boards but there didnrsquot seem to be a way to alter how they produced sounds so I picked up a teensy and a PJRC prop shield and started building from there The Teensy 32 + PJRC prop + SD card reader + voltage booster + FETs I ended up with was fairly large Luckily the Graflex lightsabers are also fairly large so I purchased a Graflex 21 and barely managed to squeeze everything in there Around this time I got kind of stuck with how to synthesize all the sounds a lightsaber makes so I decided to imple-ment support for Plecter and NEC sound fonts to get the saber I built make some sounds There are some amazing sound fonts out there but even so the interactivity I craved was still missing Since I didnrsquot really have a good idea for how to make that interactivity happen I took on a different challenge instead Make it smaller For the TeensySaber V2 I decided to try to make my own circuit board That meant integrating some components from the prop shield the sd card reader the voltage booster and the FETs into a single board To make things interesting I bought a Korbanth OWK which has an inner diameter of 78 inches and my goal was to fit everything in there It took a while to do but the result was the TeensySaber V2 board The V2 fits really great inside an OWK without cutting into the inner chassis parts and was generally a great success but the sound quality wasnrsquot as good as I wanted it to be so eventually I designed he TeensySaber V3 which is mostly the same as the V2 but uses a digital 3W amplifier As I was working on the TeensySaber V3 this guy Thexter showed up on a couple of forums with some great videos showing off an algorithm for better swing sounds Since this was what I wanted all along I couldnrsquot wait until he provided a description of his algorithm so that I could implement it Lucky for me he didnrsquot mind describing his algorithm so I imple-mented it My implementation never really sounded as good as his videos though but thatrsquos probably because Irsquom not really a font designer Later Thexter came back with an improved version which is what we now call ldquoSmoothSwing V2rdquo With SmoothSwing V3 TeensySaber V3 was getting some attention from people but a lot of people still thought it was too big since itrsquos made out of two boards sandwiched together The sandwiching also creates extra work for installers and extra complications for hobbyists so it was time to try to put everything together into one board At first I was thinking of using the same components that make up a Teensy to make the all-in-one board but it turned out to be complicated and expensive Instead I found another board called a ldquoButterflyrdquo which had nearly identical capabilities and an already functional arduino plugin Even better the Butterfly was 100 open source (the teensy is only mostly open source) I spent most of the Christmas vacation last year designing the Proffieboard and it took another couple of months of

testing to get a working prototype but itrsquos been a lot of fun

- Fredrik Hubinette

Read full interview on SaberSourcingProffieboard lightsaber controller developer Fredrik Hubinette interview

INTRODUCTION

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 03

Specifications and features

ndash ProffieBoard specific ndash Dimensions 179x346x57mm (with micro USB port and micro SD card)

ndash ProffieBoard specific ndash Single pcb board design

ndash TeensySaber V3 specific ndash Dimensions 18x395x9mm (with micro USB port and micro SD card)

ndash TeensySaber V3 specific ndash 2-pcb boards stack design

ndash 100 Open-Source you may add any feature you like (GPLv3)

ndash Power supply 26-45 Volts up to 10A per LED output 1-6 single Li-Ion 36-37V (low 26V full 42V) battery recommended

ndash Speaker 4 ohm or 8 ohm 2W (with lower volume) or 3-5W (recommended)

ndash Unlimited amount of sound banksfonts supports regular (Plecter NEC) and ldquoSmoothswingrdquo sound fonts

ndash Sound FX (WAV sound files) boot blaster blocking lockup hum swing clash drag font force ingnition retraction

ndash Light FX blade flickering pulsing flash on clash drag stab blaster blocking lockup and other

ndash Music tracks (WAV sound files) playback in idle mode and saber sound effects background

ndash Micro SD card 4-16Gb Class 4-10 by SanDisk brand recommended

ndash Support for remote control via bluetooth (with external bluetooth module addon)

ndash Speedy 32-bit processor for advanced features like sound filters synthesizing and mp3 playback

ndash 3 Watts sound amplifier 16-bit digital output (12-bit for TeensySaber V1 and V2)

ndash Sample rate is 44kHz (default) 22kHz and 11kHz are supported and upsampled to 44kHz automatically

ndash Gapless playback with 25ms cross-fade when you interrupt one sample to go to another

ndash Polyphonic playback currently configured for up to 5 simultaneous samples

ndash ldquoSmoothswingrdquo algorithm support (a new more natural swing motion sounds playback)

ndash PL9823 (RGB) WS2812B (GRB) SK6812 (GRB WWA) Neopixel support

ndash 1234-color LED stars (Tri-Cree and Quad (also RGBA) LED modules)

ndash Segmented (6 segments + Flash string) classic string blades support

ndash Multi-blade support for dual and crossguard setups

ndash Blade LED type Presets and Blade Styles selection by different values of a resistor (Blade ID functions)

ndash Crystal chamber support

ndash Power-level indicator with neopixel blade

ndash OLED PLI and FONT animations display

ndash sound files upload to SD card via USB cable directly from PC (only from firmware version 1291 and up)

ndash POV (persistance of vision) mode support

ndash Accent LEDs support (also implemented as additional ldquobladesrdquo)

ndash Spoken error and low battery messages

ndash Easy and free firmware updates by user

Demonstration videos

Link to the demonstration video by K-SithLink to the demonstration video by Megtooth Sith SabersLink to the demonstration video by Zimmer LabsLink to the demonstration video by ShtokCustomWorx

FEATURES

04 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

1HELPFUL LINKS

TeensySaber V3 boards

Send a message to this guy

Other parts links

RGB Neopixel strips (they are SK6812 though sellers list them as WS2812b)WWA (WhiteWhiteAmber) Neopixel strips SK6812 Source 1WWA (WhiteWhiteAmber) Neopixel strips SK6812 Source 2Individual Neopixel LEDsNeopixel stripsconnectorsother supplies (UK) ndash TheSaberArmoryTri-Cree high power LEDs (CanadaUSA) ndash TheCustomSaberShopTri-Cree high power LEDs (UK) ndash TheSaberArmoryVarious Accent LEDs (UK) ndash TheSaberArmoryVarious Batteries (UK) ndash TheSaberArmoryProtected KeepPower 18650 10A 3500mAh batteryProtected KeepPower 18650 15A 3120mAh batteryUnprotected Vapcell 21700 15A 5000mAh battery ndash requires external PCMUnprotected KeepPower 26650 15A 6000mAh battery ndash requires external PCM15A Protection Circuit Module (PCM)18650 Protected Battery holderHigh Power 13mm Recharge PortRecharge Ports (UK) ndash TheSaberArmoryHigh Power Kill SwitchVarious Switches (UK) ndash TheSaberArmorySCW Neopixel blade Pogo connectorTCSS Neopixel blade Pogo connectorGX16 Neopixelstring blade connectorsVarious Speakers (UK) ndash TheSaberArmory Various Speakers (UK) ndash JQ-sabersVarious Speakers (CanadaUSA) ndash TheCustomSaberShop2W and 3W Speakers ndash Saber Essentials4W Speakers ndash ebay

3D-printed chassis links

ShtokCustomWorx on ShapewaysGOTH-3Designs on Shapeways

Where to buy

ProffieBoards

TheSaberArmory (KR-sabers) UK storeJQ-sabers UK storeSaberBay Etsy USA storeShtokCustomWorx Etsy RUS store (not opened yet)

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 05

1HELPFUL LINKS

Video tutorials by Megtooth Sith Sabers

Video tutorials by Megtooth Sith Sabers on youtubeLED Resistor Calculator

For more information please check these links

TeensySaber V3 sound board instructionsProffieBoard sound board instructionsrdquoBlade style sharingrdquo - here you can find and share custom blade stylesWeb Blade Style Editor 1 (default)Web Blade Style Editor 2 (restyle)Here you can get regular (Plecter NEC) or ldquoSmoothswingrdquo sound fontsProffieOSProffieBoardTeensySaber wiki on GitHubProfezzornrsquos Lab on The Rebel Armory forumsProfezzornrsquos Lab on FX-sabers forumsAsk your question in facebook group

Get latest ProffieOS firmware

Tutorials and instructions

06 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

Board pinout

used pads

Battery + ndash 26 to 45 volt input drives everything except the LEDs

Battery - ndash negative pad for LEDs needs to be at same level as GND when both are connected

GND ndash ground for electronics except LEDs Note that GND is also available on short edge of the teensy (See the teensy pinout for details)

Speaker +- ndash hooks up to speaker

Activation Aux Aux2 button ndash hook up to closing buttons or potentially touch buttons

Blade ID Neopixel Data 1 ndash normally used to measure the blade ID restor and if itrsquos a neopixel blade feed out neopixel data

LED 1 2 3 ndash hooks up to negative side of LED (positive side of LED hooks up directly to battery) These pads can handle

up to 30 volts

LED 4 5 6 ndash like LED123 but requires FETs to be placed on the bottom of the board to function Voltage is limited by

selection of FETs

Power 1 Power 2 Power 3 ndash these control the FETs which drive LED 1 2 3

AUX LED 1 2 3 ndash these are hooked up to pads on the bottom which can be populated with FETs and used to drive additional LEDs If the

bottom FETs are not populated these pins are free and can be used for any purpose

RX3 TX3 ndash these pins are used for wiring a bluetooth module for wireless control or additional Neopixel Data out

SDA SCL ndash these pins are used to wire OLED display

+33V 250mA max ndash generated by the Teensy for powering OLED display or Bluetooth module

micro USB port ndash micro USB port used only for firmware upload and can be used for sound files upload to SD card

THIS PORT ISNrsquoT USED FOR CHARGING THE BATTERY

LED output 1 2 3

Battery - Speaker + (red dot or ldquo+rdquo mark on speaker)Battery +

Data in (SD) SCK (SD)

Battery Volt SenseAux button

Activation buttonAux2 button

SDA

SCL

Blade ID Neopixel Data 1Audio data

Audio LRClock

Power 3+33VAudio GND (not used)+5V

Data out (SD)

Power 2

Audio clock

TX3Neopixel Data 2

RX3Neopixel Data 3

Power 1AUX3 LEDAUX2 LEDAUX1 LED

Motion InterruptAmplifier enable

SD card selectGND

Speaker -

LED output 4 5 6

micro USB port on Teensy 32

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 07

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

Board assembling

1 IMPORTANT

Cut the tiny trace with a knife between VIN and VUSB as shown

Teensy 32 bottom view

2 Solder 254mm header pins (gold plated recommended) to

TeensySaber V3 board on the top or on the bottom depending

on where you want to put Teensy 32 board

(please see next step)

3 Solder Teensy 32 board on top

(A ndash micro USB port on top SD card between boards) or on the bottom (B ndash SD card on top micro USB port between boards)

A B

+

08 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

Basic Tri-Cree wiring diagram(In-hilt LED)

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

+

+

+

-

-

-

26 A

WG

26 AWG

30-32 AWG

28-30 AWG

28-30 AWG

30-32 AWG

Protected 36-37V (42V max at full charge) 10A 3500mAh battery recommended+18650 battery holder (optional)Keystone 1042P

AV switch with accent led(constantly ON no effects)

accent leds run mostly at10-15mA so resistors for them must be calculated accordingly

Main RGB led

additional RGB leds(optional)

In case no additional high power leds are needed LED channels 4 5 6can be used for 3 controllable (programmable for different effects) accent leds So AV switch led can be wired to one of these channelsby adding 1 MOSFET

LED Resistor Calculator

solder 3x FETs

solder 1 FET

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 09

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

Basic Tri-Cree wiring (In-hilt LED)ldquoconfighrdquo file setup

Use a given or build your wiring diagram on THIS PAGE then open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text

Editor (Notepad - to see code correctly in Notepad Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all

text) and Delete it then Copy-and-Paste (Ctrl+C Ctrl+V) your wiring diagram config code (example below) into empty _configh file and

Save it under new name Follow the instructions on page 22 to upload it to the board

ldquov3_confighrdquoNUM_BLADES 2NUM_BUTTONS 2VOLUME 1000CLASH_THRESHOLD_G 10StyleNormalPtrltCYAN WHITE 300 800gt()StyleNormalPtrltCYAN WHITE 300 800gt()

CreeXPE2RedTemplatelt1000gtCreeXPE2GreenTemplatelt0gtCreeXPE2BlueTemplatelt240gtNoLED

TeensySaber V3 config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)Volume level (0-3000)Clash sensitivity (adjust lower or higher with 01 step)ldquoBlade 1rdquo styleldquoBlade 2rdquo style (in case only 1 blade is used you donrsquot need this line)LED configuration (use these XP-E2 LED templatesto define your LED If other LED resistors are used change these values to match Ohm1000=ltvaluegt)

where 1000 is 1 Ohm resistor 0 is no resistor240 is 024 Ohm resistorNoLED ndash no 4th led used

Preset 1

LED 1 configuration

LED 2 configuration

Preset 2 etc

10 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

Basic Neopixel wiring diagram

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

+

+

+

-

-

-

22 A

WG

22 AWG

26 AWG

30 AWG

x2 28 AWG

x2 26 AWG

22 A

WG

30-32 AWG

30-32 AWG

Protected 36-37V (42V max at full charge) 10A 3500mAh or 15A 3120mAhbattery recommended+18650 battery holder (optional)Keystone 1042P

AV switch with accent led(constantly ON no effects)

accent leds run mostly at10-15mA so resistors for them must be calculated accordingly

Main Neopixel strip

additional Neopixelstrips(optional)

Neopixel bladeconnector

330 Ohm on the Blade pcb side

x3 28 AWGor x1 22 AWGfor Negative

330 Ohm on the Blade pcb side

arrows up

330 Ohm on the Blade pcb side

In case no additional Neopixel strips are needed LED channels 4 5 6can be used for 3 controllable (programmable for different effects) accent leds So AV switch led can be wired to one of these channelsby adding 1 MOSFETRecommended power wire gauges (22 AWG) are given for 2-strip blade For 3-strip blade you gonna need at least 20 AWG wires

solder 2x FETs

solder 1 FET

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 11

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

Basic Neopixel wiringldquoconfighrdquo file setup

ldquov3_confighrdquoNUM_BLADES 3NUM_BUTTONS 2VOLUME 1000CLASH_THRESHOLD_G 10IgnitionDelaylt0 any blade stylegtIgnitionDelaylt800 any blade stylegtIgnitionDelaylt800 any blade stylegtWS2811BladePtrlt118 WS2811 800kHz | WS2811 GRBgt()WS2811BladePtrlt26 7 ltbladePowerPin4gtgt()WS2811BladePtrlt26 8 ltbladePowerPin5gtgt()

TeensySaber V3 config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)Volume level (0-3000)Clash sensitivity (adjust lower or higher with 01 step)ldquoBlade 1rdquo style (main blade with IgnitionDelay 0)ldquoBlade 2rdquo style (CG blade 1 with IgnitionDelay 800)ldquoBlade 3rdquo style (CG blade 2 with IgnitionDelay 800)

strip configuration (defines how many pixels it has and to which LED output and pin is wired)

Preset 1

any blade style

strip (blade) 1 configuration

strip (blade) 2 configuration

strip (blade) 3 configuration

Preset 2 etc

Use a given or build your wiring diagram on THIS PAGE then open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text

Editor (Notepad - to see code correctly in Notepad Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all

text) and Delete it then Copy-and-Paste (Ctrl+C Ctrl+V) your wiring diagram config code (example below) into empty _configh file and

Save it under new name Follow the instructions on page 22 to upload it to the board

12 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

Basic Segmented string wiring diagram

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

+

+

-

-

24 A

WG

28 AWG

30-32 AWG

30-32 AWG

Protected 36-37V (42V max at full charge) 10A 3500mAh battery recommended+18650 battery holder (optional)Keystone 1042P

AV switch with accent led(constantly ON no effects)

accent leds run mostly at10-15mA so resistors for them must be calculated accordingly

6-segments string blade

FoC string

N-channel FET3A minimum

1

1 46 523

23456

Calculate resistors for each led segment of the blade string depending on which leds are used 5mm leds have max drive current around 25mA per led when 10mm leds can be 100mA and 200mA per ledSo pay attention to your led max current and Forward Voltage (Vf) when calculating a segment resistor resistence as well as its wattage Also choose wire gauges accordingly to meet segments and total blade max current draw level

LED Resistor Calculator

solder 3x FETs

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 13

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

Basic Segmented string wiringldquoconfighrdquo file setup

ldquov3_confighrdquoNUM_BLADES 1NUM_BUTTONS 2VOLUME 1000CLASH_THRESHOLD_G 10StyleNormalPtrltCYAN WHITE 300 800gt()ltBlue3mmLED 20 White3mmLEDgt

TeensySaber V3 config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)Volume level (0-3000)Clash sensitivity (adjust lower or higher with 01 step)Blade styleLED string configuration(here you mention the color and type of leds usedin the main blade string segments and FoC string20 is the FoC signal pin (Blade ID pin))

Preset

LED string configuration

Use a given or build your wiring diagram on THIS PAGE then open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text

Editor (Notepad - to see code correctly in Notepad Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all

text) and Delete it then Copy-and-Paste (Ctrl+C Ctrl+V) your wiring diagram config code (example below) into empty _configh file and

Save it under new name Follow the instructions on page 22 to upload it to the board

14 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

Accent LEDs wiring diagram(optional)

Accent LEDs work with TeensySaber board as additional ldquobladesrdquo when powered by LED outputs 4 5 6 with FETs So they can have any effect

that blade can have If no effects needed accent led can be powered just by a 33V output pad (power-on led indication)

30-32 AWGRGB ledcommon-anode

4 ldquobladesrdquo1 main and 3 accent leds

main blade style (effects) main blade style (effects)

3 accent leds style (effects)accent led style (effects)

3 accent leds configurations

RGB accent led configuration

2 ldquobladesrdquo1 main and 1 RGB accent led

ldquoPower-onrdquo indicationaccent leds (no effects)

3 accent leds withindependent effects

+ 1 or more simple accent leds without effects

1 RGB accent led+ 1 or more simple accent leds

without effects

a) b)

b)

c)

c)

solder 3x FETs solder 3x FETs

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 15

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

OLED display wiring diagram(optional)

SSD1306 128x32 pixels OLED display allows to show battery level current preset name play different animations and even simple games It

can be wired to any blade configuration and requires just one additional line in the code to work You can get monochrome display in white

or blue color

SSD1306128x32OLED

SSD1306 ndash with blue or white display color selectSSD1306 ndash cheaper priceSSD1306 just screen ndash blue or white select

30-32 AWG

30-32 AWG

add this line to enable OLED display

display shows a preset name written in these quotes ldquoldquo

16 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

Bluetooth module wiring diagram(optional)

SOON

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 17

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

Blade ID resistor functions(optional)

SOON

18 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

website TeensySaber V3 FULL wiring diagrams link

Scroll the page down till you see the interactive diagram Above the diagram there are components selection options Build your saber setup

with it and follow diagram to wire your board Then you need to copy the configuration code below and paste it into your _configh file

Choose components you want

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

More wiring diagrams

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 19

20 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

How to use it

Blade ignitionretraction ndash assuming you have at least one button pressing it briefly should turn the saber on or off If you have an AUX button pressing it briefly should also turn the saber on and off If you have no buttons you can turn the saber on and off by twisting your wrist back and forth Note that the motion has to be done long enough to count so a very quick flick of the wrist will not workTurn On muted ndash double-click power buttonNext preset ndash while saber is off click the AUX buttonPrevious preset ndash hold AUX button and click the Activation buttonTrigger Clash ndash while saber is on hit the bladeTrigger Lockup ndash while saber is on hold Activation button then trigger a clash Lockup releases when you let go of the Acti-vation buttonTrigger Drag ndash like lockup but point saber mostly down before holding Activation buttonTrigger Force ndash long-click AUX buttonStart soundtrack ndash long-click the Activation buttonTrigger Blaster Block ndash while saber is on short-click AUX button

Serial Monitor commands

battery_voltage ndash gets current battery voltage valueget_volume ndash get current volume valuepow ndash power OnOff the saberon ndash power On the saberoff ndash power Off the saberset_volume lt0-3000gt ndash set volume value (example set_volume 500)play ndash play the default preset trackplay trackslttrack namegt ndash play a specific track from tracks folder (example play tracksvenuswav)stop ndash stop the playing trackforce ndash play ldquoforcerdquo sound effectsdrag ndash play ldquodragrdquo sound effectsblast ndash play ldquoblasterrdquo sound effectslock ndash play ldquolockuprdquo sound effectsclash ndash play ldquoclashrdquo sound effectsreset ndash reboot the boardn ndash switch to next presetp ndash switch to previous presetlist_presets ndash show all presetssdtest ndash test SD card speed

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 21

2TEENSYSABER V3 INSTRUCTIONS

FIRMWARE UPLOAD AND UPDATE2

Software installation and setup

To upload firmware to TeensySaber board Arduino IDE program is required Follow these steps to install it to your PC

1 Install latest Arduino IDE software (donrsquot use BETA)

Installing as Windows app also is not recommended

because it will be installed in a specific protected folder that

wonrsquot allow you to install Teensyduino software in it

If TeensySaber wonrsquot show up in COM port use

Arduino IDE 186 version

2 Install latest Teensyduino software in same directory

usually itrsquos CProgram Files (x86)Arduino on Windows

Follow installation instructions for your system

3 Select Teensy 32 31 in Tools -gt Board

USB Type ndash Serial CPU Speed ndash 96 MHz (overclock) Optimize ndash Smallest Code Port ndash COM(the number your PC assigned) (Teensy 32) Serial

Connect TeensySaber via USB cable to PC to be able to select

the Port donrsquot forget to connect battery first

22 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

1 Download the TeensySaber firmware and SD card content

Unzip lightsaber-1286zip to your Documents directory or to

Desktop but not to Arduino program folder or anywhere in

Programs directory where all programs are installed You will

see a lightsaber folder and files inside it Donrsquot move any of

these files to any other location outside the lightsaber folder

and donrsquot reorganize them Unzip ProffieOS_SD_Cardzip to the

folder where you keep lightsaber-1286 folder Copy all files

from ProffieOS_SD_Card folder to your SD card

2 Unhide file extensions in File Explorer settings to see h ending

of config files Donrsquot add ldquohrdquo to the config file name

Go to config folder and create you own configh file (see page

23 for how-to)

Double-click the lightsaberino file

3 Add the name of your configh file as shown and Save this

lightsaberino file Make sure the other config files are

commented out there should be only one CONFIG_FILE

without You can have multiple config files

in lightsabergtconfig folder and just define the one you need

in lightsaberino file and upload it again to TeensySaber board

4 Connect battery to TeensySaber board and hook up to your PC

with a data transfer micro-USB-to-USB cable

Press arrow button it will compile and upload firmware to the

board Wait for your PC to make a sound or TeensySaber will

play boot sound if speaker is connected Now you can unplug

the USB cable Done

If it gives an error instead this means your configh file has

issues define CONFIG_FILE name has mistakes configh file

is out of config folder your PC user name is non-latin

2TEENSYSABER V3 INSTRUCTIONS

FIRMWARE UPLOAD AND UPDATE2

Uploading firmware

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 23

2TEENSYSABER V3 INSTRUCTIONS

CHANGING PARAMETERS3

Changing sound board parameters

All sound files (sound fonts music tracks) are stored on the micro SD card Add required sound fonts folders (Plecter NEC and Smoothswing

fonts are supported no need to change WAV files names just copy and paste) to SD card root directory as itrsquos done in the default

ProffieOS_SD_Card content folder and music tracks to the tracks folder

Make sure to name all music tracks and sound fonts folders with latin characters and only up to 8 characters long without using any special

characters (like |[- etc)

Make sure you have a configini file in each sound font folder if there is none - copy one from some default TeensySaberProffieBoard sound

font and paste into newly added sound font folder It has only one parameter that you can modify - humstart It helps to match hum sound

start with blade ignition 1000 usually works fine

All blade effects LED configuration volume level clash sensitivity etc are changed in the configh file located in lightsabergtconfig folder

To do that open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text Editor (Notepad - to see code correctly in Notepad

Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all text) and Delete it then Copy-and-Paste (Ctrl+C

Ctrl+V) your wiring diagram config code into empty _configh file and Save it under new name Follow the instructions on page 22 to

upload it to the board

TeensySaber V3 config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)

volume level (0-3000)

clash sensitivity (adjust lower or higher with 01 step)

sound font folder nametrack name

Preset name

Blade style

LED configuration (use these XP-E2 LED templatesto define your LED)

for Red use 1 Ohm resistor for Green - no resistor for Blue use 024 Ohm

NoLED ndash no 4th led used

Preset 1

24 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

31

PROFFIEBOARD INSTRUCTIONS

Whatrsquos needed

ndash ProffieBoard

ndash micro SD-card (see page 44 for recommendations)

ndash a USB micro SD-card reader (to load sound files from PC to micro SD card)

ndash micro USB data transfer cable (CABLES THAT SUPPORT ONLY CHARGING WONrsquoT WORK)

ndash wires of different gauges (32-20 AWG) (PTFE coated copper stranded wires recommended) heat shrink

ndash ESD safe soldering station solder wire flux etc

ndash pliers helping hands etc

ndash isopropyl alcohol to clean pads before soldering (helps solder to stick better)

ndash Digital Multimeter (VERY USEFUL)

ndash computer running Windows Linux or Mac OS with internet access

ndash 37V Li-Ion Protected rechargeable battery switches recharge port speaker LEDs resistors chassis etc

ndash Smart Li-Ion CC-CV (Constant Current - Constant Voltage mode) battery charger for 37V (42V) cells

ndash patience

WIRING DIAGRAMS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 25

31

PROFFIEBOARD INSTRUCTIONS

Board pinout

Battery + ndash 26 to 45 volt input drives everything except the LEDs

Battery - ndash negative pad for LEDs needs to be at same level as GND when both are connected Both pads are internally connected

GND ndash ground for electronics except LEDs Note that there are two GND pads on the board that are internally connected

Speaker +- ndash hooks up to speaker

Activation (1) Aux (2) Aux2 button (3) ndash hook up to closing buttons or potentially touch buttons

Blade ID Neopixel Data 1 ndash normally used to measure the blade ID restor and if itrsquos a neopixel blade feed out neopixel data

Data 2 3 4 5 ndash additional neopixel data outputs or free for other purposes

LED 1 2 3 4 5 6 ndash hooks up to negative side of LED (positive side of LED hooks up directly to battery) These pads can handle

up to 30 volts

SDA SCL ndash these pins are used to wire OLED display or to communicate with the gyro and accelerometer chip

RX TX ndash these pins are used for wiring a bluetooth module for wireless control

SWDCLK SWDIO ndash can be hooked up to a ST-LINK device and lets you debug programs running on the ProffieBoard

+5V ndash generated by the ProffieBoard normally itrsquos only ON when sound is playing

+33V ndash generated by the ProffieBoard for powering OLED display Bluetooth module or some accent leds

BOOT RESET ndash buttons to put the ProffieBoard in bootloader mode if uploading doesnrsquot work

micro USB port ndash micro USB port used only for firmware upload and can be used for sound files upload to SD card (from firmware version

1291 and up) THIS PORT ISNrsquoT USED FOR CHARGING THE BATTERY

LED 4LED 3

LED 2

LED 1

LED 5

LED 6

RESETBOOT

Battery - Battery -

Speaker + (red dot or ldquo+rdquo mark on speaker)

Battery +

Aux button (2)Activation button (1)

Aux2 button (3)

Blade ID Neopixel Data 1

Data 5

Data 4Data 3Data 2

+33V

SWDIO

SWDCLK

+5V

TXRX

GND

GND

Reset

Speaker -

SCLSDA

micro USB port

WIRING DIAGRAMS

26 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Basic Tri-Cree wiring diagram(In-hilt LED)

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

+

+

-

-

26 AWG

26 A

WG

30-32 AWG

28-30 AWG

28-3

0 A

WG

30-32 AWG

Protected 36-37V (42V max at full charge) 10A 3500mAh battery recommended+18650 battery holder (optional)Keystone 1042P

AV switch with accent led(constantly ON no effects)

accent leds run mostly at10-15mA so resistors for them must be calculated accordingly

Main RGB led

additional RGB leds(optional)

In case no additional high power leds are needed LED channels 4 5 6 can be used for 3 controllable(programmable for different effects) accent leds So AV switch led can be wired to one of these channelsAccent leds also can be wired to Data pads 1-5 please see ldquoAccent LEDs wiring and setuprdquo page

LED Resistor Calculator

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 27

3WIRING DIAGRAMS1

Basic Tri-Cree wiring (In-hilt LED)ldquoconfighrdquo file setup

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

Use a given or build your wiring diagram on THIS PAGE then open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text

Editor (Notepad - to see code correctly in Notepad Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all

text) and Delete it then Copy-and-Paste (Ctrl+C Ctrl+V) your wiring diagram config code (example below) into empty _configh file and

Save it under new name Follow the instructions on page 22 to upload it to the board

ldquoproffieboard_v1_confighrdquoNUM_BLADES 2NUM_BUTTONS 2VOLUME 1000CLASH_THRESHOLD_G 10StyleNormalPtrltCYAN WHITE 300 800gt()StyleNormalPtrltCYAN WHITE 300 800gt()

CreeXPE2RedTemplatelt1000gtCreeXPE2GreenTemplatelt0gtCreeXPE2BlueTemplatelt240gtNoLED

ProffieBoard config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)Volume level (0-3000)Clash sensitivity (adjust lower or higher with 01 step)ldquoBlade 1rdquo styleldquoBlade 2rdquo style (in case only 1 blade is used you donrsquot need this line)LED configuration (use these XP-E2 LED templatesto define your LED If other LED resistors are used change these values to match Ohm1000=ltvaluegt)

where 1000 is 1 Ohm resistor 0 is no resistor240 is 024 Ohm resistorNoLED ndash no 4th led used

Preset 1

LED 1 configuration

LED 2 configuration

Preset 2 etc

PROFFIEBOARD INSTRUCTIONS

28 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Basic Neopixel wiring diagram

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

+

+

-

-

22 A

WG

22 AWG

x2 28 AWG

x2 26 AWG

22 A

WG

30-32 AWG30-32 AWG

Protected 36-37V (42V max at full charge) 10A 3500mAh or 15A 3120mAhbattery recommended+18650 battery holder (optional)Keystone 1042P

AV switch with accent led(constantly ON no effects)

accent leds run mostly at10-15mA so resistors for them must be calculated accordingly

Main Neopixel strip

additional Neopixelstrips(optional)

Neopixel bladeconnector

330 Ohm on the Blade pcb side

x3 28 AWGor x1 22 AWGfor Negative

330 Ohm on the Blade pcb side

arrows up

330 Ohm on the Blade pcb side

In case no additional Neopixel strips are needed LED channels 4 5 6 can be used for 3 controllable(programmable for different effects) accent leds So AV switch led can be wired to one of these channelsAccent leds also can be wired to Data pads 2-5 please see ldquoAccent LEDs wiring and setuprdquo page

Recommended power wire gauges (22 AWG) are given for 2-strip blade For 3-strip blade you gonna need at least 20 AWG wires

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 29

ldquoproffieboard_v1_confighrdquo

3WIRING DIAGRAMS1

Basic Neopixel wiringldquoconfighrdquo file setup

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

NUM_BLADES 3NUM_BUTTONS 2VOLUME 1000CLASH_THRESHOLD_G 10IgnitionDelaylt0 any blade stylegtIgnitionDelaylt800 any blade stylegtIgnitionDelaylt800 any blade stylegtWS2811BladePtrlt118 WS2811 800kHz | WS2811 GRBgt()WS2811BladePtrlt26 blade2Pin ltbladePowerPin4gtgt()WS2811BladePtrlt26 blade3Pin ltbladePowerPin5gtgt()

ProffieBoard config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)Volume level (0-3000)Clash sensitivity (adjust lower or higher with 01 step)ldquoBlade 1rdquo style (main blade with IgnitionDelay 0)ldquoBlade 2rdquo style (CG blade 1 with IgnitionDelay 800)ldquoBlade 3rdquo style (CG blade 2 with IgnitionDelay 800)

strip configuration (defines how many pixels it has and to which LED output and pin is wired)

Preset 1

any blade style

strip (blade) 1 configuration

adjust this number to match your strips leds count

strip (blade) 2 configuration

strip (blade) 3 configuration

Preset 2 etc

Use a given or build your wiring diagram on THIS PAGE then open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text

Editor (Notepad - to see code correctly in Notepad Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all

text) and Delete it then Copy-and-Paste (Ctrl+C Ctrl+V) your wiring diagram config code (example below) into empty _configh file and

Save it under new name Follow the instructions on page 22 to upload it to the board

PROFFIEBOARD INSTRUCTIONS

30 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Basic Segmented string wiring diagram

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

+

+

-

-

24 A

WG

28 AWG

30-32 AWG30-32 AWG

Protected 36-37V (42V max at full charge) 10A 3500mAh battery recommended+18650 battery holder (optional)Keystone 1042P

AV switch with accent led(constantly ON no effects)

accent leds run mostly at10-15mA so resistors for them must be calculated accordingly

6-segments string blade

FoC string

N-channel FET3A minimum

123456

Calculate resistors for each led segment of the blade string depending on which leds are used 5mm leds have max drive current around 25mA per led when 10mm leds can be 100mA and 200mA per ledSo pay attention to your led max current and Forward Voltage (Vf) when calculating a segment resistor resistence as well as its wattage Also choose wire gauges accordingly to meet segments and total blade max current draw level

LED Resistor Calculator

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 31

ldquoproffieboard_v1_confighrdquo

3WIRING DIAGRAMS1

Basic Segmented string wiringldquoconfighrdquo file setup

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

NUM_BLADES 1NUM_BUTTONS 2VOLUME 1000CLASH_THRESHOLD_G 10StyleNormalPtrltCYAN WHITE 300 800gt()ltBlue3mmLED BladePin White3mmLEDgt

ProffieBoard config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)Volume level (0-3000)Clash sensitivity (adjust lower or higher with 01 step)Blade styleLED string configuration(here you mention the color and type of leds usedin the main blade string segments and FoC stringBladePin is the FoC signal pin (Blade ID pin))

Preset

LED string configuration

Use a given or build your wiring diagram on THIS PAGE then open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text

Editor (Notepad - to see code correctly in Notepad Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all

text) and Delete it then Copy-and-Paste (Ctrl+C Ctrl+V) your wiring diagram config code (example below) into empty _configh file and

Save it under new name Follow the instructions on page 22 to upload it to the board

PROFFIEBOARD INSTRUCTIONS

32 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Accent LEDs wiring diagram(optional)

Accent LEDs work with ProffieBoard as additional ldquobladesrdquo when powered by LED outputs 4 5 6 or Data pads 1 2 3 5 as PWM So they can

have any effect that blade can have If no effects needed accent led can be powered just by a 33V output pad (power-on led indication)

30-32 AWG

with Neopixel blade setup these 4 outputsdonrsquot work for regular accent leds

Recommended resistors to use for accent leds at 33V power source and 15mA drive

ndash 100 Ohm for Red (lt100000gt value in the code)ndash 13 Ohm for Green (lt13000gt value in the code)ndash 13 Ohm for Blue (lt13000gt value in the code)ndash 100 Ohm for Yellow (lt100000gt value in the code)ndash 20 Ohm for White (lt20000gt value in the code)

RGB ledcommon-anode

8 ldquobladesrdquo1 main and 7 accent leds

main blade style (effects) main blade style (effects)

7 accent leds style (effects)accent led style (effects)

7 accent leds configurations

RGB accent led configuration

2 ldquobladesrdquo1 main and 1 RGB accent led

ldquoPower-onrdquo indicationaccent leds (no effects)

7 accent leds withindependent effects

RGB accent led

a) b)

b)

c)

c)

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 33

3WIRING DIAGRAMS1

Neopixel Accent LEDs wiring diagram(optional)

With Neopixel setup additional neopixel leds or arrays can be used as accent leds There are 2 ways to wire them using additional Data

pins 2 3 4 5 or ldquoSub-bladesrdquo wiring with just 1 Data output pin Same way Neopixel connectors with on-board leds ca be wired

Option 1 ndash with extra Data pins

Main Blade

some accent leds

D1

D2

crystal leds

330 Ohm

330 Ohm

330 Ohm

main blade style (effects)

main blade 144 leds Data pin 1

accent leds blade style (effects)

accent leds ldquobladerdquo 4 leds Data pin 2

crystal leds blade style (effects)

crystal leds ldquobladerdquo 2 leds Data pin 3

3 ldquobladesrdquo1 main 1 accent leds array and 1 crystal leds array

PROFFIEBOARD INSTRUCTIONS

D3

follow arrows direction

34 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Neopixel Accent LEDs wiring diagram(optional)

PROFFIEBOARD INSTRUCTIONS

Main Blade

some accent leds

1

3

5678

2

4

D1

crystal leds

follow arrows direction

330 Ohm

330 OhmData signal

With this setup a single array of neopixel leds is separated into a couple of sub-blades with their own style configuration and behaviour This

is really usefull when you want to use only one data pin More about ldquoSub-bladesrdquo on ProffieOS wiki page

Option 2 ndash with ldquoSub-bladesrdquo

main blade style (effects)

main blade sub-blade 140 leds (7-146) but from 6 to 145 in the code

accent leds blade style (effects)

accent leds sub-blade 4 leds (1-4) but from 0 to 3 in the code

crystal leds blade style (effects)

146 leds total used

crystal leds sub-blade 2 leds (5-6) but from 4 to 5 in the code

update default 144 to a higher total value if you get all accent leds +Main blade gt 144 Example update to 146 if you have 2 crystal leds +4 accent leds + 140 Main blade leds = 146

3 ldquobladesrdquo 1 main 1 accent leds array and 1 crystal leds array

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 35

3WIRING DIAGRAMS1

OLED display wiring diagram(optional)

SSD1306 128x32 pixels OLED display allows to show battery level current preset name play different animations and even simple games It

can be wired to any blade configuration and requires just one additional line in the code to work You can get monochrome display in white

or blue color

SSD1306128x32OLED

SSD1306 ndash with blue or white display color selectSSD1306 ndash cheaper priceSSD1306 just screen ndash blue or white select

30-32 AWG

30-32 AWG

add this line to enable OLED display

display shows a preset name written in these quotes ldquoldquo

PROFFIEBOARD INSTRUCTIONS

36 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Bluetooth module wiring diagram(optional)

SOON

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 37

3WIRING DIAGRAMS1

Blade ID resistor functions(optional)

SOON

PROFFIEBOARD INSTRUCTIONS

38 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

website ProffieBoard FULL wiring diagrams link

Scroll the page down till you see the interactive diagram Above the diagram there are components selection options Build your saber setup

with it and follow diagram to wire your board Then you need to copy the configuration code below and paste it into your _configh file

Choose components you want

3WIRING DIAGRAMS1

More wiring diagrams

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 39

3WIRING DIAGRAMS1

How to use it

PROFFIEBOARD INSTRUCTIONS

Blade ignitionretraction ndash assuming you have at least one button pressing it briefly should turn the saber on or off If you have an AUX button pressing it briefly should also turn the saber on and off If you have no buttons you can turn the saber on and off by twisting your wrist back and forth Note that the motion has to be done long enough to count so a very quick flick of the wrist will not workTurn On muted ndash double-click power buttonNext preset ndash while saber is off click the AUX buttonPrevious preset ndash hold AUX button and click the Activation buttonTrigger Clash ndash while saber is on hit the bladeTrigger Lockup ndash while saber is on hold Activation button then trigger a clash Lockup releases when you let go of the Acti-vation buttonTrigger Drag ndash like lockup but point saber mostly down before holding Activation buttonTrigger Force ndash long-click AUX buttonStart soundtrack ndash long-click the Activation buttonTrigger Blaster Block ndash while saber is on short-click AUX button

Serial Monitor commands

battery_voltage ndash gets current battery voltage valueget_volume ndash get current volume valuepow ndash power OnOff the saberon ndash power On the saberoff ndash power Off the saberset_volume lt0-3000gt ndash set volume value (example set_volume 500)play ndash play the default preset trackplay trackslttrack namegt ndash play a specific track from tracks folder (example play tracksvenuswav)stop ndash stop the playing trackforce ndash play ldquoforcerdquo sound effectsdrag ndash play ldquodragrdquo sound effectsblast ndash play ldquoblasterrdquo sound effectslock ndash play ldquolockuprdquo sound effectsclash ndash play ldquoclashrdquo sound effectsreset ndash reboot the boardn ndash switch to next presetp ndash switch to previous presetlist_presets ndash show all presetssdtest ndash test SD card speed

40 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3FIRMWARE UPLOAD AND UPDATE2

Software installation and setup

PROFFIEBOARD INSTRUCTIONS

To upload firmware to ProffieBoard Arduino IDE program is required Follow these steps to install it to your PC

1 Install latest Arduino IDE software (donrsquot use BETA)

Installing as Windows app also is not recommended

because it will be installed in a specific protected folder that

wonrsquot allow you to install any additional softwareplugin in it

If ProffieBoard wonrsquot show up in COM port use

Arduino IDE 186 version

2 Install the Proffieboard Arduino Plugin and Zadig software

Follow installation instructions

3 Select Proffieboard-STM32L433 in Tools -gt Board

USB Type ndash Serial CPU Speed ndash 80 MHz Optimize ndash Smallest Code DOSFS ndash SDCARD (SPI) Port ndash COM(the number your PC assigned) (Butterfly-L433CC)

Connect Proffieboard via USB cable to PC to be able to select

the Port

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 41

3FIRMWARE UPLOAD AND UPDATE2

Uploading firmware

PROFFIEBOARD INSTRUCTIONS

1 Download the ProffieBoard firmware and SD card content

Unzip lightsaber-1286zip to your Documents directory or to

Desktop but not to Arduino program folder or anywhere in

Programs directory where all programs are installed You will

see a lightsaber folder and files inside it Donrsquot move any of

these files to any other location outside the lightsaber folder

and donrsquot reorganize them Unzip ProffieOS_SD_Cardzip to the

folder where you keep lightsaber-1286 folder Copy all files

from ProffieOS_SD_Card folder to your SD card

2 Unhide file extensions in File Explorer settings to see h ending

of config files Donrsquot add ldquohrdquo to the config file name Go to config folder and create you own configh file (see page

42 for how-to)

Double-click the lightsaberino file

3 Add the name of your configh file as shown and Save this

lightsaberino file Make sure the other config files are

commented out there should be only one CONFIG_FILE

without You can have multiple config files

in lightsabergtconfig folder and just define the one you need

in lightsaberino file and upload it again to ProffieBoard

4 Connect battery to ProffieBoard and hook up to your PC

with a data transfer micro-USB-to-USB cable

Press arrow button it will compile and upload firmware to the

board Wait for red text progress bars to stop at 100

ProffieBoard will play boot sound if speaker is connected

Now you can unplug the USB cable Done

If it gives an error instead this means your configh file has

issues define CONFIG_FILE name has mistakes configh file

is out of config folder your PC user name is non-latin

42 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

33

configh file structure editing

PROFFIEBOARD INSTRUCTIONS

CHANGING PARAMETERS

All sound files (sound fonts music tracks) are stored on the micro SD card Add required sound fonts folders (Plecter NEC and Smoothswing

fonts are supported no need to change WAV files names just copy and paste) to SD card root directory as itrsquos done in the default

ProffieOS_SD_Card content folder and music tracks to the tracks folder

Make sure to name all music tracks and sound fonts folders with latin characters and only up to 8 characters long without using any special

characters (like |[- etc)

Make sure you have a configini file in each sound font folder if there is none - copy one from some default TeensySaberProffieBoard sound

font and paste into newly added sound font folder It has only one parameter that you can modify - humstart It helps to match hum sound

start with blade ignition 1000 usually works fine

All blade effects LED configuration volume level clash sensitivity etc are changed in the configh file located in lightsabergtconfig folder

To do that open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text Editor (Notepad - to see code correctly in Notepad

Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all text) and Delete it then Copy-and-Paste (Ctrl+C

Ctrl+V) your wiring diagram config code into empty _configh file and Save it under new name Follow the instructions on page 39 to

upload it to the board

Proffieboard config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)

volume level (0-3000)

clash sensitivity (adjust lower or higher with 01 step)

sound font folder nametrack name

Preset name

Blade style

LED configuration (use these XP-E2 LED templatesto define your LED)

for Red use 1 Ohm resistor for Green - no resistor for Blue use 024 Ohm

NoLED ndash no 4th led used

Preset 1

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 43

33

Blade Styles

StylePtrltInOutHelperltSimpleClashltLockupltBlastltOnSparkltAudioFlickerltRgblt02550gtRgblt501000gtgtRgblt2552550gt150gtRgblt255500gtgtAudioFlickerltRgblt1002550gtRgblt2550150gtgtgtRgblt255100150gt40gt200300Blackgtgt

ndash this is how the Blade Style code looks pasted in the configh file Preset (it sits inside a StylePtrltgt container)

ndash this is how the Blade Style code looks when editing it inside a Blade Style Editor

Each Blade Style is made of a variety of Effects each added effect goes instead of a base color in the previous effect

PROFFIEBOARD INSTRUCTIONS

CHANGING PARAMETERS

ProffieBoard and TeensySaber use Blade Styles for the main saber blade and any other accent leds to define all light effects (color changing

flashes flickering delays ignitionretraction timing etc)

Use Blade Style Editor to create and adjust Blade Styles Megtooth Sith Sabers did a great video tutorial where he shows and explains

how to use Blade Style Editor Also you can grab some pre-made Blade Styles or share yours here on TRA forums

A Blade Style example of simple flickering Green blade with Spark on start Clash Blaster Lockup and Drag IgnitionRetraction effects

InOutHelperltSimpleClashltLockupltBlastltOnSparkltAudioFlickerltRgblt02550gtRgblt501000gtgtRgblt2552550gt150gtRgblt255500gtgtAudioFlickerltRgblt1002550gtRgblt2550150gtgtgtRgblt255100150gt40gt200300Blackgt

InOutHelperltbase color200300Blackgt ndash base color can be defined by words (WHITE RED GREEN PURPLE etc) or by Rgblt0-2550-2550-255gt values for more

custom shades 200 is extension length in milliseconds 300 is retraction length in milliseconds Black is color when retracted (also can be any other color)

SimpleClashltbase colorclash color40gt ndash clash effect 40 is clash duration in milliseconds

Lockupltbase colorlockup colorgt ndash lockup effect

Blastltbase colorblast colorgt ndash blaster effect

OnSparkltbase colorspark color150gt ndash spark on ignition effect 150 is spark duration in milliseconds

AudioFlickerltrdquoArdquo colorrdquoBrdquo colorgt ndash flickering effect (blade flickers to the actual saber hum sound) the more difference between ldquoArdquo and ldquoBrdquo colors - the more

abrupt is flickering

Rgblt255500gt ndash actual color in RGB format (0 is no light 255 is the maximum brightness value for Red Green or Blue channel)

44 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

ndash SanDisk 4GB microSDHC Class 4 (Genuine) ndash SanDisk 4GB microSDHC Class 4 (Genuine)

130238 kbs = 1477 simultaneous audio streams 137812 kbs = 1562 simultaneous audio streams

ndash Patriot LX Series 16GB microSDHC UHS-IU1 Class 10 ndash Patriot LX Series 16GB microSDHC UHS-IU1 Class 10

133005 kbs = 1508 simultaneous audio streams

ndash GSkill 16GB microSDHC UHS-IU1 Class 10 ndash GSkill 16GB microSDHC UHS-IU1 Class 10

129534 kbs = 1469 simultaneous audio streams

ndash Kingston 16GB microSDHC UHS-IU1 Class 10 ndash Kingston 16GB microSDHC UHS-IU1 Class 10

128090 kbs = 1452 simultaneous audio streams

ndash SanDisk Ultra 16GB microSDHC UHS-IU1 A1 Class 10 ndash SanDisk Ultra 16GB microSDHC UHS-IU1 A1 Class 10

102663 kbs = 1164 simultaneous audio streams 11124 kbs = 1261 simultaneous audio streams

ndash SanDisk 8GB microSDHC Class 4 ndash SanDisk 8GB microSDHC Class 4

108506 kbs = 1230 simultaneous audio streams

ndash SanDisk 16GB microSDHC Class 4 ndash SanDisk 16GB microSDHC Class 4

102663 kbs = 1164 simultaneous audio streams 106957 kbs = 1213 simultaneous audio streams

ndash SanDisk Ultra 16GB microSDHC UHS-IU1 Class 10 ndash SanDisk Ultra 16GB microSDHC UHS-IU1 Class 10

102663 kbs = 1164 simultaneous audio streams 103909 kbs = 1178 simultaneous audio streams

ndash Smartbuy 4GB microSDHC Class 4 ndash Smartbuy 4GB microSDHC Class 4

75437 kbs = 855 simultaneous audio streams

ndash Kingston 8GB microSDHC Class 4 ndash Kingston 8GB microSDHC Class 4

75209 kbs = 822 simultaneous audio streams

ndash SanDisk 4GB microSDHC Class 4 (Fake) ndash SanDisk 4GB microSDHC Class 4 (Fake)

677 kbs = 769 simultaneous audio streams

Here is a list of tested micro SD cards speed with TeensySaber V3 and ProffieBoard Any card with speed over 900 kbs is recommended the

higher the speed is ndash the better Memory size of 4-16Gb is more than enough Cards were tested with a default firmware (1291) compiled

with ldquoSmallest Coderdquo under Optimize ldquodefault_proffieboard_confighrdquo file and default ProffieOS SD card sound files (7 folders)

To test your SD card speed simply hook up ProffieBoard to PC open Arduino IDE go to Tools and open Serial Monitor make sure you have

New Line and 9600 baud rate selected on the bottom of Serial Monitor window type and send sdtest command wait for the test result

4Recommended micro SD cards

BEST

TEENSYSABER PROFFIEBOARD

GOOD

BAD

PROFFIEBOARD INSTRUCTIONS

SD CARD RECOMMENDATIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 45

There are a lot of fake (chinese copies) microSD cards on the market from aliexpress ebay amazon etc They look very similar to genuine

cards but are a bit different though and have a twice lower writingreading speed Here is an example of a SanDisk 4Gb Class 4 card one is

genuine with 137812 kbs speed and the other one is fake with 677 kbs speed I got from ebay seller

Be carefull and pay attention to how the actual card looks if you are not sure ask seller for the real photo of SD card he sells

4Genuine and Fake SanDisk 4Gb Class 4 microSD

PROFFIEBOARD INSTRUCTIONS

SD CARD RECOMMENDATIONS

46 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

WIRE GAUGE GUIDE

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 47

RECHARGE PORTS AND KILL SWITCHES

48 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

NEOPIXEL STRIPS CURRENT DRAW

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 49

6TROUBLESHOOTING

For more help please check these linksProffieOSProffieBoardTeensySaber wiki on GitHubAsk your question on The Rebel Armory forumsAsk your question on FX-sabers forumsAsk your question in facebook group

How to solve most common issues

Quick troubleshooting tips

TeensySaber board or Proffieboard is not recognized by computer (nothing under Port selection in Arduino)

ndash Make sure a charged 37V battery is connected to the board micro-USB cable is a data transfer cable all plugins and drivers are installed ndash

check again pages 21 for TeensySaber or 40 for Proffieboard Try a different USB port on your computer

Sketch (code) compile error in Arduino IDE

ndash Check your define CONFIG_FILE ldquoconfig_confighrdquo line in opened lightsaberino file if itrsquos written correctly with config in it

Sketch (code) compile error in Arduino IDE

ndash Check if the _configh file you defined in the lightsaberino sketch file is same name as in the lightsaber-rdquofirmware versionrdquolightsaber

config folder and is located in this folder

Sketch (code) compile error in Arduino IDE

ndash Check your settings under Tools tab in Arduino IDE program Check again pages 21 for TeensySaber or 40 for Proffieboard

Sketch (code) compile error in Arduino IDE

ndash Check if your _configh file is correct Blade Styles Presets const unsigned int maxLedsPerStrip = 144 if BladeConfig blades[] = is correct

Sketch (code) compile error in Arduino IDE

ndash If nothing helps install Arduino IDE version 186 and try to compile and upload the firmware again

Sound doesnrsquot play

ndash Remove SD card and insert again check speaker wiring Make sure all sound files on SD card are correctly named (8 characters max long)

Re-format SD card in FAT32 load sound files and try again try another SD card

Board says ldquoLOW POWERrdquo

ndash Charge the battery

Serial Monitor shows info sent by the board but your commands donrsquot work

ndash In the bottom right corner of Serial Monitor window make sure the Line Ending drop down is set to New Line

Sound is weird and distorted

ndash Check your SD card speed (see page 44) Check speaker wiring try another good speaker

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 03

Specifications and features

ndash ProffieBoard specific ndash Dimensions 179x346x57mm (with micro USB port and micro SD card)

ndash ProffieBoard specific ndash Single pcb board design

ndash TeensySaber V3 specific ndash Dimensions 18x395x9mm (with micro USB port and micro SD card)

ndash TeensySaber V3 specific ndash 2-pcb boards stack design

ndash 100 Open-Source you may add any feature you like (GPLv3)

ndash Power supply 26-45 Volts up to 10A per LED output 1-6 single Li-Ion 36-37V (low 26V full 42V) battery recommended

ndash Speaker 4 ohm or 8 ohm 2W (with lower volume) or 3-5W (recommended)

ndash Unlimited amount of sound banksfonts supports regular (Plecter NEC) and ldquoSmoothswingrdquo sound fonts

ndash Sound FX (WAV sound files) boot blaster blocking lockup hum swing clash drag font force ingnition retraction

ndash Light FX blade flickering pulsing flash on clash drag stab blaster blocking lockup and other

ndash Music tracks (WAV sound files) playback in idle mode and saber sound effects background

ndash Micro SD card 4-16Gb Class 4-10 by SanDisk brand recommended

ndash Support for remote control via bluetooth (with external bluetooth module addon)

ndash Speedy 32-bit processor for advanced features like sound filters synthesizing and mp3 playback

ndash 3 Watts sound amplifier 16-bit digital output (12-bit for TeensySaber V1 and V2)

ndash Sample rate is 44kHz (default) 22kHz and 11kHz are supported and upsampled to 44kHz automatically

ndash Gapless playback with 25ms cross-fade when you interrupt one sample to go to another

ndash Polyphonic playback currently configured for up to 5 simultaneous samples

ndash ldquoSmoothswingrdquo algorithm support (a new more natural swing motion sounds playback)

ndash PL9823 (RGB) WS2812B (GRB) SK6812 (GRB WWA) Neopixel support

ndash 1234-color LED stars (Tri-Cree and Quad (also RGBA) LED modules)

ndash Segmented (6 segments + Flash string) classic string blades support

ndash Multi-blade support for dual and crossguard setups

ndash Blade LED type Presets and Blade Styles selection by different values of a resistor (Blade ID functions)

ndash Crystal chamber support

ndash Power-level indicator with neopixel blade

ndash OLED PLI and FONT animations display

ndash sound files upload to SD card via USB cable directly from PC (only from firmware version 1291 and up)

ndash POV (persistance of vision) mode support

ndash Accent LEDs support (also implemented as additional ldquobladesrdquo)

ndash Spoken error and low battery messages

ndash Easy and free firmware updates by user

Demonstration videos

Link to the demonstration video by K-SithLink to the demonstration video by Megtooth Sith SabersLink to the demonstration video by Zimmer LabsLink to the demonstration video by ShtokCustomWorx

FEATURES

04 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

1HELPFUL LINKS

TeensySaber V3 boards

Send a message to this guy

Other parts links

RGB Neopixel strips (they are SK6812 though sellers list them as WS2812b)WWA (WhiteWhiteAmber) Neopixel strips SK6812 Source 1WWA (WhiteWhiteAmber) Neopixel strips SK6812 Source 2Individual Neopixel LEDsNeopixel stripsconnectorsother supplies (UK) ndash TheSaberArmoryTri-Cree high power LEDs (CanadaUSA) ndash TheCustomSaberShopTri-Cree high power LEDs (UK) ndash TheSaberArmoryVarious Accent LEDs (UK) ndash TheSaberArmoryVarious Batteries (UK) ndash TheSaberArmoryProtected KeepPower 18650 10A 3500mAh batteryProtected KeepPower 18650 15A 3120mAh batteryUnprotected Vapcell 21700 15A 5000mAh battery ndash requires external PCMUnprotected KeepPower 26650 15A 6000mAh battery ndash requires external PCM15A Protection Circuit Module (PCM)18650 Protected Battery holderHigh Power 13mm Recharge PortRecharge Ports (UK) ndash TheSaberArmoryHigh Power Kill SwitchVarious Switches (UK) ndash TheSaberArmorySCW Neopixel blade Pogo connectorTCSS Neopixel blade Pogo connectorGX16 Neopixelstring blade connectorsVarious Speakers (UK) ndash TheSaberArmory Various Speakers (UK) ndash JQ-sabersVarious Speakers (CanadaUSA) ndash TheCustomSaberShop2W and 3W Speakers ndash Saber Essentials4W Speakers ndash ebay

3D-printed chassis links

ShtokCustomWorx on ShapewaysGOTH-3Designs on Shapeways

Where to buy

ProffieBoards

TheSaberArmory (KR-sabers) UK storeJQ-sabers UK storeSaberBay Etsy USA storeShtokCustomWorx Etsy RUS store (not opened yet)

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 05

1HELPFUL LINKS

Video tutorials by Megtooth Sith Sabers

Video tutorials by Megtooth Sith Sabers on youtubeLED Resistor Calculator

For more information please check these links

TeensySaber V3 sound board instructionsProffieBoard sound board instructionsrdquoBlade style sharingrdquo - here you can find and share custom blade stylesWeb Blade Style Editor 1 (default)Web Blade Style Editor 2 (restyle)Here you can get regular (Plecter NEC) or ldquoSmoothswingrdquo sound fontsProffieOSProffieBoardTeensySaber wiki on GitHubProfezzornrsquos Lab on The Rebel Armory forumsProfezzornrsquos Lab on FX-sabers forumsAsk your question in facebook group

Get latest ProffieOS firmware

Tutorials and instructions

06 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

Board pinout

used pads

Battery + ndash 26 to 45 volt input drives everything except the LEDs

Battery - ndash negative pad for LEDs needs to be at same level as GND when both are connected

GND ndash ground for electronics except LEDs Note that GND is also available on short edge of the teensy (See the teensy pinout for details)

Speaker +- ndash hooks up to speaker

Activation Aux Aux2 button ndash hook up to closing buttons or potentially touch buttons

Blade ID Neopixel Data 1 ndash normally used to measure the blade ID restor and if itrsquos a neopixel blade feed out neopixel data

LED 1 2 3 ndash hooks up to negative side of LED (positive side of LED hooks up directly to battery) These pads can handle

up to 30 volts

LED 4 5 6 ndash like LED123 but requires FETs to be placed on the bottom of the board to function Voltage is limited by

selection of FETs

Power 1 Power 2 Power 3 ndash these control the FETs which drive LED 1 2 3

AUX LED 1 2 3 ndash these are hooked up to pads on the bottom which can be populated with FETs and used to drive additional LEDs If the

bottom FETs are not populated these pins are free and can be used for any purpose

RX3 TX3 ndash these pins are used for wiring a bluetooth module for wireless control or additional Neopixel Data out

SDA SCL ndash these pins are used to wire OLED display

+33V 250mA max ndash generated by the Teensy for powering OLED display or Bluetooth module

micro USB port ndash micro USB port used only for firmware upload and can be used for sound files upload to SD card

THIS PORT ISNrsquoT USED FOR CHARGING THE BATTERY

LED output 1 2 3

Battery - Speaker + (red dot or ldquo+rdquo mark on speaker)Battery +

Data in (SD) SCK (SD)

Battery Volt SenseAux button

Activation buttonAux2 button

SDA

SCL

Blade ID Neopixel Data 1Audio data

Audio LRClock

Power 3+33VAudio GND (not used)+5V

Data out (SD)

Power 2

Audio clock

TX3Neopixel Data 2

RX3Neopixel Data 3

Power 1AUX3 LEDAUX2 LEDAUX1 LED

Motion InterruptAmplifier enable

SD card selectGND

Speaker -

LED output 4 5 6

micro USB port on Teensy 32

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 07

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

Board assembling

1 IMPORTANT

Cut the tiny trace with a knife between VIN and VUSB as shown

Teensy 32 bottom view

2 Solder 254mm header pins (gold plated recommended) to

TeensySaber V3 board on the top or on the bottom depending

on where you want to put Teensy 32 board

(please see next step)

3 Solder Teensy 32 board on top

(A ndash micro USB port on top SD card between boards) or on the bottom (B ndash SD card on top micro USB port between boards)

A B

+

08 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

Basic Tri-Cree wiring diagram(In-hilt LED)

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

+

+

+

-

-

-

26 A

WG

26 AWG

30-32 AWG

28-30 AWG

28-30 AWG

30-32 AWG

Protected 36-37V (42V max at full charge) 10A 3500mAh battery recommended+18650 battery holder (optional)Keystone 1042P

AV switch with accent led(constantly ON no effects)

accent leds run mostly at10-15mA so resistors for them must be calculated accordingly

Main RGB led

additional RGB leds(optional)

In case no additional high power leds are needed LED channels 4 5 6can be used for 3 controllable (programmable for different effects) accent leds So AV switch led can be wired to one of these channelsby adding 1 MOSFET

LED Resistor Calculator

solder 3x FETs

solder 1 FET

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 09

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

Basic Tri-Cree wiring (In-hilt LED)ldquoconfighrdquo file setup

Use a given or build your wiring diagram on THIS PAGE then open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text

Editor (Notepad - to see code correctly in Notepad Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all

text) and Delete it then Copy-and-Paste (Ctrl+C Ctrl+V) your wiring diagram config code (example below) into empty _configh file and

Save it under new name Follow the instructions on page 22 to upload it to the board

ldquov3_confighrdquoNUM_BLADES 2NUM_BUTTONS 2VOLUME 1000CLASH_THRESHOLD_G 10StyleNormalPtrltCYAN WHITE 300 800gt()StyleNormalPtrltCYAN WHITE 300 800gt()

CreeXPE2RedTemplatelt1000gtCreeXPE2GreenTemplatelt0gtCreeXPE2BlueTemplatelt240gtNoLED

TeensySaber V3 config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)Volume level (0-3000)Clash sensitivity (adjust lower or higher with 01 step)ldquoBlade 1rdquo styleldquoBlade 2rdquo style (in case only 1 blade is used you donrsquot need this line)LED configuration (use these XP-E2 LED templatesto define your LED If other LED resistors are used change these values to match Ohm1000=ltvaluegt)

where 1000 is 1 Ohm resistor 0 is no resistor240 is 024 Ohm resistorNoLED ndash no 4th led used

Preset 1

LED 1 configuration

LED 2 configuration

Preset 2 etc

10 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

Basic Neopixel wiring diagram

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

+

+

+

-

-

-

22 A

WG

22 AWG

26 AWG

30 AWG

x2 28 AWG

x2 26 AWG

22 A

WG

30-32 AWG

30-32 AWG

Protected 36-37V (42V max at full charge) 10A 3500mAh or 15A 3120mAhbattery recommended+18650 battery holder (optional)Keystone 1042P

AV switch with accent led(constantly ON no effects)

accent leds run mostly at10-15mA so resistors for them must be calculated accordingly

Main Neopixel strip

additional Neopixelstrips(optional)

Neopixel bladeconnector

330 Ohm on the Blade pcb side

x3 28 AWGor x1 22 AWGfor Negative

330 Ohm on the Blade pcb side

arrows up

330 Ohm on the Blade pcb side

In case no additional Neopixel strips are needed LED channels 4 5 6can be used for 3 controllable (programmable for different effects) accent leds So AV switch led can be wired to one of these channelsby adding 1 MOSFETRecommended power wire gauges (22 AWG) are given for 2-strip blade For 3-strip blade you gonna need at least 20 AWG wires

solder 2x FETs

solder 1 FET

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 11

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

Basic Neopixel wiringldquoconfighrdquo file setup

ldquov3_confighrdquoNUM_BLADES 3NUM_BUTTONS 2VOLUME 1000CLASH_THRESHOLD_G 10IgnitionDelaylt0 any blade stylegtIgnitionDelaylt800 any blade stylegtIgnitionDelaylt800 any blade stylegtWS2811BladePtrlt118 WS2811 800kHz | WS2811 GRBgt()WS2811BladePtrlt26 7 ltbladePowerPin4gtgt()WS2811BladePtrlt26 8 ltbladePowerPin5gtgt()

TeensySaber V3 config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)Volume level (0-3000)Clash sensitivity (adjust lower or higher with 01 step)ldquoBlade 1rdquo style (main blade with IgnitionDelay 0)ldquoBlade 2rdquo style (CG blade 1 with IgnitionDelay 800)ldquoBlade 3rdquo style (CG blade 2 with IgnitionDelay 800)

strip configuration (defines how many pixels it has and to which LED output and pin is wired)

Preset 1

any blade style

strip (blade) 1 configuration

strip (blade) 2 configuration

strip (blade) 3 configuration

Preset 2 etc

Use a given or build your wiring diagram on THIS PAGE then open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text

Editor (Notepad - to see code correctly in Notepad Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all

text) and Delete it then Copy-and-Paste (Ctrl+C Ctrl+V) your wiring diagram config code (example below) into empty _configh file and

Save it under new name Follow the instructions on page 22 to upload it to the board

12 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

Basic Segmented string wiring diagram

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

+

+

-

-

24 A

WG

28 AWG

30-32 AWG

30-32 AWG

Protected 36-37V (42V max at full charge) 10A 3500mAh battery recommended+18650 battery holder (optional)Keystone 1042P

AV switch with accent led(constantly ON no effects)

accent leds run mostly at10-15mA so resistors for them must be calculated accordingly

6-segments string blade

FoC string

N-channel FET3A minimum

1

1 46 523

23456

Calculate resistors for each led segment of the blade string depending on which leds are used 5mm leds have max drive current around 25mA per led when 10mm leds can be 100mA and 200mA per ledSo pay attention to your led max current and Forward Voltage (Vf) when calculating a segment resistor resistence as well as its wattage Also choose wire gauges accordingly to meet segments and total blade max current draw level

LED Resistor Calculator

solder 3x FETs

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 13

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

Basic Segmented string wiringldquoconfighrdquo file setup

ldquov3_confighrdquoNUM_BLADES 1NUM_BUTTONS 2VOLUME 1000CLASH_THRESHOLD_G 10StyleNormalPtrltCYAN WHITE 300 800gt()ltBlue3mmLED 20 White3mmLEDgt

TeensySaber V3 config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)Volume level (0-3000)Clash sensitivity (adjust lower or higher with 01 step)Blade styleLED string configuration(here you mention the color and type of leds usedin the main blade string segments and FoC string20 is the FoC signal pin (Blade ID pin))

Preset

LED string configuration

Use a given or build your wiring diagram on THIS PAGE then open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text

Editor (Notepad - to see code correctly in Notepad Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all

text) and Delete it then Copy-and-Paste (Ctrl+C Ctrl+V) your wiring diagram config code (example below) into empty _configh file and

Save it under new name Follow the instructions on page 22 to upload it to the board

14 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

Accent LEDs wiring diagram(optional)

Accent LEDs work with TeensySaber board as additional ldquobladesrdquo when powered by LED outputs 4 5 6 with FETs So they can have any effect

that blade can have If no effects needed accent led can be powered just by a 33V output pad (power-on led indication)

30-32 AWGRGB ledcommon-anode

4 ldquobladesrdquo1 main and 3 accent leds

main blade style (effects) main blade style (effects)

3 accent leds style (effects)accent led style (effects)

3 accent leds configurations

RGB accent led configuration

2 ldquobladesrdquo1 main and 1 RGB accent led

ldquoPower-onrdquo indicationaccent leds (no effects)

3 accent leds withindependent effects

+ 1 or more simple accent leds without effects

1 RGB accent led+ 1 or more simple accent leds

without effects

a) b)

b)

c)

c)

solder 3x FETs solder 3x FETs

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 15

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

OLED display wiring diagram(optional)

SSD1306 128x32 pixels OLED display allows to show battery level current preset name play different animations and even simple games It

can be wired to any blade configuration and requires just one additional line in the code to work You can get monochrome display in white

or blue color

SSD1306128x32OLED

SSD1306 ndash with blue or white display color selectSSD1306 ndash cheaper priceSSD1306 just screen ndash blue or white select

30-32 AWG

30-32 AWG

add this line to enable OLED display

display shows a preset name written in these quotes ldquoldquo

16 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

Bluetooth module wiring diagram(optional)

SOON

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 17

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

Blade ID resistor functions(optional)

SOON

18 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

website TeensySaber V3 FULL wiring diagrams link

Scroll the page down till you see the interactive diagram Above the diagram there are components selection options Build your saber setup

with it and follow diagram to wire your board Then you need to copy the configuration code below and paste it into your _configh file

Choose components you want

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

More wiring diagrams

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 19

20 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

How to use it

Blade ignitionretraction ndash assuming you have at least one button pressing it briefly should turn the saber on or off If you have an AUX button pressing it briefly should also turn the saber on and off If you have no buttons you can turn the saber on and off by twisting your wrist back and forth Note that the motion has to be done long enough to count so a very quick flick of the wrist will not workTurn On muted ndash double-click power buttonNext preset ndash while saber is off click the AUX buttonPrevious preset ndash hold AUX button and click the Activation buttonTrigger Clash ndash while saber is on hit the bladeTrigger Lockup ndash while saber is on hold Activation button then trigger a clash Lockup releases when you let go of the Acti-vation buttonTrigger Drag ndash like lockup but point saber mostly down before holding Activation buttonTrigger Force ndash long-click AUX buttonStart soundtrack ndash long-click the Activation buttonTrigger Blaster Block ndash while saber is on short-click AUX button

Serial Monitor commands

battery_voltage ndash gets current battery voltage valueget_volume ndash get current volume valuepow ndash power OnOff the saberon ndash power On the saberoff ndash power Off the saberset_volume lt0-3000gt ndash set volume value (example set_volume 500)play ndash play the default preset trackplay trackslttrack namegt ndash play a specific track from tracks folder (example play tracksvenuswav)stop ndash stop the playing trackforce ndash play ldquoforcerdquo sound effectsdrag ndash play ldquodragrdquo sound effectsblast ndash play ldquoblasterrdquo sound effectslock ndash play ldquolockuprdquo sound effectsclash ndash play ldquoclashrdquo sound effectsreset ndash reboot the boardn ndash switch to next presetp ndash switch to previous presetlist_presets ndash show all presetssdtest ndash test SD card speed

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 21

2TEENSYSABER V3 INSTRUCTIONS

FIRMWARE UPLOAD AND UPDATE2

Software installation and setup

To upload firmware to TeensySaber board Arduino IDE program is required Follow these steps to install it to your PC

1 Install latest Arduino IDE software (donrsquot use BETA)

Installing as Windows app also is not recommended

because it will be installed in a specific protected folder that

wonrsquot allow you to install Teensyduino software in it

If TeensySaber wonrsquot show up in COM port use

Arduino IDE 186 version

2 Install latest Teensyduino software in same directory

usually itrsquos CProgram Files (x86)Arduino on Windows

Follow installation instructions for your system

3 Select Teensy 32 31 in Tools -gt Board

USB Type ndash Serial CPU Speed ndash 96 MHz (overclock) Optimize ndash Smallest Code Port ndash COM(the number your PC assigned) (Teensy 32) Serial

Connect TeensySaber via USB cable to PC to be able to select

the Port donrsquot forget to connect battery first

22 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

1 Download the TeensySaber firmware and SD card content

Unzip lightsaber-1286zip to your Documents directory or to

Desktop but not to Arduino program folder or anywhere in

Programs directory where all programs are installed You will

see a lightsaber folder and files inside it Donrsquot move any of

these files to any other location outside the lightsaber folder

and donrsquot reorganize them Unzip ProffieOS_SD_Cardzip to the

folder where you keep lightsaber-1286 folder Copy all files

from ProffieOS_SD_Card folder to your SD card

2 Unhide file extensions in File Explorer settings to see h ending

of config files Donrsquot add ldquohrdquo to the config file name

Go to config folder and create you own configh file (see page

23 for how-to)

Double-click the lightsaberino file

3 Add the name of your configh file as shown and Save this

lightsaberino file Make sure the other config files are

commented out there should be only one CONFIG_FILE

without You can have multiple config files

in lightsabergtconfig folder and just define the one you need

in lightsaberino file and upload it again to TeensySaber board

4 Connect battery to TeensySaber board and hook up to your PC

with a data transfer micro-USB-to-USB cable

Press arrow button it will compile and upload firmware to the

board Wait for your PC to make a sound or TeensySaber will

play boot sound if speaker is connected Now you can unplug

the USB cable Done

If it gives an error instead this means your configh file has

issues define CONFIG_FILE name has mistakes configh file

is out of config folder your PC user name is non-latin

2TEENSYSABER V3 INSTRUCTIONS

FIRMWARE UPLOAD AND UPDATE2

Uploading firmware

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 23

2TEENSYSABER V3 INSTRUCTIONS

CHANGING PARAMETERS3

Changing sound board parameters

All sound files (sound fonts music tracks) are stored on the micro SD card Add required sound fonts folders (Plecter NEC and Smoothswing

fonts are supported no need to change WAV files names just copy and paste) to SD card root directory as itrsquos done in the default

ProffieOS_SD_Card content folder and music tracks to the tracks folder

Make sure to name all music tracks and sound fonts folders with latin characters and only up to 8 characters long without using any special

characters (like |[- etc)

Make sure you have a configini file in each sound font folder if there is none - copy one from some default TeensySaberProffieBoard sound

font and paste into newly added sound font folder It has only one parameter that you can modify - humstart It helps to match hum sound

start with blade ignition 1000 usually works fine

All blade effects LED configuration volume level clash sensitivity etc are changed in the configh file located in lightsabergtconfig folder

To do that open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text Editor (Notepad - to see code correctly in Notepad

Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all text) and Delete it then Copy-and-Paste (Ctrl+C

Ctrl+V) your wiring diagram config code into empty _configh file and Save it under new name Follow the instructions on page 22 to

upload it to the board

TeensySaber V3 config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)

volume level (0-3000)

clash sensitivity (adjust lower or higher with 01 step)

sound font folder nametrack name

Preset name

Blade style

LED configuration (use these XP-E2 LED templatesto define your LED)

for Red use 1 Ohm resistor for Green - no resistor for Blue use 024 Ohm

NoLED ndash no 4th led used

Preset 1

24 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

31

PROFFIEBOARD INSTRUCTIONS

Whatrsquos needed

ndash ProffieBoard

ndash micro SD-card (see page 44 for recommendations)

ndash a USB micro SD-card reader (to load sound files from PC to micro SD card)

ndash micro USB data transfer cable (CABLES THAT SUPPORT ONLY CHARGING WONrsquoT WORK)

ndash wires of different gauges (32-20 AWG) (PTFE coated copper stranded wires recommended) heat shrink

ndash ESD safe soldering station solder wire flux etc

ndash pliers helping hands etc

ndash isopropyl alcohol to clean pads before soldering (helps solder to stick better)

ndash Digital Multimeter (VERY USEFUL)

ndash computer running Windows Linux or Mac OS with internet access

ndash 37V Li-Ion Protected rechargeable battery switches recharge port speaker LEDs resistors chassis etc

ndash Smart Li-Ion CC-CV (Constant Current - Constant Voltage mode) battery charger for 37V (42V) cells

ndash patience

WIRING DIAGRAMS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 25

31

PROFFIEBOARD INSTRUCTIONS

Board pinout

Battery + ndash 26 to 45 volt input drives everything except the LEDs

Battery - ndash negative pad for LEDs needs to be at same level as GND when both are connected Both pads are internally connected

GND ndash ground for electronics except LEDs Note that there are two GND pads on the board that are internally connected

Speaker +- ndash hooks up to speaker

Activation (1) Aux (2) Aux2 button (3) ndash hook up to closing buttons or potentially touch buttons

Blade ID Neopixel Data 1 ndash normally used to measure the blade ID restor and if itrsquos a neopixel blade feed out neopixel data

Data 2 3 4 5 ndash additional neopixel data outputs or free for other purposes

LED 1 2 3 4 5 6 ndash hooks up to negative side of LED (positive side of LED hooks up directly to battery) These pads can handle

up to 30 volts

SDA SCL ndash these pins are used to wire OLED display or to communicate with the gyro and accelerometer chip

RX TX ndash these pins are used for wiring a bluetooth module for wireless control

SWDCLK SWDIO ndash can be hooked up to a ST-LINK device and lets you debug programs running on the ProffieBoard

+5V ndash generated by the ProffieBoard normally itrsquos only ON when sound is playing

+33V ndash generated by the ProffieBoard for powering OLED display Bluetooth module or some accent leds

BOOT RESET ndash buttons to put the ProffieBoard in bootloader mode if uploading doesnrsquot work

micro USB port ndash micro USB port used only for firmware upload and can be used for sound files upload to SD card (from firmware version

1291 and up) THIS PORT ISNrsquoT USED FOR CHARGING THE BATTERY

LED 4LED 3

LED 2

LED 1

LED 5

LED 6

RESETBOOT

Battery - Battery -

Speaker + (red dot or ldquo+rdquo mark on speaker)

Battery +

Aux button (2)Activation button (1)

Aux2 button (3)

Blade ID Neopixel Data 1

Data 5

Data 4Data 3Data 2

+33V

SWDIO

SWDCLK

+5V

TXRX

GND

GND

Reset

Speaker -

SCLSDA

micro USB port

WIRING DIAGRAMS

26 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Basic Tri-Cree wiring diagram(In-hilt LED)

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

+

+

-

-

26 AWG

26 A

WG

30-32 AWG

28-30 AWG

28-3

0 A

WG

30-32 AWG

Protected 36-37V (42V max at full charge) 10A 3500mAh battery recommended+18650 battery holder (optional)Keystone 1042P

AV switch with accent led(constantly ON no effects)

accent leds run mostly at10-15mA so resistors for them must be calculated accordingly

Main RGB led

additional RGB leds(optional)

In case no additional high power leds are needed LED channels 4 5 6 can be used for 3 controllable(programmable for different effects) accent leds So AV switch led can be wired to one of these channelsAccent leds also can be wired to Data pads 1-5 please see ldquoAccent LEDs wiring and setuprdquo page

LED Resistor Calculator

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 27

3WIRING DIAGRAMS1

Basic Tri-Cree wiring (In-hilt LED)ldquoconfighrdquo file setup

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

Use a given or build your wiring diagram on THIS PAGE then open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text

Editor (Notepad - to see code correctly in Notepad Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all

text) and Delete it then Copy-and-Paste (Ctrl+C Ctrl+V) your wiring diagram config code (example below) into empty _configh file and

Save it under new name Follow the instructions on page 22 to upload it to the board

ldquoproffieboard_v1_confighrdquoNUM_BLADES 2NUM_BUTTONS 2VOLUME 1000CLASH_THRESHOLD_G 10StyleNormalPtrltCYAN WHITE 300 800gt()StyleNormalPtrltCYAN WHITE 300 800gt()

CreeXPE2RedTemplatelt1000gtCreeXPE2GreenTemplatelt0gtCreeXPE2BlueTemplatelt240gtNoLED

ProffieBoard config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)Volume level (0-3000)Clash sensitivity (adjust lower or higher with 01 step)ldquoBlade 1rdquo styleldquoBlade 2rdquo style (in case only 1 blade is used you donrsquot need this line)LED configuration (use these XP-E2 LED templatesto define your LED If other LED resistors are used change these values to match Ohm1000=ltvaluegt)

where 1000 is 1 Ohm resistor 0 is no resistor240 is 024 Ohm resistorNoLED ndash no 4th led used

Preset 1

LED 1 configuration

LED 2 configuration

Preset 2 etc

PROFFIEBOARD INSTRUCTIONS

28 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Basic Neopixel wiring diagram

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

+

+

-

-

22 A

WG

22 AWG

x2 28 AWG

x2 26 AWG

22 A

WG

30-32 AWG30-32 AWG

Protected 36-37V (42V max at full charge) 10A 3500mAh or 15A 3120mAhbattery recommended+18650 battery holder (optional)Keystone 1042P

AV switch with accent led(constantly ON no effects)

accent leds run mostly at10-15mA so resistors for them must be calculated accordingly

Main Neopixel strip

additional Neopixelstrips(optional)

Neopixel bladeconnector

330 Ohm on the Blade pcb side

x3 28 AWGor x1 22 AWGfor Negative

330 Ohm on the Blade pcb side

arrows up

330 Ohm on the Blade pcb side

In case no additional Neopixel strips are needed LED channels 4 5 6 can be used for 3 controllable(programmable for different effects) accent leds So AV switch led can be wired to one of these channelsAccent leds also can be wired to Data pads 2-5 please see ldquoAccent LEDs wiring and setuprdquo page

Recommended power wire gauges (22 AWG) are given for 2-strip blade For 3-strip blade you gonna need at least 20 AWG wires

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 29

ldquoproffieboard_v1_confighrdquo

3WIRING DIAGRAMS1

Basic Neopixel wiringldquoconfighrdquo file setup

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

NUM_BLADES 3NUM_BUTTONS 2VOLUME 1000CLASH_THRESHOLD_G 10IgnitionDelaylt0 any blade stylegtIgnitionDelaylt800 any blade stylegtIgnitionDelaylt800 any blade stylegtWS2811BladePtrlt118 WS2811 800kHz | WS2811 GRBgt()WS2811BladePtrlt26 blade2Pin ltbladePowerPin4gtgt()WS2811BladePtrlt26 blade3Pin ltbladePowerPin5gtgt()

ProffieBoard config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)Volume level (0-3000)Clash sensitivity (adjust lower or higher with 01 step)ldquoBlade 1rdquo style (main blade with IgnitionDelay 0)ldquoBlade 2rdquo style (CG blade 1 with IgnitionDelay 800)ldquoBlade 3rdquo style (CG blade 2 with IgnitionDelay 800)

strip configuration (defines how many pixels it has and to which LED output and pin is wired)

Preset 1

any blade style

strip (blade) 1 configuration

adjust this number to match your strips leds count

strip (blade) 2 configuration

strip (blade) 3 configuration

Preset 2 etc

Use a given or build your wiring diagram on THIS PAGE then open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text

Editor (Notepad - to see code correctly in Notepad Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all

text) and Delete it then Copy-and-Paste (Ctrl+C Ctrl+V) your wiring diagram config code (example below) into empty _configh file and

Save it under new name Follow the instructions on page 22 to upload it to the board

PROFFIEBOARD INSTRUCTIONS

30 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Basic Segmented string wiring diagram

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

+

+

-

-

24 A

WG

28 AWG

30-32 AWG30-32 AWG

Protected 36-37V (42V max at full charge) 10A 3500mAh battery recommended+18650 battery holder (optional)Keystone 1042P

AV switch with accent led(constantly ON no effects)

accent leds run mostly at10-15mA so resistors for them must be calculated accordingly

6-segments string blade

FoC string

N-channel FET3A minimum

123456

Calculate resistors for each led segment of the blade string depending on which leds are used 5mm leds have max drive current around 25mA per led when 10mm leds can be 100mA and 200mA per ledSo pay attention to your led max current and Forward Voltage (Vf) when calculating a segment resistor resistence as well as its wattage Also choose wire gauges accordingly to meet segments and total blade max current draw level

LED Resistor Calculator

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 31

ldquoproffieboard_v1_confighrdquo

3WIRING DIAGRAMS1

Basic Segmented string wiringldquoconfighrdquo file setup

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

NUM_BLADES 1NUM_BUTTONS 2VOLUME 1000CLASH_THRESHOLD_G 10StyleNormalPtrltCYAN WHITE 300 800gt()ltBlue3mmLED BladePin White3mmLEDgt

ProffieBoard config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)Volume level (0-3000)Clash sensitivity (adjust lower or higher with 01 step)Blade styleLED string configuration(here you mention the color and type of leds usedin the main blade string segments and FoC stringBladePin is the FoC signal pin (Blade ID pin))

Preset

LED string configuration

Use a given or build your wiring diagram on THIS PAGE then open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text

Editor (Notepad - to see code correctly in Notepad Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all

text) and Delete it then Copy-and-Paste (Ctrl+C Ctrl+V) your wiring diagram config code (example below) into empty _configh file and

Save it under new name Follow the instructions on page 22 to upload it to the board

PROFFIEBOARD INSTRUCTIONS

32 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Accent LEDs wiring diagram(optional)

Accent LEDs work with ProffieBoard as additional ldquobladesrdquo when powered by LED outputs 4 5 6 or Data pads 1 2 3 5 as PWM So they can

have any effect that blade can have If no effects needed accent led can be powered just by a 33V output pad (power-on led indication)

30-32 AWG

with Neopixel blade setup these 4 outputsdonrsquot work for regular accent leds

Recommended resistors to use for accent leds at 33V power source and 15mA drive

ndash 100 Ohm for Red (lt100000gt value in the code)ndash 13 Ohm for Green (lt13000gt value in the code)ndash 13 Ohm for Blue (lt13000gt value in the code)ndash 100 Ohm for Yellow (lt100000gt value in the code)ndash 20 Ohm for White (lt20000gt value in the code)

RGB ledcommon-anode

8 ldquobladesrdquo1 main and 7 accent leds

main blade style (effects) main blade style (effects)

7 accent leds style (effects)accent led style (effects)

7 accent leds configurations

RGB accent led configuration

2 ldquobladesrdquo1 main and 1 RGB accent led

ldquoPower-onrdquo indicationaccent leds (no effects)

7 accent leds withindependent effects

RGB accent led

a) b)

b)

c)

c)

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 33

3WIRING DIAGRAMS1

Neopixel Accent LEDs wiring diagram(optional)

With Neopixel setup additional neopixel leds or arrays can be used as accent leds There are 2 ways to wire them using additional Data

pins 2 3 4 5 or ldquoSub-bladesrdquo wiring with just 1 Data output pin Same way Neopixel connectors with on-board leds ca be wired

Option 1 ndash with extra Data pins

Main Blade

some accent leds

D1

D2

crystal leds

330 Ohm

330 Ohm

330 Ohm

main blade style (effects)

main blade 144 leds Data pin 1

accent leds blade style (effects)

accent leds ldquobladerdquo 4 leds Data pin 2

crystal leds blade style (effects)

crystal leds ldquobladerdquo 2 leds Data pin 3

3 ldquobladesrdquo1 main 1 accent leds array and 1 crystal leds array

PROFFIEBOARD INSTRUCTIONS

D3

follow arrows direction

34 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Neopixel Accent LEDs wiring diagram(optional)

PROFFIEBOARD INSTRUCTIONS

Main Blade

some accent leds

1

3

5678

2

4

D1

crystal leds

follow arrows direction

330 Ohm

330 OhmData signal

With this setup a single array of neopixel leds is separated into a couple of sub-blades with their own style configuration and behaviour This

is really usefull when you want to use only one data pin More about ldquoSub-bladesrdquo on ProffieOS wiki page

Option 2 ndash with ldquoSub-bladesrdquo

main blade style (effects)

main blade sub-blade 140 leds (7-146) but from 6 to 145 in the code

accent leds blade style (effects)

accent leds sub-blade 4 leds (1-4) but from 0 to 3 in the code

crystal leds blade style (effects)

146 leds total used

crystal leds sub-blade 2 leds (5-6) but from 4 to 5 in the code

update default 144 to a higher total value if you get all accent leds +Main blade gt 144 Example update to 146 if you have 2 crystal leds +4 accent leds + 140 Main blade leds = 146

3 ldquobladesrdquo 1 main 1 accent leds array and 1 crystal leds array

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 35

3WIRING DIAGRAMS1

OLED display wiring diagram(optional)

SSD1306 128x32 pixels OLED display allows to show battery level current preset name play different animations and even simple games It

can be wired to any blade configuration and requires just one additional line in the code to work You can get monochrome display in white

or blue color

SSD1306128x32OLED

SSD1306 ndash with blue or white display color selectSSD1306 ndash cheaper priceSSD1306 just screen ndash blue or white select

30-32 AWG

30-32 AWG

add this line to enable OLED display

display shows a preset name written in these quotes ldquoldquo

PROFFIEBOARD INSTRUCTIONS

36 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Bluetooth module wiring diagram(optional)

SOON

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 37

3WIRING DIAGRAMS1

Blade ID resistor functions(optional)

SOON

PROFFIEBOARD INSTRUCTIONS

38 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

website ProffieBoard FULL wiring diagrams link

Scroll the page down till you see the interactive diagram Above the diagram there are components selection options Build your saber setup

with it and follow diagram to wire your board Then you need to copy the configuration code below and paste it into your _configh file

Choose components you want

3WIRING DIAGRAMS1

More wiring diagrams

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 39

3WIRING DIAGRAMS1

How to use it

PROFFIEBOARD INSTRUCTIONS

Blade ignitionretraction ndash assuming you have at least one button pressing it briefly should turn the saber on or off If you have an AUX button pressing it briefly should also turn the saber on and off If you have no buttons you can turn the saber on and off by twisting your wrist back and forth Note that the motion has to be done long enough to count so a very quick flick of the wrist will not workTurn On muted ndash double-click power buttonNext preset ndash while saber is off click the AUX buttonPrevious preset ndash hold AUX button and click the Activation buttonTrigger Clash ndash while saber is on hit the bladeTrigger Lockup ndash while saber is on hold Activation button then trigger a clash Lockup releases when you let go of the Acti-vation buttonTrigger Drag ndash like lockup but point saber mostly down before holding Activation buttonTrigger Force ndash long-click AUX buttonStart soundtrack ndash long-click the Activation buttonTrigger Blaster Block ndash while saber is on short-click AUX button

Serial Monitor commands

battery_voltage ndash gets current battery voltage valueget_volume ndash get current volume valuepow ndash power OnOff the saberon ndash power On the saberoff ndash power Off the saberset_volume lt0-3000gt ndash set volume value (example set_volume 500)play ndash play the default preset trackplay trackslttrack namegt ndash play a specific track from tracks folder (example play tracksvenuswav)stop ndash stop the playing trackforce ndash play ldquoforcerdquo sound effectsdrag ndash play ldquodragrdquo sound effectsblast ndash play ldquoblasterrdquo sound effectslock ndash play ldquolockuprdquo sound effectsclash ndash play ldquoclashrdquo sound effectsreset ndash reboot the boardn ndash switch to next presetp ndash switch to previous presetlist_presets ndash show all presetssdtest ndash test SD card speed

40 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3FIRMWARE UPLOAD AND UPDATE2

Software installation and setup

PROFFIEBOARD INSTRUCTIONS

To upload firmware to ProffieBoard Arduino IDE program is required Follow these steps to install it to your PC

1 Install latest Arduino IDE software (donrsquot use BETA)

Installing as Windows app also is not recommended

because it will be installed in a specific protected folder that

wonrsquot allow you to install any additional softwareplugin in it

If ProffieBoard wonrsquot show up in COM port use

Arduino IDE 186 version

2 Install the Proffieboard Arduino Plugin and Zadig software

Follow installation instructions

3 Select Proffieboard-STM32L433 in Tools -gt Board

USB Type ndash Serial CPU Speed ndash 80 MHz Optimize ndash Smallest Code DOSFS ndash SDCARD (SPI) Port ndash COM(the number your PC assigned) (Butterfly-L433CC)

Connect Proffieboard via USB cable to PC to be able to select

the Port

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 41

3FIRMWARE UPLOAD AND UPDATE2

Uploading firmware

PROFFIEBOARD INSTRUCTIONS

1 Download the ProffieBoard firmware and SD card content

Unzip lightsaber-1286zip to your Documents directory or to

Desktop but not to Arduino program folder or anywhere in

Programs directory where all programs are installed You will

see a lightsaber folder and files inside it Donrsquot move any of

these files to any other location outside the lightsaber folder

and donrsquot reorganize them Unzip ProffieOS_SD_Cardzip to the

folder where you keep lightsaber-1286 folder Copy all files

from ProffieOS_SD_Card folder to your SD card

2 Unhide file extensions in File Explorer settings to see h ending

of config files Donrsquot add ldquohrdquo to the config file name Go to config folder and create you own configh file (see page

42 for how-to)

Double-click the lightsaberino file

3 Add the name of your configh file as shown and Save this

lightsaberino file Make sure the other config files are

commented out there should be only one CONFIG_FILE

without You can have multiple config files

in lightsabergtconfig folder and just define the one you need

in lightsaberino file and upload it again to ProffieBoard

4 Connect battery to ProffieBoard and hook up to your PC

with a data transfer micro-USB-to-USB cable

Press arrow button it will compile and upload firmware to the

board Wait for red text progress bars to stop at 100

ProffieBoard will play boot sound if speaker is connected

Now you can unplug the USB cable Done

If it gives an error instead this means your configh file has

issues define CONFIG_FILE name has mistakes configh file

is out of config folder your PC user name is non-latin

42 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

33

configh file structure editing

PROFFIEBOARD INSTRUCTIONS

CHANGING PARAMETERS

All sound files (sound fonts music tracks) are stored on the micro SD card Add required sound fonts folders (Plecter NEC and Smoothswing

fonts are supported no need to change WAV files names just copy and paste) to SD card root directory as itrsquos done in the default

ProffieOS_SD_Card content folder and music tracks to the tracks folder

Make sure to name all music tracks and sound fonts folders with latin characters and only up to 8 characters long without using any special

characters (like |[- etc)

Make sure you have a configini file in each sound font folder if there is none - copy one from some default TeensySaberProffieBoard sound

font and paste into newly added sound font folder It has only one parameter that you can modify - humstart It helps to match hum sound

start with blade ignition 1000 usually works fine

All blade effects LED configuration volume level clash sensitivity etc are changed in the configh file located in lightsabergtconfig folder

To do that open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text Editor (Notepad - to see code correctly in Notepad

Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all text) and Delete it then Copy-and-Paste (Ctrl+C

Ctrl+V) your wiring diagram config code into empty _configh file and Save it under new name Follow the instructions on page 39 to

upload it to the board

Proffieboard config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)

volume level (0-3000)

clash sensitivity (adjust lower or higher with 01 step)

sound font folder nametrack name

Preset name

Blade style

LED configuration (use these XP-E2 LED templatesto define your LED)

for Red use 1 Ohm resistor for Green - no resistor for Blue use 024 Ohm

NoLED ndash no 4th led used

Preset 1

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 43

33

Blade Styles

StylePtrltInOutHelperltSimpleClashltLockupltBlastltOnSparkltAudioFlickerltRgblt02550gtRgblt501000gtgtRgblt2552550gt150gtRgblt255500gtgtAudioFlickerltRgblt1002550gtRgblt2550150gtgtgtRgblt255100150gt40gt200300Blackgtgt

ndash this is how the Blade Style code looks pasted in the configh file Preset (it sits inside a StylePtrltgt container)

ndash this is how the Blade Style code looks when editing it inside a Blade Style Editor

Each Blade Style is made of a variety of Effects each added effect goes instead of a base color in the previous effect

PROFFIEBOARD INSTRUCTIONS

CHANGING PARAMETERS

ProffieBoard and TeensySaber use Blade Styles for the main saber blade and any other accent leds to define all light effects (color changing

flashes flickering delays ignitionretraction timing etc)

Use Blade Style Editor to create and adjust Blade Styles Megtooth Sith Sabers did a great video tutorial where he shows and explains

how to use Blade Style Editor Also you can grab some pre-made Blade Styles or share yours here on TRA forums

A Blade Style example of simple flickering Green blade with Spark on start Clash Blaster Lockup and Drag IgnitionRetraction effects

InOutHelperltSimpleClashltLockupltBlastltOnSparkltAudioFlickerltRgblt02550gtRgblt501000gtgtRgblt2552550gt150gtRgblt255500gtgtAudioFlickerltRgblt1002550gtRgblt2550150gtgtgtRgblt255100150gt40gt200300Blackgt

InOutHelperltbase color200300Blackgt ndash base color can be defined by words (WHITE RED GREEN PURPLE etc) or by Rgblt0-2550-2550-255gt values for more

custom shades 200 is extension length in milliseconds 300 is retraction length in milliseconds Black is color when retracted (also can be any other color)

SimpleClashltbase colorclash color40gt ndash clash effect 40 is clash duration in milliseconds

Lockupltbase colorlockup colorgt ndash lockup effect

Blastltbase colorblast colorgt ndash blaster effect

OnSparkltbase colorspark color150gt ndash spark on ignition effect 150 is spark duration in milliseconds

AudioFlickerltrdquoArdquo colorrdquoBrdquo colorgt ndash flickering effect (blade flickers to the actual saber hum sound) the more difference between ldquoArdquo and ldquoBrdquo colors - the more

abrupt is flickering

Rgblt255500gt ndash actual color in RGB format (0 is no light 255 is the maximum brightness value for Red Green or Blue channel)

44 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

ndash SanDisk 4GB microSDHC Class 4 (Genuine) ndash SanDisk 4GB microSDHC Class 4 (Genuine)

130238 kbs = 1477 simultaneous audio streams 137812 kbs = 1562 simultaneous audio streams

ndash Patriot LX Series 16GB microSDHC UHS-IU1 Class 10 ndash Patriot LX Series 16GB microSDHC UHS-IU1 Class 10

133005 kbs = 1508 simultaneous audio streams

ndash GSkill 16GB microSDHC UHS-IU1 Class 10 ndash GSkill 16GB microSDHC UHS-IU1 Class 10

129534 kbs = 1469 simultaneous audio streams

ndash Kingston 16GB microSDHC UHS-IU1 Class 10 ndash Kingston 16GB microSDHC UHS-IU1 Class 10

128090 kbs = 1452 simultaneous audio streams

ndash SanDisk Ultra 16GB microSDHC UHS-IU1 A1 Class 10 ndash SanDisk Ultra 16GB microSDHC UHS-IU1 A1 Class 10

102663 kbs = 1164 simultaneous audio streams 11124 kbs = 1261 simultaneous audio streams

ndash SanDisk 8GB microSDHC Class 4 ndash SanDisk 8GB microSDHC Class 4

108506 kbs = 1230 simultaneous audio streams

ndash SanDisk 16GB microSDHC Class 4 ndash SanDisk 16GB microSDHC Class 4

102663 kbs = 1164 simultaneous audio streams 106957 kbs = 1213 simultaneous audio streams

ndash SanDisk Ultra 16GB microSDHC UHS-IU1 Class 10 ndash SanDisk Ultra 16GB microSDHC UHS-IU1 Class 10

102663 kbs = 1164 simultaneous audio streams 103909 kbs = 1178 simultaneous audio streams

ndash Smartbuy 4GB microSDHC Class 4 ndash Smartbuy 4GB microSDHC Class 4

75437 kbs = 855 simultaneous audio streams

ndash Kingston 8GB microSDHC Class 4 ndash Kingston 8GB microSDHC Class 4

75209 kbs = 822 simultaneous audio streams

ndash SanDisk 4GB microSDHC Class 4 (Fake) ndash SanDisk 4GB microSDHC Class 4 (Fake)

677 kbs = 769 simultaneous audio streams

Here is a list of tested micro SD cards speed with TeensySaber V3 and ProffieBoard Any card with speed over 900 kbs is recommended the

higher the speed is ndash the better Memory size of 4-16Gb is more than enough Cards were tested with a default firmware (1291) compiled

with ldquoSmallest Coderdquo under Optimize ldquodefault_proffieboard_confighrdquo file and default ProffieOS SD card sound files (7 folders)

To test your SD card speed simply hook up ProffieBoard to PC open Arduino IDE go to Tools and open Serial Monitor make sure you have

New Line and 9600 baud rate selected on the bottom of Serial Monitor window type and send sdtest command wait for the test result

4Recommended micro SD cards

BEST

TEENSYSABER PROFFIEBOARD

GOOD

BAD

PROFFIEBOARD INSTRUCTIONS

SD CARD RECOMMENDATIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 45

There are a lot of fake (chinese copies) microSD cards on the market from aliexpress ebay amazon etc They look very similar to genuine

cards but are a bit different though and have a twice lower writingreading speed Here is an example of a SanDisk 4Gb Class 4 card one is

genuine with 137812 kbs speed and the other one is fake with 677 kbs speed I got from ebay seller

Be carefull and pay attention to how the actual card looks if you are not sure ask seller for the real photo of SD card he sells

4Genuine and Fake SanDisk 4Gb Class 4 microSD

PROFFIEBOARD INSTRUCTIONS

SD CARD RECOMMENDATIONS

46 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

WIRE GAUGE GUIDE

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 47

RECHARGE PORTS AND KILL SWITCHES

48 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

NEOPIXEL STRIPS CURRENT DRAW

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 49

6TROUBLESHOOTING

For more help please check these linksProffieOSProffieBoardTeensySaber wiki on GitHubAsk your question on The Rebel Armory forumsAsk your question on FX-sabers forumsAsk your question in facebook group

How to solve most common issues

Quick troubleshooting tips

TeensySaber board or Proffieboard is not recognized by computer (nothing under Port selection in Arduino)

ndash Make sure a charged 37V battery is connected to the board micro-USB cable is a data transfer cable all plugins and drivers are installed ndash

check again pages 21 for TeensySaber or 40 for Proffieboard Try a different USB port on your computer

Sketch (code) compile error in Arduino IDE

ndash Check your define CONFIG_FILE ldquoconfig_confighrdquo line in opened lightsaberino file if itrsquos written correctly with config in it

Sketch (code) compile error in Arduino IDE

ndash Check if the _configh file you defined in the lightsaberino sketch file is same name as in the lightsaber-rdquofirmware versionrdquolightsaber

config folder and is located in this folder

Sketch (code) compile error in Arduino IDE

ndash Check your settings under Tools tab in Arduino IDE program Check again pages 21 for TeensySaber or 40 for Proffieboard

Sketch (code) compile error in Arduino IDE

ndash Check if your _configh file is correct Blade Styles Presets const unsigned int maxLedsPerStrip = 144 if BladeConfig blades[] = is correct

Sketch (code) compile error in Arduino IDE

ndash If nothing helps install Arduino IDE version 186 and try to compile and upload the firmware again

Sound doesnrsquot play

ndash Remove SD card and insert again check speaker wiring Make sure all sound files on SD card are correctly named (8 characters max long)

Re-format SD card in FAT32 load sound files and try again try another SD card

Board says ldquoLOW POWERrdquo

ndash Charge the battery

Serial Monitor shows info sent by the board but your commands donrsquot work

ndash In the bottom right corner of Serial Monitor window make sure the Line Ending drop down is set to New Line

Sound is weird and distorted

ndash Check your SD card speed (see page 44) Check speaker wiring try another good speaker

04 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

1HELPFUL LINKS

TeensySaber V3 boards

Send a message to this guy

Other parts links

RGB Neopixel strips (they are SK6812 though sellers list them as WS2812b)WWA (WhiteWhiteAmber) Neopixel strips SK6812 Source 1WWA (WhiteWhiteAmber) Neopixel strips SK6812 Source 2Individual Neopixel LEDsNeopixel stripsconnectorsother supplies (UK) ndash TheSaberArmoryTri-Cree high power LEDs (CanadaUSA) ndash TheCustomSaberShopTri-Cree high power LEDs (UK) ndash TheSaberArmoryVarious Accent LEDs (UK) ndash TheSaberArmoryVarious Batteries (UK) ndash TheSaberArmoryProtected KeepPower 18650 10A 3500mAh batteryProtected KeepPower 18650 15A 3120mAh batteryUnprotected Vapcell 21700 15A 5000mAh battery ndash requires external PCMUnprotected KeepPower 26650 15A 6000mAh battery ndash requires external PCM15A Protection Circuit Module (PCM)18650 Protected Battery holderHigh Power 13mm Recharge PortRecharge Ports (UK) ndash TheSaberArmoryHigh Power Kill SwitchVarious Switches (UK) ndash TheSaberArmorySCW Neopixel blade Pogo connectorTCSS Neopixel blade Pogo connectorGX16 Neopixelstring blade connectorsVarious Speakers (UK) ndash TheSaberArmory Various Speakers (UK) ndash JQ-sabersVarious Speakers (CanadaUSA) ndash TheCustomSaberShop2W and 3W Speakers ndash Saber Essentials4W Speakers ndash ebay

3D-printed chassis links

ShtokCustomWorx on ShapewaysGOTH-3Designs on Shapeways

Where to buy

ProffieBoards

TheSaberArmory (KR-sabers) UK storeJQ-sabers UK storeSaberBay Etsy USA storeShtokCustomWorx Etsy RUS store (not opened yet)

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 05

1HELPFUL LINKS

Video tutorials by Megtooth Sith Sabers

Video tutorials by Megtooth Sith Sabers on youtubeLED Resistor Calculator

For more information please check these links

TeensySaber V3 sound board instructionsProffieBoard sound board instructionsrdquoBlade style sharingrdquo - here you can find and share custom blade stylesWeb Blade Style Editor 1 (default)Web Blade Style Editor 2 (restyle)Here you can get regular (Plecter NEC) or ldquoSmoothswingrdquo sound fontsProffieOSProffieBoardTeensySaber wiki on GitHubProfezzornrsquos Lab on The Rebel Armory forumsProfezzornrsquos Lab on FX-sabers forumsAsk your question in facebook group

Get latest ProffieOS firmware

Tutorials and instructions

06 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

Board pinout

used pads

Battery + ndash 26 to 45 volt input drives everything except the LEDs

Battery - ndash negative pad for LEDs needs to be at same level as GND when both are connected

GND ndash ground for electronics except LEDs Note that GND is also available on short edge of the teensy (See the teensy pinout for details)

Speaker +- ndash hooks up to speaker

Activation Aux Aux2 button ndash hook up to closing buttons or potentially touch buttons

Blade ID Neopixel Data 1 ndash normally used to measure the blade ID restor and if itrsquos a neopixel blade feed out neopixel data

LED 1 2 3 ndash hooks up to negative side of LED (positive side of LED hooks up directly to battery) These pads can handle

up to 30 volts

LED 4 5 6 ndash like LED123 but requires FETs to be placed on the bottom of the board to function Voltage is limited by

selection of FETs

Power 1 Power 2 Power 3 ndash these control the FETs which drive LED 1 2 3

AUX LED 1 2 3 ndash these are hooked up to pads on the bottom which can be populated with FETs and used to drive additional LEDs If the

bottom FETs are not populated these pins are free and can be used for any purpose

RX3 TX3 ndash these pins are used for wiring a bluetooth module for wireless control or additional Neopixel Data out

SDA SCL ndash these pins are used to wire OLED display

+33V 250mA max ndash generated by the Teensy for powering OLED display or Bluetooth module

micro USB port ndash micro USB port used only for firmware upload and can be used for sound files upload to SD card

THIS PORT ISNrsquoT USED FOR CHARGING THE BATTERY

LED output 1 2 3

Battery - Speaker + (red dot or ldquo+rdquo mark on speaker)Battery +

Data in (SD) SCK (SD)

Battery Volt SenseAux button

Activation buttonAux2 button

SDA

SCL

Blade ID Neopixel Data 1Audio data

Audio LRClock

Power 3+33VAudio GND (not used)+5V

Data out (SD)

Power 2

Audio clock

TX3Neopixel Data 2

RX3Neopixel Data 3

Power 1AUX3 LEDAUX2 LEDAUX1 LED

Motion InterruptAmplifier enable

SD card selectGND

Speaker -

LED output 4 5 6

micro USB port on Teensy 32

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 07

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

Board assembling

1 IMPORTANT

Cut the tiny trace with a knife between VIN and VUSB as shown

Teensy 32 bottom view

2 Solder 254mm header pins (gold plated recommended) to

TeensySaber V3 board on the top or on the bottom depending

on where you want to put Teensy 32 board

(please see next step)

3 Solder Teensy 32 board on top

(A ndash micro USB port on top SD card between boards) or on the bottom (B ndash SD card on top micro USB port between boards)

A B

+

08 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

Basic Tri-Cree wiring diagram(In-hilt LED)

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

+

+

+

-

-

-

26 A

WG

26 AWG

30-32 AWG

28-30 AWG

28-30 AWG

30-32 AWG

Protected 36-37V (42V max at full charge) 10A 3500mAh battery recommended+18650 battery holder (optional)Keystone 1042P

AV switch with accent led(constantly ON no effects)

accent leds run mostly at10-15mA so resistors for them must be calculated accordingly

Main RGB led

additional RGB leds(optional)

In case no additional high power leds are needed LED channels 4 5 6can be used for 3 controllable (programmable for different effects) accent leds So AV switch led can be wired to one of these channelsby adding 1 MOSFET

LED Resistor Calculator

solder 3x FETs

solder 1 FET

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 09

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

Basic Tri-Cree wiring (In-hilt LED)ldquoconfighrdquo file setup

Use a given or build your wiring diagram on THIS PAGE then open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text

Editor (Notepad - to see code correctly in Notepad Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all

text) and Delete it then Copy-and-Paste (Ctrl+C Ctrl+V) your wiring diagram config code (example below) into empty _configh file and

Save it under new name Follow the instructions on page 22 to upload it to the board

ldquov3_confighrdquoNUM_BLADES 2NUM_BUTTONS 2VOLUME 1000CLASH_THRESHOLD_G 10StyleNormalPtrltCYAN WHITE 300 800gt()StyleNormalPtrltCYAN WHITE 300 800gt()

CreeXPE2RedTemplatelt1000gtCreeXPE2GreenTemplatelt0gtCreeXPE2BlueTemplatelt240gtNoLED

TeensySaber V3 config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)Volume level (0-3000)Clash sensitivity (adjust lower or higher with 01 step)ldquoBlade 1rdquo styleldquoBlade 2rdquo style (in case only 1 blade is used you donrsquot need this line)LED configuration (use these XP-E2 LED templatesto define your LED If other LED resistors are used change these values to match Ohm1000=ltvaluegt)

where 1000 is 1 Ohm resistor 0 is no resistor240 is 024 Ohm resistorNoLED ndash no 4th led used

Preset 1

LED 1 configuration

LED 2 configuration

Preset 2 etc

10 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

Basic Neopixel wiring diagram

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

+

+

+

-

-

-

22 A

WG

22 AWG

26 AWG

30 AWG

x2 28 AWG

x2 26 AWG

22 A

WG

30-32 AWG

30-32 AWG

Protected 36-37V (42V max at full charge) 10A 3500mAh or 15A 3120mAhbattery recommended+18650 battery holder (optional)Keystone 1042P

AV switch with accent led(constantly ON no effects)

accent leds run mostly at10-15mA so resistors for them must be calculated accordingly

Main Neopixel strip

additional Neopixelstrips(optional)

Neopixel bladeconnector

330 Ohm on the Blade pcb side

x3 28 AWGor x1 22 AWGfor Negative

330 Ohm on the Blade pcb side

arrows up

330 Ohm on the Blade pcb side

In case no additional Neopixel strips are needed LED channels 4 5 6can be used for 3 controllable (programmable for different effects) accent leds So AV switch led can be wired to one of these channelsby adding 1 MOSFETRecommended power wire gauges (22 AWG) are given for 2-strip blade For 3-strip blade you gonna need at least 20 AWG wires

solder 2x FETs

solder 1 FET

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 11

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

Basic Neopixel wiringldquoconfighrdquo file setup

ldquov3_confighrdquoNUM_BLADES 3NUM_BUTTONS 2VOLUME 1000CLASH_THRESHOLD_G 10IgnitionDelaylt0 any blade stylegtIgnitionDelaylt800 any blade stylegtIgnitionDelaylt800 any blade stylegtWS2811BladePtrlt118 WS2811 800kHz | WS2811 GRBgt()WS2811BladePtrlt26 7 ltbladePowerPin4gtgt()WS2811BladePtrlt26 8 ltbladePowerPin5gtgt()

TeensySaber V3 config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)Volume level (0-3000)Clash sensitivity (adjust lower or higher with 01 step)ldquoBlade 1rdquo style (main blade with IgnitionDelay 0)ldquoBlade 2rdquo style (CG blade 1 with IgnitionDelay 800)ldquoBlade 3rdquo style (CG blade 2 with IgnitionDelay 800)

strip configuration (defines how many pixels it has and to which LED output and pin is wired)

Preset 1

any blade style

strip (blade) 1 configuration

strip (blade) 2 configuration

strip (blade) 3 configuration

Preset 2 etc

Use a given or build your wiring diagram on THIS PAGE then open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text

Editor (Notepad - to see code correctly in Notepad Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all

text) and Delete it then Copy-and-Paste (Ctrl+C Ctrl+V) your wiring diagram config code (example below) into empty _configh file and

Save it under new name Follow the instructions on page 22 to upload it to the board

12 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

Basic Segmented string wiring diagram

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

+

+

-

-

24 A

WG

28 AWG

30-32 AWG

30-32 AWG

Protected 36-37V (42V max at full charge) 10A 3500mAh battery recommended+18650 battery holder (optional)Keystone 1042P

AV switch with accent led(constantly ON no effects)

accent leds run mostly at10-15mA so resistors for them must be calculated accordingly

6-segments string blade

FoC string

N-channel FET3A minimum

1

1 46 523

23456

Calculate resistors for each led segment of the blade string depending on which leds are used 5mm leds have max drive current around 25mA per led when 10mm leds can be 100mA and 200mA per ledSo pay attention to your led max current and Forward Voltage (Vf) when calculating a segment resistor resistence as well as its wattage Also choose wire gauges accordingly to meet segments and total blade max current draw level

LED Resistor Calculator

solder 3x FETs

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 13

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

Basic Segmented string wiringldquoconfighrdquo file setup

ldquov3_confighrdquoNUM_BLADES 1NUM_BUTTONS 2VOLUME 1000CLASH_THRESHOLD_G 10StyleNormalPtrltCYAN WHITE 300 800gt()ltBlue3mmLED 20 White3mmLEDgt

TeensySaber V3 config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)Volume level (0-3000)Clash sensitivity (adjust lower or higher with 01 step)Blade styleLED string configuration(here you mention the color and type of leds usedin the main blade string segments and FoC string20 is the FoC signal pin (Blade ID pin))

Preset

LED string configuration

Use a given or build your wiring diagram on THIS PAGE then open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text

Editor (Notepad - to see code correctly in Notepad Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all

text) and Delete it then Copy-and-Paste (Ctrl+C Ctrl+V) your wiring diagram config code (example below) into empty _configh file and

Save it under new name Follow the instructions on page 22 to upload it to the board

14 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

Accent LEDs wiring diagram(optional)

Accent LEDs work with TeensySaber board as additional ldquobladesrdquo when powered by LED outputs 4 5 6 with FETs So they can have any effect

that blade can have If no effects needed accent led can be powered just by a 33V output pad (power-on led indication)

30-32 AWGRGB ledcommon-anode

4 ldquobladesrdquo1 main and 3 accent leds

main blade style (effects) main blade style (effects)

3 accent leds style (effects)accent led style (effects)

3 accent leds configurations

RGB accent led configuration

2 ldquobladesrdquo1 main and 1 RGB accent led

ldquoPower-onrdquo indicationaccent leds (no effects)

3 accent leds withindependent effects

+ 1 or more simple accent leds without effects

1 RGB accent led+ 1 or more simple accent leds

without effects

a) b)

b)

c)

c)

solder 3x FETs solder 3x FETs

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 15

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

OLED display wiring diagram(optional)

SSD1306 128x32 pixels OLED display allows to show battery level current preset name play different animations and even simple games It

can be wired to any blade configuration and requires just one additional line in the code to work You can get monochrome display in white

or blue color

SSD1306128x32OLED

SSD1306 ndash with blue or white display color selectSSD1306 ndash cheaper priceSSD1306 just screen ndash blue or white select

30-32 AWG

30-32 AWG

add this line to enable OLED display

display shows a preset name written in these quotes ldquoldquo

16 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

Bluetooth module wiring diagram(optional)

SOON

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 17

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

Blade ID resistor functions(optional)

SOON

18 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

website TeensySaber V3 FULL wiring diagrams link

Scroll the page down till you see the interactive diagram Above the diagram there are components selection options Build your saber setup

with it and follow diagram to wire your board Then you need to copy the configuration code below and paste it into your _configh file

Choose components you want

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

More wiring diagrams

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 19

20 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

How to use it

Blade ignitionretraction ndash assuming you have at least one button pressing it briefly should turn the saber on or off If you have an AUX button pressing it briefly should also turn the saber on and off If you have no buttons you can turn the saber on and off by twisting your wrist back and forth Note that the motion has to be done long enough to count so a very quick flick of the wrist will not workTurn On muted ndash double-click power buttonNext preset ndash while saber is off click the AUX buttonPrevious preset ndash hold AUX button and click the Activation buttonTrigger Clash ndash while saber is on hit the bladeTrigger Lockup ndash while saber is on hold Activation button then trigger a clash Lockup releases when you let go of the Acti-vation buttonTrigger Drag ndash like lockup but point saber mostly down before holding Activation buttonTrigger Force ndash long-click AUX buttonStart soundtrack ndash long-click the Activation buttonTrigger Blaster Block ndash while saber is on short-click AUX button

Serial Monitor commands

battery_voltage ndash gets current battery voltage valueget_volume ndash get current volume valuepow ndash power OnOff the saberon ndash power On the saberoff ndash power Off the saberset_volume lt0-3000gt ndash set volume value (example set_volume 500)play ndash play the default preset trackplay trackslttrack namegt ndash play a specific track from tracks folder (example play tracksvenuswav)stop ndash stop the playing trackforce ndash play ldquoforcerdquo sound effectsdrag ndash play ldquodragrdquo sound effectsblast ndash play ldquoblasterrdquo sound effectslock ndash play ldquolockuprdquo sound effectsclash ndash play ldquoclashrdquo sound effectsreset ndash reboot the boardn ndash switch to next presetp ndash switch to previous presetlist_presets ndash show all presetssdtest ndash test SD card speed

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 21

2TEENSYSABER V3 INSTRUCTIONS

FIRMWARE UPLOAD AND UPDATE2

Software installation and setup

To upload firmware to TeensySaber board Arduino IDE program is required Follow these steps to install it to your PC

1 Install latest Arduino IDE software (donrsquot use BETA)

Installing as Windows app also is not recommended

because it will be installed in a specific protected folder that

wonrsquot allow you to install Teensyduino software in it

If TeensySaber wonrsquot show up in COM port use

Arduino IDE 186 version

2 Install latest Teensyduino software in same directory

usually itrsquos CProgram Files (x86)Arduino on Windows

Follow installation instructions for your system

3 Select Teensy 32 31 in Tools -gt Board

USB Type ndash Serial CPU Speed ndash 96 MHz (overclock) Optimize ndash Smallest Code Port ndash COM(the number your PC assigned) (Teensy 32) Serial

Connect TeensySaber via USB cable to PC to be able to select

the Port donrsquot forget to connect battery first

22 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

1 Download the TeensySaber firmware and SD card content

Unzip lightsaber-1286zip to your Documents directory or to

Desktop but not to Arduino program folder or anywhere in

Programs directory where all programs are installed You will

see a lightsaber folder and files inside it Donrsquot move any of

these files to any other location outside the lightsaber folder

and donrsquot reorganize them Unzip ProffieOS_SD_Cardzip to the

folder where you keep lightsaber-1286 folder Copy all files

from ProffieOS_SD_Card folder to your SD card

2 Unhide file extensions in File Explorer settings to see h ending

of config files Donrsquot add ldquohrdquo to the config file name

Go to config folder and create you own configh file (see page

23 for how-to)

Double-click the lightsaberino file

3 Add the name of your configh file as shown and Save this

lightsaberino file Make sure the other config files are

commented out there should be only one CONFIG_FILE

without You can have multiple config files

in lightsabergtconfig folder and just define the one you need

in lightsaberino file and upload it again to TeensySaber board

4 Connect battery to TeensySaber board and hook up to your PC

with a data transfer micro-USB-to-USB cable

Press arrow button it will compile and upload firmware to the

board Wait for your PC to make a sound or TeensySaber will

play boot sound if speaker is connected Now you can unplug

the USB cable Done

If it gives an error instead this means your configh file has

issues define CONFIG_FILE name has mistakes configh file

is out of config folder your PC user name is non-latin

2TEENSYSABER V3 INSTRUCTIONS

FIRMWARE UPLOAD AND UPDATE2

Uploading firmware

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 23

2TEENSYSABER V3 INSTRUCTIONS

CHANGING PARAMETERS3

Changing sound board parameters

All sound files (sound fonts music tracks) are stored on the micro SD card Add required sound fonts folders (Plecter NEC and Smoothswing

fonts are supported no need to change WAV files names just copy and paste) to SD card root directory as itrsquos done in the default

ProffieOS_SD_Card content folder and music tracks to the tracks folder

Make sure to name all music tracks and sound fonts folders with latin characters and only up to 8 characters long without using any special

characters (like |[- etc)

Make sure you have a configini file in each sound font folder if there is none - copy one from some default TeensySaberProffieBoard sound

font and paste into newly added sound font folder It has only one parameter that you can modify - humstart It helps to match hum sound

start with blade ignition 1000 usually works fine

All blade effects LED configuration volume level clash sensitivity etc are changed in the configh file located in lightsabergtconfig folder

To do that open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text Editor (Notepad - to see code correctly in Notepad

Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all text) and Delete it then Copy-and-Paste (Ctrl+C

Ctrl+V) your wiring diagram config code into empty _configh file and Save it under new name Follow the instructions on page 22 to

upload it to the board

TeensySaber V3 config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)

volume level (0-3000)

clash sensitivity (adjust lower or higher with 01 step)

sound font folder nametrack name

Preset name

Blade style

LED configuration (use these XP-E2 LED templatesto define your LED)

for Red use 1 Ohm resistor for Green - no resistor for Blue use 024 Ohm

NoLED ndash no 4th led used

Preset 1

24 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

31

PROFFIEBOARD INSTRUCTIONS

Whatrsquos needed

ndash ProffieBoard

ndash micro SD-card (see page 44 for recommendations)

ndash a USB micro SD-card reader (to load sound files from PC to micro SD card)

ndash micro USB data transfer cable (CABLES THAT SUPPORT ONLY CHARGING WONrsquoT WORK)

ndash wires of different gauges (32-20 AWG) (PTFE coated copper stranded wires recommended) heat shrink

ndash ESD safe soldering station solder wire flux etc

ndash pliers helping hands etc

ndash isopropyl alcohol to clean pads before soldering (helps solder to stick better)

ndash Digital Multimeter (VERY USEFUL)

ndash computer running Windows Linux or Mac OS with internet access

ndash 37V Li-Ion Protected rechargeable battery switches recharge port speaker LEDs resistors chassis etc

ndash Smart Li-Ion CC-CV (Constant Current - Constant Voltage mode) battery charger for 37V (42V) cells

ndash patience

WIRING DIAGRAMS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 25

31

PROFFIEBOARD INSTRUCTIONS

Board pinout

Battery + ndash 26 to 45 volt input drives everything except the LEDs

Battery - ndash negative pad for LEDs needs to be at same level as GND when both are connected Both pads are internally connected

GND ndash ground for electronics except LEDs Note that there are two GND pads on the board that are internally connected

Speaker +- ndash hooks up to speaker

Activation (1) Aux (2) Aux2 button (3) ndash hook up to closing buttons or potentially touch buttons

Blade ID Neopixel Data 1 ndash normally used to measure the blade ID restor and if itrsquos a neopixel blade feed out neopixel data

Data 2 3 4 5 ndash additional neopixel data outputs or free for other purposes

LED 1 2 3 4 5 6 ndash hooks up to negative side of LED (positive side of LED hooks up directly to battery) These pads can handle

up to 30 volts

SDA SCL ndash these pins are used to wire OLED display or to communicate with the gyro and accelerometer chip

RX TX ndash these pins are used for wiring a bluetooth module for wireless control

SWDCLK SWDIO ndash can be hooked up to a ST-LINK device and lets you debug programs running on the ProffieBoard

+5V ndash generated by the ProffieBoard normally itrsquos only ON when sound is playing

+33V ndash generated by the ProffieBoard for powering OLED display Bluetooth module or some accent leds

BOOT RESET ndash buttons to put the ProffieBoard in bootloader mode if uploading doesnrsquot work

micro USB port ndash micro USB port used only for firmware upload and can be used for sound files upload to SD card (from firmware version

1291 and up) THIS PORT ISNrsquoT USED FOR CHARGING THE BATTERY

LED 4LED 3

LED 2

LED 1

LED 5

LED 6

RESETBOOT

Battery - Battery -

Speaker + (red dot or ldquo+rdquo mark on speaker)

Battery +

Aux button (2)Activation button (1)

Aux2 button (3)

Blade ID Neopixel Data 1

Data 5

Data 4Data 3Data 2

+33V

SWDIO

SWDCLK

+5V

TXRX

GND

GND

Reset

Speaker -

SCLSDA

micro USB port

WIRING DIAGRAMS

26 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Basic Tri-Cree wiring diagram(In-hilt LED)

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

+

+

-

-

26 AWG

26 A

WG

30-32 AWG

28-30 AWG

28-3

0 A

WG

30-32 AWG

Protected 36-37V (42V max at full charge) 10A 3500mAh battery recommended+18650 battery holder (optional)Keystone 1042P

AV switch with accent led(constantly ON no effects)

accent leds run mostly at10-15mA so resistors for them must be calculated accordingly

Main RGB led

additional RGB leds(optional)

In case no additional high power leds are needed LED channels 4 5 6 can be used for 3 controllable(programmable for different effects) accent leds So AV switch led can be wired to one of these channelsAccent leds also can be wired to Data pads 1-5 please see ldquoAccent LEDs wiring and setuprdquo page

LED Resistor Calculator

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 27

3WIRING DIAGRAMS1

Basic Tri-Cree wiring (In-hilt LED)ldquoconfighrdquo file setup

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

Use a given or build your wiring diagram on THIS PAGE then open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text

Editor (Notepad - to see code correctly in Notepad Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all

text) and Delete it then Copy-and-Paste (Ctrl+C Ctrl+V) your wiring diagram config code (example below) into empty _configh file and

Save it under new name Follow the instructions on page 22 to upload it to the board

ldquoproffieboard_v1_confighrdquoNUM_BLADES 2NUM_BUTTONS 2VOLUME 1000CLASH_THRESHOLD_G 10StyleNormalPtrltCYAN WHITE 300 800gt()StyleNormalPtrltCYAN WHITE 300 800gt()

CreeXPE2RedTemplatelt1000gtCreeXPE2GreenTemplatelt0gtCreeXPE2BlueTemplatelt240gtNoLED

ProffieBoard config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)Volume level (0-3000)Clash sensitivity (adjust lower or higher with 01 step)ldquoBlade 1rdquo styleldquoBlade 2rdquo style (in case only 1 blade is used you donrsquot need this line)LED configuration (use these XP-E2 LED templatesto define your LED If other LED resistors are used change these values to match Ohm1000=ltvaluegt)

where 1000 is 1 Ohm resistor 0 is no resistor240 is 024 Ohm resistorNoLED ndash no 4th led used

Preset 1

LED 1 configuration

LED 2 configuration

Preset 2 etc

PROFFIEBOARD INSTRUCTIONS

28 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Basic Neopixel wiring diagram

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

+

+

-

-

22 A

WG

22 AWG

x2 28 AWG

x2 26 AWG

22 A

WG

30-32 AWG30-32 AWG

Protected 36-37V (42V max at full charge) 10A 3500mAh or 15A 3120mAhbattery recommended+18650 battery holder (optional)Keystone 1042P

AV switch with accent led(constantly ON no effects)

accent leds run mostly at10-15mA so resistors for them must be calculated accordingly

Main Neopixel strip

additional Neopixelstrips(optional)

Neopixel bladeconnector

330 Ohm on the Blade pcb side

x3 28 AWGor x1 22 AWGfor Negative

330 Ohm on the Blade pcb side

arrows up

330 Ohm on the Blade pcb side

In case no additional Neopixel strips are needed LED channels 4 5 6 can be used for 3 controllable(programmable for different effects) accent leds So AV switch led can be wired to one of these channelsAccent leds also can be wired to Data pads 2-5 please see ldquoAccent LEDs wiring and setuprdquo page

Recommended power wire gauges (22 AWG) are given for 2-strip blade For 3-strip blade you gonna need at least 20 AWG wires

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 29

ldquoproffieboard_v1_confighrdquo

3WIRING DIAGRAMS1

Basic Neopixel wiringldquoconfighrdquo file setup

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

NUM_BLADES 3NUM_BUTTONS 2VOLUME 1000CLASH_THRESHOLD_G 10IgnitionDelaylt0 any blade stylegtIgnitionDelaylt800 any blade stylegtIgnitionDelaylt800 any blade stylegtWS2811BladePtrlt118 WS2811 800kHz | WS2811 GRBgt()WS2811BladePtrlt26 blade2Pin ltbladePowerPin4gtgt()WS2811BladePtrlt26 blade3Pin ltbladePowerPin5gtgt()

ProffieBoard config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)Volume level (0-3000)Clash sensitivity (adjust lower or higher with 01 step)ldquoBlade 1rdquo style (main blade with IgnitionDelay 0)ldquoBlade 2rdquo style (CG blade 1 with IgnitionDelay 800)ldquoBlade 3rdquo style (CG blade 2 with IgnitionDelay 800)

strip configuration (defines how many pixels it has and to which LED output and pin is wired)

Preset 1

any blade style

strip (blade) 1 configuration

adjust this number to match your strips leds count

strip (blade) 2 configuration

strip (blade) 3 configuration

Preset 2 etc

Use a given or build your wiring diagram on THIS PAGE then open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text

Editor (Notepad - to see code correctly in Notepad Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all

text) and Delete it then Copy-and-Paste (Ctrl+C Ctrl+V) your wiring diagram config code (example below) into empty _configh file and

Save it under new name Follow the instructions on page 22 to upload it to the board

PROFFIEBOARD INSTRUCTIONS

30 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Basic Segmented string wiring diagram

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

+

+

-

-

24 A

WG

28 AWG

30-32 AWG30-32 AWG

Protected 36-37V (42V max at full charge) 10A 3500mAh battery recommended+18650 battery holder (optional)Keystone 1042P

AV switch with accent led(constantly ON no effects)

accent leds run mostly at10-15mA so resistors for them must be calculated accordingly

6-segments string blade

FoC string

N-channel FET3A minimum

123456

Calculate resistors for each led segment of the blade string depending on which leds are used 5mm leds have max drive current around 25mA per led when 10mm leds can be 100mA and 200mA per ledSo pay attention to your led max current and Forward Voltage (Vf) when calculating a segment resistor resistence as well as its wattage Also choose wire gauges accordingly to meet segments and total blade max current draw level

LED Resistor Calculator

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 31

ldquoproffieboard_v1_confighrdquo

3WIRING DIAGRAMS1

Basic Segmented string wiringldquoconfighrdquo file setup

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

NUM_BLADES 1NUM_BUTTONS 2VOLUME 1000CLASH_THRESHOLD_G 10StyleNormalPtrltCYAN WHITE 300 800gt()ltBlue3mmLED BladePin White3mmLEDgt

ProffieBoard config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)Volume level (0-3000)Clash sensitivity (adjust lower or higher with 01 step)Blade styleLED string configuration(here you mention the color and type of leds usedin the main blade string segments and FoC stringBladePin is the FoC signal pin (Blade ID pin))

Preset

LED string configuration

Use a given or build your wiring diagram on THIS PAGE then open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text

Editor (Notepad - to see code correctly in Notepad Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all

text) and Delete it then Copy-and-Paste (Ctrl+C Ctrl+V) your wiring diagram config code (example below) into empty _configh file and

Save it under new name Follow the instructions on page 22 to upload it to the board

PROFFIEBOARD INSTRUCTIONS

32 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Accent LEDs wiring diagram(optional)

Accent LEDs work with ProffieBoard as additional ldquobladesrdquo when powered by LED outputs 4 5 6 or Data pads 1 2 3 5 as PWM So they can

have any effect that blade can have If no effects needed accent led can be powered just by a 33V output pad (power-on led indication)

30-32 AWG

with Neopixel blade setup these 4 outputsdonrsquot work for regular accent leds

Recommended resistors to use for accent leds at 33V power source and 15mA drive

ndash 100 Ohm for Red (lt100000gt value in the code)ndash 13 Ohm for Green (lt13000gt value in the code)ndash 13 Ohm for Blue (lt13000gt value in the code)ndash 100 Ohm for Yellow (lt100000gt value in the code)ndash 20 Ohm for White (lt20000gt value in the code)

RGB ledcommon-anode

8 ldquobladesrdquo1 main and 7 accent leds

main blade style (effects) main blade style (effects)

7 accent leds style (effects)accent led style (effects)

7 accent leds configurations

RGB accent led configuration

2 ldquobladesrdquo1 main and 1 RGB accent led

ldquoPower-onrdquo indicationaccent leds (no effects)

7 accent leds withindependent effects

RGB accent led

a) b)

b)

c)

c)

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 33

3WIRING DIAGRAMS1

Neopixel Accent LEDs wiring diagram(optional)

With Neopixel setup additional neopixel leds or arrays can be used as accent leds There are 2 ways to wire them using additional Data

pins 2 3 4 5 or ldquoSub-bladesrdquo wiring with just 1 Data output pin Same way Neopixel connectors with on-board leds ca be wired

Option 1 ndash with extra Data pins

Main Blade

some accent leds

D1

D2

crystal leds

330 Ohm

330 Ohm

330 Ohm

main blade style (effects)

main blade 144 leds Data pin 1

accent leds blade style (effects)

accent leds ldquobladerdquo 4 leds Data pin 2

crystal leds blade style (effects)

crystal leds ldquobladerdquo 2 leds Data pin 3

3 ldquobladesrdquo1 main 1 accent leds array and 1 crystal leds array

PROFFIEBOARD INSTRUCTIONS

D3

follow arrows direction

34 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Neopixel Accent LEDs wiring diagram(optional)

PROFFIEBOARD INSTRUCTIONS

Main Blade

some accent leds

1

3

5678

2

4

D1

crystal leds

follow arrows direction

330 Ohm

330 OhmData signal

With this setup a single array of neopixel leds is separated into a couple of sub-blades with their own style configuration and behaviour This

is really usefull when you want to use only one data pin More about ldquoSub-bladesrdquo on ProffieOS wiki page

Option 2 ndash with ldquoSub-bladesrdquo

main blade style (effects)

main blade sub-blade 140 leds (7-146) but from 6 to 145 in the code

accent leds blade style (effects)

accent leds sub-blade 4 leds (1-4) but from 0 to 3 in the code

crystal leds blade style (effects)

146 leds total used

crystal leds sub-blade 2 leds (5-6) but from 4 to 5 in the code

update default 144 to a higher total value if you get all accent leds +Main blade gt 144 Example update to 146 if you have 2 crystal leds +4 accent leds + 140 Main blade leds = 146

3 ldquobladesrdquo 1 main 1 accent leds array and 1 crystal leds array

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 35

3WIRING DIAGRAMS1

OLED display wiring diagram(optional)

SSD1306 128x32 pixels OLED display allows to show battery level current preset name play different animations and even simple games It

can be wired to any blade configuration and requires just one additional line in the code to work You can get monochrome display in white

or blue color

SSD1306128x32OLED

SSD1306 ndash with blue or white display color selectSSD1306 ndash cheaper priceSSD1306 just screen ndash blue or white select

30-32 AWG

30-32 AWG

add this line to enable OLED display

display shows a preset name written in these quotes ldquoldquo

PROFFIEBOARD INSTRUCTIONS

36 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Bluetooth module wiring diagram(optional)

SOON

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 37

3WIRING DIAGRAMS1

Blade ID resistor functions(optional)

SOON

PROFFIEBOARD INSTRUCTIONS

38 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

website ProffieBoard FULL wiring diagrams link

Scroll the page down till you see the interactive diagram Above the diagram there are components selection options Build your saber setup

with it and follow diagram to wire your board Then you need to copy the configuration code below and paste it into your _configh file

Choose components you want

3WIRING DIAGRAMS1

More wiring diagrams

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 39

3WIRING DIAGRAMS1

How to use it

PROFFIEBOARD INSTRUCTIONS

Blade ignitionretraction ndash assuming you have at least one button pressing it briefly should turn the saber on or off If you have an AUX button pressing it briefly should also turn the saber on and off If you have no buttons you can turn the saber on and off by twisting your wrist back and forth Note that the motion has to be done long enough to count so a very quick flick of the wrist will not workTurn On muted ndash double-click power buttonNext preset ndash while saber is off click the AUX buttonPrevious preset ndash hold AUX button and click the Activation buttonTrigger Clash ndash while saber is on hit the bladeTrigger Lockup ndash while saber is on hold Activation button then trigger a clash Lockup releases when you let go of the Acti-vation buttonTrigger Drag ndash like lockup but point saber mostly down before holding Activation buttonTrigger Force ndash long-click AUX buttonStart soundtrack ndash long-click the Activation buttonTrigger Blaster Block ndash while saber is on short-click AUX button

Serial Monitor commands

battery_voltage ndash gets current battery voltage valueget_volume ndash get current volume valuepow ndash power OnOff the saberon ndash power On the saberoff ndash power Off the saberset_volume lt0-3000gt ndash set volume value (example set_volume 500)play ndash play the default preset trackplay trackslttrack namegt ndash play a specific track from tracks folder (example play tracksvenuswav)stop ndash stop the playing trackforce ndash play ldquoforcerdquo sound effectsdrag ndash play ldquodragrdquo sound effectsblast ndash play ldquoblasterrdquo sound effectslock ndash play ldquolockuprdquo sound effectsclash ndash play ldquoclashrdquo sound effectsreset ndash reboot the boardn ndash switch to next presetp ndash switch to previous presetlist_presets ndash show all presetssdtest ndash test SD card speed

40 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3FIRMWARE UPLOAD AND UPDATE2

Software installation and setup

PROFFIEBOARD INSTRUCTIONS

To upload firmware to ProffieBoard Arduino IDE program is required Follow these steps to install it to your PC

1 Install latest Arduino IDE software (donrsquot use BETA)

Installing as Windows app also is not recommended

because it will be installed in a specific protected folder that

wonrsquot allow you to install any additional softwareplugin in it

If ProffieBoard wonrsquot show up in COM port use

Arduino IDE 186 version

2 Install the Proffieboard Arduino Plugin and Zadig software

Follow installation instructions

3 Select Proffieboard-STM32L433 in Tools -gt Board

USB Type ndash Serial CPU Speed ndash 80 MHz Optimize ndash Smallest Code DOSFS ndash SDCARD (SPI) Port ndash COM(the number your PC assigned) (Butterfly-L433CC)

Connect Proffieboard via USB cable to PC to be able to select

the Port

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 41

3FIRMWARE UPLOAD AND UPDATE2

Uploading firmware

PROFFIEBOARD INSTRUCTIONS

1 Download the ProffieBoard firmware and SD card content

Unzip lightsaber-1286zip to your Documents directory or to

Desktop but not to Arduino program folder or anywhere in

Programs directory where all programs are installed You will

see a lightsaber folder and files inside it Donrsquot move any of

these files to any other location outside the lightsaber folder

and donrsquot reorganize them Unzip ProffieOS_SD_Cardzip to the

folder where you keep lightsaber-1286 folder Copy all files

from ProffieOS_SD_Card folder to your SD card

2 Unhide file extensions in File Explorer settings to see h ending

of config files Donrsquot add ldquohrdquo to the config file name Go to config folder and create you own configh file (see page

42 for how-to)

Double-click the lightsaberino file

3 Add the name of your configh file as shown and Save this

lightsaberino file Make sure the other config files are

commented out there should be only one CONFIG_FILE

without You can have multiple config files

in lightsabergtconfig folder and just define the one you need

in lightsaberino file and upload it again to ProffieBoard

4 Connect battery to ProffieBoard and hook up to your PC

with a data transfer micro-USB-to-USB cable

Press arrow button it will compile and upload firmware to the

board Wait for red text progress bars to stop at 100

ProffieBoard will play boot sound if speaker is connected

Now you can unplug the USB cable Done

If it gives an error instead this means your configh file has

issues define CONFIG_FILE name has mistakes configh file

is out of config folder your PC user name is non-latin

42 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

33

configh file structure editing

PROFFIEBOARD INSTRUCTIONS

CHANGING PARAMETERS

All sound files (sound fonts music tracks) are stored on the micro SD card Add required sound fonts folders (Plecter NEC and Smoothswing

fonts are supported no need to change WAV files names just copy and paste) to SD card root directory as itrsquos done in the default

ProffieOS_SD_Card content folder and music tracks to the tracks folder

Make sure to name all music tracks and sound fonts folders with latin characters and only up to 8 characters long without using any special

characters (like |[- etc)

Make sure you have a configini file in each sound font folder if there is none - copy one from some default TeensySaberProffieBoard sound

font and paste into newly added sound font folder It has only one parameter that you can modify - humstart It helps to match hum sound

start with blade ignition 1000 usually works fine

All blade effects LED configuration volume level clash sensitivity etc are changed in the configh file located in lightsabergtconfig folder

To do that open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text Editor (Notepad - to see code correctly in Notepad

Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all text) and Delete it then Copy-and-Paste (Ctrl+C

Ctrl+V) your wiring diagram config code into empty _configh file and Save it under new name Follow the instructions on page 39 to

upload it to the board

Proffieboard config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)

volume level (0-3000)

clash sensitivity (adjust lower or higher with 01 step)

sound font folder nametrack name

Preset name

Blade style

LED configuration (use these XP-E2 LED templatesto define your LED)

for Red use 1 Ohm resistor for Green - no resistor for Blue use 024 Ohm

NoLED ndash no 4th led used

Preset 1

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 43

33

Blade Styles

StylePtrltInOutHelperltSimpleClashltLockupltBlastltOnSparkltAudioFlickerltRgblt02550gtRgblt501000gtgtRgblt2552550gt150gtRgblt255500gtgtAudioFlickerltRgblt1002550gtRgblt2550150gtgtgtRgblt255100150gt40gt200300Blackgtgt

ndash this is how the Blade Style code looks pasted in the configh file Preset (it sits inside a StylePtrltgt container)

ndash this is how the Blade Style code looks when editing it inside a Blade Style Editor

Each Blade Style is made of a variety of Effects each added effect goes instead of a base color in the previous effect

PROFFIEBOARD INSTRUCTIONS

CHANGING PARAMETERS

ProffieBoard and TeensySaber use Blade Styles for the main saber blade and any other accent leds to define all light effects (color changing

flashes flickering delays ignitionretraction timing etc)

Use Blade Style Editor to create and adjust Blade Styles Megtooth Sith Sabers did a great video tutorial where he shows and explains

how to use Blade Style Editor Also you can grab some pre-made Blade Styles or share yours here on TRA forums

A Blade Style example of simple flickering Green blade with Spark on start Clash Blaster Lockup and Drag IgnitionRetraction effects

InOutHelperltSimpleClashltLockupltBlastltOnSparkltAudioFlickerltRgblt02550gtRgblt501000gtgtRgblt2552550gt150gtRgblt255500gtgtAudioFlickerltRgblt1002550gtRgblt2550150gtgtgtRgblt255100150gt40gt200300Blackgt

InOutHelperltbase color200300Blackgt ndash base color can be defined by words (WHITE RED GREEN PURPLE etc) or by Rgblt0-2550-2550-255gt values for more

custom shades 200 is extension length in milliseconds 300 is retraction length in milliseconds Black is color when retracted (also can be any other color)

SimpleClashltbase colorclash color40gt ndash clash effect 40 is clash duration in milliseconds

Lockupltbase colorlockup colorgt ndash lockup effect

Blastltbase colorblast colorgt ndash blaster effect

OnSparkltbase colorspark color150gt ndash spark on ignition effect 150 is spark duration in milliseconds

AudioFlickerltrdquoArdquo colorrdquoBrdquo colorgt ndash flickering effect (blade flickers to the actual saber hum sound) the more difference between ldquoArdquo and ldquoBrdquo colors - the more

abrupt is flickering

Rgblt255500gt ndash actual color in RGB format (0 is no light 255 is the maximum brightness value for Red Green or Blue channel)

44 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

ndash SanDisk 4GB microSDHC Class 4 (Genuine) ndash SanDisk 4GB microSDHC Class 4 (Genuine)

130238 kbs = 1477 simultaneous audio streams 137812 kbs = 1562 simultaneous audio streams

ndash Patriot LX Series 16GB microSDHC UHS-IU1 Class 10 ndash Patriot LX Series 16GB microSDHC UHS-IU1 Class 10

133005 kbs = 1508 simultaneous audio streams

ndash GSkill 16GB microSDHC UHS-IU1 Class 10 ndash GSkill 16GB microSDHC UHS-IU1 Class 10

129534 kbs = 1469 simultaneous audio streams

ndash Kingston 16GB microSDHC UHS-IU1 Class 10 ndash Kingston 16GB microSDHC UHS-IU1 Class 10

128090 kbs = 1452 simultaneous audio streams

ndash SanDisk Ultra 16GB microSDHC UHS-IU1 A1 Class 10 ndash SanDisk Ultra 16GB microSDHC UHS-IU1 A1 Class 10

102663 kbs = 1164 simultaneous audio streams 11124 kbs = 1261 simultaneous audio streams

ndash SanDisk 8GB microSDHC Class 4 ndash SanDisk 8GB microSDHC Class 4

108506 kbs = 1230 simultaneous audio streams

ndash SanDisk 16GB microSDHC Class 4 ndash SanDisk 16GB microSDHC Class 4

102663 kbs = 1164 simultaneous audio streams 106957 kbs = 1213 simultaneous audio streams

ndash SanDisk Ultra 16GB microSDHC UHS-IU1 Class 10 ndash SanDisk Ultra 16GB microSDHC UHS-IU1 Class 10

102663 kbs = 1164 simultaneous audio streams 103909 kbs = 1178 simultaneous audio streams

ndash Smartbuy 4GB microSDHC Class 4 ndash Smartbuy 4GB microSDHC Class 4

75437 kbs = 855 simultaneous audio streams

ndash Kingston 8GB microSDHC Class 4 ndash Kingston 8GB microSDHC Class 4

75209 kbs = 822 simultaneous audio streams

ndash SanDisk 4GB microSDHC Class 4 (Fake) ndash SanDisk 4GB microSDHC Class 4 (Fake)

677 kbs = 769 simultaneous audio streams

Here is a list of tested micro SD cards speed with TeensySaber V3 and ProffieBoard Any card with speed over 900 kbs is recommended the

higher the speed is ndash the better Memory size of 4-16Gb is more than enough Cards were tested with a default firmware (1291) compiled

with ldquoSmallest Coderdquo under Optimize ldquodefault_proffieboard_confighrdquo file and default ProffieOS SD card sound files (7 folders)

To test your SD card speed simply hook up ProffieBoard to PC open Arduino IDE go to Tools and open Serial Monitor make sure you have

New Line and 9600 baud rate selected on the bottom of Serial Monitor window type and send sdtest command wait for the test result

4Recommended micro SD cards

BEST

TEENSYSABER PROFFIEBOARD

GOOD

BAD

PROFFIEBOARD INSTRUCTIONS

SD CARD RECOMMENDATIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 45

There are a lot of fake (chinese copies) microSD cards on the market from aliexpress ebay amazon etc They look very similar to genuine

cards but are a bit different though and have a twice lower writingreading speed Here is an example of a SanDisk 4Gb Class 4 card one is

genuine with 137812 kbs speed and the other one is fake with 677 kbs speed I got from ebay seller

Be carefull and pay attention to how the actual card looks if you are not sure ask seller for the real photo of SD card he sells

4Genuine and Fake SanDisk 4Gb Class 4 microSD

PROFFIEBOARD INSTRUCTIONS

SD CARD RECOMMENDATIONS

46 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

WIRE GAUGE GUIDE

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 47

RECHARGE PORTS AND KILL SWITCHES

48 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

NEOPIXEL STRIPS CURRENT DRAW

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 49

6TROUBLESHOOTING

For more help please check these linksProffieOSProffieBoardTeensySaber wiki on GitHubAsk your question on The Rebel Armory forumsAsk your question on FX-sabers forumsAsk your question in facebook group

How to solve most common issues

Quick troubleshooting tips

TeensySaber board or Proffieboard is not recognized by computer (nothing under Port selection in Arduino)

ndash Make sure a charged 37V battery is connected to the board micro-USB cable is a data transfer cable all plugins and drivers are installed ndash

check again pages 21 for TeensySaber or 40 for Proffieboard Try a different USB port on your computer

Sketch (code) compile error in Arduino IDE

ndash Check your define CONFIG_FILE ldquoconfig_confighrdquo line in opened lightsaberino file if itrsquos written correctly with config in it

Sketch (code) compile error in Arduino IDE

ndash Check if the _configh file you defined in the lightsaberino sketch file is same name as in the lightsaber-rdquofirmware versionrdquolightsaber

config folder and is located in this folder

Sketch (code) compile error in Arduino IDE

ndash Check your settings under Tools tab in Arduino IDE program Check again pages 21 for TeensySaber or 40 for Proffieboard

Sketch (code) compile error in Arduino IDE

ndash Check if your _configh file is correct Blade Styles Presets const unsigned int maxLedsPerStrip = 144 if BladeConfig blades[] = is correct

Sketch (code) compile error in Arduino IDE

ndash If nothing helps install Arduino IDE version 186 and try to compile and upload the firmware again

Sound doesnrsquot play

ndash Remove SD card and insert again check speaker wiring Make sure all sound files on SD card are correctly named (8 characters max long)

Re-format SD card in FAT32 load sound files and try again try another SD card

Board says ldquoLOW POWERrdquo

ndash Charge the battery

Serial Monitor shows info sent by the board but your commands donrsquot work

ndash In the bottom right corner of Serial Monitor window make sure the Line Ending drop down is set to New Line

Sound is weird and distorted

ndash Check your SD card speed (see page 44) Check speaker wiring try another good speaker

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 05

1HELPFUL LINKS

Video tutorials by Megtooth Sith Sabers

Video tutorials by Megtooth Sith Sabers on youtubeLED Resistor Calculator

For more information please check these links

TeensySaber V3 sound board instructionsProffieBoard sound board instructionsrdquoBlade style sharingrdquo - here you can find and share custom blade stylesWeb Blade Style Editor 1 (default)Web Blade Style Editor 2 (restyle)Here you can get regular (Plecter NEC) or ldquoSmoothswingrdquo sound fontsProffieOSProffieBoardTeensySaber wiki on GitHubProfezzornrsquos Lab on The Rebel Armory forumsProfezzornrsquos Lab on FX-sabers forumsAsk your question in facebook group

Get latest ProffieOS firmware

Tutorials and instructions

06 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

Board pinout

used pads

Battery + ndash 26 to 45 volt input drives everything except the LEDs

Battery - ndash negative pad for LEDs needs to be at same level as GND when both are connected

GND ndash ground for electronics except LEDs Note that GND is also available on short edge of the teensy (See the teensy pinout for details)

Speaker +- ndash hooks up to speaker

Activation Aux Aux2 button ndash hook up to closing buttons or potentially touch buttons

Blade ID Neopixel Data 1 ndash normally used to measure the blade ID restor and if itrsquos a neopixel blade feed out neopixel data

LED 1 2 3 ndash hooks up to negative side of LED (positive side of LED hooks up directly to battery) These pads can handle

up to 30 volts

LED 4 5 6 ndash like LED123 but requires FETs to be placed on the bottom of the board to function Voltage is limited by

selection of FETs

Power 1 Power 2 Power 3 ndash these control the FETs which drive LED 1 2 3

AUX LED 1 2 3 ndash these are hooked up to pads on the bottom which can be populated with FETs and used to drive additional LEDs If the

bottom FETs are not populated these pins are free and can be used for any purpose

RX3 TX3 ndash these pins are used for wiring a bluetooth module for wireless control or additional Neopixel Data out

SDA SCL ndash these pins are used to wire OLED display

+33V 250mA max ndash generated by the Teensy for powering OLED display or Bluetooth module

micro USB port ndash micro USB port used only for firmware upload and can be used for sound files upload to SD card

THIS PORT ISNrsquoT USED FOR CHARGING THE BATTERY

LED output 1 2 3

Battery - Speaker + (red dot or ldquo+rdquo mark on speaker)Battery +

Data in (SD) SCK (SD)

Battery Volt SenseAux button

Activation buttonAux2 button

SDA

SCL

Blade ID Neopixel Data 1Audio data

Audio LRClock

Power 3+33VAudio GND (not used)+5V

Data out (SD)

Power 2

Audio clock

TX3Neopixel Data 2

RX3Neopixel Data 3

Power 1AUX3 LEDAUX2 LEDAUX1 LED

Motion InterruptAmplifier enable

SD card selectGND

Speaker -

LED output 4 5 6

micro USB port on Teensy 32

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 07

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

Board assembling

1 IMPORTANT

Cut the tiny trace with a knife between VIN and VUSB as shown

Teensy 32 bottom view

2 Solder 254mm header pins (gold plated recommended) to

TeensySaber V3 board on the top or on the bottom depending

on where you want to put Teensy 32 board

(please see next step)

3 Solder Teensy 32 board on top

(A ndash micro USB port on top SD card between boards) or on the bottom (B ndash SD card on top micro USB port between boards)

A B

+

08 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

Basic Tri-Cree wiring diagram(In-hilt LED)

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

+

+

+

-

-

-

26 A

WG

26 AWG

30-32 AWG

28-30 AWG

28-30 AWG

30-32 AWG

Protected 36-37V (42V max at full charge) 10A 3500mAh battery recommended+18650 battery holder (optional)Keystone 1042P

AV switch with accent led(constantly ON no effects)

accent leds run mostly at10-15mA so resistors for them must be calculated accordingly

Main RGB led

additional RGB leds(optional)

In case no additional high power leds are needed LED channels 4 5 6can be used for 3 controllable (programmable for different effects) accent leds So AV switch led can be wired to one of these channelsby adding 1 MOSFET

LED Resistor Calculator

solder 3x FETs

solder 1 FET

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 09

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

Basic Tri-Cree wiring (In-hilt LED)ldquoconfighrdquo file setup

Use a given or build your wiring diagram on THIS PAGE then open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text

Editor (Notepad - to see code correctly in Notepad Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all

text) and Delete it then Copy-and-Paste (Ctrl+C Ctrl+V) your wiring diagram config code (example below) into empty _configh file and

Save it under new name Follow the instructions on page 22 to upload it to the board

ldquov3_confighrdquoNUM_BLADES 2NUM_BUTTONS 2VOLUME 1000CLASH_THRESHOLD_G 10StyleNormalPtrltCYAN WHITE 300 800gt()StyleNormalPtrltCYAN WHITE 300 800gt()

CreeXPE2RedTemplatelt1000gtCreeXPE2GreenTemplatelt0gtCreeXPE2BlueTemplatelt240gtNoLED

TeensySaber V3 config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)Volume level (0-3000)Clash sensitivity (adjust lower or higher with 01 step)ldquoBlade 1rdquo styleldquoBlade 2rdquo style (in case only 1 blade is used you donrsquot need this line)LED configuration (use these XP-E2 LED templatesto define your LED If other LED resistors are used change these values to match Ohm1000=ltvaluegt)

where 1000 is 1 Ohm resistor 0 is no resistor240 is 024 Ohm resistorNoLED ndash no 4th led used

Preset 1

LED 1 configuration

LED 2 configuration

Preset 2 etc

10 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

Basic Neopixel wiring diagram

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

+

+

+

-

-

-

22 A

WG

22 AWG

26 AWG

30 AWG

x2 28 AWG

x2 26 AWG

22 A

WG

30-32 AWG

30-32 AWG

Protected 36-37V (42V max at full charge) 10A 3500mAh or 15A 3120mAhbattery recommended+18650 battery holder (optional)Keystone 1042P

AV switch with accent led(constantly ON no effects)

accent leds run mostly at10-15mA so resistors for them must be calculated accordingly

Main Neopixel strip

additional Neopixelstrips(optional)

Neopixel bladeconnector

330 Ohm on the Blade pcb side

x3 28 AWGor x1 22 AWGfor Negative

330 Ohm on the Blade pcb side

arrows up

330 Ohm on the Blade pcb side

In case no additional Neopixel strips are needed LED channels 4 5 6can be used for 3 controllable (programmable for different effects) accent leds So AV switch led can be wired to one of these channelsby adding 1 MOSFETRecommended power wire gauges (22 AWG) are given for 2-strip blade For 3-strip blade you gonna need at least 20 AWG wires

solder 2x FETs

solder 1 FET

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 11

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

Basic Neopixel wiringldquoconfighrdquo file setup

ldquov3_confighrdquoNUM_BLADES 3NUM_BUTTONS 2VOLUME 1000CLASH_THRESHOLD_G 10IgnitionDelaylt0 any blade stylegtIgnitionDelaylt800 any blade stylegtIgnitionDelaylt800 any blade stylegtWS2811BladePtrlt118 WS2811 800kHz | WS2811 GRBgt()WS2811BladePtrlt26 7 ltbladePowerPin4gtgt()WS2811BladePtrlt26 8 ltbladePowerPin5gtgt()

TeensySaber V3 config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)Volume level (0-3000)Clash sensitivity (adjust lower or higher with 01 step)ldquoBlade 1rdquo style (main blade with IgnitionDelay 0)ldquoBlade 2rdquo style (CG blade 1 with IgnitionDelay 800)ldquoBlade 3rdquo style (CG blade 2 with IgnitionDelay 800)

strip configuration (defines how many pixels it has and to which LED output and pin is wired)

Preset 1

any blade style

strip (blade) 1 configuration

strip (blade) 2 configuration

strip (blade) 3 configuration

Preset 2 etc

Use a given or build your wiring diagram on THIS PAGE then open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text

Editor (Notepad - to see code correctly in Notepad Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all

text) and Delete it then Copy-and-Paste (Ctrl+C Ctrl+V) your wiring diagram config code (example below) into empty _configh file and

Save it under new name Follow the instructions on page 22 to upload it to the board

12 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

Basic Segmented string wiring diagram

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

+

+

-

-

24 A

WG

28 AWG

30-32 AWG

30-32 AWG

Protected 36-37V (42V max at full charge) 10A 3500mAh battery recommended+18650 battery holder (optional)Keystone 1042P

AV switch with accent led(constantly ON no effects)

accent leds run mostly at10-15mA so resistors for them must be calculated accordingly

6-segments string blade

FoC string

N-channel FET3A minimum

1

1 46 523

23456

Calculate resistors for each led segment of the blade string depending on which leds are used 5mm leds have max drive current around 25mA per led when 10mm leds can be 100mA and 200mA per ledSo pay attention to your led max current and Forward Voltage (Vf) when calculating a segment resistor resistence as well as its wattage Also choose wire gauges accordingly to meet segments and total blade max current draw level

LED Resistor Calculator

solder 3x FETs

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 13

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

Basic Segmented string wiringldquoconfighrdquo file setup

ldquov3_confighrdquoNUM_BLADES 1NUM_BUTTONS 2VOLUME 1000CLASH_THRESHOLD_G 10StyleNormalPtrltCYAN WHITE 300 800gt()ltBlue3mmLED 20 White3mmLEDgt

TeensySaber V3 config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)Volume level (0-3000)Clash sensitivity (adjust lower or higher with 01 step)Blade styleLED string configuration(here you mention the color and type of leds usedin the main blade string segments and FoC string20 is the FoC signal pin (Blade ID pin))

Preset

LED string configuration

Use a given or build your wiring diagram on THIS PAGE then open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text

Editor (Notepad - to see code correctly in Notepad Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all

text) and Delete it then Copy-and-Paste (Ctrl+C Ctrl+V) your wiring diagram config code (example below) into empty _configh file and

Save it under new name Follow the instructions on page 22 to upload it to the board

14 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

Accent LEDs wiring diagram(optional)

Accent LEDs work with TeensySaber board as additional ldquobladesrdquo when powered by LED outputs 4 5 6 with FETs So they can have any effect

that blade can have If no effects needed accent led can be powered just by a 33V output pad (power-on led indication)

30-32 AWGRGB ledcommon-anode

4 ldquobladesrdquo1 main and 3 accent leds

main blade style (effects) main blade style (effects)

3 accent leds style (effects)accent led style (effects)

3 accent leds configurations

RGB accent led configuration

2 ldquobladesrdquo1 main and 1 RGB accent led

ldquoPower-onrdquo indicationaccent leds (no effects)

3 accent leds withindependent effects

+ 1 or more simple accent leds without effects

1 RGB accent led+ 1 or more simple accent leds

without effects

a) b)

b)

c)

c)

solder 3x FETs solder 3x FETs

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 15

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

OLED display wiring diagram(optional)

SSD1306 128x32 pixels OLED display allows to show battery level current preset name play different animations and even simple games It

can be wired to any blade configuration and requires just one additional line in the code to work You can get monochrome display in white

or blue color

SSD1306128x32OLED

SSD1306 ndash with blue or white display color selectSSD1306 ndash cheaper priceSSD1306 just screen ndash blue or white select

30-32 AWG

30-32 AWG

add this line to enable OLED display

display shows a preset name written in these quotes ldquoldquo

16 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

Bluetooth module wiring diagram(optional)

SOON

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 17

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

Blade ID resistor functions(optional)

SOON

18 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

website TeensySaber V3 FULL wiring diagrams link

Scroll the page down till you see the interactive diagram Above the diagram there are components selection options Build your saber setup

with it and follow diagram to wire your board Then you need to copy the configuration code below and paste it into your _configh file

Choose components you want

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

More wiring diagrams

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 19

20 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

How to use it

Blade ignitionretraction ndash assuming you have at least one button pressing it briefly should turn the saber on or off If you have an AUX button pressing it briefly should also turn the saber on and off If you have no buttons you can turn the saber on and off by twisting your wrist back and forth Note that the motion has to be done long enough to count so a very quick flick of the wrist will not workTurn On muted ndash double-click power buttonNext preset ndash while saber is off click the AUX buttonPrevious preset ndash hold AUX button and click the Activation buttonTrigger Clash ndash while saber is on hit the bladeTrigger Lockup ndash while saber is on hold Activation button then trigger a clash Lockup releases when you let go of the Acti-vation buttonTrigger Drag ndash like lockup but point saber mostly down before holding Activation buttonTrigger Force ndash long-click AUX buttonStart soundtrack ndash long-click the Activation buttonTrigger Blaster Block ndash while saber is on short-click AUX button

Serial Monitor commands

battery_voltage ndash gets current battery voltage valueget_volume ndash get current volume valuepow ndash power OnOff the saberon ndash power On the saberoff ndash power Off the saberset_volume lt0-3000gt ndash set volume value (example set_volume 500)play ndash play the default preset trackplay trackslttrack namegt ndash play a specific track from tracks folder (example play tracksvenuswav)stop ndash stop the playing trackforce ndash play ldquoforcerdquo sound effectsdrag ndash play ldquodragrdquo sound effectsblast ndash play ldquoblasterrdquo sound effectslock ndash play ldquolockuprdquo sound effectsclash ndash play ldquoclashrdquo sound effectsreset ndash reboot the boardn ndash switch to next presetp ndash switch to previous presetlist_presets ndash show all presetssdtest ndash test SD card speed

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 21

2TEENSYSABER V3 INSTRUCTIONS

FIRMWARE UPLOAD AND UPDATE2

Software installation and setup

To upload firmware to TeensySaber board Arduino IDE program is required Follow these steps to install it to your PC

1 Install latest Arduino IDE software (donrsquot use BETA)

Installing as Windows app also is not recommended

because it will be installed in a specific protected folder that

wonrsquot allow you to install Teensyduino software in it

If TeensySaber wonrsquot show up in COM port use

Arduino IDE 186 version

2 Install latest Teensyduino software in same directory

usually itrsquos CProgram Files (x86)Arduino on Windows

Follow installation instructions for your system

3 Select Teensy 32 31 in Tools -gt Board

USB Type ndash Serial CPU Speed ndash 96 MHz (overclock) Optimize ndash Smallest Code Port ndash COM(the number your PC assigned) (Teensy 32) Serial

Connect TeensySaber via USB cable to PC to be able to select

the Port donrsquot forget to connect battery first

22 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

1 Download the TeensySaber firmware and SD card content

Unzip lightsaber-1286zip to your Documents directory or to

Desktop but not to Arduino program folder or anywhere in

Programs directory where all programs are installed You will

see a lightsaber folder and files inside it Donrsquot move any of

these files to any other location outside the lightsaber folder

and donrsquot reorganize them Unzip ProffieOS_SD_Cardzip to the

folder where you keep lightsaber-1286 folder Copy all files

from ProffieOS_SD_Card folder to your SD card

2 Unhide file extensions in File Explorer settings to see h ending

of config files Donrsquot add ldquohrdquo to the config file name

Go to config folder and create you own configh file (see page

23 for how-to)

Double-click the lightsaberino file

3 Add the name of your configh file as shown and Save this

lightsaberino file Make sure the other config files are

commented out there should be only one CONFIG_FILE

without You can have multiple config files

in lightsabergtconfig folder and just define the one you need

in lightsaberino file and upload it again to TeensySaber board

4 Connect battery to TeensySaber board and hook up to your PC

with a data transfer micro-USB-to-USB cable

Press arrow button it will compile and upload firmware to the

board Wait for your PC to make a sound or TeensySaber will

play boot sound if speaker is connected Now you can unplug

the USB cable Done

If it gives an error instead this means your configh file has

issues define CONFIG_FILE name has mistakes configh file

is out of config folder your PC user name is non-latin

2TEENSYSABER V3 INSTRUCTIONS

FIRMWARE UPLOAD AND UPDATE2

Uploading firmware

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 23

2TEENSYSABER V3 INSTRUCTIONS

CHANGING PARAMETERS3

Changing sound board parameters

All sound files (sound fonts music tracks) are stored on the micro SD card Add required sound fonts folders (Plecter NEC and Smoothswing

fonts are supported no need to change WAV files names just copy and paste) to SD card root directory as itrsquos done in the default

ProffieOS_SD_Card content folder and music tracks to the tracks folder

Make sure to name all music tracks and sound fonts folders with latin characters and only up to 8 characters long without using any special

characters (like |[- etc)

Make sure you have a configini file in each sound font folder if there is none - copy one from some default TeensySaberProffieBoard sound

font and paste into newly added sound font folder It has only one parameter that you can modify - humstart It helps to match hum sound

start with blade ignition 1000 usually works fine

All blade effects LED configuration volume level clash sensitivity etc are changed in the configh file located in lightsabergtconfig folder

To do that open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text Editor (Notepad - to see code correctly in Notepad

Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all text) and Delete it then Copy-and-Paste (Ctrl+C

Ctrl+V) your wiring diagram config code into empty _configh file and Save it under new name Follow the instructions on page 22 to

upload it to the board

TeensySaber V3 config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)

volume level (0-3000)

clash sensitivity (adjust lower or higher with 01 step)

sound font folder nametrack name

Preset name

Blade style

LED configuration (use these XP-E2 LED templatesto define your LED)

for Red use 1 Ohm resistor for Green - no resistor for Blue use 024 Ohm

NoLED ndash no 4th led used

Preset 1

24 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

31

PROFFIEBOARD INSTRUCTIONS

Whatrsquos needed

ndash ProffieBoard

ndash micro SD-card (see page 44 for recommendations)

ndash a USB micro SD-card reader (to load sound files from PC to micro SD card)

ndash micro USB data transfer cable (CABLES THAT SUPPORT ONLY CHARGING WONrsquoT WORK)

ndash wires of different gauges (32-20 AWG) (PTFE coated copper stranded wires recommended) heat shrink

ndash ESD safe soldering station solder wire flux etc

ndash pliers helping hands etc

ndash isopropyl alcohol to clean pads before soldering (helps solder to stick better)

ndash Digital Multimeter (VERY USEFUL)

ndash computer running Windows Linux or Mac OS with internet access

ndash 37V Li-Ion Protected rechargeable battery switches recharge port speaker LEDs resistors chassis etc

ndash Smart Li-Ion CC-CV (Constant Current - Constant Voltage mode) battery charger for 37V (42V) cells

ndash patience

WIRING DIAGRAMS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 25

31

PROFFIEBOARD INSTRUCTIONS

Board pinout

Battery + ndash 26 to 45 volt input drives everything except the LEDs

Battery - ndash negative pad for LEDs needs to be at same level as GND when both are connected Both pads are internally connected

GND ndash ground for electronics except LEDs Note that there are two GND pads on the board that are internally connected

Speaker +- ndash hooks up to speaker

Activation (1) Aux (2) Aux2 button (3) ndash hook up to closing buttons or potentially touch buttons

Blade ID Neopixel Data 1 ndash normally used to measure the blade ID restor and if itrsquos a neopixel blade feed out neopixel data

Data 2 3 4 5 ndash additional neopixel data outputs or free for other purposes

LED 1 2 3 4 5 6 ndash hooks up to negative side of LED (positive side of LED hooks up directly to battery) These pads can handle

up to 30 volts

SDA SCL ndash these pins are used to wire OLED display or to communicate with the gyro and accelerometer chip

RX TX ndash these pins are used for wiring a bluetooth module for wireless control

SWDCLK SWDIO ndash can be hooked up to a ST-LINK device and lets you debug programs running on the ProffieBoard

+5V ndash generated by the ProffieBoard normally itrsquos only ON when sound is playing

+33V ndash generated by the ProffieBoard for powering OLED display Bluetooth module or some accent leds

BOOT RESET ndash buttons to put the ProffieBoard in bootloader mode if uploading doesnrsquot work

micro USB port ndash micro USB port used only for firmware upload and can be used for sound files upload to SD card (from firmware version

1291 and up) THIS PORT ISNrsquoT USED FOR CHARGING THE BATTERY

LED 4LED 3

LED 2

LED 1

LED 5

LED 6

RESETBOOT

Battery - Battery -

Speaker + (red dot or ldquo+rdquo mark on speaker)

Battery +

Aux button (2)Activation button (1)

Aux2 button (3)

Blade ID Neopixel Data 1

Data 5

Data 4Data 3Data 2

+33V

SWDIO

SWDCLK

+5V

TXRX

GND

GND

Reset

Speaker -

SCLSDA

micro USB port

WIRING DIAGRAMS

26 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Basic Tri-Cree wiring diagram(In-hilt LED)

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

+

+

-

-

26 AWG

26 A

WG

30-32 AWG

28-30 AWG

28-3

0 A

WG

30-32 AWG

Protected 36-37V (42V max at full charge) 10A 3500mAh battery recommended+18650 battery holder (optional)Keystone 1042P

AV switch with accent led(constantly ON no effects)

accent leds run mostly at10-15mA so resistors for them must be calculated accordingly

Main RGB led

additional RGB leds(optional)

In case no additional high power leds are needed LED channels 4 5 6 can be used for 3 controllable(programmable for different effects) accent leds So AV switch led can be wired to one of these channelsAccent leds also can be wired to Data pads 1-5 please see ldquoAccent LEDs wiring and setuprdquo page

LED Resistor Calculator

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 27

3WIRING DIAGRAMS1

Basic Tri-Cree wiring (In-hilt LED)ldquoconfighrdquo file setup

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

Use a given or build your wiring diagram on THIS PAGE then open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text

Editor (Notepad - to see code correctly in Notepad Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all

text) and Delete it then Copy-and-Paste (Ctrl+C Ctrl+V) your wiring diagram config code (example below) into empty _configh file and

Save it under new name Follow the instructions on page 22 to upload it to the board

ldquoproffieboard_v1_confighrdquoNUM_BLADES 2NUM_BUTTONS 2VOLUME 1000CLASH_THRESHOLD_G 10StyleNormalPtrltCYAN WHITE 300 800gt()StyleNormalPtrltCYAN WHITE 300 800gt()

CreeXPE2RedTemplatelt1000gtCreeXPE2GreenTemplatelt0gtCreeXPE2BlueTemplatelt240gtNoLED

ProffieBoard config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)Volume level (0-3000)Clash sensitivity (adjust lower or higher with 01 step)ldquoBlade 1rdquo styleldquoBlade 2rdquo style (in case only 1 blade is used you donrsquot need this line)LED configuration (use these XP-E2 LED templatesto define your LED If other LED resistors are used change these values to match Ohm1000=ltvaluegt)

where 1000 is 1 Ohm resistor 0 is no resistor240 is 024 Ohm resistorNoLED ndash no 4th led used

Preset 1

LED 1 configuration

LED 2 configuration

Preset 2 etc

PROFFIEBOARD INSTRUCTIONS

28 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Basic Neopixel wiring diagram

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

+

+

-

-

22 A

WG

22 AWG

x2 28 AWG

x2 26 AWG

22 A

WG

30-32 AWG30-32 AWG

Protected 36-37V (42V max at full charge) 10A 3500mAh or 15A 3120mAhbattery recommended+18650 battery holder (optional)Keystone 1042P

AV switch with accent led(constantly ON no effects)

accent leds run mostly at10-15mA so resistors for them must be calculated accordingly

Main Neopixel strip

additional Neopixelstrips(optional)

Neopixel bladeconnector

330 Ohm on the Blade pcb side

x3 28 AWGor x1 22 AWGfor Negative

330 Ohm on the Blade pcb side

arrows up

330 Ohm on the Blade pcb side

In case no additional Neopixel strips are needed LED channels 4 5 6 can be used for 3 controllable(programmable for different effects) accent leds So AV switch led can be wired to one of these channelsAccent leds also can be wired to Data pads 2-5 please see ldquoAccent LEDs wiring and setuprdquo page

Recommended power wire gauges (22 AWG) are given for 2-strip blade For 3-strip blade you gonna need at least 20 AWG wires

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 29

ldquoproffieboard_v1_confighrdquo

3WIRING DIAGRAMS1

Basic Neopixel wiringldquoconfighrdquo file setup

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

NUM_BLADES 3NUM_BUTTONS 2VOLUME 1000CLASH_THRESHOLD_G 10IgnitionDelaylt0 any blade stylegtIgnitionDelaylt800 any blade stylegtIgnitionDelaylt800 any blade stylegtWS2811BladePtrlt118 WS2811 800kHz | WS2811 GRBgt()WS2811BladePtrlt26 blade2Pin ltbladePowerPin4gtgt()WS2811BladePtrlt26 blade3Pin ltbladePowerPin5gtgt()

ProffieBoard config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)Volume level (0-3000)Clash sensitivity (adjust lower or higher with 01 step)ldquoBlade 1rdquo style (main blade with IgnitionDelay 0)ldquoBlade 2rdquo style (CG blade 1 with IgnitionDelay 800)ldquoBlade 3rdquo style (CG blade 2 with IgnitionDelay 800)

strip configuration (defines how many pixels it has and to which LED output and pin is wired)

Preset 1

any blade style

strip (blade) 1 configuration

adjust this number to match your strips leds count

strip (blade) 2 configuration

strip (blade) 3 configuration

Preset 2 etc

Use a given or build your wiring diagram on THIS PAGE then open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text

Editor (Notepad - to see code correctly in Notepad Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all

text) and Delete it then Copy-and-Paste (Ctrl+C Ctrl+V) your wiring diagram config code (example below) into empty _configh file and

Save it under new name Follow the instructions on page 22 to upload it to the board

PROFFIEBOARD INSTRUCTIONS

30 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Basic Segmented string wiring diagram

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

+

+

-

-

24 A

WG

28 AWG

30-32 AWG30-32 AWG

Protected 36-37V (42V max at full charge) 10A 3500mAh battery recommended+18650 battery holder (optional)Keystone 1042P

AV switch with accent led(constantly ON no effects)

accent leds run mostly at10-15mA so resistors for them must be calculated accordingly

6-segments string blade

FoC string

N-channel FET3A minimum

123456

Calculate resistors for each led segment of the blade string depending on which leds are used 5mm leds have max drive current around 25mA per led when 10mm leds can be 100mA and 200mA per ledSo pay attention to your led max current and Forward Voltage (Vf) when calculating a segment resistor resistence as well as its wattage Also choose wire gauges accordingly to meet segments and total blade max current draw level

LED Resistor Calculator

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 31

ldquoproffieboard_v1_confighrdquo

3WIRING DIAGRAMS1

Basic Segmented string wiringldquoconfighrdquo file setup

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

NUM_BLADES 1NUM_BUTTONS 2VOLUME 1000CLASH_THRESHOLD_G 10StyleNormalPtrltCYAN WHITE 300 800gt()ltBlue3mmLED BladePin White3mmLEDgt

ProffieBoard config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)Volume level (0-3000)Clash sensitivity (adjust lower or higher with 01 step)Blade styleLED string configuration(here you mention the color and type of leds usedin the main blade string segments and FoC stringBladePin is the FoC signal pin (Blade ID pin))

Preset

LED string configuration

Use a given or build your wiring diagram on THIS PAGE then open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text

Editor (Notepad - to see code correctly in Notepad Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all

text) and Delete it then Copy-and-Paste (Ctrl+C Ctrl+V) your wiring diagram config code (example below) into empty _configh file and

Save it under new name Follow the instructions on page 22 to upload it to the board

PROFFIEBOARD INSTRUCTIONS

32 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Accent LEDs wiring diagram(optional)

Accent LEDs work with ProffieBoard as additional ldquobladesrdquo when powered by LED outputs 4 5 6 or Data pads 1 2 3 5 as PWM So they can

have any effect that blade can have If no effects needed accent led can be powered just by a 33V output pad (power-on led indication)

30-32 AWG

with Neopixel blade setup these 4 outputsdonrsquot work for regular accent leds

Recommended resistors to use for accent leds at 33V power source and 15mA drive

ndash 100 Ohm for Red (lt100000gt value in the code)ndash 13 Ohm for Green (lt13000gt value in the code)ndash 13 Ohm for Blue (lt13000gt value in the code)ndash 100 Ohm for Yellow (lt100000gt value in the code)ndash 20 Ohm for White (lt20000gt value in the code)

RGB ledcommon-anode

8 ldquobladesrdquo1 main and 7 accent leds

main blade style (effects) main blade style (effects)

7 accent leds style (effects)accent led style (effects)

7 accent leds configurations

RGB accent led configuration

2 ldquobladesrdquo1 main and 1 RGB accent led

ldquoPower-onrdquo indicationaccent leds (no effects)

7 accent leds withindependent effects

RGB accent led

a) b)

b)

c)

c)

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 33

3WIRING DIAGRAMS1

Neopixel Accent LEDs wiring diagram(optional)

With Neopixel setup additional neopixel leds or arrays can be used as accent leds There are 2 ways to wire them using additional Data

pins 2 3 4 5 or ldquoSub-bladesrdquo wiring with just 1 Data output pin Same way Neopixel connectors with on-board leds ca be wired

Option 1 ndash with extra Data pins

Main Blade

some accent leds

D1

D2

crystal leds

330 Ohm

330 Ohm

330 Ohm

main blade style (effects)

main blade 144 leds Data pin 1

accent leds blade style (effects)

accent leds ldquobladerdquo 4 leds Data pin 2

crystal leds blade style (effects)

crystal leds ldquobladerdquo 2 leds Data pin 3

3 ldquobladesrdquo1 main 1 accent leds array and 1 crystal leds array

PROFFIEBOARD INSTRUCTIONS

D3

follow arrows direction

34 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Neopixel Accent LEDs wiring diagram(optional)

PROFFIEBOARD INSTRUCTIONS

Main Blade

some accent leds

1

3

5678

2

4

D1

crystal leds

follow arrows direction

330 Ohm

330 OhmData signal

With this setup a single array of neopixel leds is separated into a couple of sub-blades with their own style configuration and behaviour This

is really usefull when you want to use only one data pin More about ldquoSub-bladesrdquo on ProffieOS wiki page

Option 2 ndash with ldquoSub-bladesrdquo

main blade style (effects)

main blade sub-blade 140 leds (7-146) but from 6 to 145 in the code

accent leds blade style (effects)

accent leds sub-blade 4 leds (1-4) but from 0 to 3 in the code

crystal leds blade style (effects)

146 leds total used

crystal leds sub-blade 2 leds (5-6) but from 4 to 5 in the code

update default 144 to a higher total value if you get all accent leds +Main blade gt 144 Example update to 146 if you have 2 crystal leds +4 accent leds + 140 Main blade leds = 146

3 ldquobladesrdquo 1 main 1 accent leds array and 1 crystal leds array

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 35

3WIRING DIAGRAMS1

OLED display wiring diagram(optional)

SSD1306 128x32 pixels OLED display allows to show battery level current preset name play different animations and even simple games It

can be wired to any blade configuration and requires just one additional line in the code to work You can get monochrome display in white

or blue color

SSD1306128x32OLED

SSD1306 ndash with blue or white display color selectSSD1306 ndash cheaper priceSSD1306 just screen ndash blue or white select

30-32 AWG

30-32 AWG

add this line to enable OLED display

display shows a preset name written in these quotes ldquoldquo

PROFFIEBOARD INSTRUCTIONS

36 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Bluetooth module wiring diagram(optional)

SOON

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 37

3WIRING DIAGRAMS1

Blade ID resistor functions(optional)

SOON

PROFFIEBOARD INSTRUCTIONS

38 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

website ProffieBoard FULL wiring diagrams link

Scroll the page down till you see the interactive diagram Above the diagram there are components selection options Build your saber setup

with it and follow diagram to wire your board Then you need to copy the configuration code below and paste it into your _configh file

Choose components you want

3WIRING DIAGRAMS1

More wiring diagrams

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 39

3WIRING DIAGRAMS1

How to use it

PROFFIEBOARD INSTRUCTIONS

Blade ignitionretraction ndash assuming you have at least one button pressing it briefly should turn the saber on or off If you have an AUX button pressing it briefly should also turn the saber on and off If you have no buttons you can turn the saber on and off by twisting your wrist back and forth Note that the motion has to be done long enough to count so a very quick flick of the wrist will not workTurn On muted ndash double-click power buttonNext preset ndash while saber is off click the AUX buttonPrevious preset ndash hold AUX button and click the Activation buttonTrigger Clash ndash while saber is on hit the bladeTrigger Lockup ndash while saber is on hold Activation button then trigger a clash Lockup releases when you let go of the Acti-vation buttonTrigger Drag ndash like lockup but point saber mostly down before holding Activation buttonTrigger Force ndash long-click AUX buttonStart soundtrack ndash long-click the Activation buttonTrigger Blaster Block ndash while saber is on short-click AUX button

Serial Monitor commands

battery_voltage ndash gets current battery voltage valueget_volume ndash get current volume valuepow ndash power OnOff the saberon ndash power On the saberoff ndash power Off the saberset_volume lt0-3000gt ndash set volume value (example set_volume 500)play ndash play the default preset trackplay trackslttrack namegt ndash play a specific track from tracks folder (example play tracksvenuswav)stop ndash stop the playing trackforce ndash play ldquoforcerdquo sound effectsdrag ndash play ldquodragrdquo sound effectsblast ndash play ldquoblasterrdquo sound effectslock ndash play ldquolockuprdquo sound effectsclash ndash play ldquoclashrdquo sound effectsreset ndash reboot the boardn ndash switch to next presetp ndash switch to previous presetlist_presets ndash show all presetssdtest ndash test SD card speed

40 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3FIRMWARE UPLOAD AND UPDATE2

Software installation and setup

PROFFIEBOARD INSTRUCTIONS

To upload firmware to ProffieBoard Arduino IDE program is required Follow these steps to install it to your PC

1 Install latest Arduino IDE software (donrsquot use BETA)

Installing as Windows app also is not recommended

because it will be installed in a specific protected folder that

wonrsquot allow you to install any additional softwareplugin in it

If ProffieBoard wonrsquot show up in COM port use

Arduino IDE 186 version

2 Install the Proffieboard Arduino Plugin and Zadig software

Follow installation instructions

3 Select Proffieboard-STM32L433 in Tools -gt Board

USB Type ndash Serial CPU Speed ndash 80 MHz Optimize ndash Smallest Code DOSFS ndash SDCARD (SPI) Port ndash COM(the number your PC assigned) (Butterfly-L433CC)

Connect Proffieboard via USB cable to PC to be able to select

the Port

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 41

3FIRMWARE UPLOAD AND UPDATE2

Uploading firmware

PROFFIEBOARD INSTRUCTIONS

1 Download the ProffieBoard firmware and SD card content

Unzip lightsaber-1286zip to your Documents directory or to

Desktop but not to Arduino program folder or anywhere in

Programs directory where all programs are installed You will

see a lightsaber folder and files inside it Donrsquot move any of

these files to any other location outside the lightsaber folder

and donrsquot reorganize them Unzip ProffieOS_SD_Cardzip to the

folder where you keep lightsaber-1286 folder Copy all files

from ProffieOS_SD_Card folder to your SD card

2 Unhide file extensions in File Explorer settings to see h ending

of config files Donrsquot add ldquohrdquo to the config file name Go to config folder and create you own configh file (see page

42 for how-to)

Double-click the lightsaberino file

3 Add the name of your configh file as shown and Save this

lightsaberino file Make sure the other config files are

commented out there should be only one CONFIG_FILE

without You can have multiple config files

in lightsabergtconfig folder and just define the one you need

in lightsaberino file and upload it again to ProffieBoard

4 Connect battery to ProffieBoard and hook up to your PC

with a data transfer micro-USB-to-USB cable

Press arrow button it will compile and upload firmware to the

board Wait for red text progress bars to stop at 100

ProffieBoard will play boot sound if speaker is connected

Now you can unplug the USB cable Done

If it gives an error instead this means your configh file has

issues define CONFIG_FILE name has mistakes configh file

is out of config folder your PC user name is non-latin

42 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

33

configh file structure editing

PROFFIEBOARD INSTRUCTIONS

CHANGING PARAMETERS

All sound files (sound fonts music tracks) are stored on the micro SD card Add required sound fonts folders (Plecter NEC and Smoothswing

fonts are supported no need to change WAV files names just copy and paste) to SD card root directory as itrsquos done in the default

ProffieOS_SD_Card content folder and music tracks to the tracks folder

Make sure to name all music tracks and sound fonts folders with latin characters and only up to 8 characters long without using any special

characters (like |[- etc)

Make sure you have a configini file in each sound font folder if there is none - copy one from some default TeensySaberProffieBoard sound

font and paste into newly added sound font folder It has only one parameter that you can modify - humstart It helps to match hum sound

start with blade ignition 1000 usually works fine

All blade effects LED configuration volume level clash sensitivity etc are changed in the configh file located in lightsabergtconfig folder

To do that open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text Editor (Notepad - to see code correctly in Notepad

Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all text) and Delete it then Copy-and-Paste (Ctrl+C

Ctrl+V) your wiring diagram config code into empty _configh file and Save it under new name Follow the instructions on page 39 to

upload it to the board

Proffieboard config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)

volume level (0-3000)

clash sensitivity (adjust lower or higher with 01 step)

sound font folder nametrack name

Preset name

Blade style

LED configuration (use these XP-E2 LED templatesto define your LED)

for Red use 1 Ohm resistor for Green - no resistor for Blue use 024 Ohm

NoLED ndash no 4th led used

Preset 1

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 43

33

Blade Styles

StylePtrltInOutHelperltSimpleClashltLockupltBlastltOnSparkltAudioFlickerltRgblt02550gtRgblt501000gtgtRgblt2552550gt150gtRgblt255500gtgtAudioFlickerltRgblt1002550gtRgblt2550150gtgtgtRgblt255100150gt40gt200300Blackgtgt

ndash this is how the Blade Style code looks pasted in the configh file Preset (it sits inside a StylePtrltgt container)

ndash this is how the Blade Style code looks when editing it inside a Blade Style Editor

Each Blade Style is made of a variety of Effects each added effect goes instead of a base color in the previous effect

PROFFIEBOARD INSTRUCTIONS

CHANGING PARAMETERS

ProffieBoard and TeensySaber use Blade Styles for the main saber blade and any other accent leds to define all light effects (color changing

flashes flickering delays ignitionretraction timing etc)

Use Blade Style Editor to create and adjust Blade Styles Megtooth Sith Sabers did a great video tutorial where he shows and explains

how to use Blade Style Editor Also you can grab some pre-made Blade Styles or share yours here on TRA forums

A Blade Style example of simple flickering Green blade with Spark on start Clash Blaster Lockup and Drag IgnitionRetraction effects

InOutHelperltSimpleClashltLockupltBlastltOnSparkltAudioFlickerltRgblt02550gtRgblt501000gtgtRgblt2552550gt150gtRgblt255500gtgtAudioFlickerltRgblt1002550gtRgblt2550150gtgtgtRgblt255100150gt40gt200300Blackgt

InOutHelperltbase color200300Blackgt ndash base color can be defined by words (WHITE RED GREEN PURPLE etc) or by Rgblt0-2550-2550-255gt values for more

custom shades 200 is extension length in milliseconds 300 is retraction length in milliseconds Black is color when retracted (also can be any other color)

SimpleClashltbase colorclash color40gt ndash clash effect 40 is clash duration in milliseconds

Lockupltbase colorlockup colorgt ndash lockup effect

Blastltbase colorblast colorgt ndash blaster effect

OnSparkltbase colorspark color150gt ndash spark on ignition effect 150 is spark duration in milliseconds

AudioFlickerltrdquoArdquo colorrdquoBrdquo colorgt ndash flickering effect (blade flickers to the actual saber hum sound) the more difference between ldquoArdquo and ldquoBrdquo colors - the more

abrupt is flickering

Rgblt255500gt ndash actual color in RGB format (0 is no light 255 is the maximum brightness value for Red Green or Blue channel)

44 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

ndash SanDisk 4GB microSDHC Class 4 (Genuine) ndash SanDisk 4GB microSDHC Class 4 (Genuine)

130238 kbs = 1477 simultaneous audio streams 137812 kbs = 1562 simultaneous audio streams

ndash Patriot LX Series 16GB microSDHC UHS-IU1 Class 10 ndash Patriot LX Series 16GB microSDHC UHS-IU1 Class 10

133005 kbs = 1508 simultaneous audio streams

ndash GSkill 16GB microSDHC UHS-IU1 Class 10 ndash GSkill 16GB microSDHC UHS-IU1 Class 10

129534 kbs = 1469 simultaneous audio streams

ndash Kingston 16GB microSDHC UHS-IU1 Class 10 ndash Kingston 16GB microSDHC UHS-IU1 Class 10

128090 kbs = 1452 simultaneous audio streams

ndash SanDisk Ultra 16GB microSDHC UHS-IU1 A1 Class 10 ndash SanDisk Ultra 16GB microSDHC UHS-IU1 A1 Class 10

102663 kbs = 1164 simultaneous audio streams 11124 kbs = 1261 simultaneous audio streams

ndash SanDisk 8GB microSDHC Class 4 ndash SanDisk 8GB microSDHC Class 4

108506 kbs = 1230 simultaneous audio streams

ndash SanDisk 16GB microSDHC Class 4 ndash SanDisk 16GB microSDHC Class 4

102663 kbs = 1164 simultaneous audio streams 106957 kbs = 1213 simultaneous audio streams

ndash SanDisk Ultra 16GB microSDHC UHS-IU1 Class 10 ndash SanDisk Ultra 16GB microSDHC UHS-IU1 Class 10

102663 kbs = 1164 simultaneous audio streams 103909 kbs = 1178 simultaneous audio streams

ndash Smartbuy 4GB microSDHC Class 4 ndash Smartbuy 4GB microSDHC Class 4

75437 kbs = 855 simultaneous audio streams

ndash Kingston 8GB microSDHC Class 4 ndash Kingston 8GB microSDHC Class 4

75209 kbs = 822 simultaneous audio streams

ndash SanDisk 4GB microSDHC Class 4 (Fake) ndash SanDisk 4GB microSDHC Class 4 (Fake)

677 kbs = 769 simultaneous audio streams

Here is a list of tested micro SD cards speed with TeensySaber V3 and ProffieBoard Any card with speed over 900 kbs is recommended the

higher the speed is ndash the better Memory size of 4-16Gb is more than enough Cards were tested with a default firmware (1291) compiled

with ldquoSmallest Coderdquo under Optimize ldquodefault_proffieboard_confighrdquo file and default ProffieOS SD card sound files (7 folders)

To test your SD card speed simply hook up ProffieBoard to PC open Arduino IDE go to Tools and open Serial Monitor make sure you have

New Line and 9600 baud rate selected on the bottom of Serial Monitor window type and send sdtest command wait for the test result

4Recommended micro SD cards

BEST

TEENSYSABER PROFFIEBOARD

GOOD

BAD

PROFFIEBOARD INSTRUCTIONS

SD CARD RECOMMENDATIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 45

There are a lot of fake (chinese copies) microSD cards on the market from aliexpress ebay amazon etc They look very similar to genuine

cards but are a bit different though and have a twice lower writingreading speed Here is an example of a SanDisk 4Gb Class 4 card one is

genuine with 137812 kbs speed and the other one is fake with 677 kbs speed I got from ebay seller

Be carefull and pay attention to how the actual card looks if you are not sure ask seller for the real photo of SD card he sells

4Genuine and Fake SanDisk 4Gb Class 4 microSD

PROFFIEBOARD INSTRUCTIONS

SD CARD RECOMMENDATIONS

46 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

WIRE GAUGE GUIDE

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 47

RECHARGE PORTS AND KILL SWITCHES

48 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

NEOPIXEL STRIPS CURRENT DRAW

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 49

6TROUBLESHOOTING

For more help please check these linksProffieOSProffieBoardTeensySaber wiki on GitHubAsk your question on The Rebel Armory forumsAsk your question on FX-sabers forumsAsk your question in facebook group

How to solve most common issues

Quick troubleshooting tips

TeensySaber board or Proffieboard is not recognized by computer (nothing under Port selection in Arduino)

ndash Make sure a charged 37V battery is connected to the board micro-USB cable is a data transfer cable all plugins and drivers are installed ndash

check again pages 21 for TeensySaber or 40 for Proffieboard Try a different USB port on your computer

Sketch (code) compile error in Arduino IDE

ndash Check your define CONFIG_FILE ldquoconfig_confighrdquo line in opened lightsaberino file if itrsquos written correctly with config in it

Sketch (code) compile error in Arduino IDE

ndash Check if the _configh file you defined in the lightsaberino sketch file is same name as in the lightsaber-rdquofirmware versionrdquolightsaber

config folder and is located in this folder

Sketch (code) compile error in Arduino IDE

ndash Check your settings under Tools tab in Arduino IDE program Check again pages 21 for TeensySaber or 40 for Proffieboard

Sketch (code) compile error in Arduino IDE

ndash Check if your _configh file is correct Blade Styles Presets const unsigned int maxLedsPerStrip = 144 if BladeConfig blades[] = is correct

Sketch (code) compile error in Arduino IDE

ndash If nothing helps install Arduino IDE version 186 and try to compile and upload the firmware again

Sound doesnrsquot play

ndash Remove SD card and insert again check speaker wiring Make sure all sound files on SD card are correctly named (8 characters max long)

Re-format SD card in FAT32 load sound files and try again try another SD card

Board says ldquoLOW POWERrdquo

ndash Charge the battery

Serial Monitor shows info sent by the board but your commands donrsquot work

ndash In the bottom right corner of Serial Monitor window make sure the Line Ending drop down is set to New Line

Sound is weird and distorted

ndash Check your SD card speed (see page 44) Check speaker wiring try another good speaker

06 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

Board pinout

used pads

Battery + ndash 26 to 45 volt input drives everything except the LEDs

Battery - ndash negative pad for LEDs needs to be at same level as GND when both are connected

GND ndash ground for electronics except LEDs Note that GND is also available on short edge of the teensy (See the teensy pinout for details)

Speaker +- ndash hooks up to speaker

Activation Aux Aux2 button ndash hook up to closing buttons or potentially touch buttons

Blade ID Neopixel Data 1 ndash normally used to measure the blade ID restor and if itrsquos a neopixel blade feed out neopixel data

LED 1 2 3 ndash hooks up to negative side of LED (positive side of LED hooks up directly to battery) These pads can handle

up to 30 volts

LED 4 5 6 ndash like LED123 but requires FETs to be placed on the bottom of the board to function Voltage is limited by

selection of FETs

Power 1 Power 2 Power 3 ndash these control the FETs which drive LED 1 2 3

AUX LED 1 2 3 ndash these are hooked up to pads on the bottom which can be populated with FETs and used to drive additional LEDs If the

bottom FETs are not populated these pins are free and can be used for any purpose

RX3 TX3 ndash these pins are used for wiring a bluetooth module for wireless control or additional Neopixel Data out

SDA SCL ndash these pins are used to wire OLED display

+33V 250mA max ndash generated by the Teensy for powering OLED display or Bluetooth module

micro USB port ndash micro USB port used only for firmware upload and can be used for sound files upload to SD card

THIS PORT ISNrsquoT USED FOR CHARGING THE BATTERY

LED output 1 2 3

Battery - Speaker + (red dot or ldquo+rdquo mark on speaker)Battery +

Data in (SD) SCK (SD)

Battery Volt SenseAux button

Activation buttonAux2 button

SDA

SCL

Blade ID Neopixel Data 1Audio data

Audio LRClock

Power 3+33VAudio GND (not used)+5V

Data out (SD)

Power 2

Audio clock

TX3Neopixel Data 2

RX3Neopixel Data 3

Power 1AUX3 LEDAUX2 LEDAUX1 LED

Motion InterruptAmplifier enable

SD card selectGND

Speaker -

LED output 4 5 6

micro USB port on Teensy 32

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 07

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

Board assembling

1 IMPORTANT

Cut the tiny trace with a knife between VIN and VUSB as shown

Teensy 32 bottom view

2 Solder 254mm header pins (gold plated recommended) to

TeensySaber V3 board on the top or on the bottom depending

on where you want to put Teensy 32 board

(please see next step)

3 Solder Teensy 32 board on top

(A ndash micro USB port on top SD card between boards) or on the bottom (B ndash SD card on top micro USB port between boards)

A B

+

08 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

Basic Tri-Cree wiring diagram(In-hilt LED)

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

+

+

+

-

-

-

26 A

WG

26 AWG

30-32 AWG

28-30 AWG

28-30 AWG

30-32 AWG

Protected 36-37V (42V max at full charge) 10A 3500mAh battery recommended+18650 battery holder (optional)Keystone 1042P

AV switch with accent led(constantly ON no effects)

accent leds run mostly at10-15mA so resistors for them must be calculated accordingly

Main RGB led

additional RGB leds(optional)

In case no additional high power leds are needed LED channels 4 5 6can be used for 3 controllable (programmable for different effects) accent leds So AV switch led can be wired to one of these channelsby adding 1 MOSFET

LED Resistor Calculator

solder 3x FETs

solder 1 FET

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 09

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

Basic Tri-Cree wiring (In-hilt LED)ldquoconfighrdquo file setup

Use a given or build your wiring diagram on THIS PAGE then open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text

Editor (Notepad - to see code correctly in Notepad Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all

text) and Delete it then Copy-and-Paste (Ctrl+C Ctrl+V) your wiring diagram config code (example below) into empty _configh file and

Save it under new name Follow the instructions on page 22 to upload it to the board

ldquov3_confighrdquoNUM_BLADES 2NUM_BUTTONS 2VOLUME 1000CLASH_THRESHOLD_G 10StyleNormalPtrltCYAN WHITE 300 800gt()StyleNormalPtrltCYAN WHITE 300 800gt()

CreeXPE2RedTemplatelt1000gtCreeXPE2GreenTemplatelt0gtCreeXPE2BlueTemplatelt240gtNoLED

TeensySaber V3 config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)Volume level (0-3000)Clash sensitivity (adjust lower or higher with 01 step)ldquoBlade 1rdquo styleldquoBlade 2rdquo style (in case only 1 blade is used you donrsquot need this line)LED configuration (use these XP-E2 LED templatesto define your LED If other LED resistors are used change these values to match Ohm1000=ltvaluegt)

where 1000 is 1 Ohm resistor 0 is no resistor240 is 024 Ohm resistorNoLED ndash no 4th led used

Preset 1

LED 1 configuration

LED 2 configuration

Preset 2 etc

10 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

Basic Neopixel wiring diagram

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

+

+

+

-

-

-

22 A

WG

22 AWG

26 AWG

30 AWG

x2 28 AWG

x2 26 AWG

22 A

WG

30-32 AWG

30-32 AWG

Protected 36-37V (42V max at full charge) 10A 3500mAh or 15A 3120mAhbattery recommended+18650 battery holder (optional)Keystone 1042P

AV switch with accent led(constantly ON no effects)

accent leds run mostly at10-15mA so resistors for them must be calculated accordingly

Main Neopixel strip

additional Neopixelstrips(optional)

Neopixel bladeconnector

330 Ohm on the Blade pcb side

x3 28 AWGor x1 22 AWGfor Negative

330 Ohm on the Blade pcb side

arrows up

330 Ohm on the Blade pcb side

In case no additional Neopixel strips are needed LED channels 4 5 6can be used for 3 controllable (programmable for different effects) accent leds So AV switch led can be wired to one of these channelsby adding 1 MOSFETRecommended power wire gauges (22 AWG) are given for 2-strip blade For 3-strip blade you gonna need at least 20 AWG wires

solder 2x FETs

solder 1 FET

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 11

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

Basic Neopixel wiringldquoconfighrdquo file setup

ldquov3_confighrdquoNUM_BLADES 3NUM_BUTTONS 2VOLUME 1000CLASH_THRESHOLD_G 10IgnitionDelaylt0 any blade stylegtIgnitionDelaylt800 any blade stylegtIgnitionDelaylt800 any blade stylegtWS2811BladePtrlt118 WS2811 800kHz | WS2811 GRBgt()WS2811BladePtrlt26 7 ltbladePowerPin4gtgt()WS2811BladePtrlt26 8 ltbladePowerPin5gtgt()

TeensySaber V3 config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)Volume level (0-3000)Clash sensitivity (adjust lower or higher with 01 step)ldquoBlade 1rdquo style (main blade with IgnitionDelay 0)ldquoBlade 2rdquo style (CG blade 1 with IgnitionDelay 800)ldquoBlade 3rdquo style (CG blade 2 with IgnitionDelay 800)

strip configuration (defines how many pixels it has and to which LED output and pin is wired)

Preset 1

any blade style

strip (blade) 1 configuration

strip (blade) 2 configuration

strip (blade) 3 configuration

Preset 2 etc

Use a given or build your wiring diagram on THIS PAGE then open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text

Editor (Notepad - to see code correctly in Notepad Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all

text) and Delete it then Copy-and-Paste (Ctrl+C Ctrl+V) your wiring diagram config code (example below) into empty _configh file and

Save it under new name Follow the instructions on page 22 to upload it to the board

12 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

Basic Segmented string wiring diagram

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

+

+

-

-

24 A

WG

28 AWG

30-32 AWG

30-32 AWG

Protected 36-37V (42V max at full charge) 10A 3500mAh battery recommended+18650 battery holder (optional)Keystone 1042P

AV switch with accent led(constantly ON no effects)

accent leds run mostly at10-15mA so resistors for them must be calculated accordingly

6-segments string blade

FoC string

N-channel FET3A minimum

1

1 46 523

23456

Calculate resistors for each led segment of the blade string depending on which leds are used 5mm leds have max drive current around 25mA per led when 10mm leds can be 100mA and 200mA per ledSo pay attention to your led max current and Forward Voltage (Vf) when calculating a segment resistor resistence as well as its wattage Also choose wire gauges accordingly to meet segments and total blade max current draw level

LED Resistor Calculator

solder 3x FETs

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 13

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

Basic Segmented string wiringldquoconfighrdquo file setup

ldquov3_confighrdquoNUM_BLADES 1NUM_BUTTONS 2VOLUME 1000CLASH_THRESHOLD_G 10StyleNormalPtrltCYAN WHITE 300 800gt()ltBlue3mmLED 20 White3mmLEDgt

TeensySaber V3 config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)Volume level (0-3000)Clash sensitivity (adjust lower or higher with 01 step)Blade styleLED string configuration(here you mention the color and type of leds usedin the main blade string segments and FoC string20 is the FoC signal pin (Blade ID pin))

Preset

LED string configuration

Use a given or build your wiring diagram on THIS PAGE then open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text

Editor (Notepad - to see code correctly in Notepad Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all

text) and Delete it then Copy-and-Paste (Ctrl+C Ctrl+V) your wiring diagram config code (example below) into empty _configh file and

Save it under new name Follow the instructions on page 22 to upload it to the board

14 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

Accent LEDs wiring diagram(optional)

Accent LEDs work with TeensySaber board as additional ldquobladesrdquo when powered by LED outputs 4 5 6 with FETs So they can have any effect

that blade can have If no effects needed accent led can be powered just by a 33V output pad (power-on led indication)

30-32 AWGRGB ledcommon-anode

4 ldquobladesrdquo1 main and 3 accent leds

main blade style (effects) main blade style (effects)

3 accent leds style (effects)accent led style (effects)

3 accent leds configurations

RGB accent led configuration

2 ldquobladesrdquo1 main and 1 RGB accent led

ldquoPower-onrdquo indicationaccent leds (no effects)

3 accent leds withindependent effects

+ 1 or more simple accent leds without effects

1 RGB accent led+ 1 or more simple accent leds

without effects

a) b)

b)

c)

c)

solder 3x FETs solder 3x FETs

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 15

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

OLED display wiring diagram(optional)

SSD1306 128x32 pixels OLED display allows to show battery level current preset name play different animations and even simple games It

can be wired to any blade configuration and requires just one additional line in the code to work You can get monochrome display in white

or blue color

SSD1306128x32OLED

SSD1306 ndash with blue or white display color selectSSD1306 ndash cheaper priceSSD1306 just screen ndash blue or white select

30-32 AWG

30-32 AWG

add this line to enable OLED display

display shows a preset name written in these quotes ldquoldquo

16 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

Bluetooth module wiring diagram(optional)

SOON

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 17

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

Blade ID resistor functions(optional)

SOON

18 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

website TeensySaber V3 FULL wiring diagrams link

Scroll the page down till you see the interactive diagram Above the diagram there are components selection options Build your saber setup

with it and follow diagram to wire your board Then you need to copy the configuration code below and paste it into your _configh file

Choose components you want

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

More wiring diagrams

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 19

20 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

How to use it

Blade ignitionretraction ndash assuming you have at least one button pressing it briefly should turn the saber on or off If you have an AUX button pressing it briefly should also turn the saber on and off If you have no buttons you can turn the saber on and off by twisting your wrist back and forth Note that the motion has to be done long enough to count so a very quick flick of the wrist will not workTurn On muted ndash double-click power buttonNext preset ndash while saber is off click the AUX buttonPrevious preset ndash hold AUX button and click the Activation buttonTrigger Clash ndash while saber is on hit the bladeTrigger Lockup ndash while saber is on hold Activation button then trigger a clash Lockup releases when you let go of the Acti-vation buttonTrigger Drag ndash like lockup but point saber mostly down before holding Activation buttonTrigger Force ndash long-click AUX buttonStart soundtrack ndash long-click the Activation buttonTrigger Blaster Block ndash while saber is on short-click AUX button

Serial Monitor commands

battery_voltage ndash gets current battery voltage valueget_volume ndash get current volume valuepow ndash power OnOff the saberon ndash power On the saberoff ndash power Off the saberset_volume lt0-3000gt ndash set volume value (example set_volume 500)play ndash play the default preset trackplay trackslttrack namegt ndash play a specific track from tracks folder (example play tracksvenuswav)stop ndash stop the playing trackforce ndash play ldquoforcerdquo sound effectsdrag ndash play ldquodragrdquo sound effectsblast ndash play ldquoblasterrdquo sound effectslock ndash play ldquolockuprdquo sound effectsclash ndash play ldquoclashrdquo sound effectsreset ndash reboot the boardn ndash switch to next presetp ndash switch to previous presetlist_presets ndash show all presetssdtest ndash test SD card speed

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 21

2TEENSYSABER V3 INSTRUCTIONS

FIRMWARE UPLOAD AND UPDATE2

Software installation and setup

To upload firmware to TeensySaber board Arduino IDE program is required Follow these steps to install it to your PC

1 Install latest Arduino IDE software (donrsquot use BETA)

Installing as Windows app also is not recommended

because it will be installed in a specific protected folder that

wonrsquot allow you to install Teensyduino software in it

If TeensySaber wonrsquot show up in COM port use

Arduino IDE 186 version

2 Install latest Teensyduino software in same directory

usually itrsquos CProgram Files (x86)Arduino on Windows

Follow installation instructions for your system

3 Select Teensy 32 31 in Tools -gt Board

USB Type ndash Serial CPU Speed ndash 96 MHz (overclock) Optimize ndash Smallest Code Port ndash COM(the number your PC assigned) (Teensy 32) Serial

Connect TeensySaber via USB cable to PC to be able to select

the Port donrsquot forget to connect battery first

22 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

1 Download the TeensySaber firmware and SD card content

Unzip lightsaber-1286zip to your Documents directory or to

Desktop but not to Arduino program folder or anywhere in

Programs directory where all programs are installed You will

see a lightsaber folder and files inside it Donrsquot move any of

these files to any other location outside the lightsaber folder

and donrsquot reorganize them Unzip ProffieOS_SD_Cardzip to the

folder where you keep lightsaber-1286 folder Copy all files

from ProffieOS_SD_Card folder to your SD card

2 Unhide file extensions in File Explorer settings to see h ending

of config files Donrsquot add ldquohrdquo to the config file name

Go to config folder and create you own configh file (see page

23 for how-to)

Double-click the lightsaberino file

3 Add the name of your configh file as shown and Save this

lightsaberino file Make sure the other config files are

commented out there should be only one CONFIG_FILE

without You can have multiple config files

in lightsabergtconfig folder and just define the one you need

in lightsaberino file and upload it again to TeensySaber board

4 Connect battery to TeensySaber board and hook up to your PC

with a data transfer micro-USB-to-USB cable

Press arrow button it will compile and upload firmware to the

board Wait for your PC to make a sound or TeensySaber will

play boot sound if speaker is connected Now you can unplug

the USB cable Done

If it gives an error instead this means your configh file has

issues define CONFIG_FILE name has mistakes configh file

is out of config folder your PC user name is non-latin

2TEENSYSABER V3 INSTRUCTIONS

FIRMWARE UPLOAD AND UPDATE2

Uploading firmware

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 23

2TEENSYSABER V3 INSTRUCTIONS

CHANGING PARAMETERS3

Changing sound board parameters

All sound files (sound fonts music tracks) are stored on the micro SD card Add required sound fonts folders (Plecter NEC and Smoothswing

fonts are supported no need to change WAV files names just copy and paste) to SD card root directory as itrsquos done in the default

ProffieOS_SD_Card content folder and music tracks to the tracks folder

Make sure to name all music tracks and sound fonts folders with latin characters and only up to 8 characters long without using any special

characters (like |[- etc)

Make sure you have a configini file in each sound font folder if there is none - copy one from some default TeensySaberProffieBoard sound

font and paste into newly added sound font folder It has only one parameter that you can modify - humstart It helps to match hum sound

start with blade ignition 1000 usually works fine

All blade effects LED configuration volume level clash sensitivity etc are changed in the configh file located in lightsabergtconfig folder

To do that open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text Editor (Notepad - to see code correctly in Notepad

Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all text) and Delete it then Copy-and-Paste (Ctrl+C

Ctrl+V) your wiring diagram config code into empty _configh file and Save it under new name Follow the instructions on page 22 to

upload it to the board

TeensySaber V3 config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)

volume level (0-3000)

clash sensitivity (adjust lower or higher with 01 step)

sound font folder nametrack name

Preset name

Blade style

LED configuration (use these XP-E2 LED templatesto define your LED)

for Red use 1 Ohm resistor for Green - no resistor for Blue use 024 Ohm

NoLED ndash no 4th led used

Preset 1

24 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

31

PROFFIEBOARD INSTRUCTIONS

Whatrsquos needed

ndash ProffieBoard

ndash micro SD-card (see page 44 for recommendations)

ndash a USB micro SD-card reader (to load sound files from PC to micro SD card)

ndash micro USB data transfer cable (CABLES THAT SUPPORT ONLY CHARGING WONrsquoT WORK)

ndash wires of different gauges (32-20 AWG) (PTFE coated copper stranded wires recommended) heat shrink

ndash ESD safe soldering station solder wire flux etc

ndash pliers helping hands etc

ndash isopropyl alcohol to clean pads before soldering (helps solder to stick better)

ndash Digital Multimeter (VERY USEFUL)

ndash computer running Windows Linux or Mac OS with internet access

ndash 37V Li-Ion Protected rechargeable battery switches recharge port speaker LEDs resistors chassis etc

ndash Smart Li-Ion CC-CV (Constant Current - Constant Voltage mode) battery charger for 37V (42V) cells

ndash patience

WIRING DIAGRAMS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 25

31

PROFFIEBOARD INSTRUCTIONS

Board pinout

Battery + ndash 26 to 45 volt input drives everything except the LEDs

Battery - ndash negative pad for LEDs needs to be at same level as GND when both are connected Both pads are internally connected

GND ndash ground for electronics except LEDs Note that there are two GND pads on the board that are internally connected

Speaker +- ndash hooks up to speaker

Activation (1) Aux (2) Aux2 button (3) ndash hook up to closing buttons or potentially touch buttons

Blade ID Neopixel Data 1 ndash normally used to measure the blade ID restor and if itrsquos a neopixel blade feed out neopixel data

Data 2 3 4 5 ndash additional neopixel data outputs or free for other purposes

LED 1 2 3 4 5 6 ndash hooks up to negative side of LED (positive side of LED hooks up directly to battery) These pads can handle

up to 30 volts

SDA SCL ndash these pins are used to wire OLED display or to communicate with the gyro and accelerometer chip

RX TX ndash these pins are used for wiring a bluetooth module for wireless control

SWDCLK SWDIO ndash can be hooked up to a ST-LINK device and lets you debug programs running on the ProffieBoard

+5V ndash generated by the ProffieBoard normally itrsquos only ON when sound is playing

+33V ndash generated by the ProffieBoard for powering OLED display Bluetooth module or some accent leds

BOOT RESET ndash buttons to put the ProffieBoard in bootloader mode if uploading doesnrsquot work

micro USB port ndash micro USB port used only for firmware upload and can be used for sound files upload to SD card (from firmware version

1291 and up) THIS PORT ISNrsquoT USED FOR CHARGING THE BATTERY

LED 4LED 3

LED 2

LED 1

LED 5

LED 6

RESETBOOT

Battery - Battery -

Speaker + (red dot or ldquo+rdquo mark on speaker)

Battery +

Aux button (2)Activation button (1)

Aux2 button (3)

Blade ID Neopixel Data 1

Data 5

Data 4Data 3Data 2

+33V

SWDIO

SWDCLK

+5V

TXRX

GND

GND

Reset

Speaker -

SCLSDA

micro USB port

WIRING DIAGRAMS

26 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Basic Tri-Cree wiring diagram(In-hilt LED)

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

+

+

-

-

26 AWG

26 A

WG

30-32 AWG

28-30 AWG

28-3

0 A

WG

30-32 AWG

Protected 36-37V (42V max at full charge) 10A 3500mAh battery recommended+18650 battery holder (optional)Keystone 1042P

AV switch with accent led(constantly ON no effects)

accent leds run mostly at10-15mA so resistors for them must be calculated accordingly

Main RGB led

additional RGB leds(optional)

In case no additional high power leds are needed LED channels 4 5 6 can be used for 3 controllable(programmable for different effects) accent leds So AV switch led can be wired to one of these channelsAccent leds also can be wired to Data pads 1-5 please see ldquoAccent LEDs wiring and setuprdquo page

LED Resistor Calculator

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 27

3WIRING DIAGRAMS1

Basic Tri-Cree wiring (In-hilt LED)ldquoconfighrdquo file setup

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

Use a given or build your wiring diagram on THIS PAGE then open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text

Editor (Notepad - to see code correctly in Notepad Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all

text) and Delete it then Copy-and-Paste (Ctrl+C Ctrl+V) your wiring diagram config code (example below) into empty _configh file and

Save it under new name Follow the instructions on page 22 to upload it to the board

ldquoproffieboard_v1_confighrdquoNUM_BLADES 2NUM_BUTTONS 2VOLUME 1000CLASH_THRESHOLD_G 10StyleNormalPtrltCYAN WHITE 300 800gt()StyleNormalPtrltCYAN WHITE 300 800gt()

CreeXPE2RedTemplatelt1000gtCreeXPE2GreenTemplatelt0gtCreeXPE2BlueTemplatelt240gtNoLED

ProffieBoard config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)Volume level (0-3000)Clash sensitivity (adjust lower or higher with 01 step)ldquoBlade 1rdquo styleldquoBlade 2rdquo style (in case only 1 blade is used you donrsquot need this line)LED configuration (use these XP-E2 LED templatesto define your LED If other LED resistors are used change these values to match Ohm1000=ltvaluegt)

where 1000 is 1 Ohm resistor 0 is no resistor240 is 024 Ohm resistorNoLED ndash no 4th led used

Preset 1

LED 1 configuration

LED 2 configuration

Preset 2 etc

PROFFIEBOARD INSTRUCTIONS

28 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Basic Neopixel wiring diagram

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

+

+

-

-

22 A

WG

22 AWG

x2 28 AWG

x2 26 AWG

22 A

WG

30-32 AWG30-32 AWG

Protected 36-37V (42V max at full charge) 10A 3500mAh or 15A 3120mAhbattery recommended+18650 battery holder (optional)Keystone 1042P

AV switch with accent led(constantly ON no effects)

accent leds run mostly at10-15mA so resistors for them must be calculated accordingly

Main Neopixel strip

additional Neopixelstrips(optional)

Neopixel bladeconnector

330 Ohm on the Blade pcb side

x3 28 AWGor x1 22 AWGfor Negative

330 Ohm on the Blade pcb side

arrows up

330 Ohm on the Blade pcb side

In case no additional Neopixel strips are needed LED channels 4 5 6 can be used for 3 controllable(programmable for different effects) accent leds So AV switch led can be wired to one of these channelsAccent leds also can be wired to Data pads 2-5 please see ldquoAccent LEDs wiring and setuprdquo page

Recommended power wire gauges (22 AWG) are given for 2-strip blade For 3-strip blade you gonna need at least 20 AWG wires

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 29

ldquoproffieboard_v1_confighrdquo

3WIRING DIAGRAMS1

Basic Neopixel wiringldquoconfighrdquo file setup

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

NUM_BLADES 3NUM_BUTTONS 2VOLUME 1000CLASH_THRESHOLD_G 10IgnitionDelaylt0 any blade stylegtIgnitionDelaylt800 any blade stylegtIgnitionDelaylt800 any blade stylegtWS2811BladePtrlt118 WS2811 800kHz | WS2811 GRBgt()WS2811BladePtrlt26 blade2Pin ltbladePowerPin4gtgt()WS2811BladePtrlt26 blade3Pin ltbladePowerPin5gtgt()

ProffieBoard config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)Volume level (0-3000)Clash sensitivity (adjust lower or higher with 01 step)ldquoBlade 1rdquo style (main blade with IgnitionDelay 0)ldquoBlade 2rdquo style (CG blade 1 with IgnitionDelay 800)ldquoBlade 3rdquo style (CG blade 2 with IgnitionDelay 800)

strip configuration (defines how many pixels it has and to which LED output and pin is wired)

Preset 1

any blade style

strip (blade) 1 configuration

adjust this number to match your strips leds count

strip (blade) 2 configuration

strip (blade) 3 configuration

Preset 2 etc

Use a given or build your wiring diagram on THIS PAGE then open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text

Editor (Notepad - to see code correctly in Notepad Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all

text) and Delete it then Copy-and-Paste (Ctrl+C Ctrl+V) your wiring diagram config code (example below) into empty _configh file and

Save it under new name Follow the instructions on page 22 to upload it to the board

PROFFIEBOARD INSTRUCTIONS

30 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Basic Segmented string wiring diagram

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

+

+

-

-

24 A

WG

28 AWG

30-32 AWG30-32 AWG

Protected 36-37V (42V max at full charge) 10A 3500mAh battery recommended+18650 battery holder (optional)Keystone 1042P

AV switch with accent led(constantly ON no effects)

accent leds run mostly at10-15mA so resistors for them must be calculated accordingly

6-segments string blade

FoC string

N-channel FET3A minimum

123456

Calculate resistors for each led segment of the blade string depending on which leds are used 5mm leds have max drive current around 25mA per led when 10mm leds can be 100mA and 200mA per ledSo pay attention to your led max current and Forward Voltage (Vf) when calculating a segment resistor resistence as well as its wattage Also choose wire gauges accordingly to meet segments and total blade max current draw level

LED Resistor Calculator

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 31

ldquoproffieboard_v1_confighrdquo

3WIRING DIAGRAMS1

Basic Segmented string wiringldquoconfighrdquo file setup

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

NUM_BLADES 1NUM_BUTTONS 2VOLUME 1000CLASH_THRESHOLD_G 10StyleNormalPtrltCYAN WHITE 300 800gt()ltBlue3mmLED BladePin White3mmLEDgt

ProffieBoard config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)Volume level (0-3000)Clash sensitivity (adjust lower or higher with 01 step)Blade styleLED string configuration(here you mention the color and type of leds usedin the main blade string segments and FoC stringBladePin is the FoC signal pin (Blade ID pin))

Preset

LED string configuration

Use a given or build your wiring diagram on THIS PAGE then open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text

Editor (Notepad - to see code correctly in Notepad Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all

text) and Delete it then Copy-and-Paste (Ctrl+C Ctrl+V) your wiring diagram config code (example below) into empty _configh file and

Save it under new name Follow the instructions on page 22 to upload it to the board

PROFFIEBOARD INSTRUCTIONS

32 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Accent LEDs wiring diagram(optional)

Accent LEDs work with ProffieBoard as additional ldquobladesrdquo when powered by LED outputs 4 5 6 or Data pads 1 2 3 5 as PWM So they can

have any effect that blade can have If no effects needed accent led can be powered just by a 33V output pad (power-on led indication)

30-32 AWG

with Neopixel blade setup these 4 outputsdonrsquot work for regular accent leds

Recommended resistors to use for accent leds at 33V power source and 15mA drive

ndash 100 Ohm for Red (lt100000gt value in the code)ndash 13 Ohm for Green (lt13000gt value in the code)ndash 13 Ohm for Blue (lt13000gt value in the code)ndash 100 Ohm for Yellow (lt100000gt value in the code)ndash 20 Ohm for White (lt20000gt value in the code)

RGB ledcommon-anode

8 ldquobladesrdquo1 main and 7 accent leds

main blade style (effects) main blade style (effects)

7 accent leds style (effects)accent led style (effects)

7 accent leds configurations

RGB accent led configuration

2 ldquobladesrdquo1 main and 1 RGB accent led

ldquoPower-onrdquo indicationaccent leds (no effects)

7 accent leds withindependent effects

RGB accent led

a) b)

b)

c)

c)

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 33

3WIRING DIAGRAMS1

Neopixel Accent LEDs wiring diagram(optional)

With Neopixel setup additional neopixel leds or arrays can be used as accent leds There are 2 ways to wire them using additional Data

pins 2 3 4 5 or ldquoSub-bladesrdquo wiring with just 1 Data output pin Same way Neopixel connectors with on-board leds ca be wired

Option 1 ndash with extra Data pins

Main Blade

some accent leds

D1

D2

crystal leds

330 Ohm

330 Ohm

330 Ohm

main blade style (effects)

main blade 144 leds Data pin 1

accent leds blade style (effects)

accent leds ldquobladerdquo 4 leds Data pin 2

crystal leds blade style (effects)

crystal leds ldquobladerdquo 2 leds Data pin 3

3 ldquobladesrdquo1 main 1 accent leds array and 1 crystal leds array

PROFFIEBOARD INSTRUCTIONS

D3

follow arrows direction

34 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Neopixel Accent LEDs wiring diagram(optional)

PROFFIEBOARD INSTRUCTIONS

Main Blade

some accent leds

1

3

5678

2

4

D1

crystal leds

follow arrows direction

330 Ohm

330 OhmData signal

With this setup a single array of neopixel leds is separated into a couple of sub-blades with their own style configuration and behaviour This

is really usefull when you want to use only one data pin More about ldquoSub-bladesrdquo on ProffieOS wiki page

Option 2 ndash with ldquoSub-bladesrdquo

main blade style (effects)

main blade sub-blade 140 leds (7-146) but from 6 to 145 in the code

accent leds blade style (effects)

accent leds sub-blade 4 leds (1-4) but from 0 to 3 in the code

crystal leds blade style (effects)

146 leds total used

crystal leds sub-blade 2 leds (5-6) but from 4 to 5 in the code

update default 144 to a higher total value if you get all accent leds +Main blade gt 144 Example update to 146 if you have 2 crystal leds +4 accent leds + 140 Main blade leds = 146

3 ldquobladesrdquo 1 main 1 accent leds array and 1 crystal leds array

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 35

3WIRING DIAGRAMS1

OLED display wiring diagram(optional)

SSD1306 128x32 pixels OLED display allows to show battery level current preset name play different animations and even simple games It

can be wired to any blade configuration and requires just one additional line in the code to work You can get monochrome display in white

or blue color

SSD1306128x32OLED

SSD1306 ndash with blue or white display color selectSSD1306 ndash cheaper priceSSD1306 just screen ndash blue or white select

30-32 AWG

30-32 AWG

add this line to enable OLED display

display shows a preset name written in these quotes ldquoldquo

PROFFIEBOARD INSTRUCTIONS

36 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Bluetooth module wiring diagram(optional)

SOON

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 37

3WIRING DIAGRAMS1

Blade ID resistor functions(optional)

SOON

PROFFIEBOARD INSTRUCTIONS

38 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

website ProffieBoard FULL wiring diagrams link

Scroll the page down till you see the interactive diagram Above the diagram there are components selection options Build your saber setup

with it and follow diagram to wire your board Then you need to copy the configuration code below and paste it into your _configh file

Choose components you want

3WIRING DIAGRAMS1

More wiring diagrams

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 39

3WIRING DIAGRAMS1

How to use it

PROFFIEBOARD INSTRUCTIONS

Blade ignitionretraction ndash assuming you have at least one button pressing it briefly should turn the saber on or off If you have an AUX button pressing it briefly should also turn the saber on and off If you have no buttons you can turn the saber on and off by twisting your wrist back and forth Note that the motion has to be done long enough to count so a very quick flick of the wrist will not workTurn On muted ndash double-click power buttonNext preset ndash while saber is off click the AUX buttonPrevious preset ndash hold AUX button and click the Activation buttonTrigger Clash ndash while saber is on hit the bladeTrigger Lockup ndash while saber is on hold Activation button then trigger a clash Lockup releases when you let go of the Acti-vation buttonTrigger Drag ndash like lockup but point saber mostly down before holding Activation buttonTrigger Force ndash long-click AUX buttonStart soundtrack ndash long-click the Activation buttonTrigger Blaster Block ndash while saber is on short-click AUX button

Serial Monitor commands

battery_voltage ndash gets current battery voltage valueget_volume ndash get current volume valuepow ndash power OnOff the saberon ndash power On the saberoff ndash power Off the saberset_volume lt0-3000gt ndash set volume value (example set_volume 500)play ndash play the default preset trackplay trackslttrack namegt ndash play a specific track from tracks folder (example play tracksvenuswav)stop ndash stop the playing trackforce ndash play ldquoforcerdquo sound effectsdrag ndash play ldquodragrdquo sound effectsblast ndash play ldquoblasterrdquo sound effectslock ndash play ldquolockuprdquo sound effectsclash ndash play ldquoclashrdquo sound effectsreset ndash reboot the boardn ndash switch to next presetp ndash switch to previous presetlist_presets ndash show all presetssdtest ndash test SD card speed

40 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3FIRMWARE UPLOAD AND UPDATE2

Software installation and setup

PROFFIEBOARD INSTRUCTIONS

To upload firmware to ProffieBoard Arduino IDE program is required Follow these steps to install it to your PC

1 Install latest Arduino IDE software (donrsquot use BETA)

Installing as Windows app also is not recommended

because it will be installed in a specific protected folder that

wonrsquot allow you to install any additional softwareplugin in it

If ProffieBoard wonrsquot show up in COM port use

Arduino IDE 186 version

2 Install the Proffieboard Arduino Plugin and Zadig software

Follow installation instructions

3 Select Proffieboard-STM32L433 in Tools -gt Board

USB Type ndash Serial CPU Speed ndash 80 MHz Optimize ndash Smallest Code DOSFS ndash SDCARD (SPI) Port ndash COM(the number your PC assigned) (Butterfly-L433CC)

Connect Proffieboard via USB cable to PC to be able to select

the Port

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 41

3FIRMWARE UPLOAD AND UPDATE2

Uploading firmware

PROFFIEBOARD INSTRUCTIONS

1 Download the ProffieBoard firmware and SD card content

Unzip lightsaber-1286zip to your Documents directory or to

Desktop but not to Arduino program folder or anywhere in

Programs directory where all programs are installed You will

see a lightsaber folder and files inside it Donrsquot move any of

these files to any other location outside the lightsaber folder

and donrsquot reorganize them Unzip ProffieOS_SD_Cardzip to the

folder where you keep lightsaber-1286 folder Copy all files

from ProffieOS_SD_Card folder to your SD card

2 Unhide file extensions in File Explorer settings to see h ending

of config files Donrsquot add ldquohrdquo to the config file name Go to config folder and create you own configh file (see page

42 for how-to)

Double-click the lightsaberino file

3 Add the name of your configh file as shown and Save this

lightsaberino file Make sure the other config files are

commented out there should be only one CONFIG_FILE

without You can have multiple config files

in lightsabergtconfig folder and just define the one you need

in lightsaberino file and upload it again to ProffieBoard

4 Connect battery to ProffieBoard and hook up to your PC

with a data transfer micro-USB-to-USB cable

Press arrow button it will compile and upload firmware to the

board Wait for red text progress bars to stop at 100

ProffieBoard will play boot sound if speaker is connected

Now you can unplug the USB cable Done

If it gives an error instead this means your configh file has

issues define CONFIG_FILE name has mistakes configh file

is out of config folder your PC user name is non-latin

42 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

33

configh file structure editing

PROFFIEBOARD INSTRUCTIONS

CHANGING PARAMETERS

All sound files (sound fonts music tracks) are stored on the micro SD card Add required sound fonts folders (Plecter NEC and Smoothswing

fonts are supported no need to change WAV files names just copy and paste) to SD card root directory as itrsquos done in the default

ProffieOS_SD_Card content folder and music tracks to the tracks folder

Make sure to name all music tracks and sound fonts folders with latin characters and only up to 8 characters long without using any special

characters (like |[- etc)

Make sure you have a configini file in each sound font folder if there is none - copy one from some default TeensySaberProffieBoard sound

font and paste into newly added sound font folder It has only one parameter that you can modify - humstart It helps to match hum sound

start with blade ignition 1000 usually works fine

All blade effects LED configuration volume level clash sensitivity etc are changed in the configh file located in lightsabergtconfig folder

To do that open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text Editor (Notepad - to see code correctly in Notepad

Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all text) and Delete it then Copy-and-Paste (Ctrl+C

Ctrl+V) your wiring diagram config code into empty _configh file and Save it under new name Follow the instructions on page 39 to

upload it to the board

Proffieboard config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)

volume level (0-3000)

clash sensitivity (adjust lower or higher with 01 step)

sound font folder nametrack name

Preset name

Blade style

LED configuration (use these XP-E2 LED templatesto define your LED)

for Red use 1 Ohm resistor for Green - no resistor for Blue use 024 Ohm

NoLED ndash no 4th led used

Preset 1

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 43

33

Blade Styles

StylePtrltInOutHelperltSimpleClashltLockupltBlastltOnSparkltAudioFlickerltRgblt02550gtRgblt501000gtgtRgblt2552550gt150gtRgblt255500gtgtAudioFlickerltRgblt1002550gtRgblt2550150gtgtgtRgblt255100150gt40gt200300Blackgtgt

ndash this is how the Blade Style code looks pasted in the configh file Preset (it sits inside a StylePtrltgt container)

ndash this is how the Blade Style code looks when editing it inside a Blade Style Editor

Each Blade Style is made of a variety of Effects each added effect goes instead of a base color in the previous effect

PROFFIEBOARD INSTRUCTIONS

CHANGING PARAMETERS

ProffieBoard and TeensySaber use Blade Styles for the main saber blade and any other accent leds to define all light effects (color changing

flashes flickering delays ignitionretraction timing etc)

Use Blade Style Editor to create and adjust Blade Styles Megtooth Sith Sabers did a great video tutorial where he shows and explains

how to use Blade Style Editor Also you can grab some pre-made Blade Styles or share yours here on TRA forums

A Blade Style example of simple flickering Green blade with Spark on start Clash Blaster Lockup and Drag IgnitionRetraction effects

InOutHelperltSimpleClashltLockupltBlastltOnSparkltAudioFlickerltRgblt02550gtRgblt501000gtgtRgblt2552550gt150gtRgblt255500gtgtAudioFlickerltRgblt1002550gtRgblt2550150gtgtgtRgblt255100150gt40gt200300Blackgt

InOutHelperltbase color200300Blackgt ndash base color can be defined by words (WHITE RED GREEN PURPLE etc) or by Rgblt0-2550-2550-255gt values for more

custom shades 200 is extension length in milliseconds 300 is retraction length in milliseconds Black is color when retracted (also can be any other color)

SimpleClashltbase colorclash color40gt ndash clash effect 40 is clash duration in milliseconds

Lockupltbase colorlockup colorgt ndash lockup effect

Blastltbase colorblast colorgt ndash blaster effect

OnSparkltbase colorspark color150gt ndash spark on ignition effect 150 is spark duration in milliseconds

AudioFlickerltrdquoArdquo colorrdquoBrdquo colorgt ndash flickering effect (blade flickers to the actual saber hum sound) the more difference between ldquoArdquo and ldquoBrdquo colors - the more

abrupt is flickering

Rgblt255500gt ndash actual color in RGB format (0 is no light 255 is the maximum brightness value for Red Green or Blue channel)

44 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

ndash SanDisk 4GB microSDHC Class 4 (Genuine) ndash SanDisk 4GB microSDHC Class 4 (Genuine)

130238 kbs = 1477 simultaneous audio streams 137812 kbs = 1562 simultaneous audio streams

ndash Patriot LX Series 16GB microSDHC UHS-IU1 Class 10 ndash Patriot LX Series 16GB microSDHC UHS-IU1 Class 10

133005 kbs = 1508 simultaneous audio streams

ndash GSkill 16GB microSDHC UHS-IU1 Class 10 ndash GSkill 16GB microSDHC UHS-IU1 Class 10

129534 kbs = 1469 simultaneous audio streams

ndash Kingston 16GB microSDHC UHS-IU1 Class 10 ndash Kingston 16GB microSDHC UHS-IU1 Class 10

128090 kbs = 1452 simultaneous audio streams

ndash SanDisk Ultra 16GB microSDHC UHS-IU1 A1 Class 10 ndash SanDisk Ultra 16GB microSDHC UHS-IU1 A1 Class 10

102663 kbs = 1164 simultaneous audio streams 11124 kbs = 1261 simultaneous audio streams

ndash SanDisk 8GB microSDHC Class 4 ndash SanDisk 8GB microSDHC Class 4

108506 kbs = 1230 simultaneous audio streams

ndash SanDisk 16GB microSDHC Class 4 ndash SanDisk 16GB microSDHC Class 4

102663 kbs = 1164 simultaneous audio streams 106957 kbs = 1213 simultaneous audio streams

ndash SanDisk Ultra 16GB microSDHC UHS-IU1 Class 10 ndash SanDisk Ultra 16GB microSDHC UHS-IU1 Class 10

102663 kbs = 1164 simultaneous audio streams 103909 kbs = 1178 simultaneous audio streams

ndash Smartbuy 4GB microSDHC Class 4 ndash Smartbuy 4GB microSDHC Class 4

75437 kbs = 855 simultaneous audio streams

ndash Kingston 8GB microSDHC Class 4 ndash Kingston 8GB microSDHC Class 4

75209 kbs = 822 simultaneous audio streams

ndash SanDisk 4GB microSDHC Class 4 (Fake) ndash SanDisk 4GB microSDHC Class 4 (Fake)

677 kbs = 769 simultaneous audio streams

Here is a list of tested micro SD cards speed with TeensySaber V3 and ProffieBoard Any card with speed over 900 kbs is recommended the

higher the speed is ndash the better Memory size of 4-16Gb is more than enough Cards were tested with a default firmware (1291) compiled

with ldquoSmallest Coderdquo under Optimize ldquodefault_proffieboard_confighrdquo file and default ProffieOS SD card sound files (7 folders)

To test your SD card speed simply hook up ProffieBoard to PC open Arduino IDE go to Tools and open Serial Monitor make sure you have

New Line and 9600 baud rate selected on the bottom of Serial Monitor window type and send sdtest command wait for the test result

4Recommended micro SD cards

BEST

TEENSYSABER PROFFIEBOARD

GOOD

BAD

PROFFIEBOARD INSTRUCTIONS

SD CARD RECOMMENDATIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 45

There are a lot of fake (chinese copies) microSD cards on the market from aliexpress ebay amazon etc They look very similar to genuine

cards but are a bit different though and have a twice lower writingreading speed Here is an example of a SanDisk 4Gb Class 4 card one is

genuine with 137812 kbs speed and the other one is fake with 677 kbs speed I got from ebay seller

Be carefull and pay attention to how the actual card looks if you are not sure ask seller for the real photo of SD card he sells

4Genuine and Fake SanDisk 4Gb Class 4 microSD

PROFFIEBOARD INSTRUCTIONS

SD CARD RECOMMENDATIONS

46 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

WIRE GAUGE GUIDE

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 47

RECHARGE PORTS AND KILL SWITCHES

48 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

NEOPIXEL STRIPS CURRENT DRAW

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 49

6TROUBLESHOOTING

For more help please check these linksProffieOSProffieBoardTeensySaber wiki on GitHubAsk your question on The Rebel Armory forumsAsk your question on FX-sabers forumsAsk your question in facebook group

How to solve most common issues

Quick troubleshooting tips

TeensySaber board or Proffieboard is not recognized by computer (nothing under Port selection in Arduino)

ndash Make sure a charged 37V battery is connected to the board micro-USB cable is a data transfer cable all plugins and drivers are installed ndash

check again pages 21 for TeensySaber or 40 for Proffieboard Try a different USB port on your computer

Sketch (code) compile error in Arduino IDE

ndash Check your define CONFIG_FILE ldquoconfig_confighrdquo line in opened lightsaberino file if itrsquos written correctly with config in it

Sketch (code) compile error in Arduino IDE

ndash Check if the _configh file you defined in the lightsaberino sketch file is same name as in the lightsaber-rdquofirmware versionrdquolightsaber

config folder and is located in this folder

Sketch (code) compile error in Arduino IDE

ndash Check your settings under Tools tab in Arduino IDE program Check again pages 21 for TeensySaber or 40 for Proffieboard

Sketch (code) compile error in Arduino IDE

ndash Check if your _configh file is correct Blade Styles Presets const unsigned int maxLedsPerStrip = 144 if BladeConfig blades[] = is correct

Sketch (code) compile error in Arduino IDE

ndash If nothing helps install Arduino IDE version 186 and try to compile and upload the firmware again

Sound doesnrsquot play

ndash Remove SD card and insert again check speaker wiring Make sure all sound files on SD card are correctly named (8 characters max long)

Re-format SD card in FAT32 load sound files and try again try another SD card

Board says ldquoLOW POWERrdquo

ndash Charge the battery

Serial Monitor shows info sent by the board but your commands donrsquot work

ndash In the bottom right corner of Serial Monitor window make sure the Line Ending drop down is set to New Line

Sound is weird and distorted

ndash Check your SD card speed (see page 44) Check speaker wiring try another good speaker

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 07

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

Board assembling

1 IMPORTANT

Cut the tiny trace with a knife between VIN and VUSB as shown

Teensy 32 bottom view

2 Solder 254mm header pins (gold plated recommended) to

TeensySaber V3 board on the top or on the bottom depending

on where you want to put Teensy 32 board

(please see next step)

3 Solder Teensy 32 board on top

(A ndash micro USB port on top SD card between boards) or on the bottom (B ndash SD card on top micro USB port between boards)

A B

+

08 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

Basic Tri-Cree wiring diagram(In-hilt LED)

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

+

+

+

-

-

-

26 A

WG

26 AWG

30-32 AWG

28-30 AWG

28-30 AWG

30-32 AWG

Protected 36-37V (42V max at full charge) 10A 3500mAh battery recommended+18650 battery holder (optional)Keystone 1042P

AV switch with accent led(constantly ON no effects)

accent leds run mostly at10-15mA so resistors for them must be calculated accordingly

Main RGB led

additional RGB leds(optional)

In case no additional high power leds are needed LED channels 4 5 6can be used for 3 controllable (programmable for different effects) accent leds So AV switch led can be wired to one of these channelsby adding 1 MOSFET

LED Resistor Calculator

solder 3x FETs

solder 1 FET

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 09

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

Basic Tri-Cree wiring (In-hilt LED)ldquoconfighrdquo file setup

Use a given or build your wiring diagram on THIS PAGE then open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text

Editor (Notepad - to see code correctly in Notepad Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all

text) and Delete it then Copy-and-Paste (Ctrl+C Ctrl+V) your wiring diagram config code (example below) into empty _configh file and

Save it under new name Follow the instructions on page 22 to upload it to the board

ldquov3_confighrdquoNUM_BLADES 2NUM_BUTTONS 2VOLUME 1000CLASH_THRESHOLD_G 10StyleNormalPtrltCYAN WHITE 300 800gt()StyleNormalPtrltCYAN WHITE 300 800gt()

CreeXPE2RedTemplatelt1000gtCreeXPE2GreenTemplatelt0gtCreeXPE2BlueTemplatelt240gtNoLED

TeensySaber V3 config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)Volume level (0-3000)Clash sensitivity (adjust lower or higher with 01 step)ldquoBlade 1rdquo styleldquoBlade 2rdquo style (in case only 1 blade is used you donrsquot need this line)LED configuration (use these XP-E2 LED templatesto define your LED If other LED resistors are used change these values to match Ohm1000=ltvaluegt)

where 1000 is 1 Ohm resistor 0 is no resistor240 is 024 Ohm resistorNoLED ndash no 4th led used

Preset 1

LED 1 configuration

LED 2 configuration

Preset 2 etc

10 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

Basic Neopixel wiring diagram

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

+

+

+

-

-

-

22 A

WG

22 AWG

26 AWG

30 AWG

x2 28 AWG

x2 26 AWG

22 A

WG

30-32 AWG

30-32 AWG

Protected 36-37V (42V max at full charge) 10A 3500mAh or 15A 3120mAhbattery recommended+18650 battery holder (optional)Keystone 1042P

AV switch with accent led(constantly ON no effects)

accent leds run mostly at10-15mA so resistors for them must be calculated accordingly

Main Neopixel strip

additional Neopixelstrips(optional)

Neopixel bladeconnector

330 Ohm on the Blade pcb side

x3 28 AWGor x1 22 AWGfor Negative

330 Ohm on the Blade pcb side

arrows up

330 Ohm on the Blade pcb side

In case no additional Neopixel strips are needed LED channels 4 5 6can be used for 3 controllable (programmable for different effects) accent leds So AV switch led can be wired to one of these channelsby adding 1 MOSFETRecommended power wire gauges (22 AWG) are given for 2-strip blade For 3-strip blade you gonna need at least 20 AWG wires

solder 2x FETs

solder 1 FET

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 11

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

Basic Neopixel wiringldquoconfighrdquo file setup

ldquov3_confighrdquoNUM_BLADES 3NUM_BUTTONS 2VOLUME 1000CLASH_THRESHOLD_G 10IgnitionDelaylt0 any blade stylegtIgnitionDelaylt800 any blade stylegtIgnitionDelaylt800 any blade stylegtWS2811BladePtrlt118 WS2811 800kHz | WS2811 GRBgt()WS2811BladePtrlt26 7 ltbladePowerPin4gtgt()WS2811BladePtrlt26 8 ltbladePowerPin5gtgt()

TeensySaber V3 config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)Volume level (0-3000)Clash sensitivity (adjust lower or higher with 01 step)ldquoBlade 1rdquo style (main blade with IgnitionDelay 0)ldquoBlade 2rdquo style (CG blade 1 with IgnitionDelay 800)ldquoBlade 3rdquo style (CG blade 2 with IgnitionDelay 800)

strip configuration (defines how many pixels it has and to which LED output and pin is wired)

Preset 1

any blade style

strip (blade) 1 configuration

strip (blade) 2 configuration

strip (blade) 3 configuration

Preset 2 etc

Use a given or build your wiring diagram on THIS PAGE then open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text

Editor (Notepad - to see code correctly in Notepad Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all

text) and Delete it then Copy-and-Paste (Ctrl+C Ctrl+V) your wiring diagram config code (example below) into empty _configh file and

Save it under new name Follow the instructions on page 22 to upload it to the board

12 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

Basic Segmented string wiring diagram

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

+

+

-

-

24 A

WG

28 AWG

30-32 AWG

30-32 AWG

Protected 36-37V (42V max at full charge) 10A 3500mAh battery recommended+18650 battery holder (optional)Keystone 1042P

AV switch with accent led(constantly ON no effects)

accent leds run mostly at10-15mA so resistors for them must be calculated accordingly

6-segments string blade

FoC string

N-channel FET3A minimum

1

1 46 523

23456

Calculate resistors for each led segment of the blade string depending on which leds are used 5mm leds have max drive current around 25mA per led when 10mm leds can be 100mA and 200mA per ledSo pay attention to your led max current and Forward Voltage (Vf) when calculating a segment resistor resistence as well as its wattage Also choose wire gauges accordingly to meet segments and total blade max current draw level

LED Resistor Calculator

solder 3x FETs

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 13

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

Basic Segmented string wiringldquoconfighrdquo file setup

ldquov3_confighrdquoNUM_BLADES 1NUM_BUTTONS 2VOLUME 1000CLASH_THRESHOLD_G 10StyleNormalPtrltCYAN WHITE 300 800gt()ltBlue3mmLED 20 White3mmLEDgt

TeensySaber V3 config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)Volume level (0-3000)Clash sensitivity (adjust lower or higher with 01 step)Blade styleLED string configuration(here you mention the color and type of leds usedin the main blade string segments and FoC string20 is the FoC signal pin (Blade ID pin))

Preset

LED string configuration

Use a given or build your wiring diagram on THIS PAGE then open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text

Editor (Notepad - to see code correctly in Notepad Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all

text) and Delete it then Copy-and-Paste (Ctrl+C Ctrl+V) your wiring diagram config code (example below) into empty _configh file and

Save it under new name Follow the instructions on page 22 to upload it to the board

14 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

Accent LEDs wiring diagram(optional)

Accent LEDs work with TeensySaber board as additional ldquobladesrdquo when powered by LED outputs 4 5 6 with FETs So they can have any effect

that blade can have If no effects needed accent led can be powered just by a 33V output pad (power-on led indication)

30-32 AWGRGB ledcommon-anode

4 ldquobladesrdquo1 main and 3 accent leds

main blade style (effects) main blade style (effects)

3 accent leds style (effects)accent led style (effects)

3 accent leds configurations

RGB accent led configuration

2 ldquobladesrdquo1 main and 1 RGB accent led

ldquoPower-onrdquo indicationaccent leds (no effects)

3 accent leds withindependent effects

+ 1 or more simple accent leds without effects

1 RGB accent led+ 1 or more simple accent leds

without effects

a) b)

b)

c)

c)

solder 3x FETs solder 3x FETs

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 15

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

OLED display wiring diagram(optional)

SSD1306 128x32 pixels OLED display allows to show battery level current preset name play different animations and even simple games It

can be wired to any blade configuration and requires just one additional line in the code to work You can get monochrome display in white

or blue color

SSD1306128x32OLED

SSD1306 ndash with blue or white display color selectSSD1306 ndash cheaper priceSSD1306 just screen ndash blue or white select

30-32 AWG

30-32 AWG

add this line to enable OLED display

display shows a preset name written in these quotes ldquoldquo

16 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

Bluetooth module wiring diagram(optional)

SOON

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 17

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

Blade ID resistor functions(optional)

SOON

18 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

website TeensySaber V3 FULL wiring diagrams link

Scroll the page down till you see the interactive diagram Above the diagram there are components selection options Build your saber setup

with it and follow diagram to wire your board Then you need to copy the configuration code below and paste it into your _configh file

Choose components you want

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

More wiring diagrams

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 19

20 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

How to use it

Blade ignitionretraction ndash assuming you have at least one button pressing it briefly should turn the saber on or off If you have an AUX button pressing it briefly should also turn the saber on and off If you have no buttons you can turn the saber on and off by twisting your wrist back and forth Note that the motion has to be done long enough to count so a very quick flick of the wrist will not workTurn On muted ndash double-click power buttonNext preset ndash while saber is off click the AUX buttonPrevious preset ndash hold AUX button and click the Activation buttonTrigger Clash ndash while saber is on hit the bladeTrigger Lockup ndash while saber is on hold Activation button then trigger a clash Lockup releases when you let go of the Acti-vation buttonTrigger Drag ndash like lockup but point saber mostly down before holding Activation buttonTrigger Force ndash long-click AUX buttonStart soundtrack ndash long-click the Activation buttonTrigger Blaster Block ndash while saber is on short-click AUX button

Serial Monitor commands

battery_voltage ndash gets current battery voltage valueget_volume ndash get current volume valuepow ndash power OnOff the saberon ndash power On the saberoff ndash power Off the saberset_volume lt0-3000gt ndash set volume value (example set_volume 500)play ndash play the default preset trackplay trackslttrack namegt ndash play a specific track from tracks folder (example play tracksvenuswav)stop ndash stop the playing trackforce ndash play ldquoforcerdquo sound effectsdrag ndash play ldquodragrdquo sound effectsblast ndash play ldquoblasterrdquo sound effectslock ndash play ldquolockuprdquo sound effectsclash ndash play ldquoclashrdquo sound effectsreset ndash reboot the boardn ndash switch to next presetp ndash switch to previous presetlist_presets ndash show all presetssdtest ndash test SD card speed

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 21

2TEENSYSABER V3 INSTRUCTIONS

FIRMWARE UPLOAD AND UPDATE2

Software installation and setup

To upload firmware to TeensySaber board Arduino IDE program is required Follow these steps to install it to your PC

1 Install latest Arduino IDE software (donrsquot use BETA)

Installing as Windows app also is not recommended

because it will be installed in a specific protected folder that

wonrsquot allow you to install Teensyduino software in it

If TeensySaber wonrsquot show up in COM port use

Arduino IDE 186 version

2 Install latest Teensyduino software in same directory

usually itrsquos CProgram Files (x86)Arduino on Windows

Follow installation instructions for your system

3 Select Teensy 32 31 in Tools -gt Board

USB Type ndash Serial CPU Speed ndash 96 MHz (overclock) Optimize ndash Smallest Code Port ndash COM(the number your PC assigned) (Teensy 32) Serial

Connect TeensySaber via USB cable to PC to be able to select

the Port donrsquot forget to connect battery first

22 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

1 Download the TeensySaber firmware and SD card content

Unzip lightsaber-1286zip to your Documents directory or to

Desktop but not to Arduino program folder or anywhere in

Programs directory where all programs are installed You will

see a lightsaber folder and files inside it Donrsquot move any of

these files to any other location outside the lightsaber folder

and donrsquot reorganize them Unzip ProffieOS_SD_Cardzip to the

folder where you keep lightsaber-1286 folder Copy all files

from ProffieOS_SD_Card folder to your SD card

2 Unhide file extensions in File Explorer settings to see h ending

of config files Donrsquot add ldquohrdquo to the config file name

Go to config folder and create you own configh file (see page

23 for how-to)

Double-click the lightsaberino file

3 Add the name of your configh file as shown and Save this

lightsaberino file Make sure the other config files are

commented out there should be only one CONFIG_FILE

without You can have multiple config files

in lightsabergtconfig folder and just define the one you need

in lightsaberino file and upload it again to TeensySaber board

4 Connect battery to TeensySaber board and hook up to your PC

with a data transfer micro-USB-to-USB cable

Press arrow button it will compile and upload firmware to the

board Wait for your PC to make a sound or TeensySaber will

play boot sound if speaker is connected Now you can unplug

the USB cable Done

If it gives an error instead this means your configh file has

issues define CONFIG_FILE name has mistakes configh file

is out of config folder your PC user name is non-latin

2TEENSYSABER V3 INSTRUCTIONS

FIRMWARE UPLOAD AND UPDATE2

Uploading firmware

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 23

2TEENSYSABER V3 INSTRUCTIONS

CHANGING PARAMETERS3

Changing sound board parameters

All sound files (sound fonts music tracks) are stored on the micro SD card Add required sound fonts folders (Plecter NEC and Smoothswing

fonts are supported no need to change WAV files names just copy and paste) to SD card root directory as itrsquos done in the default

ProffieOS_SD_Card content folder and music tracks to the tracks folder

Make sure to name all music tracks and sound fonts folders with latin characters and only up to 8 characters long without using any special

characters (like |[- etc)

Make sure you have a configini file in each sound font folder if there is none - copy one from some default TeensySaberProffieBoard sound

font and paste into newly added sound font folder It has only one parameter that you can modify - humstart It helps to match hum sound

start with blade ignition 1000 usually works fine

All blade effects LED configuration volume level clash sensitivity etc are changed in the configh file located in lightsabergtconfig folder

To do that open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text Editor (Notepad - to see code correctly in Notepad

Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all text) and Delete it then Copy-and-Paste (Ctrl+C

Ctrl+V) your wiring diagram config code into empty _configh file and Save it under new name Follow the instructions on page 22 to

upload it to the board

TeensySaber V3 config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)

volume level (0-3000)

clash sensitivity (adjust lower or higher with 01 step)

sound font folder nametrack name

Preset name

Blade style

LED configuration (use these XP-E2 LED templatesto define your LED)

for Red use 1 Ohm resistor for Green - no resistor for Blue use 024 Ohm

NoLED ndash no 4th led used

Preset 1

24 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

31

PROFFIEBOARD INSTRUCTIONS

Whatrsquos needed

ndash ProffieBoard

ndash micro SD-card (see page 44 for recommendations)

ndash a USB micro SD-card reader (to load sound files from PC to micro SD card)

ndash micro USB data transfer cable (CABLES THAT SUPPORT ONLY CHARGING WONrsquoT WORK)

ndash wires of different gauges (32-20 AWG) (PTFE coated copper stranded wires recommended) heat shrink

ndash ESD safe soldering station solder wire flux etc

ndash pliers helping hands etc

ndash isopropyl alcohol to clean pads before soldering (helps solder to stick better)

ndash Digital Multimeter (VERY USEFUL)

ndash computer running Windows Linux or Mac OS with internet access

ndash 37V Li-Ion Protected rechargeable battery switches recharge port speaker LEDs resistors chassis etc

ndash Smart Li-Ion CC-CV (Constant Current - Constant Voltage mode) battery charger for 37V (42V) cells

ndash patience

WIRING DIAGRAMS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 25

31

PROFFIEBOARD INSTRUCTIONS

Board pinout

Battery + ndash 26 to 45 volt input drives everything except the LEDs

Battery - ndash negative pad for LEDs needs to be at same level as GND when both are connected Both pads are internally connected

GND ndash ground for electronics except LEDs Note that there are two GND pads on the board that are internally connected

Speaker +- ndash hooks up to speaker

Activation (1) Aux (2) Aux2 button (3) ndash hook up to closing buttons or potentially touch buttons

Blade ID Neopixel Data 1 ndash normally used to measure the blade ID restor and if itrsquos a neopixel blade feed out neopixel data

Data 2 3 4 5 ndash additional neopixel data outputs or free for other purposes

LED 1 2 3 4 5 6 ndash hooks up to negative side of LED (positive side of LED hooks up directly to battery) These pads can handle

up to 30 volts

SDA SCL ndash these pins are used to wire OLED display or to communicate with the gyro and accelerometer chip

RX TX ndash these pins are used for wiring a bluetooth module for wireless control

SWDCLK SWDIO ndash can be hooked up to a ST-LINK device and lets you debug programs running on the ProffieBoard

+5V ndash generated by the ProffieBoard normally itrsquos only ON when sound is playing

+33V ndash generated by the ProffieBoard for powering OLED display Bluetooth module or some accent leds

BOOT RESET ndash buttons to put the ProffieBoard in bootloader mode if uploading doesnrsquot work

micro USB port ndash micro USB port used only for firmware upload and can be used for sound files upload to SD card (from firmware version

1291 and up) THIS PORT ISNrsquoT USED FOR CHARGING THE BATTERY

LED 4LED 3

LED 2

LED 1

LED 5

LED 6

RESETBOOT

Battery - Battery -

Speaker + (red dot or ldquo+rdquo mark on speaker)

Battery +

Aux button (2)Activation button (1)

Aux2 button (3)

Blade ID Neopixel Data 1

Data 5

Data 4Data 3Data 2

+33V

SWDIO

SWDCLK

+5V

TXRX

GND

GND

Reset

Speaker -

SCLSDA

micro USB port

WIRING DIAGRAMS

26 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Basic Tri-Cree wiring diagram(In-hilt LED)

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

+

+

-

-

26 AWG

26 A

WG

30-32 AWG

28-30 AWG

28-3

0 A

WG

30-32 AWG

Protected 36-37V (42V max at full charge) 10A 3500mAh battery recommended+18650 battery holder (optional)Keystone 1042P

AV switch with accent led(constantly ON no effects)

accent leds run mostly at10-15mA so resistors for them must be calculated accordingly

Main RGB led

additional RGB leds(optional)

In case no additional high power leds are needed LED channels 4 5 6 can be used for 3 controllable(programmable for different effects) accent leds So AV switch led can be wired to one of these channelsAccent leds also can be wired to Data pads 1-5 please see ldquoAccent LEDs wiring and setuprdquo page

LED Resistor Calculator

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 27

3WIRING DIAGRAMS1

Basic Tri-Cree wiring (In-hilt LED)ldquoconfighrdquo file setup

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

Use a given or build your wiring diagram on THIS PAGE then open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text

Editor (Notepad - to see code correctly in Notepad Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all

text) and Delete it then Copy-and-Paste (Ctrl+C Ctrl+V) your wiring diagram config code (example below) into empty _configh file and

Save it under new name Follow the instructions on page 22 to upload it to the board

ldquoproffieboard_v1_confighrdquoNUM_BLADES 2NUM_BUTTONS 2VOLUME 1000CLASH_THRESHOLD_G 10StyleNormalPtrltCYAN WHITE 300 800gt()StyleNormalPtrltCYAN WHITE 300 800gt()

CreeXPE2RedTemplatelt1000gtCreeXPE2GreenTemplatelt0gtCreeXPE2BlueTemplatelt240gtNoLED

ProffieBoard config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)Volume level (0-3000)Clash sensitivity (adjust lower or higher with 01 step)ldquoBlade 1rdquo styleldquoBlade 2rdquo style (in case only 1 blade is used you donrsquot need this line)LED configuration (use these XP-E2 LED templatesto define your LED If other LED resistors are used change these values to match Ohm1000=ltvaluegt)

where 1000 is 1 Ohm resistor 0 is no resistor240 is 024 Ohm resistorNoLED ndash no 4th led used

Preset 1

LED 1 configuration

LED 2 configuration

Preset 2 etc

PROFFIEBOARD INSTRUCTIONS

28 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Basic Neopixel wiring diagram

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

+

+

-

-

22 A

WG

22 AWG

x2 28 AWG

x2 26 AWG

22 A

WG

30-32 AWG30-32 AWG

Protected 36-37V (42V max at full charge) 10A 3500mAh or 15A 3120mAhbattery recommended+18650 battery holder (optional)Keystone 1042P

AV switch with accent led(constantly ON no effects)

accent leds run mostly at10-15mA so resistors for them must be calculated accordingly

Main Neopixel strip

additional Neopixelstrips(optional)

Neopixel bladeconnector

330 Ohm on the Blade pcb side

x3 28 AWGor x1 22 AWGfor Negative

330 Ohm on the Blade pcb side

arrows up

330 Ohm on the Blade pcb side

In case no additional Neopixel strips are needed LED channels 4 5 6 can be used for 3 controllable(programmable for different effects) accent leds So AV switch led can be wired to one of these channelsAccent leds also can be wired to Data pads 2-5 please see ldquoAccent LEDs wiring and setuprdquo page

Recommended power wire gauges (22 AWG) are given for 2-strip blade For 3-strip blade you gonna need at least 20 AWG wires

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 29

ldquoproffieboard_v1_confighrdquo

3WIRING DIAGRAMS1

Basic Neopixel wiringldquoconfighrdquo file setup

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

NUM_BLADES 3NUM_BUTTONS 2VOLUME 1000CLASH_THRESHOLD_G 10IgnitionDelaylt0 any blade stylegtIgnitionDelaylt800 any blade stylegtIgnitionDelaylt800 any blade stylegtWS2811BladePtrlt118 WS2811 800kHz | WS2811 GRBgt()WS2811BladePtrlt26 blade2Pin ltbladePowerPin4gtgt()WS2811BladePtrlt26 blade3Pin ltbladePowerPin5gtgt()

ProffieBoard config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)Volume level (0-3000)Clash sensitivity (adjust lower or higher with 01 step)ldquoBlade 1rdquo style (main blade with IgnitionDelay 0)ldquoBlade 2rdquo style (CG blade 1 with IgnitionDelay 800)ldquoBlade 3rdquo style (CG blade 2 with IgnitionDelay 800)

strip configuration (defines how many pixels it has and to which LED output and pin is wired)

Preset 1

any blade style

strip (blade) 1 configuration

adjust this number to match your strips leds count

strip (blade) 2 configuration

strip (blade) 3 configuration

Preset 2 etc

Use a given or build your wiring diagram on THIS PAGE then open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text

Editor (Notepad - to see code correctly in Notepad Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all

text) and Delete it then Copy-and-Paste (Ctrl+C Ctrl+V) your wiring diagram config code (example below) into empty _configh file and

Save it under new name Follow the instructions on page 22 to upload it to the board

PROFFIEBOARD INSTRUCTIONS

30 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Basic Segmented string wiring diagram

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

+

+

-

-

24 A

WG

28 AWG

30-32 AWG30-32 AWG

Protected 36-37V (42V max at full charge) 10A 3500mAh battery recommended+18650 battery holder (optional)Keystone 1042P

AV switch with accent led(constantly ON no effects)

accent leds run mostly at10-15mA so resistors for them must be calculated accordingly

6-segments string blade

FoC string

N-channel FET3A minimum

123456

Calculate resistors for each led segment of the blade string depending on which leds are used 5mm leds have max drive current around 25mA per led when 10mm leds can be 100mA and 200mA per ledSo pay attention to your led max current and Forward Voltage (Vf) when calculating a segment resistor resistence as well as its wattage Also choose wire gauges accordingly to meet segments and total blade max current draw level

LED Resistor Calculator

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 31

ldquoproffieboard_v1_confighrdquo

3WIRING DIAGRAMS1

Basic Segmented string wiringldquoconfighrdquo file setup

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

NUM_BLADES 1NUM_BUTTONS 2VOLUME 1000CLASH_THRESHOLD_G 10StyleNormalPtrltCYAN WHITE 300 800gt()ltBlue3mmLED BladePin White3mmLEDgt

ProffieBoard config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)Volume level (0-3000)Clash sensitivity (adjust lower or higher with 01 step)Blade styleLED string configuration(here you mention the color and type of leds usedin the main blade string segments and FoC stringBladePin is the FoC signal pin (Blade ID pin))

Preset

LED string configuration

Use a given or build your wiring diagram on THIS PAGE then open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text

Editor (Notepad - to see code correctly in Notepad Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all

text) and Delete it then Copy-and-Paste (Ctrl+C Ctrl+V) your wiring diagram config code (example below) into empty _configh file and

Save it under new name Follow the instructions on page 22 to upload it to the board

PROFFIEBOARD INSTRUCTIONS

32 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Accent LEDs wiring diagram(optional)

Accent LEDs work with ProffieBoard as additional ldquobladesrdquo when powered by LED outputs 4 5 6 or Data pads 1 2 3 5 as PWM So they can

have any effect that blade can have If no effects needed accent led can be powered just by a 33V output pad (power-on led indication)

30-32 AWG

with Neopixel blade setup these 4 outputsdonrsquot work for regular accent leds

Recommended resistors to use for accent leds at 33V power source and 15mA drive

ndash 100 Ohm for Red (lt100000gt value in the code)ndash 13 Ohm for Green (lt13000gt value in the code)ndash 13 Ohm for Blue (lt13000gt value in the code)ndash 100 Ohm for Yellow (lt100000gt value in the code)ndash 20 Ohm for White (lt20000gt value in the code)

RGB ledcommon-anode

8 ldquobladesrdquo1 main and 7 accent leds

main blade style (effects) main blade style (effects)

7 accent leds style (effects)accent led style (effects)

7 accent leds configurations

RGB accent led configuration

2 ldquobladesrdquo1 main and 1 RGB accent led

ldquoPower-onrdquo indicationaccent leds (no effects)

7 accent leds withindependent effects

RGB accent led

a) b)

b)

c)

c)

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 33

3WIRING DIAGRAMS1

Neopixel Accent LEDs wiring diagram(optional)

With Neopixel setup additional neopixel leds or arrays can be used as accent leds There are 2 ways to wire them using additional Data

pins 2 3 4 5 or ldquoSub-bladesrdquo wiring with just 1 Data output pin Same way Neopixel connectors with on-board leds ca be wired

Option 1 ndash with extra Data pins

Main Blade

some accent leds

D1

D2

crystal leds

330 Ohm

330 Ohm

330 Ohm

main blade style (effects)

main blade 144 leds Data pin 1

accent leds blade style (effects)

accent leds ldquobladerdquo 4 leds Data pin 2

crystal leds blade style (effects)

crystal leds ldquobladerdquo 2 leds Data pin 3

3 ldquobladesrdquo1 main 1 accent leds array and 1 crystal leds array

PROFFIEBOARD INSTRUCTIONS

D3

follow arrows direction

34 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Neopixel Accent LEDs wiring diagram(optional)

PROFFIEBOARD INSTRUCTIONS

Main Blade

some accent leds

1

3

5678

2

4

D1

crystal leds

follow arrows direction

330 Ohm

330 OhmData signal

With this setup a single array of neopixel leds is separated into a couple of sub-blades with their own style configuration and behaviour This

is really usefull when you want to use only one data pin More about ldquoSub-bladesrdquo on ProffieOS wiki page

Option 2 ndash with ldquoSub-bladesrdquo

main blade style (effects)

main blade sub-blade 140 leds (7-146) but from 6 to 145 in the code

accent leds blade style (effects)

accent leds sub-blade 4 leds (1-4) but from 0 to 3 in the code

crystal leds blade style (effects)

146 leds total used

crystal leds sub-blade 2 leds (5-6) but from 4 to 5 in the code

update default 144 to a higher total value if you get all accent leds +Main blade gt 144 Example update to 146 if you have 2 crystal leds +4 accent leds + 140 Main blade leds = 146

3 ldquobladesrdquo 1 main 1 accent leds array and 1 crystal leds array

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 35

3WIRING DIAGRAMS1

OLED display wiring diagram(optional)

SSD1306 128x32 pixels OLED display allows to show battery level current preset name play different animations and even simple games It

can be wired to any blade configuration and requires just one additional line in the code to work You can get monochrome display in white

or blue color

SSD1306128x32OLED

SSD1306 ndash with blue or white display color selectSSD1306 ndash cheaper priceSSD1306 just screen ndash blue or white select

30-32 AWG

30-32 AWG

add this line to enable OLED display

display shows a preset name written in these quotes ldquoldquo

PROFFIEBOARD INSTRUCTIONS

36 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Bluetooth module wiring diagram(optional)

SOON

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 37

3WIRING DIAGRAMS1

Blade ID resistor functions(optional)

SOON

PROFFIEBOARD INSTRUCTIONS

38 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

website ProffieBoard FULL wiring diagrams link

Scroll the page down till you see the interactive diagram Above the diagram there are components selection options Build your saber setup

with it and follow diagram to wire your board Then you need to copy the configuration code below and paste it into your _configh file

Choose components you want

3WIRING DIAGRAMS1

More wiring diagrams

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 39

3WIRING DIAGRAMS1

How to use it

PROFFIEBOARD INSTRUCTIONS

Blade ignitionretraction ndash assuming you have at least one button pressing it briefly should turn the saber on or off If you have an AUX button pressing it briefly should also turn the saber on and off If you have no buttons you can turn the saber on and off by twisting your wrist back and forth Note that the motion has to be done long enough to count so a very quick flick of the wrist will not workTurn On muted ndash double-click power buttonNext preset ndash while saber is off click the AUX buttonPrevious preset ndash hold AUX button and click the Activation buttonTrigger Clash ndash while saber is on hit the bladeTrigger Lockup ndash while saber is on hold Activation button then trigger a clash Lockup releases when you let go of the Acti-vation buttonTrigger Drag ndash like lockup but point saber mostly down before holding Activation buttonTrigger Force ndash long-click AUX buttonStart soundtrack ndash long-click the Activation buttonTrigger Blaster Block ndash while saber is on short-click AUX button

Serial Monitor commands

battery_voltage ndash gets current battery voltage valueget_volume ndash get current volume valuepow ndash power OnOff the saberon ndash power On the saberoff ndash power Off the saberset_volume lt0-3000gt ndash set volume value (example set_volume 500)play ndash play the default preset trackplay trackslttrack namegt ndash play a specific track from tracks folder (example play tracksvenuswav)stop ndash stop the playing trackforce ndash play ldquoforcerdquo sound effectsdrag ndash play ldquodragrdquo sound effectsblast ndash play ldquoblasterrdquo sound effectslock ndash play ldquolockuprdquo sound effectsclash ndash play ldquoclashrdquo sound effectsreset ndash reboot the boardn ndash switch to next presetp ndash switch to previous presetlist_presets ndash show all presetssdtest ndash test SD card speed

40 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3FIRMWARE UPLOAD AND UPDATE2

Software installation and setup

PROFFIEBOARD INSTRUCTIONS

To upload firmware to ProffieBoard Arduino IDE program is required Follow these steps to install it to your PC

1 Install latest Arduino IDE software (donrsquot use BETA)

Installing as Windows app also is not recommended

because it will be installed in a specific protected folder that

wonrsquot allow you to install any additional softwareplugin in it

If ProffieBoard wonrsquot show up in COM port use

Arduino IDE 186 version

2 Install the Proffieboard Arduino Plugin and Zadig software

Follow installation instructions

3 Select Proffieboard-STM32L433 in Tools -gt Board

USB Type ndash Serial CPU Speed ndash 80 MHz Optimize ndash Smallest Code DOSFS ndash SDCARD (SPI) Port ndash COM(the number your PC assigned) (Butterfly-L433CC)

Connect Proffieboard via USB cable to PC to be able to select

the Port

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 41

3FIRMWARE UPLOAD AND UPDATE2

Uploading firmware

PROFFIEBOARD INSTRUCTIONS

1 Download the ProffieBoard firmware and SD card content

Unzip lightsaber-1286zip to your Documents directory or to

Desktop but not to Arduino program folder or anywhere in

Programs directory where all programs are installed You will

see a lightsaber folder and files inside it Donrsquot move any of

these files to any other location outside the lightsaber folder

and donrsquot reorganize them Unzip ProffieOS_SD_Cardzip to the

folder where you keep lightsaber-1286 folder Copy all files

from ProffieOS_SD_Card folder to your SD card

2 Unhide file extensions in File Explorer settings to see h ending

of config files Donrsquot add ldquohrdquo to the config file name Go to config folder and create you own configh file (see page

42 for how-to)

Double-click the lightsaberino file

3 Add the name of your configh file as shown and Save this

lightsaberino file Make sure the other config files are

commented out there should be only one CONFIG_FILE

without You can have multiple config files

in lightsabergtconfig folder and just define the one you need

in lightsaberino file and upload it again to ProffieBoard

4 Connect battery to ProffieBoard and hook up to your PC

with a data transfer micro-USB-to-USB cable

Press arrow button it will compile and upload firmware to the

board Wait for red text progress bars to stop at 100

ProffieBoard will play boot sound if speaker is connected

Now you can unplug the USB cable Done

If it gives an error instead this means your configh file has

issues define CONFIG_FILE name has mistakes configh file

is out of config folder your PC user name is non-latin

42 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

33

configh file structure editing

PROFFIEBOARD INSTRUCTIONS

CHANGING PARAMETERS

All sound files (sound fonts music tracks) are stored on the micro SD card Add required sound fonts folders (Plecter NEC and Smoothswing

fonts are supported no need to change WAV files names just copy and paste) to SD card root directory as itrsquos done in the default

ProffieOS_SD_Card content folder and music tracks to the tracks folder

Make sure to name all music tracks and sound fonts folders with latin characters and only up to 8 characters long without using any special

characters (like |[- etc)

Make sure you have a configini file in each sound font folder if there is none - copy one from some default TeensySaberProffieBoard sound

font and paste into newly added sound font folder It has only one parameter that you can modify - humstart It helps to match hum sound

start with blade ignition 1000 usually works fine

All blade effects LED configuration volume level clash sensitivity etc are changed in the configh file located in lightsabergtconfig folder

To do that open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text Editor (Notepad - to see code correctly in Notepad

Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all text) and Delete it then Copy-and-Paste (Ctrl+C

Ctrl+V) your wiring diagram config code into empty _configh file and Save it under new name Follow the instructions on page 39 to

upload it to the board

Proffieboard config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)

volume level (0-3000)

clash sensitivity (adjust lower or higher with 01 step)

sound font folder nametrack name

Preset name

Blade style

LED configuration (use these XP-E2 LED templatesto define your LED)

for Red use 1 Ohm resistor for Green - no resistor for Blue use 024 Ohm

NoLED ndash no 4th led used

Preset 1

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 43

33

Blade Styles

StylePtrltInOutHelperltSimpleClashltLockupltBlastltOnSparkltAudioFlickerltRgblt02550gtRgblt501000gtgtRgblt2552550gt150gtRgblt255500gtgtAudioFlickerltRgblt1002550gtRgblt2550150gtgtgtRgblt255100150gt40gt200300Blackgtgt

ndash this is how the Blade Style code looks pasted in the configh file Preset (it sits inside a StylePtrltgt container)

ndash this is how the Blade Style code looks when editing it inside a Blade Style Editor

Each Blade Style is made of a variety of Effects each added effect goes instead of a base color in the previous effect

PROFFIEBOARD INSTRUCTIONS

CHANGING PARAMETERS

ProffieBoard and TeensySaber use Blade Styles for the main saber blade and any other accent leds to define all light effects (color changing

flashes flickering delays ignitionretraction timing etc)

Use Blade Style Editor to create and adjust Blade Styles Megtooth Sith Sabers did a great video tutorial where he shows and explains

how to use Blade Style Editor Also you can grab some pre-made Blade Styles or share yours here on TRA forums

A Blade Style example of simple flickering Green blade with Spark on start Clash Blaster Lockup and Drag IgnitionRetraction effects

InOutHelperltSimpleClashltLockupltBlastltOnSparkltAudioFlickerltRgblt02550gtRgblt501000gtgtRgblt2552550gt150gtRgblt255500gtgtAudioFlickerltRgblt1002550gtRgblt2550150gtgtgtRgblt255100150gt40gt200300Blackgt

InOutHelperltbase color200300Blackgt ndash base color can be defined by words (WHITE RED GREEN PURPLE etc) or by Rgblt0-2550-2550-255gt values for more

custom shades 200 is extension length in milliseconds 300 is retraction length in milliseconds Black is color when retracted (also can be any other color)

SimpleClashltbase colorclash color40gt ndash clash effect 40 is clash duration in milliseconds

Lockupltbase colorlockup colorgt ndash lockup effect

Blastltbase colorblast colorgt ndash blaster effect

OnSparkltbase colorspark color150gt ndash spark on ignition effect 150 is spark duration in milliseconds

AudioFlickerltrdquoArdquo colorrdquoBrdquo colorgt ndash flickering effect (blade flickers to the actual saber hum sound) the more difference between ldquoArdquo and ldquoBrdquo colors - the more

abrupt is flickering

Rgblt255500gt ndash actual color in RGB format (0 is no light 255 is the maximum brightness value for Red Green or Blue channel)

44 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

ndash SanDisk 4GB microSDHC Class 4 (Genuine) ndash SanDisk 4GB microSDHC Class 4 (Genuine)

130238 kbs = 1477 simultaneous audio streams 137812 kbs = 1562 simultaneous audio streams

ndash Patriot LX Series 16GB microSDHC UHS-IU1 Class 10 ndash Patriot LX Series 16GB microSDHC UHS-IU1 Class 10

133005 kbs = 1508 simultaneous audio streams

ndash GSkill 16GB microSDHC UHS-IU1 Class 10 ndash GSkill 16GB microSDHC UHS-IU1 Class 10

129534 kbs = 1469 simultaneous audio streams

ndash Kingston 16GB microSDHC UHS-IU1 Class 10 ndash Kingston 16GB microSDHC UHS-IU1 Class 10

128090 kbs = 1452 simultaneous audio streams

ndash SanDisk Ultra 16GB microSDHC UHS-IU1 A1 Class 10 ndash SanDisk Ultra 16GB microSDHC UHS-IU1 A1 Class 10

102663 kbs = 1164 simultaneous audio streams 11124 kbs = 1261 simultaneous audio streams

ndash SanDisk 8GB microSDHC Class 4 ndash SanDisk 8GB microSDHC Class 4

108506 kbs = 1230 simultaneous audio streams

ndash SanDisk 16GB microSDHC Class 4 ndash SanDisk 16GB microSDHC Class 4

102663 kbs = 1164 simultaneous audio streams 106957 kbs = 1213 simultaneous audio streams

ndash SanDisk Ultra 16GB microSDHC UHS-IU1 Class 10 ndash SanDisk Ultra 16GB microSDHC UHS-IU1 Class 10

102663 kbs = 1164 simultaneous audio streams 103909 kbs = 1178 simultaneous audio streams

ndash Smartbuy 4GB microSDHC Class 4 ndash Smartbuy 4GB microSDHC Class 4

75437 kbs = 855 simultaneous audio streams

ndash Kingston 8GB microSDHC Class 4 ndash Kingston 8GB microSDHC Class 4

75209 kbs = 822 simultaneous audio streams

ndash SanDisk 4GB microSDHC Class 4 (Fake) ndash SanDisk 4GB microSDHC Class 4 (Fake)

677 kbs = 769 simultaneous audio streams

Here is a list of tested micro SD cards speed with TeensySaber V3 and ProffieBoard Any card with speed over 900 kbs is recommended the

higher the speed is ndash the better Memory size of 4-16Gb is more than enough Cards were tested with a default firmware (1291) compiled

with ldquoSmallest Coderdquo under Optimize ldquodefault_proffieboard_confighrdquo file and default ProffieOS SD card sound files (7 folders)

To test your SD card speed simply hook up ProffieBoard to PC open Arduino IDE go to Tools and open Serial Monitor make sure you have

New Line and 9600 baud rate selected on the bottom of Serial Monitor window type and send sdtest command wait for the test result

4Recommended micro SD cards

BEST

TEENSYSABER PROFFIEBOARD

GOOD

BAD

PROFFIEBOARD INSTRUCTIONS

SD CARD RECOMMENDATIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 45

There are a lot of fake (chinese copies) microSD cards on the market from aliexpress ebay amazon etc They look very similar to genuine

cards but are a bit different though and have a twice lower writingreading speed Here is an example of a SanDisk 4Gb Class 4 card one is

genuine with 137812 kbs speed and the other one is fake with 677 kbs speed I got from ebay seller

Be carefull and pay attention to how the actual card looks if you are not sure ask seller for the real photo of SD card he sells

4Genuine and Fake SanDisk 4Gb Class 4 microSD

PROFFIEBOARD INSTRUCTIONS

SD CARD RECOMMENDATIONS

46 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

WIRE GAUGE GUIDE

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 47

RECHARGE PORTS AND KILL SWITCHES

48 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

NEOPIXEL STRIPS CURRENT DRAW

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 49

6TROUBLESHOOTING

For more help please check these linksProffieOSProffieBoardTeensySaber wiki on GitHubAsk your question on The Rebel Armory forumsAsk your question on FX-sabers forumsAsk your question in facebook group

How to solve most common issues

Quick troubleshooting tips

TeensySaber board or Proffieboard is not recognized by computer (nothing under Port selection in Arduino)

ndash Make sure a charged 37V battery is connected to the board micro-USB cable is a data transfer cable all plugins and drivers are installed ndash

check again pages 21 for TeensySaber or 40 for Proffieboard Try a different USB port on your computer

Sketch (code) compile error in Arduino IDE

ndash Check your define CONFIG_FILE ldquoconfig_confighrdquo line in opened lightsaberino file if itrsquos written correctly with config in it

Sketch (code) compile error in Arduino IDE

ndash Check if the _configh file you defined in the lightsaberino sketch file is same name as in the lightsaber-rdquofirmware versionrdquolightsaber

config folder and is located in this folder

Sketch (code) compile error in Arduino IDE

ndash Check your settings under Tools tab in Arduino IDE program Check again pages 21 for TeensySaber or 40 for Proffieboard

Sketch (code) compile error in Arduino IDE

ndash Check if your _configh file is correct Blade Styles Presets const unsigned int maxLedsPerStrip = 144 if BladeConfig blades[] = is correct

Sketch (code) compile error in Arduino IDE

ndash If nothing helps install Arduino IDE version 186 and try to compile and upload the firmware again

Sound doesnrsquot play

ndash Remove SD card and insert again check speaker wiring Make sure all sound files on SD card are correctly named (8 characters max long)

Re-format SD card in FAT32 load sound files and try again try another SD card

Board says ldquoLOW POWERrdquo

ndash Charge the battery

Serial Monitor shows info sent by the board but your commands donrsquot work

ndash In the bottom right corner of Serial Monitor window make sure the Line Ending drop down is set to New Line

Sound is weird and distorted

ndash Check your SD card speed (see page 44) Check speaker wiring try another good speaker

08 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

Basic Tri-Cree wiring diagram(In-hilt LED)

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

+

+

+

-

-

-

26 A

WG

26 AWG

30-32 AWG

28-30 AWG

28-30 AWG

30-32 AWG

Protected 36-37V (42V max at full charge) 10A 3500mAh battery recommended+18650 battery holder (optional)Keystone 1042P

AV switch with accent led(constantly ON no effects)

accent leds run mostly at10-15mA so resistors for them must be calculated accordingly

Main RGB led

additional RGB leds(optional)

In case no additional high power leds are needed LED channels 4 5 6can be used for 3 controllable (programmable for different effects) accent leds So AV switch led can be wired to one of these channelsby adding 1 MOSFET

LED Resistor Calculator

solder 3x FETs

solder 1 FET

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 09

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

Basic Tri-Cree wiring (In-hilt LED)ldquoconfighrdquo file setup

Use a given or build your wiring diagram on THIS PAGE then open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text

Editor (Notepad - to see code correctly in Notepad Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all

text) and Delete it then Copy-and-Paste (Ctrl+C Ctrl+V) your wiring diagram config code (example below) into empty _configh file and

Save it under new name Follow the instructions on page 22 to upload it to the board

ldquov3_confighrdquoNUM_BLADES 2NUM_BUTTONS 2VOLUME 1000CLASH_THRESHOLD_G 10StyleNormalPtrltCYAN WHITE 300 800gt()StyleNormalPtrltCYAN WHITE 300 800gt()

CreeXPE2RedTemplatelt1000gtCreeXPE2GreenTemplatelt0gtCreeXPE2BlueTemplatelt240gtNoLED

TeensySaber V3 config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)Volume level (0-3000)Clash sensitivity (adjust lower or higher with 01 step)ldquoBlade 1rdquo styleldquoBlade 2rdquo style (in case only 1 blade is used you donrsquot need this line)LED configuration (use these XP-E2 LED templatesto define your LED If other LED resistors are used change these values to match Ohm1000=ltvaluegt)

where 1000 is 1 Ohm resistor 0 is no resistor240 is 024 Ohm resistorNoLED ndash no 4th led used

Preset 1

LED 1 configuration

LED 2 configuration

Preset 2 etc

10 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

Basic Neopixel wiring diagram

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

+

+

+

-

-

-

22 A

WG

22 AWG

26 AWG

30 AWG

x2 28 AWG

x2 26 AWG

22 A

WG

30-32 AWG

30-32 AWG

Protected 36-37V (42V max at full charge) 10A 3500mAh or 15A 3120mAhbattery recommended+18650 battery holder (optional)Keystone 1042P

AV switch with accent led(constantly ON no effects)

accent leds run mostly at10-15mA so resistors for them must be calculated accordingly

Main Neopixel strip

additional Neopixelstrips(optional)

Neopixel bladeconnector

330 Ohm on the Blade pcb side

x3 28 AWGor x1 22 AWGfor Negative

330 Ohm on the Blade pcb side

arrows up

330 Ohm on the Blade pcb side

In case no additional Neopixel strips are needed LED channels 4 5 6can be used for 3 controllable (programmable for different effects) accent leds So AV switch led can be wired to one of these channelsby adding 1 MOSFETRecommended power wire gauges (22 AWG) are given for 2-strip blade For 3-strip blade you gonna need at least 20 AWG wires

solder 2x FETs

solder 1 FET

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 11

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

Basic Neopixel wiringldquoconfighrdquo file setup

ldquov3_confighrdquoNUM_BLADES 3NUM_BUTTONS 2VOLUME 1000CLASH_THRESHOLD_G 10IgnitionDelaylt0 any blade stylegtIgnitionDelaylt800 any blade stylegtIgnitionDelaylt800 any blade stylegtWS2811BladePtrlt118 WS2811 800kHz | WS2811 GRBgt()WS2811BladePtrlt26 7 ltbladePowerPin4gtgt()WS2811BladePtrlt26 8 ltbladePowerPin5gtgt()

TeensySaber V3 config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)Volume level (0-3000)Clash sensitivity (adjust lower or higher with 01 step)ldquoBlade 1rdquo style (main blade with IgnitionDelay 0)ldquoBlade 2rdquo style (CG blade 1 with IgnitionDelay 800)ldquoBlade 3rdquo style (CG blade 2 with IgnitionDelay 800)

strip configuration (defines how many pixels it has and to which LED output and pin is wired)

Preset 1

any blade style

strip (blade) 1 configuration

strip (blade) 2 configuration

strip (blade) 3 configuration

Preset 2 etc

Use a given or build your wiring diagram on THIS PAGE then open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text

Editor (Notepad - to see code correctly in Notepad Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all

text) and Delete it then Copy-and-Paste (Ctrl+C Ctrl+V) your wiring diagram config code (example below) into empty _configh file and

Save it under new name Follow the instructions on page 22 to upload it to the board

12 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

Basic Segmented string wiring diagram

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

+

+

-

-

24 A

WG

28 AWG

30-32 AWG

30-32 AWG

Protected 36-37V (42V max at full charge) 10A 3500mAh battery recommended+18650 battery holder (optional)Keystone 1042P

AV switch with accent led(constantly ON no effects)

accent leds run mostly at10-15mA so resistors for them must be calculated accordingly

6-segments string blade

FoC string

N-channel FET3A minimum

1

1 46 523

23456

Calculate resistors for each led segment of the blade string depending on which leds are used 5mm leds have max drive current around 25mA per led when 10mm leds can be 100mA and 200mA per ledSo pay attention to your led max current and Forward Voltage (Vf) when calculating a segment resistor resistence as well as its wattage Also choose wire gauges accordingly to meet segments and total blade max current draw level

LED Resistor Calculator

solder 3x FETs

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 13

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

Basic Segmented string wiringldquoconfighrdquo file setup

ldquov3_confighrdquoNUM_BLADES 1NUM_BUTTONS 2VOLUME 1000CLASH_THRESHOLD_G 10StyleNormalPtrltCYAN WHITE 300 800gt()ltBlue3mmLED 20 White3mmLEDgt

TeensySaber V3 config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)Volume level (0-3000)Clash sensitivity (adjust lower or higher with 01 step)Blade styleLED string configuration(here you mention the color and type of leds usedin the main blade string segments and FoC string20 is the FoC signal pin (Blade ID pin))

Preset

LED string configuration

Use a given or build your wiring diagram on THIS PAGE then open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text

Editor (Notepad - to see code correctly in Notepad Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all

text) and Delete it then Copy-and-Paste (Ctrl+C Ctrl+V) your wiring diagram config code (example below) into empty _configh file and

Save it under new name Follow the instructions on page 22 to upload it to the board

14 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

Accent LEDs wiring diagram(optional)

Accent LEDs work with TeensySaber board as additional ldquobladesrdquo when powered by LED outputs 4 5 6 with FETs So they can have any effect

that blade can have If no effects needed accent led can be powered just by a 33V output pad (power-on led indication)

30-32 AWGRGB ledcommon-anode

4 ldquobladesrdquo1 main and 3 accent leds

main blade style (effects) main blade style (effects)

3 accent leds style (effects)accent led style (effects)

3 accent leds configurations

RGB accent led configuration

2 ldquobladesrdquo1 main and 1 RGB accent led

ldquoPower-onrdquo indicationaccent leds (no effects)

3 accent leds withindependent effects

+ 1 or more simple accent leds without effects

1 RGB accent led+ 1 or more simple accent leds

without effects

a) b)

b)

c)

c)

solder 3x FETs solder 3x FETs

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 15

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

OLED display wiring diagram(optional)

SSD1306 128x32 pixels OLED display allows to show battery level current preset name play different animations and even simple games It

can be wired to any blade configuration and requires just one additional line in the code to work You can get monochrome display in white

or blue color

SSD1306128x32OLED

SSD1306 ndash with blue or white display color selectSSD1306 ndash cheaper priceSSD1306 just screen ndash blue or white select

30-32 AWG

30-32 AWG

add this line to enable OLED display

display shows a preset name written in these quotes ldquoldquo

16 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

Bluetooth module wiring diagram(optional)

SOON

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 17

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

Blade ID resistor functions(optional)

SOON

18 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

website TeensySaber V3 FULL wiring diagrams link

Scroll the page down till you see the interactive diagram Above the diagram there are components selection options Build your saber setup

with it and follow diagram to wire your board Then you need to copy the configuration code below and paste it into your _configh file

Choose components you want

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

More wiring diagrams

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 19

20 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

How to use it

Blade ignitionretraction ndash assuming you have at least one button pressing it briefly should turn the saber on or off If you have an AUX button pressing it briefly should also turn the saber on and off If you have no buttons you can turn the saber on and off by twisting your wrist back and forth Note that the motion has to be done long enough to count so a very quick flick of the wrist will not workTurn On muted ndash double-click power buttonNext preset ndash while saber is off click the AUX buttonPrevious preset ndash hold AUX button and click the Activation buttonTrigger Clash ndash while saber is on hit the bladeTrigger Lockup ndash while saber is on hold Activation button then trigger a clash Lockup releases when you let go of the Acti-vation buttonTrigger Drag ndash like lockup but point saber mostly down before holding Activation buttonTrigger Force ndash long-click AUX buttonStart soundtrack ndash long-click the Activation buttonTrigger Blaster Block ndash while saber is on short-click AUX button

Serial Monitor commands

battery_voltage ndash gets current battery voltage valueget_volume ndash get current volume valuepow ndash power OnOff the saberon ndash power On the saberoff ndash power Off the saberset_volume lt0-3000gt ndash set volume value (example set_volume 500)play ndash play the default preset trackplay trackslttrack namegt ndash play a specific track from tracks folder (example play tracksvenuswav)stop ndash stop the playing trackforce ndash play ldquoforcerdquo sound effectsdrag ndash play ldquodragrdquo sound effectsblast ndash play ldquoblasterrdquo sound effectslock ndash play ldquolockuprdquo sound effectsclash ndash play ldquoclashrdquo sound effectsreset ndash reboot the boardn ndash switch to next presetp ndash switch to previous presetlist_presets ndash show all presetssdtest ndash test SD card speed

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 21

2TEENSYSABER V3 INSTRUCTIONS

FIRMWARE UPLOAD AND UPDATE2

Software installation and setup

To upload firmware to TeensySaber board Arduino IDE program is required Follow these steps to install it to your PC

1 Install latest Arduino IDE software (donrsquot use BETA)

Installing as Windows app also is not recommended

because it will be installed in a specific protected folder that

wonrsquot allow you to install Teensyduino software in it

If TeensySaber wonrsquot show up in COM port use

Arduino IDE 186 version

2 Install latest Teensyduino software in same directory

usually itrsquos CProgram Files (x86)Arduino on Windows

Follow installation instructions for your system

3 Select Teensy 32 31 in Tools -gt Board

USB Type ndash Serial CPU Speed ndash 96 MHz (overclock) Optimize ndash Smallest Code Port ndash COM(the number your PC assigned) (Teensy 32) Serial

Connect TeensySaber via USB cable to PC to be able to select

the Port donrsquot forget to connect battery first

22 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

1 Download the TeensySaber firmware and SD card content

Unzip lightsaber-1286zip to your Documents directory or to

Desktop but not to Arduino program folder or anywhere in

Programs directory where all programs are installed You will

see a lightsaber folder and files inside it Donrsquot move any of

these files to any other location outside the lightsaber folder

and donrsquot reorganize them Unzip ProffieOS_SD_Cardzip to the

folder where you keep lightsaber-1286 folder Copy all files

from ProffieOS_SD_Card folder to your SD card

2 Unhide file extensions in File Explorer settings to see h ending

of config files Donrsquot add ldquohrdquo to the config file name

Go to config folder and create you own configh file (see page

23 for how-to)

Double-click the lightsaberino file

3 Add the name of your configh file as shown and Save this

lightsaberino file Make sure the other config files are

commented out there should be only one CONFIG_FILE

without You can have multiple config files

in lightsabergtconfig folder and just define the one you need

in lightsaberino file and upload it again to TeensySaber board

4 Connect battery to TeensySaber board and hook up to your PC

with a data transfer micro-USB-to-USB cable

Press arrow button it will compile and upload firmware to the

board Wait for your PC to make a sound or TeensySaber will

play boot sound if speaker is connected Now you can unplug

the USB cable Done

If it gives an error instead this means your configh file has

issues define CONFIG_FILE name has mistakes configh file

is out of config folder your PC user name is non-latin

2TEENSYSABER V3 INSTRUCTIONS

FIRMWARE UPLOAD AND UPDATE2

Uploading firmware

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 23

2TEENSYSABER V3 INSTRUCTIONS

CHANGING PARAMETERS3

Changing sound board parameters

All sound files (sound fonts music tracks) are stored on the micro SD card Add required sound fonts folders (Plecter NEC and Smoothswing

fonts are supported no need to change WAV files names just copy and paste) to SD card root directory as itrsquos done in the default

ProffieOS_SD_Card content folder and music tracks to the tracks folder

Make sure to name all music tracks and sound fonts folders with latin characters and only up to 8 characters long without using any special

characters (like |[- etc)

Make sure you have a configini file in each sound font folder if there is none - copy one from some default TeensySaberProffieBoard sound

font and paste into newly added sound font folder It has only one parameter that you can modify - humstart It helps to match hum sound

start with blade ignition 1000 usually works fine

All blade effects LED configuration volume level clash sensitivity etc are changed in the configh file located in lightsabergtconfig folder

To do that open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text Editor (Notepad - to see code correctly in Notepad

Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all text) and Delete it then Copy-and-Paste (Ctrl+C

Ctrl+V) your wiring diagram config code into empty _configh file and Save it under new name Follow the instructions on page 22 to

upload it to the board

TeensySaber V3 config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)

volume level (0-3000)

clash sensitivity (adjust lower or higher with 01 step)

sound font folder nametrack name

Preset name

Blade style

LED configuration (use these XP-E2 LED templatesto define your LED)

for Red use 1 Ohm resistor for Green - no resistor for Blue use 024 Ohm

NoLED ndash no 4th led used

Preset 1

24 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

31

PROFFIEBOARD INSTRUCTIONS

Whatrsquos needed

ndash ProffieBoard

ndash micro SD-card (see page 44 for recommendations)

ndash a USB micro SD-card reader (to load sound files from PC to micro SD card)

ndash micro USB data transfer cable (CABLES THAT SUPPORT ONLY CHARGING WONrsquoT WORK)

ndash wires of different gauges (32-20 AWG) (PTFE coated copper stranded wires recommended) heat shrink

ndash ESD safe soldering station solder wire flux etc

ndash pliers helping hands etc

ndash isopropyl alcohol to clean pads before soldering (helps solder to stick better)

ndash Digital Multimeter (VERY USEFUL)

ndash computer running Windows Linux or Mac OS with internet access

ndash 37V Li-Ion Protected rechargeable battery switches recharge port speaker LEDs resistors chassis etc

ndash Smart Li-Ion CC-CV (Constant Current - Constant Voltage mode) battery charger for 37V (42V) cells

ndash patience

WIRING DIAGRAMS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 25

31

PROFFIEBOARD INSTRUCTIONS

Board pinout

Battery + ndash 26 to 45 volt input drives everything except the LEDs

Battery - ndash negative pad for LEDs needs to be at same level as GND when both are connected Both pads are internally connected

GND ndash ground for electronics except LEDs Note that there are two GND pads on the board that are internally connected

Speaker +- ndash hooks up to speaker

Activation (1) Aux (2) Aux2 button (3) ndash hook up to closing buttons or potentially touch buttons

Blade ID Neopixel Data 1 ndash normally used to measure the blade ID restor and if itrsquos a neopixel blade feed out neopixel data

Data 2 3 4 5 ndash additional neopixel data outputs or free for other purposes

LED 1 2 3 4 5 6 ndash hooks up to negative side of LED (positive side of LED hooks up directly to battery) These pads can handle

up to 30 volts

SDA SCL ndash these pins are used to wire OLED display or to communicate with the gyro and accelerometer chip

RX TX ndash these pins are used for wiring a bluetooth module for wireless control

SWDCLK SWDIO ndash can be hooked up to a ST-LINK device and lets you debug programs running on the ProffieBoard

+5V ndash generated by the ProffieBoard normally itrsquos only ON when sound is playing

+33V ndash generated by the ProffieBoard for powering OLED display Bluetooth module or some accent leds

BOOT RESET ndash buttons to put the ProffieBoard in bootloader mode if uploading doesnrsquot work

micro USB port ndash micro USB port used only for firmware upload and can be used for sound files upload to SD card (from firmware version

1291 and up) THIS PORT ISNrsquoT USED FOR CHARGING THE BATTERY

LED 4LED 3

LED 2

LED 1

LED 5

LED 6

RESETBOOT

Battery - Battery -

Speaker + (red dot or ldquo+rdquo mark on speaker)

Battery +

Aux button (2)Activation button (1)

Aux2 button (3)

Blade ID Neopixel Data 1

Data 5

Data 4Data 3Data 2

+33V

SWDIO

SWDCLK

+5V

TXRX

GND

GND

Reset

Speaker -

SCLSDA

micro USB port

WIRING DIAGRAMS

26 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Basic Tri-Cree wiring diagram(In-hilt LED)

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

+

+

-

-

26 AWG

26 A

WG

30-32 AWG

28-30 AWG

28-3

0 A

WG

30-32 AWG

Protected 36-37V (42V max at full charge) 10A 3500mAh battery recommended+18650 battery holder (optional)Keystone 1042P

AV switch with accent led(constantly ON no effects)

accent leds run mostly at10-15mA so resistors for them must be calculated accordingly

Main RGB led

additional RGB leds(optional)

In case no additional high power leds are needed LED channels 4 5 6 can be used for 3 controllable(programmable for different effects) accent leds So AV switch led can be wired to one of these channelsAccent leds also can be wired to Data pads 1-5 please see ldquoAccent LEDs wiring and setuprdquo page

LED Resistor Calculator

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 27

3WIRING DIAGRAMS1

Basic Tri-Cree wiring (In-hilt LED)ldquoconfighrdquo file setup

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

Use a given or build your wiring diagram on THIS PAGE then open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text

Editor (Notepad - to see code correctly in Notepad Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all

text) and Delete it then Copy-and-Paste (Ctrl+C Ctrl+V) your wiring diagram config code (example below) into empty _configh file and

Save it under new name Follow the instructions on page 22 to upload it to the board

ldquoproffieboard_v1_confighrdquoNUM_BLADES 2NUM_BUTTONS 2VOLUME 1000CLASH_THRESHOLD_G 10StyleNormalPtrltCYAN WHITE 300 800gt()StyleNormalPtrltCYAN WHITE 300 800gt()

CreeXPE2RedTemplatelt1000gtCreeXPE2GreenTemplatelt0gtCreeXPE2BlueTemplatelt240gtNoLED

ProffieBoard config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)Volume level (0-3000)Clash sensitivity (adjust lower or higher with 01 step)ldquoBlade 1rdquo styleldquoBlade 2rdquo style (in case only 1 blade is used you donrsquot need this line)LED configuration (use these XP-E2 LED templatesto define your LED If other LED resistors are used change these values to match Ohm1000=ltvaluegt)

where 1000 is 1 Ohm resistor 0 is no resistor240 is 024 Ohm resistorNoLED ndash no 4th led used

Preset 1

LED 1 configuration

LED 2 configuration

Preset 2 etc

PROFFIEBOARD INSTRUCTIONS

28 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Basic Neopixel wiring diagram

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

+

+

-

-

22 A

WG

22 AWG

x2 28 AWG

x2 26 AWG

22 A

WG

30-32 AWG30-32 AWG

Protected 36-37V (42V max at full charge) 10A 3500mAh or 15A 3120mAhbattery recommended+18650 battery holder (optional)Keystone 1042P

AV switch with accent led(constantly ON no effects)

accent leds run mostly at10-15mA so resistors for them must be calculated accordingly

Main Neopixel strip

additional Neopixelstrips(optional)

Neopixel bladeconnector

330 Ohm on the Blade pcb side

x3 28 AWGor x1 22 AWGfor Negative

330 Ohm on the Blade pcb side

arrows up

330 Ohm on the Blade pcb side

In case no additional Neopixel strips are needed LED channels 4 5 6 can be used for 3 controllable(programmable for different effects) accent leds So AV switch led can be wired to one of these channelsAccent leds also can be wired to Data pads 2-5 please see ldquoAccent LEDs wiring and setuprdquo page

Recommended power wire gauges (22 AWG) are given for 2-strip blade For 3-strip blade you gonna need at least 20 AWG wires

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 29

ldquoproffieboard_v1_confighrdquo

3WIRING DIAGRAMS1

Basic Neopixel wiringldquoconfighrdquo file setup

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

NUM_BLADES 3NUM_BUTTONS 2VOLUME 1000CLASH_THRESHOLD_G 10IgnitionDelaylt0 any blade stylegtIgnitionDelaylt800 any blade stylegtIgnitionDelaylt800 any blade stylegtWS2811BladePtrlt118 WS2811 800kHz | WS2811 GRBgt()WS2811BladePtrlt26 blade2Pin ltbladePowerPin4gtgt()WS2811BladePtrlt26 blade3Pin ltbladePowerPin5gtgt()

ProffieBoard config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)Volume level (0-3000)Clash sensitivity (adjust lower or higher with 01 step)ldquoBlade 1rdquo style (main blade with IgnitionDelay 0)ldquoBlade 2rdquo style (CG blade 1 with IgnitionDelay 800)ldquoBlade 3rdquo style (CG blade 2 with IgnitionDelay 800)

strip configuration (defines how many pixels it has and to which LED output and pin is wired)

Preset 1

any blade style

strip (blade) 1 configuration

adjust this number to match your strips leds count

strip (blade) 2 configuration

strip (blade) 3 configuration

Preset 2 etc

Use a given or build your wiring diagram on THIS PAGE then open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text

Editor (Notepad - to see code correctly in Notepad Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all

text) and Delete it then Copy-and-Paste (Ctrl+C Ctrl+V) your wiring diagram config code (example below) into empty _configh file and

Save it under new name Follow the instructions on page 22 to upload it to the board

PROFFIEBOARD INSTRUCTIONS

30 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Basic Segmented string wiring diagram

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

+

+

-

-

24 A

WG

28 AWG

30-32 AWG30-32 AWG

Protected 36-37V (42V max at full charge) 10A 3500mAh battery recommended+18650 battery holder (optional)Keystone 1042P

AV switch with accent led(constantly ON no effects)

accent leds run mostly at10-15mA so resistors for them must be calculated accordingly

6-segments string blade

FoC string

N-channel FET3A minimum

123456

Calculate resistors for each led segment of the blade string depending on which leds are used 5mm leds have max drive current around 25mA per led when 10mm leds can be 100mA and 200mA per ledSo pay attention to your led max current and Forward Voltage (Vf) when calculating a segment resistor resistence as well as its wattage Also choose wire gauges accordingly to meet segments and total blade max current draw level

LED Resistor Calculator

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 31

ldquoproffieboard_v1_confighrdquo

3WIRING DIAGRAMS1

Basic Segmented string wiringldquoconfighrdquo file setup

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

NUM_BLADES 1NUM_BUTTONS 2VOLUME 1000CLASH_THRESHOLD_G 10StyleNormalPtrltCYAN WHITE 300 800gt()ltBlue3mmLED BladePin White3mmLEDgt

ProffieBoard config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)Volume level (0-3000)Clash sensitivity (adjust lower or higher with 01 step)Blade styleLED string configuration(here you mention the color and type of leds usedin the main blade string segments and FoC stringBladePin is the FoC signal pin (Blade ID pin))

Preset

LED string configuration

Use a given or build your wiring diagram on THIS PAGE then open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text

Editor (Notepad - to see code correctly in Notepad Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all

text) and Delete it then Copy-and-Paste (Ctrl+C Ctrl+V) your wiring diagram config code (example below) into empty _configh file and

Save it under new name Follow the instructions on page 22 to upload it to the board

PROFFIEBOARD INSTRUCTIONS

32 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Accent LEDs wiring diagram(optional)

Accent LEDs work with ProffieBoard as additional ldquobladesrdquo when powered by LED outputs 4 5 6 or Data pads 1 2 3 5 as PWM So they can

have any effect that blade can have If no effects needed accent led can be powered just by a 33V output pad (power-on led indication)

30-32 AWG

with Neopixel blade setup these 4 outputsdonrsquot work for regular accent leds

Recommended resistors to use for accent leds at 33V power source and 15mA drive

ndash 100 Ohm for Red (lt100000gt value in the code)ndash 13 Ohm for Green (lt13000gt value in the code)ndash 13 Ohm for Blue (lt13000gt value in the code)ndash 100 Ohm for Yellow (lt100000gt value in the code)ndash 20 Ohm for White (lt20000gt value in the code)

RGB ledcommon-anode

8 ldquobladesrdquo1 main and 7 accent leds

main blade style (effects) main blade style (effects)

7 accent leds style (effects)accent led style (effects)

7 accent leds configurations

RGB accent led configuration

2 ldquobladesrdquo1 main and 1 RGB accent led

ldquoPower-onrdquo indicationaccent leds (no effects)

7 accent leds withindependent effects

RGB accent led

a) b)

b)

c)

c)

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 33

3WIRING DIAGRAMS1

Neopixel Accent LEDs wiring diagram(optional)

With Neopixel setup additional neopixel leds or arrays can be used as accent leds There are 2 ways to wire them using additional Data

pins 2 3 4 5 or ldquoSub-bladesrdquo wiring with just 1 Data output pin Same way Neopixel connectors with on-board leds ca be wired

Option 1 ndash with extra Data pins

Main Blade

some accent leds

D1

D2

crystal leds

330 Ohm

330 Ohm

330 Ohm

main blade style (effects)

main blade 144 leds Data pin 1

accent leds blade style (effects)

accent leds ldquobladerdquo 4 leds Data pin 2

crystal leds blade style (effects)

crystal leds ldquobladerdquo 2 leds Data pin 3

3 ldquobladesrdquo1 main 1 accent leds array and 1 crystal leds array

PROFFIEBOARD INSTRUCTIONS

D3

follow arrows direction

34 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Neopixel Accent LEDs wiring diagram(optional)

PROFFIEBOARD INSTRUCTIONS

Main Blade

some accent leds

1

3

5678

2

4

D1

crystal leds

follow arrows direction

330 Ohm

330 OhmData signal

With this setup a single array of neopixel leds is separated into a couple of sub-blades with their own style configuration and behaviour This

is really usefull when you want to use only one data pin More about ldquoSub-bladesrdquo on ProffieOS wiki page

Option 2 ndash with ldquoSub-bladesrdquo

main blade style (effects)

main blade sub-blade 140 leds (7-146) but from 6 to 145 in the code

accent leds blade style (effects)

accent leds sub-blade 4 leds (1-4) but from 0 to 3 in the code

crystal leds blade style (effects)

146 leds total used

crystal leds sub-blade 2 leds (5-6) but from 4 to 5 in the code

update default 144 to a higher total value if you get all accent leds +Main blade gt 144 Example update to 146 if you have 2 crystal leds +4 accent leds + 140 Main blade leds = 146

3 ldquobladesrdquo 1 main 1 accent leds array and 1 crystal leds array

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 35

3WIRING DIAGRAMS1

OLED display wiring diagram(optional)

SSD1306 128x32 pixels OLED display allows to show battery level current preset name play different animations and even simple games It

can be wired to any blade configuration and requires just one additional line in the code to work You can get monochrome display in white

or blue color

SSD1306128x32OLED

SSD1306 ndash with blue or white display color selectSSD1306 ndash cheaper priceSSD1306 just screen ndash blue or white select

30-32 AWG

30-32 AWG

add this line to enable OLED display

display shows a preset name written in these quotes ldquoldquo

PROFFIEBOARD INSTRUCTIONS

36 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Bluetooth module wiring diagram(optional)

SOON

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 37

3WIRING DIAGRAMS1

Blade ID resistor functions(optional)

SOON

PROFFIEBOARD INSTRUCTIONS

38 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

website ProffieBoard FULL wiring diagrams link

Scroll the page down till you see the interactive diagram Above the diagram there are components selection options Build your saber setup

with it and follow diagram to wire your board Then you need to copy the configuration code below and paste it into your _configh file

Choose components you want

3WIRING DIAGRAMS1

More wiring diagrams

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 39

3WIRING DIAGRAMS1

How to use it

PROFFIEBOARD INSTRUCTIONS

Blade ignitionretraction ndash assuming you have at least one button pressing it briefly should turn the saber on or off If you have an AUX button pressing it briefly should also turn the saber on and off If you have no buttons you can turn the saber on and off by twisting your wrist back and forth Note that the motion has to be done long enough to count so a very quick flick of the wrist will not workTurn On muted ndash double-click power buttonNext preset ndash while saber is off click the AUX buttonPrevious preset ndash hold AUX button and click the Activation buttonTrigger Clash ndash while saber is on hit the bladeTrigger Lockup ndash while saber is on hold Activation button then trigger a clash Lockup releases when you let go of the Acti-vation buttonTrigger Drag ndash like lockup but point saber mostly down before holding Activation buttonTrigger Force ndash long-click AUX buttonStart soundtrack ndash long-click the Activation buttonTrigger Blaster Block ndash while saber is on short-click AUX button

Serial Monitor commands

battery_voltage ndash gets current battery voltage valueget_volume ndash get current volume valuepow ndash power OnOff the saberon ndash power On the saberoff ndash power Off the saberset_volume lt0-3000gt ndash set volume value (example set_volume 500)play ndash play the default preset trackplay trackslttrack namegt ndash play a specific track from tracks folder (example play tracksvenuswav)stop ndash stop the playing trackforce ndash play ldquoforcerdquo sound effectsdrag ndash play ldquodragrdquo sound effectsblast ndash play ldquoblasterrdquo sound effectslock ndash play ldquolockuprdquo sound effectsclash ndash play ldquoclashrdquo sound effectsreset ndash reboot the boardn ndash switch to next presetp ndash switch to previous presetlist_presets ndash show all presetssdtest ndash test SD card speed

40 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3FIRMWARE UPLOAD AND UPDATE2

Software installation and setup

PROFFIEBOARD INSTRUCTIONS

To upload firmware to ProffieBoard Arduino IDE program is required Follow these steps to install it to your PC

1 Install latest Arduino IDE software (donrsquot use BETA)

Installing as Windows app also is not recommended

because it will be installed in a specific protected folder that

wonrsquot allow you to install any additional softwareplugin in it

If ProffieBoard wonrsquot show up in COM port use

Arduino IDE 186 version

2 Install the Proffieboard Arduino Plugin and Zadig software

Follow installation instructions

3 Select Proffieboard-STM32L433 in Tools -gt Board

USB Type ndash Serial CPU Speed ndash 80 MHz Optimize ndash Smallest Code DOSFS ndash SDCARD (SPI) Port ndash COM(the number your PC assigned) (Butterfly-L433CC)

Connect Proffieboard via USB cable to PC to be able to select

the Port

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 41

3FIRMWARE UPLOAD AND UPDATE2

Uploading firmware

PROFFIEBOARD INSTRUCTIONS

1 Download the ProffieBoard firmware and SD card content

Unzip lightsaber-1286zip to your Documents directory or to

Desktop but not to Arduino program folder or anywhere in

Programs directory where all programs are installed You will

see a lightsaber folder and files inside it Donrsquot move any of

these files to any other location outside the lightsaber folder

and donrsquot reorganize them Unzip ProffieOS_SD_Cardzip to the

folder where you keep lightsaber-1286 folder Copy all files

from ProffieOS_SD_Card folder to your SD card

2 Unhide file extensions in File Explorer settings to see h ending

of config files Donrsquot add ldquohrdquo to the config file name Go to config folder and create you own configh file (see page

42 for how-to)

Double-click the lightsaberino file

3 Add the name of your configh file as shown and Save this

lightsaberino file Make sure the other config files are

commented out there should be only one CONFIG_FILE

without You can have multiple config files

in lightsabergtconfig folder and just define the one you need

in lightsaberino file and upload it again to ProffieBoard

4 Connect battery to ProffieBoard and hook up to your PC

with a data transfer micro-USB-to-USB cable

Press arrow button it will compile and upload firmware to the

board Wait for red text progress bars to stop at 100

ProffieBoard will play boot sound if speaker is connected

Now you can unplug the USB cable Done

If it gives an error instead this means your configh file has

issues define CONFIG_FILE name has mistakes configh file

is out of config folder your PC user name is non-latin

42 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

33

configh file structure editing

PROFFIEBOARD INSTRUCTIONS

CHANGING PARAMETERS

All sound files (sound fonts music tracks) are stored on the micro SD card Add required sound fonts folders (Plecter NEC and Smoothswing

fonts are supported no need to change WAV files names just copy and paste) to SD card root directory as itrsquos done in the default

ProffieOS_SD_Card content folder and music tracks to the tracks folder

Make sure to name all music tracks and sound fonts folders with latin characters and only up to 8 characters long without using any special

characters (like |[- etc)

Make sure you have a configini file in each sound font folder if there is none - copy one from some default TeensySaberProffieBoard sound

font and paste into newly added sound font folder It has only one parameter that you can modify - humstart It helps to match hum sound

start with blade ignition 1000 usually works fine

All blade effects LED configuration volume level clash sensitivity etc are changed in the configh file located in lightsabergtconfig folder

To do that open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text Editor (Notepad - to see code correctly in Notepad

Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all text) and Delete it then Copy-and-Paste (Ctrl+C

Ctrl+V) your wiring diagram config code into empty _configh file and Save it under new name Follow the instructions on page 39 to

upload it to the board

Proffieboard config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)

volume level (0-3000)

clash sensitivity (adjust lower or higher with 01 step)

sound font folder nametrack name

Preset name

Blade style

LED configuration (use these XP-E2 LED templatesto define your LED)

for Red use 1 Ohm resistor for Green - no resistor for Blue use 024 Ohm

NoLED ndash no 4th led used

Preset 1

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 43

33

Blade Styles

StylePtrltInOutHelperltSimpleClashltLockupltBlastltOnSparkltAudioFlickerltRgblt02550gtRgblt501000gtgtRgblt2552550gt150gtRgblt255500gtgtAudioFlickerltRgblt1002550gtRgblt2550150gtgtgtRgblt255100150gt40gt200300Blackgtgt

ndash this is how the Blade Style code looks pasted in the configh file Preset (it sits inside a StylePtrltgt container)

ndash this is how the Blade Style code looks when editing it inside a Blade Style Editor

Each Blade Style is made of a variety of Effects each added effect goes instead of a base color in the previous effect

PROFFIEBOARD INSTRUCTIONS

CHANGING PARAMETERS

ProffieBoard and TeensySaber use Blade Styles for the main saber blade and any other accent leds to define all light effects (color changing

flashes flickering delays ignitionretraction timing etc)

Use Blade Style Editor to create and adjust Blade Styles Megtooth Sith Sabers did a great video tutorial where he shows and explains

how to use Blade Style Editor Also you can grab some pre-made Blade Styles or share yours here on TRA forums

A Blade Style example of simple flickering Green blade with Spark on start Clash Blaster Lockup and Drag IgnitionRetraction effects

InOutHelperltSimpleClashltLockupltBlastltOnSparkltAudioFlickerltRgblt02550gtRgblt501000gtgtRgblt2552550gt150gtRgblt255500gtgtAudioFlickerltRgblt1002550gtRgblt2550150gtgtgtRgblt255100150gt40gt200300Blackgt

InOutHelperltbase color200300Blackgt ndash base color can be defined by words (WHITE RED GREEN PURPLE etc) or by Rgblt0-2550-2550-255gt values for more

custom shades 200 is extension length in milliseconds 300 is retraction length in milliseconds Black is color when retracted (also can be any other color)

SimpleClashltbase colorclash color40gt ndash clash effect 40 is clash duration in milliseconds

Lockupltbase colorlockup colorgt ndash lockup effect

Blastltbase colorblast colorgt ndash blaster effect

OnSparkltbase colorspark color150gt ndash spark on ignition effect 150 is spark duration in milliseconds

AudioFlickerltrdquoArdquo colorrdquoBrdquo colorgt ndash flickering effect (blade flickers to the actual saber hum sound) the more difference between ldquoArdquo and ldquoBrdquo colors - the more

abrupt is flickering

Rgblt255500gt ndash actual color in RGB format (0 is no light 255 is the maximum brightness value for Red Green or Blue channel)

44 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

ndash SanDisk 4GB microSDHC Class 4 (Genuine) ndash SanDisk 4GB microSDHC Class 4 (Genuine)

130238 kbs = 1477 simultaneous audio streams 137812 kbs = 1562 simultaneous audio streams

ndash Patriot LX Series 16GB microSDHC UHS-IU1 Class 10 ndash Patriot LX Series 16GB microSDHC UHS-IU1 Class 10

133005 kbs = 1508 simultaneous audio streams

ndash GSkill 16GB microSDHC UHS-IU1 Class 10 ndash GSkill 16GB microSDHC UHS-IU1 Class 10

129534 kbs = 1469 simultaneous audio streams

ndash Kingston 16GB microSDHC UHS-IU1 Class 10 ndash Kingston 16GB microSDHC UHS-IU1 Class 10

128090 kbs = 1452 simultaneous audio streams

ndash SanDisk Ultra 16GB microSDHC UHS-IU1 A1 Class 10 ndash SanDisk Ultra 16GB microSDHC UHS-IU1 A1 Class 10

102663 kbs = 1164 simultaneous audio streams 11124 kbs = 1261 simultaneous audio streams

ndash SanDisk 8GB microSDHC Class 4 ndash SanDisk 8GB microSDHC Class 4

108506 kbs = 1230 simultaneous audio streams

ndash SanDisk 16GB microSDHC Class 4 ndash SanDisk 16GB microSDHC Class 4

102663 kbs = 1164 simultaneous audio streams 106957 kbs = 1213 simultaneous audio streams

ndash SanDisk Ultra 16GB microSDHC UHS-IU1 Class 10 ndash SanDisk Ultra 16GB microSDHC UHS-IU1 Class 10

102663 kbs = 1164 simultaneous audio streams 103909 kbs = 1178 simultaneous audio streams

ndash Smartbuy 4GB microSDHC Class 4 ndash Smartbuy 4GB microSDHC Class 4

75437 kbs = 855 simultaneous audio streams

ndash Kingston 8GB microSDHC Class 4 ndash Kingston 8GB microSDHC Class 4

75209 kbs = 822 simultaneous audio streams

ndash SanDisk 4GB microSDHC Class 4 (Fake) ndash SanDisk 4GB microSDHC Class 4 (Fake)

677 kbs = 769 simultaneous audio streams

Here is a list of tested micro SD cards speed with TeensySaber V3 and ProffieBoard Any card with speed over 900 kbs is recommended the

higher the speed is ndash the better Memory size of 4-16Gb is more than enough Cards were tested with a default firmware (1291) compiled

with ldquoSmallest Coderdquo under Optimize ldquodefault_proffieboard_confighrdquo file and default ProffieOS SD card sound files (7 folders)

To test your SD card speed simply hook up ProffieBoard to PC open Arduino IDE go to Tools and open Serial Monitor make sure you have

New Line and 9600 baud rate selected on the bottom of Serial Monitor window type and send sdtest command wait for the test result

4Recommended micro SD cards

BEST

TEENSYSABER PROFFIEBOARD

GOOD

BAD

PROFFIEBOARD INSTRUCTIONS

SD CARD RECOMMENDATIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 45

There are a lot of fake (chinese copies) microSD cards on the market from aliexpress ebay amazon etc They look very similar to genuine

cards but are a bit different though and have a twice lower writingreading speed Here is an example of a SanDisk 4Gb Class 4 card one is

genuine with 137812 kbs speed and the other one is fake with 677 kbs speed I got from ebay seller

Be carefull and pay attention to how the actual card looks if you are not sure ask seller for the real photo of SD card he sells

4Genuine and Fake SanDisk 4Gb Class 4 microSD

PROFFIEBOARD INSTRUCTIONS

SD CARD RECOMMENDATIONS

46 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

WIRE GAUGE GUIDE

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 47

RECHARGE PORTS AND KILL SWITCHES

48 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

NEOPIXEL STRIPS CURRENT DRAW

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 49

6TROUBLESHOOTING

For more help please check these linksProffieOSProffieBoardTeensySaber wiki on GitHubAsk your question on The Rebel Armory forumsAsk your question on FX-sabers forumsAsk your question in facebook group

How to solve most common issues

Quick troubleshooting tips

TeensySaber board or Proffieboard is not recognized by computer (nothing under Port selection in Arduino)

ndash Make sure a charged 37V battery is connected to the board micro-USB cable is a data transfer cable all plugins and drivers are installed ndash

check again pages 21 for TeensySaber or 40 for Proffieboard Try a different USB port on your computer

Sketch (code) compile error in Arduino IDE

ndash Check your define CONFIG_FILE ldquoconfig_confighrdquo line in opened lightsaberino file if itrsquos written correctly with config in it

Sketch (code) compile error in Arduino IDE

ndash Check if the _configh file you defined in the lightsaberino sketch file is same name as in the lightsaber-rdquofirmware versionrdquolightsaber

config folder and is located in this folder

Sketch (code) compile error in Arduino IDE

ndash Check your settings under Tools tab in Arduino IDE program Check again pages 21 for TeensySaber or 40 for Proffieboard

Sketch (code) compile error in Arduino IDE

ndash Check if your _configh file is correct Blade Styles Presets const unsigned int maxLedsPerStrip = 144 if BladeConfig blades[] = is correct

Sketch (code) compile error in Arduino IDE

ndash If nothing helps install Arduino IDE version 186 and try to compile and upload the firmware again

Sound doesnrsquot play

ndash Remove SD card and insert again check speaker wiring Make sure all sound files on SD card are correctly named (8 characters max long)

Re-format SD card in FAT32 load sound files and try again try another SD card

Board says ldquoLOW POWERrdquo

ndash Charge the battery

Serial Monitor shows info sent by the board but your commands donrsquot work

ndash In the bottom right corner of Serial Monitor window make sure the Line Ending drop down is set to New Line

Sound is weird and distorted

ndash Check your SD card speed (see page 44) Check speaker wiring try another good speaker

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 09

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

Basic Tri-Cree wiring (In-hilt LED)ldquoconfighrdquo file setup

Use a given or build your wiring diagram on THIS PAGE then open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text

Editor (Notepad - to see code correctly in Notepad Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all

text) and Delete it then Copy-and-Paste (Ctrl+C Ctrl+V) your wiring diagram config code (example below) into empty _configh file and

Save it under new name Follow the instructions on page 22 to upload it to the board

ldquov3_confighrdquoNUM_BLADES 2NUM_BUTTONS 2VOLUME 1000CLASH_THRESHOLD_G 10StyleNormalPtrltCYAN WHITE 300 800gt()StyleNormalPtrltCYAN WHITE 300 800gt()

CreeXPE2RedTemplatelt1000gtCreeXPE2GreenTemplatelt0gtCreeXPE2BlueTemplatelt240gtNoLED

TeensySaber V3 config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)Volume level (0-3000)Clash sensitivity (adjust lower or higher with 01 step)ldquoBlade 1rdquo styleldquoBlade 2rdquo style (in case only 1 blade is used you donrsquot need this line)LED configuration (use these XP-E2 LED templatesto define your LED If other LED resistors are used change these values to match Ohm1000=ltvaluegt)

where 1000 is 1 Ohm resistor 0 is no resistor240 is 024 Ohm resistorNoLED ndash no 4th led used

Preset 1

LED 1 configuration

LED 2 configuration

Preset 2 etc

10 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

Basic Neopixel wiring diagram

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

+

+

+

-

-

-

22 A

WG

22 AWG

26 AWG

30 AWG

x2 28 AWG

x2 26 AWG

22 A

WG

30-32 AWG

30-32 AWG

Protected 36-37V (42V max at full charge) 10A 3500mAh or 15A 3120mAhbattery recommended+18650 battery holder (optional)Keystone 1042P

AV switch with accent led(constantly ON no effects)

accent leds run mostly at10-15mA so resistors for them must be calculated accordingly

Main Neopixel strip

additional Neopixelstrips(optional)

Neopixel bladeconnector

330 Ohm on the Blade pcb side

x3 28 AWGor x1 22 AWGfor Negative

330 Ohm on the Blade pcb side

arrows up

330 Ohm on the Blade pcb side

In case no additional Neopixel strips are needed LED channels 4 5 6can be used for 3 controllable (programmable for different effects) accent leds So AV switch led can be wired to one of these channelsby adding 1 MOSFETRecommended power wire gauges (22 AWG) are given for 2-strip blade For 3-strip blade you gonna need at least 20 AWG wires

solder 2x FETs

solder 1 FET

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 11

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

Basic Neopixel wiringldquoconfighrdquo file setup

ldquov3_confighrdquoNUM_BLADES 3NUM_BUTTONS 2VOLUME 1000CLASH_THRESHOLD_G 10IgnitionDelaylt0 any blade stylegtIgnitionDelaylt800 any blade stylegtIgnitionDelaylt800 any blade stylegtWS2811BladePtrlt118 WS2811 800kHz | WS2811 GRBgt()WS2811BladePtrlt26 7 ltbladePowerPin4gtgt()WS2811BladePtrlt26 8 ltbladePowerPin5gtgt()

TeensySaber V3 config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)Volume level (0-3000)Clash sensitivity (adjust lower or higher with 01 step)ldquoBlade 1rdquo style (main blade with IgnitionDelay 0)ldquoBlade 2rdquo style (CG blade 1 with IgnitionDelay 800)ldquoBlade 3rdquo style (CG blade 2 with IgnitionDelay 800)

strip configuration (defines how many pixels it has and to which LED output and pin is wired)

Preset 1

any blade style

strip (blade) 1 configuration

strip (blade) 2 configuration

strip (blade) 3 configuration

Preset 2 etc

Use a given or build your wiring diagram on THIS PAGE then open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text

Editor (Notepad - to see code correctly in Notepad Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all

text) and Delete it then Copy-and-Paste (Ctrl+C Ctrl+V) your wiring diagram config code (example below) into empty _configh file and

Save it under new name Follow the instructions on page 22 to upload it to the board

12 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

Basic Segmented string wiring diagram

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

+

+

-

-

24 A

WG

28 AWG

30-32 AWG

30-32 AWG

Protected 36-37V (42V max at full charge) 10A 3500mAh battery recommended+18650 battery holder (optional)Keystone 1042P

AV switch with accent led(constantly ON no effects)

accent leds run mostly at10-15mA so resistors for them must be calculated accordingly

6-segments string blade

FoC string

N-channel FET3A minimum

1

1 46 523

23456

Calculate resistors for each led segment of the blade string depending on which leds are used 5mm leds have max drive current around 25mA per led when 10mm leds can be 100mA and 200mA per ledSo pay attention to your led max current and Forward Voltage (Vf) when calculating a segment resistor resistence as well as its wattage Also choose wire gauges accordingly to meet segments and total blade max current draw level

LED Resistor Calculator

solder 3x FETs

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 13

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

Basic Segmented string wiringldquoconfighrdquo file setup

ldquov3_confighrdquoNUM_BLADES 1NUM_BUTTONS 2VOLUME 1000CLASH_THRESHOLD_G 10StyleNormalPtrltCYAN WHITE 300 800gt()ltBlue3mmLED 20 White3mmLEDgt

TeensySaber V3 config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)Volume level (0-3000)Clash sensitivity (adjust lower or higher with 01 step)Blade styleLED string configuration(here you mention the color and type of leds usedin the main blade string segments and FoC string20 is the FoC signal pin (Blade ID pin))

Preset

LED string configuration

Use a given or build your wiring diagram on THIS PAGE then open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text

Editor (Notepad - to see code correctly in Notepad Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all

text) and Delete it then Copy-and-Paste (Ctrl+C Ctrl+V) your wiring diagram config code (example below) into empty _configh file and

Save it under new name Follow the instructions on page 22 to upload it to the board

14 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

Accent LEDs wiring diagram(optional)

Accent LEDs work with TeensySaber board as additional ldquobladesrdquo when powered by LED outputs 4 5 6 with FETs So they can have any effect

that blade can have If no effects needed accent led can be powered just by a 33V output pad (power-on led indication)

30-32 AWGRGB ledcommon-anode

4 ldquobladesrdquo1 main and 3 accent leds

main blade style (effects) main blade style (effects)

3 accent leds style (effects)accent led style (effects)

3 accent leds configurations

RGB accent led configuration

2 ldquobladesrdquo1 main and 1 RGB accent led

ldquoPower-onrdquo indicationaccent leds (no effects)

3 accent leds withindependent effects

+ 1 or more simple accent leds without effects

1 RGB accent led+ 1 or more simple accent leds

without effects

a) b)

b)

c)

c)

solder 3x FETs solder 3x FETs

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 15

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

OLED display wiring diagram(optional)

SSD1306 128x32 pixels OLED display allows to show battery level current preset name play different animations and even simple games It

can be wired to any blade configuration and requires just one additional line in the code to work You can get monochrome display in white

or blue color

SSD1306128x32OLED

SSD1306 ndash with blue or white display color selectSSD1306 ndash cheaper priceSSD1306 just screen ndash blue or white select

30-32 AWG

30-32 AWG

add this line to enable OLED display

display shows a preset name written in these quotes ldquoldquo

16 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

Bluetooth module wiring diagram(optional)

SOON

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 17

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

Blade ID resistor functions(optional)

SOON

18 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

website TeensySaber V3 FULL wiring diagrams link

Scroll the page down till you see the interactive diagram Above the diagram there are components selection options Build your saber setup

with it and follow diagram to wire your board Then you need to copy the configuration code below and paste it into your _configh file

Choose components you want

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

More wiring diagrams

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 19

20 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

How to use it

Blade ignitionretraction ndash assuming you have at least one button pressing it briefly should turn the saber on or off If you have an AUX button pressing it briefly should also turn the saber on and off If you have no buttons you can turn the saber on and off by twisting your wrist back and forth Note that the motion has to be done long enough to count so a very quick flick of the wrist will not workTurn On muted ndash double-click power buttonNext preset ndash while saber is off click the AUX buttonPrevious preset ndash hold AUX button and click the Activation buttonTrigger Clash ndash while saber is on hit the bladeTrigger Lockup ndash while saber is on hold Activation button then trigger a clash Lockup releases when you let go of the Acti-vation buttonTrigger Drag ndash like lockup but point saber mostly down before holding Activation buttonTrigger Force ndash long-click AUX buttonStart soundtrack ndash long-click the Activation buttonTrigger Blaster Block ndash while saber is on short-click AUX button

Serial Monitor commands

battery_voltage ndash gets current battery voltage valueget_volume ndash get current volume valuepow ndash power OnOff the saberon ndash power On the saberoff ndash power Off the saberset_volume lt0-3000gt ndash set volume value (example set_volume 500)play ndash play the default preset trackplay trackslttrack namegt ndash play a specific track from tracks folder (example play tracksvenuswav)stop ndash stop the playing trackforce ndash play ldquoforcerdquo sound effectsdrag ndash play ldquodragrdquo sound effectsblast ndash play ldquoblasterrdquo sound effectslock ndash play ldquolockuprdquo sound effectsclash ndash play ldquoclashrdquo sound effectsreset ndash reboot the boardn ndash switch to next presetp ndash switch to previous presetlist_presets ndash show all presetssdtest ndash test SD card speed

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 21

2TEENSYSABER V3 INSTRUCTIONS

FIRMWARE UPLOAD AND UPDATE2

Software installation and setup

To upload firmware to TeensySaber board Arduino IDE program is required Follow these steps to install it to your PC

1 Install latest Arduino IDE software (donrsquot use BETA)

Installing as Windows app also is not recommended

because it will be installed in a specific protected folder that

wonrsquot allow you to install Teensyduino software in it

If TeensySaber wonrsquot show up in COM port use

Arduino IDE 186 version

2 Install latest Teensyduino software in same directory

usually itrsquos CProgram Files (x86)Arduino on Windows

Follow installation instructions for your system

3 Select Teensy 32 31 in Tools -gt Board

USB Type ndash Serial CPU Speed ndash 96 MHz (overclock) Optimize ndash Smallest Code Port ndash COM(the number your PC assigned) (Teensy 32) Serial

Connect TeensySaber via USB cable to PC to be able to select

the Port donrsquot forget to connect battery first

22 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

1 Download the TeensySaber firmware and SD card content

Unzip lightsaber-1286zip to your Documents directory or to

Desktop but not to Arduino program folder or anywhere in

Programs directory where all programs are installed You will

see a lightsaber folder and files inside it Donrsquot move any of

these files to any other location outside the lightsaber folder

and donrsquot reorganize them Unzip ProffieOS_SD_Cardzip to the

folder where you keep lightsaber-1286 folder Copy all files

from ProffieOS_SD_Card folder to your SD card

2 Unhide file extensions in File Explorer settings to see h ending

of config files Donrsquot add ldquohrdquo to the config file name

Go to config folder and create you own configh file (see page

23 for how-to)

Double-click the lightsaberino file

3 Add the name of your configh file as shown and Save this

lightsaberino file Make sure the other config files are

commented out there should be only one CONFIG_FILE

without You can have multiple config files

in lightsabergtconfig folder and just define the one you need

in lightsaberino file and upload it again to TeensySaber board

4 Connect battery to TeensySaber board and hook up to your PC

with a data transfer micro-USB-to-USB cable

Press arrow button it will compile and upload firmware to the

board Wait for your PC to make a sound or TeensySaber will

play boot sound if speaker is connected Now you can unplug

the USB cable Done

If it gives an error instead this means your configh file has

issues define CONFIG_FILE name has mistakes configh file

is out of config folder your PC user name is non-latin

2TEENSYSABER V3 INSTRUCTIONS

FIRMWARE UPLOAD AND UPDATE2

Uploading firmware

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 23

2TEENSYSABER V3 INSTRUCTIONS

CHANGING PARAMETERS3

Changing sound board parameters

All sound files (sound fonts music tracks) are stored on the micro SD card Add required sound fonts folders (Plecter NEC and Smoothswing

fonts are supported no need to change WAV files names just copy and paste) to SD card root directory as itrsquos done in the default

ProffieOS_SD_Card content folder and music tracks to the tracks folder

Make sure to name all music tracks and sound fonts folders with latin characters and only up to 8 characters long without using any special

characters (like |[- etc)

Make sure you have a configini file in each sound font folder if there is none - copy one from some default TeensySaberProffieBoard sound

font and paste into newly added sound font folder It has only one parameter that you can modify - humstart It helps to match hum sound

start with blade ignition 1000 usually works fine

All blade effects LED configuration volume level clash sensitivity etc are changed in the configh file located in lightsabergtconfig folder

To do that open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text Editor (Notepad - to see code correctly in Notepad

Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all text) and Delete it then Copy-and-Paste (Ctrl+C

Ctrl+V) your wiring diagram config code into empty _configh file and Save it under new name Follow the instructions on page 22 to

upload it to the board

TeensySaber V3 config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)

volume level (0-3000)

clash sensitivity (adjust lower or higher with 01 step)

sound font folder nametrack name

Preset name

Blade style

LED configuration (use these XP-E2 LED templatesto define your LED)

for Red use 1 Ohm resistor for Green - no resistor for Blue use 024 Ohm

NoLED ndash no 4th led used

Preset 1

24 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

31

PROFFIEBOARD INSTRUCTIONS

Whatrsquos needed

ndash ProffieBoard

ndash micro SD-card (see page 44 for recommendations)

ndash a USB micro SD-card reader (to load sound files from PC to micro SD card)

ndash micro USB data transfer cable (CABLES THAT SUPPORT ONLY CHARGING WONrsquoT WORK)

ndash wires of different gauges (32-20 AWG) (PTFE coated copper stranded wires recommended) heat shrink

ndash ESD safe soldering station solder wire flux etc

ndash pliers helping hands etc

ndash isopropyl alcohol to clean pads before soldering (helps solder to stick better)

ndash Digital Multimeter (VERY USEFUL)

ndash computer running Windows Linux or Mac OS with internet access

ndash 37V Li-Ion Protected rechargeable battery switches recharge port speaker LEDs resistors chassis etc

ndash Smart Li-Ion CC-CV (Constant Current - Constant Voltage mode) battery charger for 37V (42V) cells

ndash patience

WIRING DIAGRAMS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 25

31

PROFFIEBOARD INSTRUCTIONS

Board pinout

Battery + ndash 26 to 45 volt input drives everything except the LEDs

Battery - ndash negative pad for LEDs needs to be at same level as GND when both are connected Both pads are internally connected

GND ndash ground for electronics except LEDs Note that there are two GND pads on the board that are internally connected

Speaker +- ndash hooks up to speaker

Activation (1) Aux (2) Aux2 button (3) ndash hook up to closing buttons or potentially touch buttons

Blade ID Neopixel Data 1 ndash normally used to measure the blade ID restor and if itrsquos a neopixel blade feed out neopixel data

Data 2 3 4 5 ndash additional neopixel data outputs or free for other purposes

LED 1 2 3 4 5 6 ndash hooks up to negative side of LED (positive side of LED hooks up directly to battery) These pads can handle

up to 30 volts

SDA SCL ndash these pins are used to wire OLED display or to communicate with the gyro and accelerometer chip

RX TX ndash these pins are used for wiring a bluetooth module for wireless control

SWDCLK SWDIO ndash can be hooked up to a ST-LINK device and lets you debug programs running on the ProffieBoard

+5V ndash generated by the ProffieBoard normally itrsquos only ON when sound is playing

+33V ndash generated by the ProffieBoard for powering OLED display Bluetooth module or some accent leds

BOOT RESET ndash buttons to put the ProffieBoard in bootloader mode if uploading doesnrsquot work

micro USB port ndash micro USB port used only for firmware upload and can be used for sound files upload to SD card (from firmware version

1291 and up) THIS PORT ISNrsquoT USED FOR CHARGING THE BATTERY

LED 4LED 3

LED 2

LED 1

LED 5

LED 6

RESETBOOT

Battery - Battery -

Speaker + (red dot or ldquo+rdquo mark on speaker)

Battery +

Aux button (2)Activation button (1)

Aux2 button (3)

Blade ID Neopixel Data 1

Data 5

Data 4Data 3Data 2

+33V

SWDIO

SWDCLK

+5V

TXRX

GND

GND

Reset

Speaker -

SCLSDA

micro USB port

WIRING DIAGRAMS

26 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Basic Tri-Cree wiring diagram(In-hilt LED)

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

+

+

-

-

26 AWG

26 A

WG

30-32 AWG

28-30 AWG

28-3

0 A

WG

30-32 AWG

Protected 36-37V (42V max at full charge) 10A 3500mAh battery recommended+18650 battery holder (optional)Keystone 1042P

AV switch with accent led(constantly ON no effects)

accent leds run mostly at10-15mA so resistors for them must be calculated accordingly

Main RGB led

additional RGB leds(optional)

In case no additional high power leds are needed LED channels 4 5 6 can be used for 3 controllable(programmable for different effects) accent leds So AV switch led can be wired to one of these channelsAccent leds also can be wired to Data pads 1-5 please see ldquoAccent LEDs wiring and setuprdquo page

LED Resistor Calculator

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 27

3WIRING DIAGRAMS1

Basic Tri-Cree wiring (In-hilt LED)ldquoconfighrdquo file setup

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

Use a given or build your wiring diagram on THIS PAGE then open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text

Editor (Notepad - to see code correctly in Notepad Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all

text) and Delete it then Copy-and-Paste (Ctrl+C Ctrl+V) your wiring diagram config code (example below) into empty _configh file and

Save it under new name Follow the instructions on page 22 to upload it to the board

ldquoproffieboard_v1_confighrdquoNUM_BLADES 2NUM_BUTTONS 2VOLUME 1000CLASH_THRESHOLD_G 10StyleNormalPtrltCYAN WHITE 300 800gt()StyleNormalPtrltCYAN WHITE 300 800gt()

CreeXPE2RedTemplatelt1000gtCreeXPE2GreenTemplatelt0gtCreeXPE2BlueTemplatelt240gtNoLED

ProffieBoard config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)Volume level (0-3000)Clash sensitivity (adjust lower or higher with 01 step)ldquoBlade 1rdquo styleldquoBlade 2rdquo style (in case only 1 blade is used you donrsquot need this line)LED configuration (use these XP-E2 LED templatesto define your LED If other LED resistors are used change these values to match Ohm1000=ltvaluegt)

where 1000 is 1 Ohm resistor 0 is no resistor240 is 024 Ohm resistorNoLED ndash no 4th led used

Preset 1

LED 1 configuration

LED 2 configuration

Preset 2 etc

PROFFIEBOARD INSTRUCTIONS

28 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Basic Neopixel wiring diagram

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

+

+

-

-

22 A

WG

22 AWG

x2 28 AWG

x2 26 AWG

22 A

WG

30-32 AWG30-32 AWG

Protected 36-37V (42V max at full charge) 10A 3500mAh or 15A 3120mAhbattery recommended+18650 battery holder (optional)Keystone 1042P

AV switch with accent led(constantly ON no effects)

accent leds run mostly at10-15mA so resistors for them must be calculated accordingly

Main Neopixel strip

additional Neopixelstrips(optional)

Neopixel bladeconnector

330 Ohm on the Blade pcb side

x3 28 AWGor x1 22 AWGfor Negative

330 Ohm on the Blade pcb side

arrows up

330 Ohm on the Blade pcb side

In case no additional Neopixel strips are needed LED channels 4 5 6 can be used for 3 controllable(programmable for different effects) accent leds So AV switch led can be wired to one of these channelsAccent leds also can be wired to Data pads 2-5 please see ldquoAccent LEDs wiring and setuprdquo page

Recommended power wire gauges (22 AWG) are given for 2-strip blade For 3-strip blade you gonna need at least 20 AWG wires

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 29

ldquoproffieboard_v1_confighrdquo

3WIRING DIAGRAMS1

Basic Neopixel wiringldquoconfighrdquo file setup

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

NUM_BLADES 3NUM_BUTTONS 2VOLUME 1000CLASH_THRESHOLD_G 10IgnitionDelaylt0 any blade stylegtIgnitionDelaylt800 any blade stylegtIgnitionDelaylt800 any blade stylegtWS2811BladePtrlt118 WS2811 800kHz | WS2811 GRBgt()WS2811BladePtrlt26 blade2Pin ltbladePowerPin4gtgt()WS2811BladePtrlt26 blade3Pin ltbladePowerPin5gtgt()

ProffieBoard config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)Volume level (0-3000)Clash sensitivity (adjust lower or higher with 01 step)ldquoBlade 1rdquo style (main blade with IgnitionDelay 0)ldquoBlade 2rdquo style (CG blade 1 with IgnitionDelay 800)ldquoBlade 3rdquo style (CG blade 2 with IgnitionDelay 800)

strip configuration (defines how many pixels it has and to which LED output and pin is wired)

Preset 1

any blade style

strip (blade) 1 configuration

adjust this number to match your strips leds count

strip (blade) 2 configuration

strip (blade) 3 configuration

Preset 2 etc

Use a given or build your wiring diagram on THIS PAGE then open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text

Editor (Notepad - to see code correctly in Notepad Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all

text) and Delete it then Copy-and-Paste (Ctrl+C Ctrl+V) your wiring diagram config code (example below) into empty _configh file and

Save it under new name Follow the instructions on page 22 to upload it to the board

PROFFIEBOARD INSTRUCTIONS

30 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Basic Segmented string wiring diagram

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

+

+

-

-

24 A

WG

28 AWG

30-32 AWG30-32 AWG

Protected 36-37V (42V max at full charge) 10A 3500mAh battery recommended+18650 battery holder (optional)Keystone 1042P

AV switch with accent led(constantly ON no effects)

accent leds run mostly at10-15mA so resistors for them must be calculated accordingly

6-segments string blade

FoC string

N-channel FET3A minimum

123456

Calculate resistors for each led segment of the blade string depending on which leds are used 5mm leds have max drive current around 25mA per led when 10mm leds can be 100mA and 200mA per ledSo pay attention to your led max current and Forward Voltage (Vf) when calculating a segment resistor resistence as well as its wattage Also choose wire gauges accordingly to meet segments and total blade max current draw level

LED Resistor Calculator

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 31

ldquoproffieboard_v1_confighrdquo

3WIRING DIAGRAMS1

Basic Segmented string wiringldquoconfighrdquo file setup

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

NUM_BLADES 1NUM_BUTTONS 2VOLUME 1000CLASH_THRESHOLD_G 10StyleNormalPtrltCYAN WHITE 300 800gt()ltBlue3mmLED BladePin White3mmLEDgt

ProffieBoard config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)Volume level (0-3000)Clash sensitivity (adjust lower or higher with 01 step)Blade styleLED string configuration(here you mention the color and type of leds usedin the main blade string segments and FoC stringBladePin is the FoC signal pin (Blade ID pin))

Preset

LED string configuration

Use a given or build your wiring diagram on THIS PAGE then open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text

Editor (Notepad - to see code correctly in Notepad Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all

text) and Delete it then Copy-and-Paste (Ctrl+C Ctrl+V) your wiring diagram config code (example below) into empty _configh file and

Save it under new name Follow the instructions on page 22 to upload it to the board

PROFFIEBOARD INSTRUCTIONS

32 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Accent LEDs wiring diagram(optional)

Accent LEDs work with ProffieBoard as additional ldquobladesrdquo when powered by LED outputs 4 5 6 or Data pads 1 2 3 5 as PWM So they can

have any effect that blade can have If no effects needed accent led can be powered just by a 33V output pad (power-on led indication)

30-32 AWG

with Neopixel blade setup these 4 outputsdonrsquot work for regular accent leds

Recommended resistors to use for accent leds at 33V power source and 15mA drive

ndash 100 Ohm for Red (lt100000gt value in the code)ndash 13 Ohm for Green (lt13000gt value in the code)ndash 13 Ohm for Blue (lt13000gt value in the code)ndash 100 Ohm for Yellow (lt100000gt value in the code)ndash 20 Ohm for White (lt20000gt value in the code)

RGB ledcommon-anode

8 ldquobladesrdquo1 main and 7 accent leds

main blade style (effects) main blade style (effects)

7 accent leds style (effects)accent led style (effects)

7 accent leds configurations

RGB accent led configuration

2 ldquobladesrdquo1 main and 1 RGB accent led

ldquoPower-onrdquo indicationaccent leds (no effects)

7 accent leds withindependent effects

RGB accent led

a) b)

b)

c)

c)

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 33

3WIRING DIAGRAMS1

Neopixel Accent LEDs wiring diagram(optional)

With Neopixel setup additional neopixel leds or arrays can be used as accent leds There are 2 ways to wire them using additional Data

pins 2 3 4 5 or ldquoSub-bladesrdquo wiring with just 1 Data output pin Same way Neopixel connectors with on-board leds ca be wired

Option 1 ndash with extra Data pins

Main Blade

some accent leds

D1

D2

crystal leds

330 Ohm

330 Ohm

330 Ohm

main blade style (effects)

main blade 144 leds Data pin 1

accent leds blade style (effects)

accent leds ldquobladerdquo 4 leds Data pin 2

crystal leds blade style (effects)

crystal leds ldquobladerdquo 2 leds Data pin 3

3 ldquobladesrdquo1 main 1 accent leds array and 1 crystal leds array

PROFFIEBOARD INSTRUCTIONS

D3

follow arrows direction

34 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Neopixel Accent LEDs wiring diagram(optional)

PROFFIEBOARD INSTRUCTIONS

Main Blade

some accent leds

1

3

5678

2

4

D1

crystal leds

follow arrows direction

330 Ohm

330 OhmData signal

With this setup a single array of neopixel leds is separated into a couple of sub-blades with their own style configuration and behaviour This

is really usefull when you want to use only one data pin More about ldquoSub-bladesrdquo on ProffieOS wiki page

Option 2 ndash with ldquoSub-bladesrdquo

main blade style (effects)

main blade sub-blade 140 leds (7-146) but from 6 to 145 in the code

accent leds blade style (effects)

accent leds sub-blade 4 leds (1-4) but from 0 to 3 in the code

crystal leds blade style (effects)

146 leds total used

crystal leds sub-blade 2 leds (5-6) but from 4 to 5 in the code

update default 144 to a higher total value if you get all accent leds +Main blade gt 144 Example update to 146 if you have 2 crystal leds +4 accent leds + 140 Main blade leds = 146

3 ldquobladesrdquo 1 main 1 accent leds array and 1 crystal leds array

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 35

3WIRING DIAGRAMS1

OLED display wiring diagram(optional)

SSD1306 128x32 pixels OLED display allows to show battery level current preset name play different animations and even simple games It

can be wired to any blade configuration and requires just one additional line in the code to work You can get monochrome display in white

or blue color

SSD1306128x32OLED

SSD1306 ndash with blue or white display color selectSSD1306 ndash cheaper priceSSD1306 just screen ndash blue or white select

30-32 AWG

30-32 AWG

add this line to enable OLED display

display shows a preset name written in these quotes ldquoldquo

PROFFIEBOARD INSTRUCTIONS

36 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Bluetooth module wiring diagram(optional)

SOON

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 37

3WIRING DIAGRAMS1

Blade ID resistor functions(optional)

SOON

PROFFIEBOARD INSTRUCTIONS

38 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

website ProffieBoard FULL wiring diagrams link

Scroll the page down till you see the interactive diagram Above the diagram there are components selection options Build your saber setup

with it and follow diagram to wire your board Then you need to copy the configuration code below and paste it into your _configh file

Choose components you want

3WIRING DIAGRAMS1

More wiring diagrams

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 39

3WIRING DIAGRAMS1

How to use it

PROFFIEBOARD INSTRUCTIONS

Blade ignitionretraction ndash assuming you have at least one button pressing it briefly should turn the saber on or off If you have an AUX button pressing it briefly should also turn the saber on and off If you have no buttons you can turn the saber on and off by twisting your wrist back and forth Note that the motion has to be done long enough to count so a very quick flick of the wrist will not workTurn On muted ndash double-click power buttonNext preset ndash while saber is off click the AUX buttonPrevious preset ndash hold AUX button and click the Activation buttonTrigger Clash ndash while saber is on hit the bladeTrigger Lockup ndash while saber is on hold Activation button then trigger a clash Lockup releases when you let go of the Acti-vation buttonTrigger Drag ndash like lockup but point saber mostly down before holding Activation buttonTrigger Force ndash long-click AUX buttonStart soundtrack ndash long-click the Activation buttonTrigger Blaster Block ndash while saber is on short-click AUX button

Serial Monitor commands

battery_voltage ndash gets current battery voltage valueget_volume ndash get current volume valuepow ndash power OnOff the saberon ndash power On the saberoff ndash power Off the saberset_volume lt0-3000gt ndash set volume value (example set_volume 500)play ndash play the default preset trackplay trackslttrack namegt ndash play a specific track from tracks folder (example play tracksvenuswav)stop ndash stop the playing trackforce ndash play ldquoforcerdquo sound effectsdrag ndash play ldquodragrdquo sound effectsblast ndash play ldquoblasterrdquo sound effectslock ndash play ldquolockuprdquo sound effectsclash ndash play ldquoclashrdquo sound effectsreset ndash reboot the boardn ndash switch to next presetp ndash switch to previous presetlist_presets ndash show all presetssdtest ndash test SD card speed

40 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3FIRMWARE UPLOAD AND UPDATE2

Software installation and setup

PROFFIEBOARD INSTRUCTIONS

To upload firmware to ProffieBoard Arduino IDE program is required Follow these steps to install it to your PC

1 Install latest Arduino IDE software (donrsquot use BETA)

Installing as Windows app also is not recommended

because it will be installed in a specific protected folder that

wonrsquot allow you to install any additional softwareplugin in it

If ProffieBoard wonrsquot show up in COM port use

Arduino IDE 186 version

2 Install the Proffieboard Arduino Plugin and Zadig software

Follow installation instructions

3 Select Proffieboard-STM32L433 in Tools -gt Board

USB Type ndash Serial CPU Speed ndash 80 MHz Optimize ndash Smallest Code DOSFS ndash SDCARD (SPI) Port ndash COM(the number your PC assigned) (Butterfly-L433CC)

Connect Proffieboard via USB cable to PC to be able to select

the Port

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 41

3FIRMWARE UPLOAD AND UPDATE2

Uploading firmware

PROFFIEBOARD INSTRUCTIONS

1 Download the ProffieBoard firmware and SD card content

Unzip lightsaber-1286zip to your Documents directory or to

Desktop but not to Arduino program folder or anywhere in

Programs directory where all programs are installed You will

see a lightsaber folder and files inside it Donrsquot move any of

these files to any other location outside the lightsaber folder

and donrsquot reorganize them Unzip ProffieOS_SD_Cardzip to the

folder where you keep lightsaber-1286 folder Copy all files

from ProffieOS_SD_Card folder to your SD card

2 Unhide file extensions in File Explorer settings to see h ending

of config files Donrsquot add ldquohrdquo to the config file name Go to config folder and create you own configh file (see page

42 for how-to)

Double-click the lightsaberino file

3 Add the name of your configh file as shown and Save this

lightsaberino file Make sure the other config files are

commented out there should be only one CONFIG_FILE

without You can have multiple config files

in lightsabergtconfig folder and just define the one you need

in lightsaberino file and upload it again to ProffieBoard

4 Connect battery to ProffieBoard and hook up to your PC

with a data transfer micro-USB-to-USB cable

Press arrow button it will compile and upload firmware to the

board Wait for red text progress bars to stop at 100

ProffieBoard will play boot sound if speaker is connected

Now you can unplug the USB cable Done

If it gives an error instead this means your configh file has

issues define CONFIG_FILE name has mistakes configh file

is out of config folder your PC user name is non-latin

42 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

33

configh file structure editing

PROFFIEBOARD INSTRUCTIONS

CHANGING PARAMETERS

All sound files (sound fonts music tracks) are stored on the micro SD card Add required sound fonts folders (Plecter NEC and Smoothswing

fonts are supported no need to change WAV files names just copy and paste) to SD card root directory as itrsquos done in the default

ProffieOS_SD_Card content folder and music tracks to the tracks folder

Make sure to name all music tracks and sound fonts folders with latin characters and only up to 8 characters long without using any special

characters (like |[- etc)

Make sure you have a configini file in each sound font folder if there is none - copy one from some default TeensySaberProffieBoard sound

font and paste into newly added sound font folder It has only one parameter that you can modify - humstart It helps to match hum sound

start with blade ignition 1000 usually works fine

All blade effects LED configuration volume level clash sensitivity etc are changed in the configh file located in lightsabergtconfig folder

To do that open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text Editor (Notepad - to see code correctly in Notepad

Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all text) and Delete it then Copy-and-Paste (Ctrl+C

Ctrl+V) your wiring diagram config code into empty _configh file and Save it under new name Follow the instructions on page 39 to

upload it to the board

Proffieboard config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)

volume level (0-3000)

clash sensitivity (adjust lower or higher with 01 step)

sound font folder nametrack name

Preset name

Blade style

LED configuration (use these XP-E2 LED templatesto define your LED)

for Red use 1 Ohm resistor for Green - no resistor for Blue use 024 Ohm

NoLED ndash no 4th led used

Preset 1

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 43

33

Blade Styles

StylePtrltInOutHelperltSimpleClashltLockupltBlastltOnSparkltAudioFlickerltRgblt02550gtRgblt501000gtgtRgblt2552550gt150gtRgblt255500gtgtAudioFlickerltRgblt1002550gtRgblt2550150gtgtgtRgblt255100150gt40gt200300Blackgtgt

ndash this is how the Blade Style code looks pasted in the configh file Preset (it sits inside a StylePtrltgt container)

ndash this is how the Blade Style code looks when editing it inside a Blade Style Editor

Each Blade Style is made of a variety of Effects each added effect goes instead of a base color in the previous effect

PROFFIEBOARD INSTRUCTIONS

CHANGING PARAMETERS

ProffieBoard and TeensySaber use Blade Styles for the main saber blade and any other accent leds to define all light effects (color changing

flashes flickering delays ignitionretraction timing etc)

Use Blade Style Editor to create and adjust Blade Styles Megtooth Sith Sabers did a great video tutorial where he shows and explains

how to use Blade Style Editor Also you can grab some pre-made Blade Styles or share yours here on TRA forums

A Blade Style example of simple flickering Green blade with Spark on start Clash Blaster Lockup and Drag IgnitionRetraction effects

InOutHelperltSimpleClashltLockupltBlastltOnSparkltAudioFlickerltRgblt02550gtRgblt501000gtgtRgblt2552550gt150gtRgblt255500gtgtAudioFlickerltRgblt1002550gtRgblt2550150gtgtgtRgblt255100150gt40gt200300Blackgt

InOutHelperltbase color200300Blackgt ndash base color can be defined by words (WHITE RED GREEN PURPLE etc) or by Rgblt0-2550-2550-255gt values for more

custom shades 200 is extension length in milliseconds 300 is retraction length in milliseconds Black is color when retracted (also can be any other color)

SimpleClashltbase colorclash color40gt ndash clash effect 40 is clash duration in milliseconds

Lockupltbase colorlockup colorgt ndash lockup effect

Blastltbase colorblast colorgt ndash blaster effect

OnSparkltbase colorspark color150gt ndash spark on ignition effect 150 is spark duration in milliseconds

AudioFlickerltrdquoArdquo colorrdquoBrdquo colorgt ndash flickering effect (blade flickers to the actual saber hum sound) the more difference between ldquoArdquo and ldquoBrdquo colors - the more

abrupt is flickering

Rgblt255500gt ndash actual color in RGB format (0 is no light 255 is the maximum brightness value for Red Green or Blue channel)

44 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

ndash SanDisk 4GB microSDHC Class 4 (Genuine) ndash SanDisk 4GB microSDHC Class 4 (Genuine)

130238 kbs = 1477 simultaneous audio streams 137812 kbs = 1562 simultaneous audio streams

ndash Patriot LX Series 16GB microSDHC UHS-IU1 Class 10 ndash Patriot LX Series 16GB microSDHC UHS-IU1 Class 10

133005 kbs = 1508 simultaneous audio streams

ndash GSkill 16GB microSDHC UHS-IU1 Class 10 ndash GSkill 16GB microSDHC UHS-IU1 Class 10

129534 kbs = 1469 simultaneous audio streams

ndash Kingston 16GB microSDHC UHS-IU1 Class 10 ndash Kingston 16GB microSDHC UHS-IU1 Class 10

128090 kbs = 1452 simultaneous audio streams

ndash SanDisk Ultra 16GB microSDHC UHS-IU1 A1 Class 10 ndash SanDisk Ultra 16GB microSDHC UHS-IU1 A1 Class 10

102663 kbs = 1164 simultaneous audio streams 11124 kbs = 1261 simultaneous audio streams

ndash SanDisk 8GB microSDHC Class 4 ndash SanDisk 8GB microSDHC Class 4

108506 kbs = 1230 simultaneous audio streams

ndash SanDisk 16GB microSDHC Class 4 ndash SanDisk 16GB microSDHC Class 4

102663 kbs = 1164 simultaneous audio streams 106957 kbs = 1213 simultaneous audio streams

ndash SanDisk Ultra 16GB microSDHC UHS-IU1 Class 10 ndash SanDisk Ultra 16GB microSDHC UHS-IU1 Class 10

102663 kbs = 1164 simultaneous audio streams 103909 kbs = 1178 simultaneous audio streams

ndash Smartbuy 4GB microSDHC Class 4 ndash Smartbuy 4GB microSDHC Class 4

75437 kbs = 855 simultaneous audio streams

ndash Kingston 8GB microSDHC Class 4 ndash Kingston 8GB microSDHC Class 4

75209 kbs = 822 simultaneous audio streams

ndash SanDisk 4GB microSDHC Class 4 (Fake) ndash SanDisk 4GB microSDHC Class 4 (Fake)

677 kbs = 769 simultaneous audio streams

Here is a list of tested micro SD cards speed with TeensySaber V3 and ProffieBoard Any card with speed over 900 kbs is recommended the

higher the speed is ndash the better Memory size of 4-16Gb is more than enough Cards were tested with a default firmware (1291) compiled

with ldquoSmallest Coderdquo under Optimize ldquodefault_proffieboard_confighrdquo file and default ProffieOS SD card sound files (7 folders)

To test your SD card speed simply hook up ProffieBoard to PC open Arduino IDE go to Tools and open Serial Monitor make sure you have

New Line and 9600 baud rate selected on the bottom of Serial Monitor window type and send sdtest command wait for the test result

4Recommended micro SD cards

BEST

TEENSYSABER PROFFIEBOARD

GOOD

BAD

PROFFIEBOARD INSTRUCTIONS

SD CARD RECOMMENDATIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 45

There are a lot of fake (chinese copies) microSD cards on the market from aliexpress ebay amazon etc They look very similar to genuine

cards but are a bit different though and have a twice lower writingreading speed Here is an example of a SanDisk 4Gb Class 4 card one is

genuine with 137812 kbs speed and the other one is fake with 677 kbs speed I got from ebay seller

Be carefull and pay attention to how the actual card looks if you are not sure ask seller for the real photo of SD card he sells

4Genuine and Fake SanDisk 4Gb Class 4 microSD

PROFFIEBOARD INSTRUCTIONS

SD CARD RECOMMENDATIONS

46 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

WIRE GAUGE GUIDE

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 47

RECHARGE PORTS AND KILL SWITCHES

48 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

NEOPIXEL STRIPS CURRENT DRAW

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 49

6TROUBLESHOOTING

For more help please check these linksProffieOSProffieBoardTeensySaber wiki on GitHubAsk your question on The Rebel Armory forumsAsk your question on FX-sabers forumsAsk your question in facebook group

How to solve most common issues

Quick troubleshooting tips

TeensySaber board or Proffieboard is not recognized by computer (nothing under Port selection in Arduino)

ndash Make sure a charged 37V battery is connected to the board micro-USB cable is a data transfer cable all plugins and drivers are installed ndash

check again pages 21 for TeensySaber or 40 for Proffieboard Try a different USB port on your computer

Sketch (code) compile error in Arduino IDE

ndash Check your define CONFIG_FILE ldquoconfig_confighrdquo line in opened lightsaberino file if itrsquos written correctly with config in it

Sketch (code) compile error in Arduino IDE

ndash Check if the _configh file you defined in the lightsaberino sketch file is same name as in the lightsaber-rdquofirmware versionrdquolightsaber

config folder and is located in this folder

Sketch (code) compile error in Arduino IDE

ndash Check your settings under Tools tab in Arduino IDE program Check again pages 21 for TeensySaber or 40 for Proffieboard

Sketch (code) compile error in Arduino IDE

ndash Check if your _configh file is correct Blade Styles Presets const unsigned int maxLedsPerStrip = 144 if BladeConfig blades[] = is correct

Sketch (code) compile error in Arduino IDE

ndash If nothing helps install Arduino IDE version 186 and try to compile and upload the firmware again

Sound doesnrsquot play

ndash Remove SD card and insert again check speaker wiring Make sure all sound files on SD card are correctly named (8 characters max long)

Re-format SD card in FAT32 load sound files and try again try another SD card

Board says ldquoLOW POWERrdquo

ndash Charge the battery

Serial Monitor shows info sent by the board but your commands donrsquot work

ndash In the bottom right corner of Serial Monitor window make sure the Line Ending drop down is set to New Line

Sound is weird and distorted

ndash Check your SD card speed (see page 44) Check speaker wiring try another good speaker

10 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

Basic Neopixel wiring diagram

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

+

+

+

-

-

-

22 A

WG

22 AWG

26 AWG

30 AWG

x2 28 AWG

x2 26 AWG

22 A

WG

30-32 AWG

30-32 AWG

Protected 36-37V (42V max at full charge) 10A 3500mAh or 15A 3120mAhbattery recommended+18650 battery holder (optional)Keystone 1042P

AV switch with accent led(constantly ON no effects)

accent leds run mostly at10-15mA so resistors for them must be calculated accordingly

Main Neopixel strip

additional Neopixelstrips(optional)

Neopixel bladeconnector

330 Ohm on the Blade pcb side

x3 28 AWGor x1 22 AWGfor Negative

330 Ohm on the Blade pcb side

arrows up

330 Ohm on the Blade pcb side

In case no additional Neopixel strips are needed LED channels 4 5 6can be used for 3 controllable (programmable for different effects) accent leds So AV switch led can be wired to one of these channelsby adding 1 MOSFETRecommended power wire gauges (22 AWG) are given for 2-strip blade For 3-strip blade you gonna need at least 20 AWG wires

solder 2x FETs

solder 1 FET

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 11

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

Basic Neopixel wiringldquoconfighrdquo file setup

ldquov3_confighrdquoNUM_BLADES 3NUM_BUTTONS 2VOLUME 1000CLASH_THRESHOLD_G 10IgnitionDelaylt0 any blade stylegtIgnitionDelaylt800 any blade stylegtIgnitionDelaylt800 any blade stylegtWS2811BladePtrlt118 WS2811 800kHz | WS2811 GRBgt()WS2811BladePtrlt26 7 ltbladePowerPin4gtgt()WS2811BladePtrlt26 8 ltbladePowerPin5gtgt()

TeensySaber V3 config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)Volume level (0-3000)Clash sensitivity (adjust lower or higher with 01 step)ldquoBlade 1rdquo style (main blade with IgnitionDelay 0)ldquoBlade 2rdquo style (CG blade 1 with IgnitionDelay 800)ldquoBlade 3rdquo style (CG blade 2 with IgnitionDelay 800)

strip configuration (defines how many pixels it has and to which LED output and pin is wired)

Preset 1

any blade style

strip (blade) 1 configuration

strip (blade) 2 configuration

strip (blade) 3 configuration

Preset 2 etc

Use a given or build your wiring diagram on THIS PAGE then open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text

Editor (Notepad - to see code correctly in Notepad Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all

text) and Delete it then Copy-and-Paste (Ctrl+C Ctrl+V) your wiring diagram config code (example below) into empty _configh file and

Save it under new name Follow the instructions on page 22 to upload it to the board

12 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

Basic Segmented string wiring diagram

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

+

+

-

-

24 A

WG

28 AWG

30-32 AWG

30-32 AWG

Protected 36-37V (42V max at full charge) 10A 3500mAh battery recommended+18650 battery holder (optional)Keystone 1042P

AV switch with accent led(constantly ON no effects)

accent leds run mostly at10-15mA so resistors for them must be calculated accordingly

6-segments string blade

FoC string

N-channel FET3A minimum

1

1 46 523

23456

Calculate resistors for each led segment of the blade string depending on which leds are used 5mm leds have max drive current around 25mA per led when 10mm leds can be 100mA and 200mA per ledSo pay attention to your led max current and Forward Voltage (Vf) when calculating a segment resistor resistence as well as its wattage Also choose wire gauges accordingly to meet segments and total blade max current draw level

LED Resistor Calculator

solder 3x FETs

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 13

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

Basic Segmented string wiringldquoconfighrdquo file setup

ldquov3_confighrdquoNUM_BLADES 1NUM_BUTTONS 2VOLUME 1000CLASH_THRESHOLD_G 10StyleNormalPtrltCYAN WHITE 300 800gt()ltBlue3mmLED 20 White3mmLEDgt

TeensySaber V3 config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)Volume level (0-3000)Clash sensitivity (adjust lower or higher with 01 step)Blade styleLED string configuration(here you mention the color and type of leds usedin the main blade string segments and FoC string20 is the FoC signal pin (Blade ID pin))

Preset

LED string configuration

Use a given or build your wiring diagram on THIS PAGE then open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text

Editor (Notepad - to see code correctly in Notepad Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all

text) and Delete it then Copy-and-Paste (Ctrl+C Ctrl+V) your wiring diagram config code (example below) into empty _configh file and

Save it under new name Follow the instructions on page 22 to upload it to the board

14 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

Accent LEDs wiring diagram(optional)

Accent LEDs work with TeensySaber board as additional ldquobladesrdquo when powered by LED outputs 4 5 6 with FETs So they can have any effect

that blade can have If no effects needed accent led can be powered just by a 33V output pad (power-on led indication)

30-32 AWGRGB ledcommon-anode

4 ldquobladesrdquo1 main and 3 accent leds

main blade style (effects) main blade style (effects)

3 accent leds style (effects)accent led style (effects)

3 accent leds configurations

RGB accent led configuration

2 ldquobladesrdquo1 main and 1 RGB accent led

ldquoPower-onrdquo indicationaccent leds (no effects)

3 accent leds withindependent effects

+ 1 or more simple accent leds without effects

1 RGB accent led+ 1 or more simple accent leds

without effects

a) b)

b)

c)

c)

solder 3x FETs solder 3x FETs

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 15

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

OLED display wiring diagram(optional)

SSD1306 128x32 pixels OLED display allows to show battery level current preset name play different animations and even simple games It

can be wired to any blade configuration and requires just one additional line in the code to work You can get monochrome display in white

or blue color

SSD1306128x32OLED

SSD1306 ndash with blue or white display color selectSSD1306 ndash cheaper priceSSD1306 just screen ndash blue or white select

30-32 AWG

30-32 AWG

add this line to enable OLED display

display shows a preset name written in these quotes ldquoldquo

16 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

Bluetooth module wiring diagram(optional)

SOON

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 17

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

Blade ID resistor functions(optional)

SOON

18 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

website TeensySaber V3 FULL wiring diagrams link

Scroll the page down till you see the interactive diagram Above the diagram there are components selection options Build your saber setup

with it and follow diagram to wire your board Then you need to copy the configuration code below and paste it into your _configh file

Choose components you want

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

More wiring diagrams

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 19

20 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

How to use it

Blade ignitionretraction ndash assuming you have at least one button pressing it briefly should turn the saber on or off If you have an AUX button pressing it briefly should also turn the saber on and off If you have no buttons you can turn the saber on and off by twisting your wrist back and forth Note that the motion has to be done long enough to count so a very quick flick of the wrist will not workTurn On muted ndash double-click power buttonNext preset ndash while saber is off click the AUX buttonPrevious preset ndash hold AUX button and click the Activation buttonTrigger Clash ndash while saber is on hit the bladeTrigger Lockup ndash while saber is on hold Activation button then trigger a clash Lockup releases when you let go of the Acti-vation buttonTrigger Drag ndash like lockup but point saber mostly down before holding Activation buttonTrigger Force ndash long-click AUX buttonStart soundtrack ndash long-click the Activation buttonTrigger Blaster Block ndash while saber is on short-click AUX button

Serial Monitor commands

battery_voltage ndash gets current battery voltage valueget_volume ndash get current volume valuepow ndash power OnOff the saberon ndash power On the saberoff ndash power Off the saberset_volume lt0-3000gt ndash set volume value (example set_volume 500)play ndash play the default preset trackplay trackslttrack namegt ndash play a specific track from tracks folder (example play tracksvenuswav)stop ndash stop the playing trackforce ndash play ldquoforcerdquo sound effectsdrag ndash play ldquodragrdquo sound effectsblast ndash play ldquoblasterrdquo sound effectslock ndash play ldquolockuprdquo sound effectsclash ndash play ldquoclashrdquo sound effectsreset ndash reboot the boardn ndash switch to next presetp ndash switch to previous presetlist_presets ndash show all presetssdtest ndash test SD card speed

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 21

2TEENSYSABER V3 INSTRUCTIONS

FIRMWARE UPLOAD AND UPDATE2

Software installation and setup

To upload firmware to TeensySaber board Arduino IDE program is required Follow these steps to install it to your PC

1 Install latest Arduino IDE software (donrsquot use BETA)

Installing as Windows app also is not recommended

because it will be installed in a specific protected folder that

wonrsquot allow you to install Teensyduino software in it

If TeensySaber wonrsquot show up in COM port use

Arduino IDE 186 version

2 Install latest Teensyduino software in same directory

usually itrsquos CProgram Files (x86)Arduino on Windows

Follow installation instructions for your system

3 Select Teensy 32 31 in Tools -gt Board

USB Type ndash Serial CPU Speed ndash 96 MHz (overclock) Optimize ndash Smallest Code Port ndash COM(the number your PC assigned) (Teensy 32) Serial

Connect TeensySaber via USB cable to PC to be able to select

the Port donrsquot forget to connect battery first

22 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

1 Download the TeensySaber firmware and SD card content

Unzip lightsaber-1286zip to your Documents directory or to

Desktop but not to Arduino program folder or anywhere in

Programs directory where all programs are installed You will

see a lightsaber folder and files inside it Donrsquot move any of

these files to any other location outside the lightsaber folder

and donrsquot reorganize them Unzip ProffieOS_SD_Cardzip to the

folder where you keep lightsaber-1286 folder Copy all files

from ProffieOS_SD_Card folder to your SD card

2 Unhide file extensions in File Explorer settings to see h ending

of config files Donrsquot add ldquohrdquo to the config file name

Go to config folder and create you own configh file (see page

23 for how-to)

Double-click the lightsaberino file

3 Add the name of your configh file as shown and Save this

lightsaberino file Make sure the other config files are

commented out there should be only one CONFIG_FILE

without You can have multiple config files

in lightsabergtconfig folder and just define the one you need

in lightsaberino file and upload it again to TeensySaber board

4 Connect battery to TeensySaber board and hook up to your PC

with a data transfer micro-USB-to-USB cable

Press arrow button it will compile and upload firmware to the

board Wait for your PC to make a sound or TeensySaber will

play boot sound if speaker is connected Now you can unplug

the USB cable Done

If it gives an error instead this means your configh file has

issues define CONFIG_FILE name has mistakes configh file

is out of config folder your PC user name is non-latin

2TEENSYSABER V3 INSTRUCTIONS

FIRMWARE UPLOAD AND UPDATE2

Uploading firmware

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 23

2TEENSYSABER V3 INSTRUCTIONS

CHANGING PARAMETERS3

Changing sound board parameters

All sound files (sound fonts music tracks) are stored on the micro SD card Add required sound fonts folders (Plecter NEC and Smoothswing

fonts are supported no need to change WAV files names just copy and paste) to SD card root directory as itrsquos done in the default

ProffieOS_SD_Card content folder and music tracks to the tracks folder

Make sure to name all music tracks and sound fonts folders with latin characters and only up to 8 characters long without using any special

characters (like |[- etc)

Make sure you have a configini file in each sound font folder if there is none - copy one from some default TeensySaberProffieBoard sound

font and paste into newly added sound font folder It has only one parameter that you can modify - humstart It helps to match hum sound

start with blade ignition 1000 usually works fine

All blade effects LED configuration volume level clash sensitivity etc are changed in the configh file located in lightsabergtconfig folder

To do that open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text Editor (Notepad - to see code correctly in Notepad

Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all text) and Delete it then Copy-and-Paste (Ctrl+C

Ctrl+V) your wiring diagram config code into empty _configh file and Save it under new name Follow the instructions on page 22 to

upload it to the board

TeensySaber V3 config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)

volume level (0-3000)

clash sensitivity (adjust lower or higher with 01 step)

sound font folder nametrack name

Preset name

Blade style

LED configuration (use these XP-E2 LED templatesto define your LED)

for Red use 1 Ohm resistor for Green - no resistor for Blue use 024 Ohm

NoLED ndash no 4th led used

Preset 1

24 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

31

PROFFIEBOARD INSTRUCTIONS

Whatrsquos needed

ndash ProffieBoard

ndash micro SD-card (see page 44 for recommendations)

ndash a USB micro SD-card reader (to load sound files from PC to micro SD card)

ndash micro USB data transfer cable (CABLES THAT SUPPORT ONLY CHARGING WONrsquoT WORK)

ndash wires of different gauges (32-20 AWG) (PTFE coated copper stranded wires recommended) heat shrink

ndash ESD safe soldering station solder wire flux etc

ndash pliers helping hands etc

ndash isopropyl alcohol to clean pads before soldering (helps solder to stick better)

ndash Digital Multimeter (VERY USEFUL)

ndash computer running Windows Linux or Mac OS with internet access

ndash 37V Li-Ion Protected rechargeable battery switches recharge port speaker LEDs resistors chassis etc

ndash Smart Li-Ion CC-CV (Constant Current - Constant Voltage mode) battery charger for 37V (42V) cells

ndash patience

WIRING DIAGRAMS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 25

31

PROFFIEBOARD INSTRUCTIONS

Board pinout

Battery + ndash 26 to 45 volt input drives everything except the LEDs

Battery - ndash negative pad for LEDs needs to be at same level as GND when both are connected Both pads are internally connected

GND ndash ground for electronics except LEDs Note that there are two GND pads on the board that are internally connected

Speaker +- ndash hooks up to speaker

Activation (1) Aux (2) Aux2 button (3) ndash hook up to closing buttons or potentially touch buttons

Blade ID Neopixel Data 1 ndash normally used to measure the blade ID restor and if itrsquos a neopixel blade feed out neopixel data

Data 2 3 4 5 ndash additional neopixel data outputs or free for other purposes

LED 1 2 3 4 5 6 ndash hooks up to negative side of LED (positive side of LED hooks up directly to battery) These pads can handle

up to 30 volts

SDA SCL ndash these pins are used to wire OLED display or to communicate with the gyro and accelerometer chip

RX TX ndash these pins are used for wiring a bluetooth module for wireless control

SWDCLK SWDIO ndash can be hooked up to a ST-LINK device and lets you debug programs running on the ProffieBoard

+5V ndash generated by the ProffieBoard normally itrsquos only ON when sound is playing

+33V ndash generated by the ProffieBoard for powering OLED display Bluetooth module or some accent leds

BOOT RESET ndash buttons to put the ProffieBoard in bootloader mode if uploading doesnrsquot work

micro USB port ndash micro USB port used only for firmware upload and can be used for sound files upload to SD card (from firmware version

1291 and up) THIS PORT ISNrsquoT USED FOR CHARGING THE BATTERY

LED 4LED 3

LED 2

LED 1

LED 5

LED 6

RESETBOOT

Battery - Battery -

Speaker + (red dot or ldquo+rdquo mark on speaker)

Battery +

Aux button (2)Activation button (1)

Aux2 button (3)

Blade ID Neopixel Data 1

Data 5

Data 4Data 3Data 2

+33V

SWDIO

SWDCLK

+5V

TXRX

GND

GND

Reset

Speaker -

SCLSDA

micro USB port

WIRING DIAGRAMS

26 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Basic Tri-Cree wiring diagram(In-hilt LED)

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

+

+

-

-

26 AWG

26 A

WG

30-32 AWG

28-30 AWG

28-3

0 A

WG

30-32 AWG

Protected 36-37V (42V max at full charge) 10A 3500mAh battery recommended+18650 battery holder (optional)Keystone 1042P

AV switch with accent led(constantly ON no effects)

accent leds run mostly at10-15mA so resistors for them must be calculated accordingly

Main RGB led

additional RGB leds(optional)

In case no additional high power leds are needed LED channels 4 5 6 can be used for 3 controllable(programmable for different effects) accent leds So AV switch led can be wired to one of these channelsAccent leds also can be wired to Data pads 1-5 please see ldquoAccent LEDs wiring and setuprdquo page

LED Resistor Calculator

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 27

3WIRING DIAGRAMS1

Basic Tri-Cree wiring (In-hilt LED)ldquoconfighrdquo file setup

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

Use a given or build your wiring diagram on THIS PAGE then open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text

Editor (Notepad - to see code correctly in Notepad Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all

text) and Delete it then Copy-and-Paste (Ctrl+C Ctrl+V) your wiring diagram config code (example below) into empty _configh file and

Save it under new name Follow the instructions on page 22 to upload it to the board

ldquoproffieboard_v1_confighrdquoNUM_BLADES 2NUM_BUTTONS 2VOLUME 1000CLASH_THRESHOLD_G 10StyleNormalPtrltCYAN WHITE 300 800gt()StyleNormalPtrltCYAN WHITE 300 800gt()

CreeXPE2RedTemplatelt1000gtCreeXPE2GreenTemplatelt0gtCreeXPE2BlueTemplatelt240gtNoLED

ProffieBoard config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)Volume level (0-3000)Clash sensitivity (adjust lower or higher with 01 step)ldquoBlade 1rdquo styleldquoBlade 2rdquo style (in case only 1 blade is used you donrsquot need this line)LED configuration (use these XP-E2 LED templatesto define your LED If other LED resistors are used change these values to match Ohm1000=ltvaluegt)

where 1000 is 1 Ohm resistor 0 is no resistor240 is 024 Ohm resistorNoLED ndash no 4th led used

Preset 1

LED 1 configuration

LED 2 configuration

Preset 2 etc

PROFFIEBOARD INSTRUCTIONS

28 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Basic Neopixel wiring diagram

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

+

+

-

-

22 A

WG

22 AWG

x2 28 AWG

x2 26 AWG

22 A

WG

30-32 AWG30-32 AWG

Protected 36-37V (42V max at full charge) 10A 3500mAh or 15A 3120mAhbattery recommended+18650 battery holder (optional)Keystone 1042P

AV switch with accent led(constantly ON no effects)

accent leds run mostly at10-15mA so resistors for them must be calculated accordingly

Main Neopixel strip

additional Neopixelstrips(optional)

Neopixel bladeconnector

330 Ohm on the Blade pcb side

x3 28 AWGor x1 22 AWGfor Negative

330 Ohm on the Blade pcb side

arrows up

330 Ohm on the Blade pcb side

In case no additional Neopixel strips are needed LED channels 4 5 6 can be used for 3 controllable(programmable for different effects) accent leds So AV switch led can be wired to one of these channelsAccent leds also can be wired to Data pads 2-5 please see ldquoAccent LEDs wiring and setuprdquo page

Recommended power wire gauges (22 AWG) are given for 2-strip blade For 3-strip blade you gonna need at least 20 AWG wires

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 29

ldquoproffieboard_v1_confighrdquo

3WIRING DIAGRAMS1

Basic Neopixel wiringldquoconfighrdquo file setup

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

NUM_BLADES 3NUM_BUTTONS 2VOLUME 1000CLASH_THRESHOLD_G 10IgnitionDelaylt0 any blade stylegtIgnitionDelaylt800 any blade stylegtIgnitionDelaylt800 any blade stylegtWS2811BladePtrlt118 WS2811 800kHz | WS2811 GRBgt()WS2811BladePtrlt26 blade2Pin ltbladePowerPin4gtgt()WS2811BladePtrlt26 blade3Pin ltbladePowerPin5gtgt()

ProffieBoard config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)Volume level (0-3000)Clash sensitivity (adjust lower or higher with 01 step)ldquoBlade 1rdquo style (main blade with IgnitionDelay 0)ldquoBlade 2rdquo style (CG blade 1 with IgnitionDelay 800)ldquoBlade 3rdquo style (CG blade 2 with IgnitionDelay 800)

strip configuration (defines how many pixels it has and to which LED output and pin is wired)

Preset 1

any blade style

strip (blade) 1 configuration

adjust this number to match your strips leds count

strip (blade) 2 configuration

strip (blade) 3 configuration

Preset 2 etc

Use a given or build your wiring diagram on THIS PAGE then open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text

Editor (Notepad - to see code correctly in Notepad Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all

text) and Delete it then Copy-and-Paste (Ctrl+C Ctrl+V) your wiring diagram config code (example below) into empty _configh file and

Save it under new name Follow the instructions on page 22 to upload it to the board

PROFFIEBOARD INSTRUCTIONS

30 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Basic Segmented string wiring diagram

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

+

+

-

-

24 A

WG

28 AWG

30-32 AWG30-32 AWG

Protected 36-37V (42V max at full charge) 10A 3500mAh battery recommended+18650 battery holder (optional)Keystone 1042P

AV switch with accent led(constantly ON no effects)

accent leds run mostly at10-15mA so resistors for them must be calculated accordingly

6-segments string blade

FoC string

N-channel FET3A minimum

123456

Calculate resistors for each led segment of the blade string depending on which leds are used 5mm leds have max drive current around 25mA per led when 10mm leds can be 100mA and 200mA per ledSo pay attention to your led max current and Forward Voltage (Vf) when calculating a segment resistor resistence as well as its wattage Also choose wire gauges accordingly to meet segments and total blade max current draw level

LED Resistor Calculator

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 31

ldquoproffieboard_v1_confighrdquo

3WIRING DIAGRAMS1

Basic Segmented string wiringldquoconfighrdquo file setup

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

NUM_BLADES 1NUM_BUTTONS 2VOLUME 1000CLASH_THRESHOLD_G 10StyleNormalPtrltCYAN WHITE 300 800gt()ltBlue3mmLED BladePin White3mmLEDgt

ProffieBoard config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)Volume level (0-3000)Clash sensitivity (adjust lower or higher with 01 step)Blade styleLED string configuration(here you mention the color and type of leds usedin the main blade string segments and FoC stringBladePin is the FoC signal pin (Blade ID pin))

Preset

LED string configuration

Use a given or build your wiring diagram on THIS PAGE then open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text

Editor (Notepad - to see code correctly in Notepad Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all

text) and Delete it then Copy-and-Paste (Ctrl+C Ctrl+V) your wiring diagram config code (example below) into empty _configh file and

Save it under new name Follow the instructions on page 22 to upload it to the board

PROFFIEBOARD INSTRUCTIONS

32 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Accent LEDs wiring diagram(optional)

Accent LEDs work with ProffieBoard as additional ldquobladesrdquo when powered by LED outputs 4 5 6 or Data pads 1 2 3 5 as PWM So they can

have any effect that blade can have If no effects needed accent led can be powered just by a 33V output pad (power-on led indication)

30-32 AWG

with Neopixel blade setup these 4 outputsdonrsquot work for regular accent leds

Recommended resistors to use for accent leds at 33V power source and 15mA drive

ndash 100 Ohm for Red (lt100000gt value in the code)ndash 13 Ohm for Green (lt13000gt value in the code)ndash 13 Ohm for Blue (lt13000gt value in the code)ndash 100 Ohm for Yellow (lt100000gt value in the code)ndash 20 Ohm for White (lt20000gt value in the code)

RGB ledcommon-anode

8 ldquobladesrdquo1 main and 7 accent leds

main blade style (effects) main blade style (effects)

7 accent leds style (effects)accent led style (effects)

7 accent leds configurations

RGB accent led configuration

2 ldquobladesrdquo1 main and 1 RGB accent led

ldquoPower-onrdquo indicationaccent leds (no effects)

7 accent leds withindependent effects

RGB accent led

a) b)

b)

c)

c)

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 33

3WIRING DIAGRAMS1

Neopixel Accent LEDs wiring diagram(optional)

With Neopixel setup additional neopixel leds or arrays can be used as accent leds There are 2 ways to wire them using additional Data

pins 2 3 4 5 or ldquoSub-bladesrdquo wiring with just 1 Data output pin Same way Neopixel connectors with on-board leds ca be wired

Option 1 ndash with extra Data pins

Main Blade

some accent leds

D1

D2

crystal leds

330 Ohm

330 Ohm

330 Ohm

main blade style (effects)

main blade 144 leds Data pin 1

accent leds blade style (effects)

accent leds ldquobladerdquo 4 leds Data pin 2

crystal leds blade style (effects)

crystal leds ldquobladerdquo 2 leds Data pin 3

3 ldquobladesrdquo1 main 1 accent leds array and 1 crystal leds array

PROFFIEBOARD INSTRUCTIONS

D3

follow arrows direction

34 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Neopixel Accent LEDs wiring diagram(optional)

PROFFIEBOARD INSTRUCTIONS

Main Blade

some accent leds

1

3

5678

2

4

D1

crystal leds

follow arrows direction

330 Ohm

330 OhmData signal

With this setup a single array of neopixel leds is separated into a couple of sub-blades with their own style configuration and behaviour This

is really usefull when you want to use only one data pin More about ldquoSub-bladesrdquo on ProffieOS wiki page

Option 2 ndash with ldquoSub-bladesrdquo

main blade style (effects)

main blade sub-blade 140 leds (7-146) but from 6 to 145 in the code

accent leds blade style (effects)

accent leds sub-blade 4 leds (1-4) but from 0 to 3 in the code

crystal leds blade style (effects)

146 leds total used

crystal leds sub-blade 2 leds (5-6) but from 4 to 5 in the code

update default 144 to a higher total value if you get all accent leds +Main blade gt 144 Example update to 146 if you have 2 crystal leds +4 accent leds + 140 Main blade leds = 146

3 ldquobladesrdquo 1 main 1 accent leds array and 1 crystal leds array

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 35

3WIRING DIAGRAMS1

OLED display wiring diagram(optional)

SSD1306 128x32 pixels OLED display allows to show battery level current preset name play different animations and even simple games It

can be wired to any blade configuration and requires just one additional line in the code to work You can get monochrome display in white

or blue color

SSD1306128x32OLED

SSD1306 ndash with blue or white display color selectSSD1306 ndash cheaper priceSSD1306 just screen ndash blue or white select

30-32 AWG

30-32 AWG

add this line to enable OLED display

display shows a preset name written in these quotes ldquoldquo

PROFFIEBOARD INSTRUCTIONS

36 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Bluetooth module wiring diagram(optional)

SOON

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 37

3WIRING DIAGRAMS1

Blade ID resistor functions(optional)

SOON

PROFFIEBOARD INSTRUCTIONS

38 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

website ProffieBoard FULL wiring diagrams link

Scroll the page down till you see the interactive diagram Above the diagram there are components selection options Build your saber setup

with it and follow diagram to wire your board Then you need to copy the configuration code below and paste it into your _configh file

Choose components you want

3WIRING DIAGRAMS1

More wiring diagrams

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 39

3WIRING DIAGRAMS1

How to use it

PROFFIEBOARD INSTRUCTIONS

Blade ignitionretraction ndash assuming you have at least one button pressing it briefly should turn the saber on or off If you have an AUX button pressing it briefly should also turn the saber on and off If you have no buttons you can turn the saber on and off by twisting your wrist back and forth Note that the motion has to be done long enough to count so a very quick flick of the wrist will not workTurn On muted ndash double-click power buttonNext preset ndash while saber is off click the AUX buttonPrevious preset ndash hold AUX button and click the Activation buttonTrigger Clash ndash while saber is on hit the bladeTrigger Lockup ndash while saber is on hold Activation button then trigger a clash Lockup releases when you let go of the Acti-vation buttonTrigger Drag ndash like lockup but point saber mostly down before holding Activation buttonTrigger Force ndash long-click AUX buttonStart soundtrack ndash long-click the Activation buttonTrigger Blaster Block ndash while saber is on short-click AUX button

Serial Monitor commands

battery_voltage ndash gets current battery voltage valueget_volume ndash get current volume valuepow ndash power OnOff the saberon ndash power On the saberoff ndash power Off the saberset_volume lt0-3000gt ndash set volume value (example set_volume 500)play ndash play the default preset trackplay trackslttrack namegt ndash play a specific track from tracks folder (example play tracksvenuswav)stop ndash stop the playing trackforce ndash play ldquoforcerdquo sound effectsdrag ndash play ldquodragrdquo sound effectsblast ndash play ldquoblasterrdquo sound effectslock ndash play ldquolockuprdquo sound effectsclash ndash play ldquoclashrdquo sound effectsreset ndash reboot the boardn ndash switch to next presetp ndash switch to previous presetlist_presets ndash show all presetssdtest ndash test SD card speed

40 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3FIRMWARE UPLOAD AND UPDATE2

Software installation and setup

PROFFIEBOARD INSTRUCTIONS

To upload firmware to ProffieBoard Arduino IDE program is required Follow these steps to install it to your PC

1 Install latest Arduino IDE software (donrsquot use BETA)

Installing as Windows app also is not recommended

because it will be installed in a specific protected folder that

wonrsquot allow you to install any additional softwareplugin in it

If ProffieBoard wonrsquot show up in COM port use

Arduino IDE 186 version

2 Install the Proffieboard Arduino Plugin and Zadig software

Follow installation instructions

3 Select Proffieboard-STM32L433 in Tools -gt Board

USB Type ndash Serial CPU Speed ndash 80 MHz Optimize ndash Smallest Code DOSFS ndash SDCARD (SPI) Port ndash COM(the number your PC assigned) (Butterfly-L433CC)

Connect Proffieboard via USB cable to PC to be able to select

the Port

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 41

3FIRMWARE UPLOAD AND UPDATE2

Uploading firmware

PROFFIEBOARD INSTRUCTIONS

1 Download the ProffieBoard firmware and SD card content

Unzip lightsaber-1286zip to your Documents directory or to

Desktop but not to Arduino program folder or anywhere in

Programs directory where all programs are installed You will

see a lightsaber folder and files inside it Donrsquot move any of

these files to any other location outside the lightsaber folder

and donrsquot reorganize them Unzip ProffieOS_SD_Cardzip to the

folder where you keep lightsaber-1286 folder Copy all files

from ProffieOS_SD_Card folder to your SD card

2 Unhide file extensions in File Explorer settings to see h ending

of config files Donrsquot add ldquohrdquo to the config file name Go to config folder and create you own configh file (see page

42 for how-to)

Double-click the lightsaberino file

3 Add the name of your configh file as shown and Save this

lightsaberino file Make sure the other config files are

commented out there should be only one CONFIG_FILE

without You can have multiple config files

in lightsabergtconfig folder and just define the one you need

in lightsaberino file and upload it again to ProffieBoard

4 Connect battery to ProffieBoard and hook up to your PC

with a data transfer micro-USB-to-USB cable

Press arrow button it will compile and upload firmware to the

board Wait for red text progress bars to stop at 100

ProffieBoard will play boot sound if speaker is connected

Now you can unplug the USB cable Done

If it gives an error instead this means your configh file has

issues define CONFIG_FILE name has mistakes configh file

is out of config folder your PC user name is non-latin

42 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

33

configh file structure editing

PROFFIEBOARD INSTRUCTIONS

CHANGING PARAMETERS

All sound files (sound fonts music tracks) are stored on the micro SD card Add required sound fonts folders (Plecter NEC and Smoothswing

fonts are supported no need to change WAV files names just copy and paste) to SD card root directory as itrsquos done in the default

ProffieOS_SD_Card content folder and music tracks to the tracks folder

Make sure to name all music tracks and sound fonts folders with latin characters and only up to 8 characters long without using any special

characters (like |[- etc)

Make sure you have a configini file in each sound font folder if there is none - copy one from some default TeensySaberProffieBoard sound

font and paste into newly added sound font folder It has only one parameter that you can modify - humstart It helps to match hum sound

start with blade ignition 1000 usually works fine

All blade effects LED configuration volume level clash sensitivity etc are changed in the configh file located in lightsabergtconfig folder

To do that open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text Editor (Notepad - to see code correctly in Notepad

Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all text) and Delete it then Copy-and-Paste (Ctrl+C

Ctrl+V) your wiring diagram config code into empty _configh file and Save it under new name Follow the instructions on page 39 to

upload it to the board

Proffieboard config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)

volume level (0-3000)

clash sensitivity (adjust lower or higher with 01 step)

sound font folder nametrack name

Preset name

Blade style

LED configuration (use these XP-E2 LED templatesto define your LED)

for Red use 1 Ohm resistor for Green - no resistor for Blue use 024 Ohm

NoLED ndash no 4th led used

Preset 1

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 43

33

Blade Styles

StylePtrltInOutHelperltSimpleClashltLockupltBlastltOnSparkltAudioFlickerltRgblt02550gtRgblt501000gtgtRgblt2552550gt150gtRgblt255500gtgtAudioFlickerltRgblt1002550gtRgblt2550150gtgtgtRgblt255100150gt40gt200300Blackgtgt

ndash this is how the Blade Style code looks pasted in the configh file Preset (it sits inside a StylePtrltgt container)

ndash this is how the Blade Style code looks when editing it inside a Blade Style Editor

Each Blade Style is made of a variety of Effects each added effect goes instead of a base color in the previous effect

PROFFIEBOARD INSTRUCTIONS

CHANGING PARAMETERS

ProffieBoard and TeensySaber use Blade Styles for the main saber blade and any other accent leds to define all light effects (color changing

flashes flickering delays ignitionretraction timing etc)

Use Blade Style Editor to create and adjust Blade Styles Megtooth Sith Sabers did a great video tutorial where he shows and explains

how to use Blade Style Editor Also you can grab some pre-made Blade Styles or share yours here on TRA forums

A Blade Style example of simple flickering Green blade with Spark on start Clash Blaster Lockup and Drag IgnitionRetraction effects

InOutHelperltSimpleClashltLockupltBlastltOnSparkltAudioFlickerltRgblt02550gtRgblt501000gtgtRgblt2552550gt150gtRgblt255500gtgtAudioFlickerltRgblt1002550gtRgblt2550150gtgtgtRgblt255100150gt40gt200300Blackgt

InOutHelperltbase color200300Blackgt ndash base color can be defined by words (WHITE RED GREEN PURPLE etc) or by Rgblt0-2550-2550-255gt values for more

custom shades 200 is extension length in milliseconds 300 is retraction length in milliseconds Black is color when retracted (also can be any other color)

SimpleClashltbase colorclash color40gt ndash clash effect 40 is clash duration in milliseconds

Lockupltbase colorlockup colorgt ndash lockup effect

Blastltbase colorblast colorgt ndash blaster effect

OnSparkltbase colorspark color150gt ndash spark on ignition effect 150 is spark duration in milliseconds

AudioFlickerltrdquoArdquo colorrdquoBrdquo colorgt ndash flickering effect (blade flickers to the actual saber hum sound) the more difference between ldquoArdquo and ldquoBrdquo colors - the more

abrupt is flickering

Rgblt255500gt ndash actual color in RGB format (0 is no light 255 is the maximum brightness value for Red Green or Blue channel)

44 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

ndash SanDisk 4GB microSDHC Class 4 (Genuine) ndash SanDisk 4GB microSDHC Class 4 (Genuine)

130238 kbs = 1477 simultaneous audio streams 137812 kbs = 1562 simultaneous audio streams

ndash Patriot LX Series 16GB microSDHC UHS-IU1 Class 10 ndash Patriot LX Series 16GB microSDHC UHS-IU1 Class 10

133005 kbs = 1508 simultaneous audio streams

ndash GSkill 16GB microSDHC UHS-IU1 Class 10 ndash GSkill 16GB microSDHC UHS-IU1 Class 10

129534 kbs = 1469 simultaneous audio streams

ndash Kingston 16GB microSDHC UHS-IU1 Class 10 ndash Kingston 16GB microSDHC UHS-IU1 Class 10

128090 kbs = 1452 simultaneous audio streams

ndash SanDisk Ultra 16GB microSDHC UHS-IU1 A1 Class 10 ndash SanDisk Ultra 16GB microSDHC UHS-IU1 A1 Class 10

102663 kbs = 1164 simultaneous audio streams 11124 kbs = 1261 simultaneous audio streams

ndash SanDisk 8GB microSDHC Class 4 ndash SanDisk 8GB microSDHC Class 4

108506 kbs = 1230 simultaneous audio streams

ndash SanDisk 16GB microSDHC Class 4 ndash SanDisk 16GB microSDHC Class 4

102663 kbs = 1164 simultaneous audio streams 106957 kbs = 1213 simultaneous audio streams

ndash SanDisk Ultra 16GB microSDHC UHS-IU1 Class 10 ndash SanDisk Ultra 16GB microSDHC UHS-IU1 Class 10

102663 kbs = 1164 simultaneous audio streams 103909 kbs = 1178 simultaneous audio streams

ndash Smartbuy 4GB microSDHC Class 4 ndash Smartbuy 4GB microSDHC Class 4

75437 kbs = 855 simultaneous audio streams

ndash Kingston 8GB microSDHC Class 4 ndash Kingston 8GB microSDHC Class 4

75209 kbs = 822 simultaneous audio streams

ndash SanDisk 4GB microSDHC Class 4 (Fake) ndash SanDisk 4GB microSDHC Class 4 (Fake)

677 kbs = 769 simultaneous audio streams

Here is a list of tested micro SD cards speed with TeensySaber V3 and ProffieBoard Any card with speed over 900 kbs is recommended the

higher the speed is ndash the better Memory size of 4-16Gb is more than enough Cards were tested with a default firmware (1291) compiled

with ldquoSmallest Coderdquo under Optimize ldquodefault_proffieboard_confighrdquo file and default ProffieOS SD card sound files (7 folders)

To test your SD card speed simply hook up ProffieBoard to PC open Arduino IDE go to Tools and open Serial Monitor make sure you have

New Line and 9600 baud rate selected on the bottom of Serial Monitor window type and send sdtest command wait for the test result

4Recommended micro SD cards

BEST

TEENSYSABER PROFFIEBOARD

GOOD

BAD

PROFFIEBOARD INSTRUCTIONS

SD CARD RECOMMENDATIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 45

There are a lot of fake (chinese copies) microSD cards on the market from aliexpress ebay amazon etc They look very similar to genuine

cards but are a bit different though and have a twice lower writingreading speed Here is an example of a SanDisk 4Gb Class 4 card one is

genuine with 137812 kbs speed and the other one is fake with 677 kbs speed I got from ebay seller

Be carefull and pay attention to how the actual card looks if you are not sure ask seller for the real photo of SD card he sells

4Genuine and Fake SanDisk 4Gb Class 4 microSD

PROFFIEBOARD INSTRUCTIONS

SD CARD RECOMMENDATIONS

46 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

WIRE GAUGE GUIDE

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 47

RECHARGE PORTS AND KILL SWITCHES

48 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

NEOPIXEL STRIPS CURRENT DRAW

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 49

6TROUBLESHOOTING

For more help please check these linksProffieOSProffieBoardTeensySaber wiki on GitHubAsk your question on The Rebel Armory forumsAsk your question on FX-sabers forumsAsk your question in facebook group

How to solve most common issues

Quick troubleshooting tips

TeensySaber board or Proffieboard is not recognized by computer (nothing under Port selection in Arduino)

ndash Make sure a charged 37V battery is connected to the board micro-USB cable is a data transfer cable all plugins and drivers are installed ndash

check again pages 21 for TeensySaber or 40 for Proffieboard Try a different USB port on your computer

Sketch (code) compile error in Arduino IDE

ndash Check your define CONFIG_FILE ldquoconfig_confighrdquo line in opened lightsaberino file if itrsquos written correctly with config in it

Sketch (code) compile error in Arduino IDE

ndash Check if the _configh file you defined in the lightsaberino sketch file is same name as in the lightsaber-rdquofirmware versionrdquolightsaber

config folder and is located in this folder

Sketch (code) compile error in Arduino IDE

ndash Check your settings under Tools tab in Arduino IDE program Check again pages 21 for TeensySaber or 40 for Proffieboard

Sketch (code) compile error in Arduino IDE

ndash Check if your _configh file is correct Blade Styles Presets const unsigned int maxLedsPerStrip = 144 if BladeConfig blades[] = is correct

Sketch (code) compile error in Arduino IDE

ndash If nothing helps install Arduino IDE version 186 and try to compile and upload the firmware again

Sound doesnrsquot play

ndash Remove SD card and insert again check speaker wiring Make sure all sound files on SD card are correctly named (8 characters max long)

Re-format SD card in FAT32 load sound files and try again try another SD card

Board says ldquoLOW POWERrdquo

ndash Charge the battery

Serial Monitor shows info sent by the board but your commands donrsquot work

ndash In the bottom right corner of Serial Monitor window make sure the Line Ending drop down is set to New Line

Sound is weird and distorted

ndash Check your SD card speed (see page 44) Check speaker wiring try another good speaker

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 11

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

Basic Neopixel wiringldquoconfighrdquo file setup

ldquov3_confighrdquoNUM_BLADES 3NUM_BUTTONS 2VOLUME 1000CLASH_THRESHOLD_G 10IgnitionDelaylt0 any blade stylegtIgnitionDelaylt800 any blade stylegtIgnitionDelaylt800 any blade stylegtWS2811BladePtrlt118 WS2811 800kHz | WS2811 GRBgt()WS2811BladePtrlt26 7 ltbladePowerPin4gtgt()WS2811BladePtrlt26 8 ltbladePowerPin5gtgt()

TeensySaber V3 config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)Volume level (0-3000)Clash sensitivity (adjust lower or higher with 01 step)ldquoBlade 1rdquo style (main blade with IgnitionDelay 0)ldquoBlade 2rdquo style (CG blade 1 with IgnitionDelay 800)ldquoBlade 3rdquo style (CG blade 2 with IgnitionDelay 800)

strip configuration (defines how many pixels it has and to which LED output and pin is wired)

Preset 1

any blade style

strip (blade) 1 configuration

strip (blade) 2 configuration

strip (blade) 3 configuration

Preset 2 etc

Use a given or build your wiring diagram on THIS PAGE then open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text

Editor (Notepad - to see code correctly in Notepad Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all

text) and Delete it then Copy-and-Paste (Ctrl+C Ctrl+V) your wiring diagram config code (example below) into empty _configh file and

Save it under new name Follow the instructions on page 22 to upload it to the board

12 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

Basic Segmented string wiring diagram

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

+

+

-

-

24 A

WG

28 AWG

30-32 AWG

30-32 AWG

Protected 36-37V (42V max at full charge) 10A 3500mAh battery recommended+18650 battery holder (optional)Keystone 1042P

AV switch with accent led(constantly ON no effects)

accent leds run mostly at10-15mA so resistors for them must be calculated accordingly

6-segments string blade

FoC string

N-channel FET3A minimum

1

1 46 523

23456

Calculate resistors for each led segment of the blade string depending on which leds are used 5mm leds have max drive current around 25mA per led when 10mm leds can be 100mA and 200mA per ledSo pay attention to your led max current and Forward Voltage (Vf) when calculating a segment resistor resistence as well as its wattage Also choose wire gauges accordingly to meet segments and total blade max current draw level

LED Resistor Calculator

solder 3x FETs

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 13

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

Basic Segmented string wiringldquoconfighrdquo file setup

ldquov3_confighrdquoNUM_BLADES 1NUM_BUTTONS 2VOLUME 1000CLASH_THRESHOLD_G 10StyleNormalPtrltCYAN WHITE 300 800gt()ltBlue3mmLED 20 White3mmLEDgt

TeensySaber V3 config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)Volume level (0-3000)Clash sensitivity (adjust lower or higher with 01 step)Blade styleLED string configuration(here you mention the color and type of leds usedin the main blade string segments and FoC string20 is the FoC signal pin (Blade ID pin))

Preset

LED string configuration

Use a given or build your wiring diagram on THIS PAGE then open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text

Editor (Notepad - to see code correctly in Notepad Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all

text) and Delete it then Copy-and-Paste (Ctrl+C Ctrl+V) your wiring diagram config code (example below) into empty _configh file and

Save it under new name Follow the instructions on page 22 to upload it to the board

14 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

Accent LEDs wiring diagram(optional)

Accent LEDs work with TeensySaber board as additional ldquobladesrdquo when powered by LED outputs 4 5 6 with FETs So they can have any effect

that blade can have If no effects needed accent led can be powered just by a 33V output pad (power-on led indication)

30-32 AWGRGB ledcommon-anode

4 ldquobladesrdquo1 main and 3 accent leds

main blade style (effects) main blade style (effects)

3 accent leds style (effects)accent led style (effects)

3 accent leds configurations

RGB accent led configuration

2 ldquobladesrdquo1 main and 1 RGB accent led

ldquoPower-onrdquo indicationaccent leds (no effects)

3 accent leds withindependent effects

+ 1 or more simple accent leds without effects

1 RGB accent led+ 1 or more simple accent leds

without effects

a) b)

b)

c)

c)

solder 3x FETs solder 3x FETs

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 15

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

OLED display wiring diagram(optional)

SSD1306 128x32 pixels OLED display allows to show battery level current preset name play different animations and even simple games It

can be wired to any blade configuration and requires just one additional line in the code to work You can get monochrome display in white

or blue color

SSD1306128x32OLED

SSD1306 ndash with blue or white display color selectSSD1306 ndash cheaper priceSSD1306 just screen ndash blue or white select

30-32 AWG

30-32 AWG

add this line to enable OLED display

display shows a preset name written in these quotes ldquoldquo

16 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

Bluetooth module wiring diagram(optional)

SOON

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 17

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

Blade ID resistor functions(optional)

SOON

18 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

website TeensySaber V3 FULL wiring diagrams link

Scroll the page down till you see the interactive diagram Above the diagram there are components selection options Build your saber setup

with it and follow diagram to wire your board Then you need to copy the configuration code below and paste it into your _configh file

Choose components you want

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

More wiring diagrams

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 19

20 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

How to use it

Blade ignitionretraction ndash assuming you have at least one button pressing it briefly should turn the saber on or off If you have an AUX button pressing it briefly should also turn the saber on and off If you have no buttons you can turn the saber on and off by twisting your wrist back and forth Note that the motion has to be done long enough to count so a very quick flick of the wrist will not workTurn On muted ndash double-click power buttonNext preset ndash while saber is off click the AUX buttonPrevious preset ndash hold AUX button and click the Activation buttonTrigger Clash ndash while saber is on hit the bladeTrigger Lockup ndash while saber is on hold Activation button then trigger a clash Lockup releases when you let go of the Acti-vation buttonTrigger Drag ndash like lockup but point saber mostly down before holding Activation buttonTrigger Force ndash long-click AUX buttonStart soundtrack ndash long-click the Activation buttonTrigger Blaster Block ndash while saber is on short-click AUX button

Serial Monitor commands

battery_voltage ndash gets current battery voltage valueget_volume ndash get current volume valuepow ndash power OnOff the saberon ndash power On the saberoff ndash power Off the saberset_volume lt0-3000gt ndash set volume value (example set_volume 500)play ndash play the default preset trackplay trackslttrack namegt ndash play a specific track from tracks folder (example play tracksvenuswav)stop ndash stop the playing trackforce ndash play ldquoforcerdquo sound effectsdrag ndash play ldquodragrdquo sound effectsblast ndash play ldquoblasterrdquo sound effectslock ndash play ldquolockuprdquo sound effectsclash ndash play ldquoclashrdquo sound effectsreset ndash reboot the boardn ndash switch to next presetp ndash switch to previous presetlist_presets ndash show all presetssdtest ndash test SD card speed

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 21

2TEENSYSABER V3 INSTRUCTIONS

FIRMWARE UPLOAD AND UPDATE2

Software installation and setup

To upload firmware to TeensySaber board Arduino IDE program is required Follow these steps to install it to your PC

1 Install latest Arduino IDE software (donrsquot use BETA)

Installing as Windows app also is not recommended

because it will be installed in a specific protected folder that

wonrsquot allow you to install Teensyduino software in it

If TeensySaber wonrsquot show up in COM port use

Arduino IDE 186 version

2 Install latest Teensyduino software in same directory

usually itrsquos CProgram Files (x86)Arduino on Windows

Follow installation instructions for your system

3 Select Teensy 32 31 in Tools -gt Board

USB Type ndash Serial CPU Speed ndash 96 MHz (overclock) Optimize ndash Smallest Code Port ndash COM(the number your PC assigned) (Teensy 32) Serial

Connect TeensySaber via USB cable to PC to be able to select

the Port donrsquot forget to connect battery first

22 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

1 Download the TeensySaber firmware and SD card content

Unzip lightsaber-1286zip to your Documents directory or to

Desktop but not to Arduino program folder or anywhere in

Programs directory where all programs are installed You will

see a lightsaber folder and files inside it Donrsquot move any of

these files to any other location outside the lightsaber folder

and donrsquot reorganize them Unzip ProffieOS_SD_Cardzip to the

folder where you keep lightsaber-1286 folder Copy all files

from ProffieOS_SD_Card folder to your SD card

2 Unhide file extensions in File Explorer settings to see h ending

of config files Donrsquot add ldquohrdquo to the config file name

Go to config folder and create you own configh file (see page

23 for how-to)

Double-click the lightsaberino file

3 Add the name of your configh file as shown and Save this

lightsaberino file Make sure the other config files are

commented out there should be only one CONFIG_FILE

without You can have multiple config files

in lightsabergtconfig folder and just define the one you need

in lightsaberino file and upload it again to TeensySaber board

4 Connect battery to TeensySaber board and hook up to your PC

with a data transfer micro-USB-to-USB cable

Press arrow button it will compile and upload firmware to the

board Wait for your PC to make a sound or TeensySaber will

play boot sound if speaker is connected Now you can unplug

the USB cable Done

If it gives an error instead this means your configh file has

issues define CONFIG_FILE name has mistakes configh file

is out of config folder your PC user name is non-latin

2TEENSYSABER V3 INSTRUCTIONS

FIRMWARE UPLOAD AND UPDATE2

Uploading firmware

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 23

2TEENSYSABER V3 INSTRUCTIONS

CHANGING PARAMETERS3

Changing sound board parameters

All sound files (sound fonts music tracks) are stored on the micro SD card Add required sound fonts folders (Plecter NEC and Smoothswing

fonts are supported no need to change WAV files names just copy and paste) to SD card root directory as itrsquos done in the default

ProffieOS_SD_Card content folder and music tracks to the tracks folder

Make sure to name all music tracks and sound fonts folders with latin characters and only up to 8 characters long without using any special

characters (like |[- etc)

Make sure you have a configini file in each sound font folder if there is none - copy one from some default TeensySaberProffieBoard sound

font and paste into newly added sound font folder It has only one parameter that you can modify - humstart It helps to match hum sound

start with blade ignition 1000 usually works fine

All blade effects LED configuration volume level clash sensitivity etc are changed in the configh file located in lightsabergtconfig folder

To do that open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text Editor (Notepad - to see code correctly in Notepad

Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all text) and Delete it then Copy-and-Paste (Ctrl+C

Ctrl+V) your wiring diagram config code into empty _configh file and Save it under new name Follow the instructions on page 22 to

upload it to the board

TeensySaber V3 config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)

volume level (0-3000)

clash sensitivity (adjust lower or higher with 01 step)

sound font folder nametrack name

Preset name

Blade style

LED configuration (use these XP-E2 LED templatesto define your LED)

for Red use 1 Ohm resistor for Green - no resistor for Blue use 024 Ohm

NoLED ndash no 4th led used

Preset 1

24 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

31

PROFFIEBOARD INSTRUCTIONS

Whatrsquos needed

ndash ProffieBoard

ndash micro SD-card (see page 44 for recommendations)

ndash a USB micro SD-card reader (to load sound files from PC to micro SD card)

ndash micro USB data transfer cable (CABLES THAT SUPPORT ONLY CHARGING WONrsquoT WORK)

ndash wires of different gauges (32-20 AWG) (PTFE coated copper stranded wires recommended) heat shrink

ndash ESD safe soldering station solder wire flux etc

ndash pliers helping hands etc

ndash isopropyl alcohol to clean pads before soldering (helps solder to stick better)

ndash Digital Multimeter (VERY USEFUL)

ndash computer running Windows Linux or Mac OS with internet access

ndash 37V Li-Ion Protected rechargeable battery switches recharge port speaker LEDs resistors chassis etc

ndash Smart Li-Ion CC-CV (Constant Current - Constant Voltage mode) battery charger for 37V (42V) cells

ndash patience

WIRING DIAGRAMS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 25

31

PROFFIEBOARD INSTRUCTIONS

Board pinout

Battery + ndash 26 to 45 volt input drives everything except the LEDs

Battery - ndash negative pad for LEDs needs to be at same level as GND when both are connected Both pads are internally connected

GND ndash ground for electronics except LEDs Note that there are two GND pads on the board that are internally connected

Speaker +- ndash hooks up to speaker

Activation (1) Aux (2) Aux2 button (3) ndash hook up to closing buttons or potentially touch buttons

Blade ID Neopixel Data 1 ndash normally used to measure the blade ID restor and if itrsquos a neopixel blade feed out neopixel data

Data 2 3 4 5 ndash additional neopixel data outputs or free for other purposes

LED 1 2 3 4 5 6 ndash hooks up to negative side of LED (positive side of LED hooks up directly to battery) These pads can handle

up to 30 volts

SDA SCL ndash these pins are used to wire OLED display or to communicate with the gyro and accelerometer chip

RX TX ndash these pins are used for wiring a bluetooth module for wireless control

SWDCLK SWDIO ndash can be hooked up to a ST-LINK device and lets you debug programs running on the ProffieBoard

+5V ndash generated by the ProffieBoard normally itrsquos only ON when sound is playing

+33V ndash generated by the ProffieBoard for powering OLED display Bluetooth module or some accent leds

BOOT RESET ndash buttons to put the ProffieBoard in bootloader mode if uploading doesnrsquot work

micro USB port ndash micro USB port used only for firmware upload and can be used for sound files upload to SD card (from firmware version

1291 and up) THIS PORT ISNrsquoT USED FOR CHARGING THE BATTERY

LED 4LED 3

LED 2

LED 1

LED 5

LED 6

RESETBOOT

Battery - Battery -

Speaker + (red dot or ldquo+rdquo mark on speaker)

Battery +

Aux button (2)Activation button (1)

Aux2 button (3)

Blade ID Neopixel Data 1

Data 5

Data 4Data 3Data 2

+33V

SWDIO

SWDCLK

+5V

TXRX

GND

GND

Reset

Speaker -

SCLSDA

micro USB port

WIRING DIAGRAMS

26 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Basic Tri-Cree wiring diagram(In-hilt LED)

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

+

+

-

-

26 AWG

26 A

WG

30-32 AWG

28-30 AWG

28-3

0 A

WG

30-32 AWG

Protected 36-37V (42V max at full charge) 10A 3500mAh battery recommended+18650 battery holder (optional)Keystone 1042P

AV switch with accent led(constantly ON no effects)

accent leds run mostly at10-15mA so resistors for them must be calculated accordingly

Main RGB led

additional RGB leds(optional)

In case no additional high power leds are needed LED channels 4 5 6 can be used for 3 controllable(programmable for different effects) accent leds So AV switch led can be wired to one of these channelsAccent leds also can be wired to Data pads 1-5 please see ldquoAccent LEDs wiring and setuprdquo page

LED Resistor Calculator

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 27

3WIRING DIAGRAMS1

Basic Tri-Cree wiring (In-hilt LED)ldquoconfighrdquo file setup

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

Use a given or build your wiring diagram on THIS PAGE then open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text

Editor (Notepad - to see code correctly in Notepad Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all

text) and Delete it then Copy-and-Paste (Ctrl+C Ctrl+V) your wiring diagram config code (example below) into empty _configh file and

Save it under new name Follow the instructions on page 22 to upload it to the board

ldquoproffieboard_v1_confighrdquoNUM_BLADES 2NUM_BUTTONS 2VOLUME 1000CLASH_THRESHOLD_G 10StyleNormalPtrltCYAN WHITE 300 800gt()StyleNormalPtrltCYAN WHITE 300 800gt()

CreeXPE2RedTemplatelt1000gtCreeXPE2GreenTemplatelt0gtCreeXPE2BlueTemplatelt240gtNoLED

ProffieBoard config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)Volume level (0-3000)Clash sensitivity (adjust lower or higher with 01 step)ldquoBlade 1rdquo styleldquoBlade 2rdquo style (in case only 1 blade is used you donrsquot need this line)LED configuration (use these XP-E2 LED templatesto define your LED If other LED resistors are used change these values to match Ohm1000=ltvaluegt)

where 1000 is 1 Ohm resistor 0 is no resistor240 is 024 Ohm resistorNoLED ndash no 4th led used

Preset 1

LED 1 configuration

LED 2 configuration

Preset 2 etc

PROFFIEBOARD INSTRUCTIONS

28 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Basic Neopixel wiring diagram

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

+

+

-

-

22 A

WG

22 AWG

x2 28 AWG

x2 26 AWG

22 A

WG

30-32 AWG30-32 AWG

Protected 36-37V (42V max at full charge) 10A 3500mAh or 15A 3120mAhbattery recommended+18650 battery holder (optional)Keystone 1042P

AV switch with accent led(constantly ON no effects)

accent leds run mostly at10-15mA so resistors for them must be calculated accordingly

Main Neopixel strip

additional Neopixelstrips(optional)

Neopixel bladeconnector

330 Ohm on the Blade pcb side

x3 28 AWGor x1 22 AWGfor Negative

330 Ohm on the Blade pcb side

arrows up

330 Ohm on the Blade pcb side

In case no additional Neopixel strips are needed LED channels 4 5 6 can be used for 3 controllable(programmable for different effects) accent leds So AV switch led can be wired to one of these channelsAccent leds also can be wired to Data pads 2-5 please see ldquoAccent LEDs wiring and setuprdquo page

Recommended power wire gauges (22 AWG) are given for 2-strip blade For 3-strip blade you gonna need at least 20 AWG wires

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 29

ldquoproffieboard_v1_confighrdquo

3WIRING DIAGRAMS1

Basic Neopixel wiringldquoconfighrdquo file setup

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

NUM_BLADES 3NUM_BUTTONS 2VOLUME 1000CLASH_THRESHOLD_G 10IgnitionDelaylt0 any blade stylegtIgnitionDelaylt800 any blade stylegtIgnitionDelaylt800 any blade stylegtWS2811BladePtrlt118 WS2811 800kHz | WS2811 GRBgt()WS2811BladePtrlt26 blade2Pin ltbladePowerPin4gtgt()WS2811BladePtrlt26 blade3Pin ltbladePowerPin5gtgt()

ProffieBoard config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)Volume level (0-3000)Clash sensitivity (adjust lower or higher with 01 step)ldquoBlade 1rdquo style (main blade with IgnitionDelay 0)ldquoBlade 2rdquo style (CG blade 1 with IgnitionDelay 800)ldquoBlade 3rdquo style (CG blade 2 with IgnitionDelay 800)

strip configuration (defines how many pixels it has and to which LED output and pin is wired)

Preset 1

any blade style

strip (blade) 1 configuration

adjust this number to match your strips leds count

strip (blade) 2 configuration

strip (blade) 3 configuration

Preset 2 etc

Use a given or build your wiring diagram on THIS PAGE then open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text

Editor (Notepad - to see code correctly in Notepad Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all

text) and Delete it then Copy-and-Paste (Ctrl+C Ctrl+V) your wiring diagram config code (example below) into empty _configh file and

Save it under new name Follow the instructions on page 22 to upload it to the board

PROFFIEBOARD INSTRUCTIONS

30 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Basic Segmented string wiring diagram

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

+

+

-

-

24 A

WG

28 AWG

30-32 AWG30-32 AWG

Protected 36-37V (42V max at full charge) 10A 3500mAh battery recommended+18650 battery holder (optional)Keystone 1042P

AV switch with accent led(constantly ON no effects)

accent leds run mostly at10-15mA so resistors for them must be calculated accordingly

6-segments string blade

FoC string

N-channel FET3A minimum

123456

Calculate resistors for each led segment of the blade string depending on which leds are used 5mm leds have max drive current around 25mA per led when 10mm leds can be 100mA and 200mA per ledSo pay attention to your led max current and Forward Voltage (Vf) when calculating a segment resistor resistence as well as its wattage Also choose wire gauges accordingly to meet segments and total blade max current draw level

LED Resistor Calculator

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 31

ldquoproffieboard_v1_confighrdquo

3WIRING DIAGRAMS1

Basic Segmented string wiringldquoconfighrdquo file setup

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

NUM_BLADES 1NUM_BUTTONS 2VOLUME 1000CLASH_THRESHOLD_G 10StyleNormalPtrltCYAN WHITE 300 800gt()ltBlue3mmLED BladePin White3mmLEDgt

ProffieBoard config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)Volume level (0-3000)Clash sensitivity (adjust lower or higher with 01 step)Blade styleLED string configuration(here you mention the color and type of leds usedin the main blade string segments and FoC stringBladePin is the FoC signal pin (Blade ID pin))

Preset

LED string configuration

Use a given or build your wiring diagram on THIS PAGE then open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text

Editor (Notepad - to see code correctly in Notepad Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all

text) and Delete it then Copy-and-Paste (Ctrl+C Ctrl+V) your wiring diagram config code (example below) into empty _configh file and

Save it under new name Follow the instructions on page 22 to upload it to the board

PROFFIEBOARD INSTRUCTIONS

32 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Accent LEDs wiring diagram(optional)

Accent LEDs work with ProffieBoard as additional ldquobladesrdquo when powered by LED outputs 4 5 6 or Data pads 1 2 3 5 as PWM So they can

have any effect that blade can have If no effects needed accent led can be powered just by a 33V output pad (power-on led indication)

30-32 AWG

with Neopixel blade setup these 4 outputsdonrsquot work for regular accent leds

Recommended resistors to use for accent leds at 33V power source and 15mA drive

ndash 100 Ohm for Red (lt100000gt value in the code)ndash 13 Ohm for Green (lt13000gt value in the code)ndash 13 Ohm for Blue (lt13000gt value in the code)ndash 100 Ohm for Yellow (lt100000gt value in the code)ndash 20 Ohm for White (lt20000gt value in the code)

RGB ledcommon-anode

8 ldquobladesrdquo1 main and 7 accent leds

main blade style (effects) main blade style (effects)

7 accent leds style (effects)accent led style (effects)

7 accent leds configurations

RGB accent led configuration

2 ldquobladesrdquo1 main and 1 RGB accent led

ldquoPower-onrdquo indicationaccent leds (no effects)

7 accent leds withindependent effects

RGB accent led

a) b)

b)

c)

c)

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 33

3WIRING DIAGRAMS1

Neopixel Accent LEDs wiring diagram(optional)

With Neopixel setup additional neopixel leds or arrays can be used as accent leds There are 2 ways to wire them using additional Data

pins 2 3 4 5 or ldquoSub-bladesrdquo wiring with just 1 Data output pin Same way Neopixel connectors with on-board leds ca be wired

Option 1 ndash with extra Data pins

Main Blade

some accent leds

D1

D2

crystal leds

330 Ohm

330 Ohm

330 Ohm

main blade style (effects)

main blade 144 leds Data pin 1

accent leds blade style (effects)

accent leds ldquobladerdquo 4 leds Data pin 2

crystal leds blade style (effects)

crystal leds ldquobladerdquo 2 leds Data pin 3

3 ldquobladesrdquo1 main 1 accent leds array and 1 crystal leds array

PROFFIEBOARD INSTRUCTIONS

D3

follow arrows direction

34 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Neopixel Accent LEDs wiring diagram(optional)

PROFFIEBOARD INSTRUCTIONS

Main Blade

some accent leds

1

3

5678

2

4

D1

crystal leds

follow arrows direction

330 Ohm

330 OhmData signal

With this setup a single array of neopixel leds is separated into a couple of sub-blades with their own style configuration and behaviour This

is really usefull when you want to use only one data pin More about ldquoSub-bladesrdquo on ProffieOS wiki page

Option 2 ndash with ldquoSub-bladesrdquo

main blade style (effects)

main blade sub-blade 140 leds (7-146) but from 6 to 145 in the code

accent leds blade style (effects)

accent leds sub-blade 4 leds (1-4) but from 0 to 3 in the code

crystal leds blade style (effects)

146 leds total used

crystal leds sub-blade 2 leds (5-6) but from 4 to 5 in the code

update default 144 to a higher total value if you get all accent leds +Main blade gt 144 Example update to 146 if you have 2 crystal leds +4 accent leds + 140 Main blade leds = 146

3 ldquobladesrdquo 1 main 1 accent leds array and 1 crystal leds array

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 35

3WIRING DIAGRAMS1

OLED display wiring diagram(optional)

SSD1306 128x32 pixels OLED display allows to show battery level current preset name play different animations and even simple games It

can be wired to any blade configuration and requires just one additional line in the code to work You can get monochrome display in white

or blue color

SSD1306128x32OLED

SSD1306 ndash with blue or white display color selectSSD1306 ndash cheaper priceSSD1306 just screen ndash blue or white select

30-32 AWG

30-32 AWG

add this line to enable OLED display

display shows a preset name written in these quotes ldquoldquo

PROFFIEBOARD INSTRUCTIONS

36 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Bluetooth module wiring diagram(optional)

SOON

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 37

3WIRING DIAGRAMS1

Blade ID resistor functions(optional)

SOON

PROFFIEBOARD INSTRUCTIONS

38 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

website ProffieBoard FULL wiring diagrams link

Scroll the page down till you see the interactive diagram Above the diagram there are components selection options Build your saber setup

with it and follow diagram to wire your board Then you need to copy the configuration code below and paste it into your _configh file

Choose components you want

3WIRING DIAGRAMS1

More wiring diagrams

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 39

3WIRING DIAGRAMS1

How to use it

PROFFIEBOARD INSTRUCTIONS

Blade ignitionretraction ndash assuming you have at least one button pressing it briefly should turn the saber on or off If you have an AUX button pressing it briefly should also turn the saber on and off If you have no buttons you can turn the saber on and off by twisting your wrist back and forth Note that the motion has to be done long enough to count so a very quick flick of the wrist will not workTurn On muted ndash double-click power buttonNext preset ndash while saber is off click the AUX buttonPrevious preset ndash hold AUX button and click the Activation buttonTrigger Clash ndash while saber is on hit the bladeTrigger Lockup ndash while saber is on hold Activation button then trigger a clash Lockup releases when you let go of the Acti-vation buttonTrigger Drag ndash like lockup but point saber mostly down before holding Activation buttonTrigger Force ndash long-click AUX buttonStart soundtrack ndash long-click the Activation buttonTrigger Blaster Block ndash while saber is on short-click AUX button

Serial Monitor commands

battery_voltage ndash gets current battery voltage valueget_volume ndash get current volume valuepow ndash power OnOff the saberon ndash power On the saberoff ndash power Off the saberset_volume lt0-3000gt ndash set volume value (example set_volume 500)play ndash play the default preset trackplay trackslttrack namegt ndash play a specific track from tracks folder (example play tracksvenuswav)stop ndash stop the playing trackforce ndash play ldquoforcerdquo sound effectsdrag ndash play ldquodragrdquo sound effectsblast ndash play ldquoblasterrdquo sound effectslock ndash play ldquolockuprdquo sound effectsclash ndash play ldquoclashrdquo sound effectsreset ndash reboot the boardn ndash switch to next presetp ndash switch to previous presetlist_presets ndash show all presetssdtest ndash test SD card speed

40 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3FIRMWARE UPLOAD AND UPDATE2

Software installation and setup

PROFFIEBOARD INSTRUCTIONS

To upload firmware to ProffieBoard Arduino IDE program is required Follow these steps to install it to your PC

1 Install latest Arduino IDE software (donrsquot use BETA)

Installing as Windows app also is not recommended

because it will be installed in a specific protected folder that

wonrsquot allow you to install any additional softwareplugin in it

If ProffieBoard wonrsquot show up in COM port use

Arduino IDE 186 version

2 Install the Proffieboard Arduino Plugin and Zadig software

Follow installation instructions

3 Select Proffieboard-STM32L433 in Tools -gt Board

USB Type ndash Serial CPU Speed ndash 80 MHz Optimize ndash Smallest Code DOSFS ndash SDCARD (SPI) Port ndash COM(the number your PC assigned) (Butterfly-L433CC)

Connect Proffieboard via USB cable to PC to be able to select

the Port

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 41

3FIRMWARE UPLOAD AND UPDATE2

Uploading firmware

PROFFIEBOARD INSTRUCTIONS

1 Download the ProffieBoard firmware and SD card content

Unzip lightsaber-1286zip to your Documents directory or to

Desktop but not to Arduino program folder or anywhere in

Programs directory where all programs are installed You will

see a lightsaber folder and files inside it Donrsquot move any of

these files to any other location outside the lightsaber folder

and donrsquot reorganize them Unzip ProffieOS_SD_Cardzip to the

folder where you keep lightsaber-1286 folder Copy all files

from ProffieOS_SD_Card folder to your SD card

2 Unhide file extensions in File Explorer settings to see h ending

of config files Donrsquot add ldquohrdquo to the config file name Go to config folder and create you own configh file (see page

42 for how-to)

Double-click the lightsaberino file

3 Add the name of your configh file as shown and Save this

lightsaberino file Make sure the other config files are

commented out there should be only one CONFIG_FILE

without You can have multiple config files

in lightsabergtconfig folder and just define the one you need

in lightsaberino file and upload it again to ProffieBoard

4 Connect battery to ProffieBoard and hook up to your PC

with a data transfer micro-USB-to-USB cable

Press arrow button it will compile and upload firmware to the

board Wait for red text progress bars to stop at 100

ProffieBoard will play boot sound if speaker is connected

Now you can unplug the USB cable Done

If it gives an error instead this means your configh file has

issues define CONFIG_FILE name has mistakes configh file

is out of config folder your PC user name is non-latin

42 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

33

configh file structure editing

PROFFIEBOARD INSTRUCTIONS

CHANGING PARAMETERS

All sound files (sound fonts music tracks) are stored on the micro SD card Add required sound fonts folders (Plecter NEC and Smoothswing

fonts are supported no need to change WAV files names just copy and paste) to SD card root directory as itrsquos done in the default

ProffieOS_SD_Card content folder and music tracks to the tracks folder

Make sure to name all music tracks and sound fonts folders with latin characters and only up to 8 characters long without using any special

characters (like |[- etc)

Make sure you have a configini file in each sound font folder if there is none - copy one from some default TeensySaberProffieBoard sound

font and paste into newly added sound font folder It has only one parameter that you can modify - humstart It helps to match hum sound

start with blade ignition 1000 usually works fine

All blade effects LED configuration volume level clash sensitivity etc are changed in the configh file located in lightsabergtconfig folder

To do that open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text Editor (Notepad - to see code correctly in Notepad

Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all text) and Delete it then Copy-and-Paste (Ctrl+C

Ctrl+V) your wiring diagram config code into empty _configh file and Save it under new name Follow the instructions on page 39 to

upload it to the board

Proffieboard config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)

volume level (0-3000)

clash sensitivity (adjust lower or higher with 01 step)

sound font folder nametrack name

Preset name

Blade style

LED configuration (use these XP-E2 LED templatesto define your LED)

for Red use 1 Ohm resistor for Green - no resistor for Blue use 024 Ohm

NoLED ndash no 4th led used

Preset 1

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 43

33

Blade Styles

StylePtrltInOutHelperltSimpleClashltLockupltBlastltOnSparkltAudioFlickerltRgblt02550gtRgblt501000gtgtRgblt2552550gt150gtRgblt255500gtgtAudioFlickerltRgblt1002550gtRgblt2550150gtgtgtRgblt255100150gt40gt200300Blackgtgt

ndash this is how the Blade Style code looks pasted in the configh file Preset (it sits inside a StylePtrltgt container)

ndash this is how the Blade Style code looks when editing it inside a Blade Style Editor

Each Blade Style is made of a variety of Effects each added effect goes instead of a base color in the previous effect

PROFFIEBOARD INSTRUCTIONS

CHANGING PARAMETERS

ProffieBoard and TeensySaber use Blade Styles for the main saber blade and any other accent leds to define all light effects (color changing

flashes flickering delays ignitionretraction timing etc)

Use Blade Style Editor to create and adjust Blade Styles Megtooth Sith Sabers did a great video tutorial where he shows and explains

how to use Blade Style Editor Also you can grab some pre-made Blade Styles or share yours here on TRA forums

A Blade Style example of simple flickering Green blade with Spark on start Clash Blaster Lockup and Drag IgnitionRetraction effects

InOutHelperltSimpleClashltLockupltBlastltOnSparkltAudioFlickerltRgblt02550gtRgblt501000gtgtRgblt2552550gt150gtRgblt255500gtgtAudioFlickerltRgblt1002550gtRgblt2550150gtgtgtRgblt255100150gt40gt200300Blackgt

InOutHelperltbase color200300Blackgt ndash base color can be defined by words (WHITE RED GREEN PURPLE etc) or by Rgblt0-2550-2550-255gt values for more

custom shades 200 is extension length in milliseconds 300 is retraction length in milliseconds Black is color when retracted (also can be any other color)

SimpleClashltbase colorclash color40gt ndash clash effect 40 is clash duration in milliseconds

Lockupltbase colorlockup colorgt ndash lockup effect

Blastltbase colorblast colorgt ndash blaster effect

OnSparkltbase colorspark color150gt ndash spark on ignition effect 150 is spark duration in milliseconds

AudioFlickerltrdquoArdquo colorrdquoBrdquo colorgt ndash flickering effect (blade flickers to the actual saber hum sound) the more difference between ldquoArdquo and ldquoBrdquo colors - the more

abrupt is flickering

Rgblt255500gt ndash actual color in RGB format (0 is no light 255 is the maximum brightness value for Red Green or Blue channel)

44 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

ndash SanDisk 4GB microSDHC Class 4 (Genuine) ndash SanDisk 4GB microSDHC Class 4 (Genuine)

130238 kbs = 1477 simultaneous audio streams 137812 kbs = 1562 simultaneous audio streams

ndash Patriot LX Series 16GB microSDHC UHS-IU1 Class 10 ndash Patriot LX Series 16GB microSDHC UHS-IU1 Class 10

133005 kbs = 1508 simultaneous audio streams

ndash GSkill 16GB microSDHC UHS-IU1 Class 10 ndash GSkill 16GB microSDHC UHS-IU1 Class 10

129534 kbs = 1469 simultaneous audio streams

ndash Kingston 16GB microSDHC UHS-IU1 Class 10 ndash Kingston 16GB microSDHC UHS-IU1 Class 10

128090 kbs = 1452 simultaneous audio streams

ndash SanDisk Ultra 16GB microSDHC UHS-IU1 A1 Class 10 ndash SanDisk Ultra 16GB microSDHC UHS-IU1 A1 Class 10

102663 kbs = 1164 simultaneous audio streams 11124 kbs = 1261 simultaneous audio streams

ndash SanDisk 8GB microSDHC Class 4 ndash SanDisk 8GB microSDHC Class 4

108506 kbs = 1230 simultaneous audio streams

ndash SanDisk 16GB microSDHC Class 4 ndash SanDisk 16GB microSDHC Class 4

102663 kbs = 1164 simultaneous audio streams 106957 kbs = 1213 simultaneous audio streams

ndash SanDisk Ultra 16GB microSDHC UHS-IU1 Class 10 ndash SanDisk Ultra 16GB microSDHC UHS-IU1 Class 10

102663 kbs = 1164 simultaneous audio streams 103909 kbs = 1178 simultaneous audio streams

ndash Smartbuy 4GB microSDHC Class 4 ndash Smartbuy 4GB microSDHC Class 4

75437 kbs = 855 simultaneous audio streams

ndash Kingston 8GB microSDHC Class 4 ndash Kingston 8GB microSDHC Class 4

75209 kbs = 822 simultaneous audio streams

ndash SanDisk 4GB microSDHC Class 4 (Fake) ndash SanDisk 4GB microSDHC Class 4 (Fake)

677 kbs = 769 simultaneous audio streams

Here is a list of tested micro SD cards speed with TeensySaber V3 and ProffieBoard Any card with speed over 900 kbs is recommended the

higher the speed is ndash the better Memory size of 4-16Gb is more than enough Cards were tested with a default firmware (1291) compiled

with ldquoSmallest Coderdquo under Optimize ldquodefault_proffieboard_confighrdquo file and default ProffieOS SD card sound files (7 folders)

To test your SD card speed simply hook up ProffieBoard to PC open Arduino IDE go to Tools and open Serial Monitor make sure you have

New Line and 9600 baud rate selected on the bottom of Serial Monitor window type and send sdtest command wait for the test result

4Recommended micro SD cards

BEST

TEENSYSABER PROFFIEBOARD

GOOD

BAD

PROFFIEBOARD INSTRUCTIONS

SD CARD RECOMMENDATIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 45

There are a lot of fake (chinese copies) microSD cards on the market from aliexpress ebay amazon etc They look very similar to genuine

cards but are a bit different though and have a twice lower writingreading speed Here is an example of a SanDisk 4Gb Class 4 card one is

genuine with 137812 kbs speed and the other one is fake with 677 kbs speed I got from ebay seller

Be carefull and pay attention to how the actual card looks if you are not sure ask seller for the real photo of SD card he sells

4Genuine and Fake SanDisk 4Gb Class 4 microSD

PROFFIEBOARD INSTRUCTIONS

SD CARD RECOMMENDATIONS

46 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

WIRE GAUGE GUIDE

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 47

RECHARGE PORTS AND KILL SWITCHES

48 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

NEOPIXEL STRIPS CURRENT DRAW

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 49

6TROUBLESHOOTING

For more help please check these linksProffieOSProffieBoardTeensySaber wiki on GitHubAsk your question on The Rebel Armory forumsAsk your question on FX-sabers forumsAsk your question in facebook group

How to solve most common issues

Quick troubleshooting tips

TeensySaber board or Proffieboard is not recognized by computer (nothing under Port selection in Arduino)

ndash Make sure a charged 37V battery is connected to the board micro-USB cable is a data transfer cable all plugins and drivers are installed ndash

check again pages 21 for TeensySaber or 40 for Proffieboard Try a different USB port on your computer

Sketch (code) compile error in Arduino IDE

ndash Check your define CONFIG_FILE ldquoconfig_confighrdquo line in opened lightsaberino file if itrsquos written correctly with config in it

Sketch (code) compile error in Arduino IDE

ndash Check if the _configh file you defined in the lightsaberino sketch file is same name as in the lightsaber-rdquofirmware versionrdquolightsaber

config folder and is located in this folder

Sketch (code) compile error in Arduino IDE

ndash Check your settings under Tools tab in Arduino IDE program Check again pages 21 for TeensySaber or 40 for Proffieboard

Sketch (code) compile error in Arduino IDE

ndash Check if your _configh file is correct Blade Styles Presets const unsigned int maxLedsPerStrip = 144 if BladeConfig blades[] = is correct

Sketch (code) compile error in Arduino IDE

ndash If nothing helps install Arduino IDE version 186 and try to compile and upload the firmware again

Sound doesnrsquot play

ndash Remove SD card and insert again check speaker wiring Make sure all sound files on SD card are correctly named (8 characters max long)

Re-format SD card in FAT32 load sound files and try again try another SD card

Board says ldquoLOW POWERrdquo

ndash Charge the battery

Serial Monitor shows info sent by the board but your commands donrsquot work

ndash In the bottom right corner of Serial Monitor window make sure the Line Ending drop down is set to New Line

Sound is weird and distorted

ndash Check your SD card speed (see page 44) Check speaker wiring try another good speaker

12 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

Basic Segmented string wiring diagram

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

+

+

-

-

24 A

WG

28 AWG

30-32 AWG

30-32 AWG

Protected 36-37V (42V max at full charge) 10A 3500mAh battery recommended+18650 battery holder (optional)Keystone 1042P

AV switch with accent led(constantly ON no effects)

accent leds run mostly at10-15mA so resistors for them must be calculated accordingly

6-segments string blade

FoC string

N-channel FET3A minimum

1

1 46 523

23456

Calculate resistors for each led segment of the blade string depending on which leds are used 5mm leds have max drive current around 25mA per led when 10mm leds can be 100mA and 200mA per ledSo pay attention to your led max current and Forward Voltage (Vf) when calculating a segment resistor resistence as well as its wattage Also choose wire gauges accordingly to meet segments and total blade max current draw level

LED Resistor Calculator

solder 3x FETs

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 13

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

Basic Segmented string wiringldquoconfighrdquo file setup

ldquov3_confighrdquoNUM_BLADES 1NUM_BUTTONS 2VOLUME 1000CLASH_THRESHOLD_G 10StyleNormalPtrltCYAN WHITE 300 800gt()ltBlue3mmLED 20 White3mmLEDgt

TeensySaber V3 config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)Volume level (0-3000)Clash sensitivity (adjust lower or higher with 01 step)Blade styleLED string configuration(here you mention the color and type of leds usedin the main blade string segments and FoC string20 is the FoC signal pin (Blade ID pin))

Preset

LED string configuration

Use a given or build your wiring diagram on THIS PAGE then open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text

Editor (Notepad - to see code correctly in Notepad Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all

text) and Delete it then Copy-and-Paste (Ctrl+C Ctrl+V) your wiring diagram config code (example below) into empty _configh file and

Save it under new name Follow the instructions on page 22 to upload it to the board

14 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

Accent LEDs wiring diagram(optional)

Accent LEDs work with TeensySaber board as additional ldquobladesrdquo when powered by LED outputs 4 5 6 with FETs So they can have any effect

that blade can have If no effects needed accent led can be powered just by a 33V output pad (power-on led indication)

30-32 AWGRGB ledcommon-anode

4 ldquobladesrdquo1 main and 3 accent leds

main blade style (effects) main blade style (effects)

3 accent leds style (effects)accent led style (effects)

3 accent leds configurations

RGB accent led configuration

2 ldquobladesrdquo1 main and 1 RGB accent led

ldquoPower-onrdquo indicationaccent leds (no effects)

3 accent leds withindependent effects

+ 1 or more simple accent leds without effects

1 RGB accent led+ 1 or more simple accent leds

without effects

a) b)

b)

c)

c)

solder 3x FETs solder 3x FETs

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 15

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

OLED display wiring diagram(optional)

SSD1306 128x32 pixels OLED display allows to show battery level current preset name play different animations and even simple games It

can be wired to any blade configuration and requires just one additional line in the code to work You can get monochrome display in white

or blue color

SSD1306128x32OLED

SSD1306 ndash with blue or white display color selectSSD1306 ndash cheaper priceSSD1306 just screen ndash blue or white select

30-32 AWG

30-32 AWG

add this line to enable OLED display

display shows a preset name written in these quotes ldquoldquo

16 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

Bluetooth module wiring diagram(optional)

SOON

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 17

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

Blade ID resistor functions(optional)

SOON

18 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

website TeensySaber V3 FULL wiring diagrams link

Scroll the page down till you see the interactive diagram Above the diagram there are components selection options Build your saber setup

with it and follow diagram to wire your board Then you need to copy the configuration code below and paste it into your _configh file

Choose components you want

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

More wiring diagrams

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 19

20 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

How to use it

Blade ignitionretraction ndash assuming you have at least one button pressing it briefly should turn the saber on or off If you have an AUX button pressing it briefly should also turn the saber on and off If you have no buttons you can turn the saber on and off by twisting your wrist back and forth Note that the motion has to be done long enough to count so a very quick flick of the wrist will not workTurn On muted ndash double-click power buttonNext preset ndash while saber is off click the AUX buttonPrevious preset ndash hold AUX button and click the Activation buttonTrigger Clash ndash while saber is on hit the bladeTrigger Lockup ndash while saber is on hold Activation button then trigger a clash Lockup releases when you let go of the Acti-vation buttonTrigger Drag ndash like lockup but point saber mostly down before holding Activation buttonTrigger Force ndash long-click AUX buttonStart soundtrack ndash long-click the Activation buttonTrigger Blaster Block ndash while saber is on short-click AUX button

Serial Monitor commands

battery_voltage ndash gets current battery voltage valueget_volume ndash get current volume valuepow ndash power OnOff the saberon ndash power On the saberoff ndash power Off the saberset_volume lt0-3000gt ndash set volume value (example set_volume 500)play ndash play the default preset trackplay trackslttrack namegt ndash play a specific track from tracks folder (example play tracksvenuswav)stop ndash stop the playing trackforce ndash play ldquoforcerdquo sound effectsdrag ndash play ldquodragrdquo sound effectsblast ndash play ldquoblasterrdquo sound effectslock ndash play ldquolockuprdquo sound effectsclash ndash play ldquoclashrdquo sound effectsreset ndash reboot the boardn ndash switch to next presetp ndash switch to previous presetlist_presets ndash show all presetssdtest ndash test SD card speed

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 21

2TEENSYSABER V3 INSTRUCTIONS

FIRMWARE UPLOAD AND UPDATE2

Software installation and setup

To upload firmware to TeensySaber board Arduino IDE program is required Follow these steps to install it to your PC

1 Install latest Arduino IDE software (donrsquot use BETA)

Installing as Windows app also is not recommended

because it will be installed in a specific protected folder that

wonrsquot allow you to install Teensyduino software in it

If TeensySaber wonrsquot show up in COM port use

Arduino IDE 186 version

2 Install latest Teensyduino software in same directory

usually itrsquos CProgram Files (x86)Arduino on Windows

Follow installation instructions for your system

3 Select Teensy 32 31 in Tools -gt Board

USB Type ndash Serial CPU Speed ndash 96 MHz (overclock) Optimize ndash Smallest Code Port ndash COM(the number your PC assigned) (Teensy 32) Serial

Connect TeensySaber via USB cable to PC to be able to select

the Port donrsquot forget to connect battery first

22 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

1 Download the TeensySaber firmware and SD card content

Unzip lightsaber-1286zip to your Documents directory or to

Desktop but not to Arduino program folder or anywhere in

Programs directory where all programs are installed You will

see a lightsaber folder and files inside it Donrsquot move any of

these files to any other location outside the lightsaber folder

and donrsquot reorganize them Unzip ProffieOS_SD_Cardzip to the

folder where you keep lightsaber-1286 folder Copy all files

from ProffieOS_SD_Card folder to your SD card

2 Unhide file extensions in File Explorer settings to see h ending

of config files Donrsquot add ldquohrdquo to the config file name

Go to config folder and create you own configh file (see page

23 for how-to)

Double-click the lightsaberino file

3 Add the name of your configh file as shown and Save this

lightsaberino file Make sure the other config files are

commented out there should be only one CONFIG_FILE

without You can have multiple config files

in lightsabergtconfig folder and just define the one you need

in lightsaberino file and upload it again to TeensySaber board

4 Connect battery to TeensySaber board and hook up to your PC

with a data transfer micro-USB-to-USB cable

Press arrow button it will compile and upload firmware to the

board Wait for your PC to make a sound or TeensySaber will

play boot sound if speaker is connected Now you can unplug

the USB cable Done

If it gives an error instead this means your configh file has

issues define CONFIG_FILE name has mistakes configh file

is out of config folder your PC user name is non-latin

2TEENSYSABER V3 INSTRUCTIONS

FIRMWARE UPLOAD AND UPDATE2

Uploading firmware

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 23

2TEENSYSABER V3 INSTRUCTIONS

CHANGING PARAMETERS3

Changing sound board parameters

All sound files (sound fonts music tracks) are stored on the micro SD card Add required sound fonts folders (Plecter NEC and Smoothswing

fonts are supported no need to change WAV files names just copy and paste) to SD card root directory as itrsquos done in the default

ProffieOS_SD_Card content folder and music tracks to the tracks folder

Make sure to name all music tracks and sound fonts folders with latin characters and only up to 8 characters long without using any special

characters (like |[- etc)

Make sure you have a configini file in each sound font folder if there is none - copy one from some default TeensySaberProffieBoard sound

font and paste into newly added sound font folder It has only one parameter that you can modify - humstart It helps to match hum sound

start with blade ignition 1000 usually works fine

All blade effects LED configuration volume level clash sensitivity etc are changed in the configh file located in lightsabergtconfig folder

To do that open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text Editor (Notepad - to see code correctly in Notepad

Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all text) and Delete it then Copy-and-Paste (Ctrl+C

Ctrl+V) your wiring diagram config code into empty _configh file and Save it under new name Follow the instructions on page 22 to

upload it to the board

TeensySaber V3 config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)

volume level (0-3000)

clash sensitivity (adjust lower or higher with 01 step)

sound font folder nametrack name

Preset name

Blade style

LED configuration (use these XP-E2 LED templatesto define your LED)

for Red use 1 Ohm resistor for Green - no resistor for Blue use 024 Ohm

NoLED ndash no 4th led used

Preset 1

24 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

31

PROFFIEBOARD INSTRUCTIONS

Whatrsquos needed

ndash ProffieBoard

ndash micro SD-card (see page 44 for recommendations)

ndash a USB micro SD-card reader (to load sound files from PC to micro SD card)

ndash micro USB data transfer cable (CABLES THAT SUPPORT ONLY CHARGING WONrsquoT WORK)

ndash wires of different gauges (32-20 AWG) (PTFE coated copper stranded wires recommended) heat shrink

ndash ESD safe soldering station solder wire flux etc

ndash pliers helping hands etc

ndash isopropyl alcohol to clean pads before soldering (helps solder to stick better)

ndash Digital Multimeter (VERY USEFUL)

ndash computer running Windows Linux or Mac OS with internet access

ndash 37V Li-Ion Protected rechargeable battery switches recharge port speaker LEDs resistors chassis etc

ndash Smart Li-Ion CC-CV (Constant Current - Constant Voltage mode) battery charger for 37V (42V) cells

ndash patience

WIRING DIAGRAMS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 25

31

PROFFIEBOARD INSTRUCTIONS

Board pinout

Battery + ndash 26 to 45 volt input drives everything except the LEDs

Battery - ndash negative pad for LEDs needs to be at same level as GND when both are connected Both pads are internally connected

GND ndash ground for electronics except LEDs Note that there are two GND pads on the board that are internally connected

Speaker +- ndash hooks up to speaker

Activation (1) Aux (2) Aux2 button (3) ndash hook up to closing buttons or potentially touch buttons

Blade ID Neopixel Data 1 ndash normally used to measure the blade ID restor and if itrsquos a neopixel blade feed out neopixel data

Data 2 3 4 5 ndash additional neopixel data outputs or free for other purposes

LED 1 2 3 4 5 6 ndash hooks up to negative side of LED (positive side of LED hooks up directly to battery) These pads can handle

up to 30 volts

SDA SCL ndash these pins are used to wire OLED display or to communicate with the gyro and accelerometer chip

RX TX ndash these pins are used for wiring a bluetooth module for wireless control

SWDCLK SWDIO ndash can be hooked up to a ST-LINK device and lets you debug programs running on the ProffieBoard

+5V ndash generated by the ProffieBoard normally itrsquos only ON when sound is playing

+33V ndash generated by the ProffieBoard for powering OLED display Bluetooth module or some accent leds

BOOT RESET ndash buttons to put the ProffieBoard in bootloader mode if uploading doesnrsquot work

micro USB port ndash micro USB port used only for firmware upload and can be used for sound files upload to SD card (from firmware version

1291 and up) THIS PORT ISNrsquoT USED FOR CHARGING THE BATTERY

LED 4LED 3

LED 2

LED 1

LED 5

LED 6

RESETBOOT

Battery - Battery -

Speaker + (red dot or ldquo+rdquo mark on speaker)

Battery +

Aux button (2)Activation button (1)

Aux2 button (3)

Blade ID Neopixel Data 1

Data 5

Data 4Data 3Data 2

+33V

SWDIO

SWDCLK

+5V

TXRX

GND

GND

Reset

Speaker -

SCLSDA

micro USB port

WIRING DIAGRAMS

26 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Basic Tri-Cree wiring diagram(In-hilt LED)

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

+

+

-

-

26 AWG

26 A

WG

30-32 AWG

28-30 AWG

28-3

0 A

WG

30-32 AWG

Protected 36-37V (42V max at full charge) 10A 3500mAh battery recommended+18650 battery holder (optional)Keystone 1042P

AV switch with accent led(constantly ON no effects)

accent leds run mostly at10-15mA so resistors for them must be calculated accordingly

Main RGB led

additional RGB leds(optional)

In case no additional high power leds are needed LED channels 4 5 6 can be used for 3 controllable(programmable for different effects) accent leds So AV switch led can be wired to one of these channelsAccent leds also can be wired to Data pads 1-5 please see ldquoAccent LEDs wiring and setuprdquo page

LED Resistor Calculator

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 27

3WIRING DIAGRAMS1

Basic Tri-Cree wiring (In-hilt LED)ldquoconfighrdquo file setup

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

Use a given or build your wiring diagram on THIS PAGE then open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text

Editor (Notepad - to see code correctly in Notepad Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all

text) and Delete it then Copy-and-Paste (Ctrl+C Ctrl+V) your wiring diagram config code (example below) into empty _configh file and

Save it under new name Follow the instructions on page 22 to upload it to the board

ldquoproffieboard_v1_confighrdquoNUM_BLADES 2NUM_BUTTONS 2VOLUME 1000CLASH_THRESHOLD_G 10StyleNormalPtrltCYAN WHITE 300 800gt()StyleNormalPtrltCYAN WHITE 300 800gt()

CreeXPE2RedTemplatelt1000gtCreeXPE2GreenTemplatelt0gtCreeXPE2BlueTemplatelt240gtNoLED

ProffieBoard config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)Volume level (0-3000)Clash sensitivity (adjust lower or higher with 01 step)ldquoBlade 1rdquo styleldquoBlade 2rdquo style (in case only 1 blade is used you donrsquot need this line)LED configuration (use these XP-E2 LED templatesto define your LED If other LED resistors are used change these values to match Ohm1000=ltvaluegt)

where 1000 is 1 Ohm resistor 0 is no resistor240 is 024 Ohm resistorNoLED ndash no 4th led used

Preset 1

LED 1 configuration

LED 2 configuration

Preset 2 etc

PROFFIEBOARD INSTRUCTIONS

28 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Basic Neopixel wiring diagram

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

+

+

-

-

22 A

WG

22 AWG

x2 28 AWG

x2 26 AWG

22 A

WG

30-32 AWG30-32 AWG

Protected 36-37V (42V max at full charge) 10A 3500mAh or 15A 3120mAhbattery recommended+18650 battery holder (optional)Keystone 1042P

AV switch with accent led(constantly ON no effects)

accent leds run mostly at10-15mA so resistors for them must be calculated accordingly

Main Neopixel strip

additional Neopixelstrips(optional)

Neopixel bladeconnector

330 Ohm on the Blade pcb side

x3 28 AWGor x1 22 AWGfor Negative

330 Ohm on the Blade pcb side

arrows up

330 Ohm on the Blade pcb side

In case no additional Neopixel strips are needed LED channels 4 5 6 can be used for 3 controllable(programmable for different effects) accent leds So AV switch led can be wired to one of these channelsAccent leds also can be wired to Data pads 2-5 please see ldquoAccent LEDs wiring and setuprdquo page

Recommended power wire gauges (22 AWG) are given for 2-strip blade For 3-strip blade you gonna need at least 20 AWG wires

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 29

ldquoproffieboard_v1_confighrdquo

3WIRING DIAGRAMS1

Basic Neopixel wiringldquoconfighrdquo file setup

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

NUM_BLADES 3NUM_BUTTONS 2VOLUME 1000CLASH_THRESHOLD_G 10IgnitionDelaylt0 any blade stylegtIgnitionDelaylt800 any blade stylegtIgnitionDelaylt800 any blade stylegtWS2811BladePtrlt118 WS2811 800kHz | WS2811 GRBgt()WS2811BladePtrlt26 blade2Pin ltbladePowerPin4gtgt()WS2811BladePtrlt26 blade3Pin ltbladePowerPin5gtgt()

ProffieBoard config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)Volume level (0-3000)Clash sensitivity (adjust lower or higher with 01 step)ldquoBlade 1rdquo style (main blade with IgnitionDelay 0)ldquoBlade 2rdquo style (CG blade 1 with IgnitionDelay 800)ldquoBlade 3rdquo style (CG blade 2 with IgnitionDelay 800)

strip configuration (defines how many pixels it has and to which LED output and pin is wired)

Preset 1

any blade style

strip (blade) 1 configuration

adjust this number to match your strips leds count

strip (blade) 2 configuration

strip (blade) 3 configuration

Preset 2 etc

Use a given or build your wiring diagram on THIS PAGE then open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text

Editor (Notepad - to see code correctly in Notepad Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all

text) and Delete it then Copy-and-Paste (Ctrl+C Ctrl+V) your wiring diagram config code (example below) into empty _configh file and

Save it under new name Follow the instructions on page 22 to upload it to the board

PROFFIEBOARD INSTRUCTIONS

30 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Basic Segmented string wiring diagram

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

+

+

-

-

24 A

WG

28 AWG

30-32 AWG30-32 AWG

Protected 36-37V (42V max at full charge) 10A 3500mAh battery recommended+18650 battery holder (optional)Keystone 1042P

AV switch with accent led(constantly ON no effects)

accent leds run mostly at10-15mA so resistors for them must be calculated accordingly

6-segments string blade

FoC string

N-channel FET3A minimum

123456

Calculate resistors for each led segment of the blade string depending on which leds are used 5mm leds have max drive current around 25mA per led when 10mm leds can be 100mA and 200mA per ledSo pay attention to your led max current and Forward Voltage (Vf) when calculating a segment resistor resistence as well as its wattage Also choose wire gauges accordingly to meet segments and total blade max current draw level

LED Resistor Calculator

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 31

ldquoproffieboard_v1_confighrdquo

3WIRING DIAGRAMS1

Basic Segmented string wiringldquoconfighrdquo file setup

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

NUM_BLADES 1NUM_BUTTONS 2VOLUME 1000CLASH_THRESHOLD_G 10StyleNormalPtrltCYAN WHITE 300 800gt()ltBlue3mmLED BladePin White3mmLEDgt

ProffieBoard config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)Volume level (0-3000)Clash sensitivity (adjust lower or higher with 01 step)Blade styleLED string configuration(here you mention the color and type of leds usedin the main blade string segments and FoC stringBladePin is the FoC signal pin (Blade ID pin))

Preset

LED string configuration

Use a given or build your wiring diagram on THIS PAGE then open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text

Editor (Notepad - to see code correctly in Notepad Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all

text) and Delete it then Copy-and-Paste (Ctrl+C Ctrl+V) your wiring diagram config code (example below) into empty _configh file and

Save it under new name Follow the instructions on page 22 to upload it to the board

PROFFIEBOARD INSTRUCTIONS

32 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Accent LEDs wiring diagram(optional)

Accent LEDs work with ProffieBoard as additional ldquobladesrdquo when powered by LED outputs 4 5 6 or Data pads 1 2 3 5 as PWM So they can

have any effect that blade can have If no effects needed accent led can be powered just by a 33V output pad (power-on led indication)

30-32 AWG

with Neopixel blade setup these 4 outputsdonrsquot work for regular accent leds

Recommended resistors to use for accent leds at 33V power source and 15mA drive

ndash 100 Ohm for Red (lt100000gt value in the code)ndash 13 Ohm for Green (lt13000gt value in the code)ndash 13 Ohm for Blue (lt13000gt value in the code)ndash 100 Ohm for Yellow (lt100000gt value in the code)ndash 20 Ohm for White (lt20000gt value in the code)

RGB ledcommon-anode

8 ldquobladesrdquo1 main and 7 accent leds

main blade style (effects) main blade style (effects)

7 accent leds style (effects)accent led style (effects)

7 accent leds configurations

RGB accent led configuration

2 ldquobladesrdquo1 main and 1 RGB accent led

ldquoPower-onrdquo indicationaccent leds (no effects)

7 accent leds withindependent effects

RGB accent led

a) b)

b)

c)

c)

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 33

3WIRING DIAGRAMS1

Neopixel Accent LEDs wiring diagram(optional)

With Neopixel setup additional neopixel leds or arrays can be used as accent leds There are 2 ways to wire them using additional Data

pins 2 3 4 5 or ldquoSub-bladesrdquo wiring with just 1 Data output pin Same way Neopixel connectors with on-board leds ca be wired

Option 1 ndash with extra Data pins

Main Blade

some accent leds

D1

D2

crystal leds

330 Ohm

330 Ohm

330 Ohm

main blade style (effects)

main blade 144 leds Data pin 1

accent leds blade style (effects)

accent leds ldquobladerdquo 4 leds Data pin 2

crystal leds blade style (effects)

crystal leds ldquobladerdquo 2 leds Data pin 3

3 ldquobladesrdquo1 main 1 accent leds array and 1 crystal leds array

PROFFIEBOARD INSTRUCTIONS

D3

follow arrows direction

34 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Neopixel Accent LEDs wiring diagram(optional)

PROFFIEBOARD INSTRUCTIONS

Main Blade

some accent leds

1

3

5678

2

4

D1

crystal leds

follow arrows direction

330 Ohm

330 OhmData signal

With this setup a single array of neopixel leds is separated into a couple of sub-blades with their own style configuration and behaviour This

is really usefull when you want to use only one data pin More about ldquoSub-bladesrdquo on ProffieOS wiki page

Option 2 ndash with ldquoSub-bladesrdquo

main blade style (effects)

main blade sub-blade 140 leds (7-146) but from 6 to 145 in the code

accent leds blade style (effects)

accent leds sub-blade 4 leds (1-4) but from 0 to 3 in the code

crystal leds blade style (effects)

146 leds total used

crystal leds sub-blade 2 leds (5-6) but from 4 to 5 in the code

update default 144 to a higher total value if you get all accent leds +Main blade gt 144 Example update to 146 if you have 2 crystal leds +4 accent leds + 140 Main blade leds = 146

3 ldquobladesrdquo 1 main 1 accent leds array and 1 crystal leds array

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 35

3WIRING DIAGRAMS1

OLED display wiring diagram(optional)

SSD1306 128x32 pixels OLED display allows to show battery level current preset name play different animations and even simple games It

can be wired to any blade configuration and requires just one additional line in the code to work You can get monochrome display in white

or blue color

SSD1306128x32OLED

SSD1306 ndash with blue or white display color selectSSD1306 ndash cheaper priceSSD1306 just screen ndash blue or white select

30-32 AWG

30-32 AWG

add this line to enable OLED display

display shows a preset name written in these quotes ldquoldquo

PROFFIEBOARD INSTRUCTIONS

36 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Bluetooth module wiring diagram(optional)

SOON

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 37

3WIRING DIAGRAMS1

Blade ID resistor functions(optional)

SOON

PROFFIEBOARD INSTRUCTIONS

38 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

website ProffieBoard FULL wiring diagrams link

Scroll the page down till you see the interactive diagram Above the diagram there are components selection options Build your saber setup

with it and follow diagram to wire your board Then you need to copy the configuration code below and paste it into your _configh file

Choose components you want

3WIRING DIAGRAMS1

More wiring diagrams

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 39

3WIRING DIAGRAMS1

How to use it

PROFFIEBOARD INSTRUCTIONS

Blade ignitionretraction ndash assuming you have at least one button pressing it briefly should turn the saber on or off If you have an AUX button pressing it briefly should also turn the saber on and off If you have no buttons you can turn the saber on and off by twisting your wrist back and forth Note that the motion has to be done long enough to count so a very quick flick of the wrist will not workTurn On muted ndash double-click power buttonNext preset ndash while saber is off click the AUX buttonPrevious preset ndash hold AUX button and click the Activation buttonTrigger Clash ndash while saber is on hit the bladeTrigger Lockup ndash while saber is on hold Activation button then trigger a clash Lockup releases when you let go of the Acti-vation buttonTrigger Drag ndash like lockup but point saber mostly down before holding Activation buttonTrigger Force ndash long-click AUX buttonStart soundtrack ndash long-click the Activation buttonTrigger Blaster Block ndash while saber is on short-click AUX button

Serial Monitor commands

battery_voltage ndash gets current battery voltage valueget_volume ndash get current volume valuepow ndash power OnOff the saberon ndash power On the saberoff ndash power Off the saberset_volume lt0-3000gt ndash set volume value (example set_volume 500)play ndash play the default preset trackplay trackslttrack namegt ndash play a specific track from tracks folder (example play tracksvenuswav)stop ndash stop the playing trackforce ndash play ldquoforcerdquo sound effectsdrag ndash play ldquodragrdquo sound effectsblast ndash play ldquoblasterrdquo sound effectslock ndash play ldquolockuprdquo sound effectsclash ndash play ldquoclashrdquo sound effectsreset ndash reboot the boardn ndash switch to next presetp ndash switch to previous presetlist_presets ndash show all presetssdtest ndash test SD card speed

40 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3FIRMWARE UPLOAD AND UPDATE2

Software installation and setup

PROFFIEBOARD INSTRUCTIONS

To upload firmware to ProffieBoard Arduino IDE program is required Follow these steps to install it to your PC

1 Install latest Arduino IDE software (donrsquot use BETA)

Installing as Windows app also is not recommended

because it will be installed in a specific protected folder that

wonrsquot allow you to install any additional softwareplugin in it

If ProffieBoard wonrsquot show up in COM port use

Arduino IDE 186 version

2 Install the Proffieboard Arduino Plugin and Zadig software

Follow installation instructions

3 Select Proffieboard-STM32L433 in Tools -gt Board

USB Type ndash Serial CPU Speed ndash 80 MHz Optimize ndash Smallest Code DOSFS ndash SDCARD (SPI) Port ndash COM(the number your PC assigned) (Butterfly-L433CC)

Connect Proffieboard via USB cable to PC to be able to select

the Port

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 41

3FIRMWARE UPLOAD AND UPDATE2

Uploading firmware

PROFFIEBOARD INSTRUCTIONS

1 Download the ProffieBoard firmware and SD card content

Unzip lightsaber-1286zip to your Documents directory or to

Desktop but not to Arduino program folder or anywhere in

Programs directory where all programs are installed You will

see a lightsaber folder and files inside it Donrsquot move any of

these files to any other location outside the lightsaber folder

and donrsquot reorganize them Unzip ProffieOS_SD_Cardzip to the

folder where you keep lightsaber-1286 folder Copy all files

from ProffieOS_SD_Card folder to your SD card

2 Unhide file extensions in File Explorer settings to see h ending

of config files Donrsquot add ldquohrdquo to the config file name Go to config folder and create you own configh file (see page

42 for how-to)

Double-click the lightsaberino file

3 Add the name of your configh file as shown and Save this

lightsaberino file Make sure the other config files are

commented out there should be only one CONFIG_FILE

without You can have multiple config files

in lightsabergtconfig folder and just define the one you need

in lightsaberino file and upload it again to ProffieBoard

4 Connect battery to ProffieBoard and hook up to your PC

with a data transfer micro-USB-to-USB cable

Press arrow button it will compile and upload firmware to the

board Wait for red text progress bars to stop at 100

ProffieBoard will play boot sound if speaker is connected

Now you can unplug the USB cable Done

If it gives an error instead this means your configh file has

issues define CONFIG_FILE name has mistakes configh file

is out of config folder your PC user name is non-latin

42 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

33

configh file structure editing

PROFFIEBOARD INSTRUCTIONS

CHANGING PARAMETERS

All sound files (sound fonts music tracks) are stored on the micro SD card Add required sound fonts folders (Plecter NEC and Smoothswing

fonts are supported no need to change WAV files names just copy and paste) to SD card root directory as itrsquos done in the default

ProffieOS_SD_Card content folder and music tracks to the tracks folder

Make sure to name all music tracks and sound fonts folders with latin characters and only up to 8 characters long without using any special

characters (like |[- etc)

Make sure you have a configini file in each sound font folder if there is none - copy one from some default TeensySaberProffieBoard sound

font and paste into newly added sound font folder It has only one parameter that you can modify - humstart It helps to match hum sound

start with blade ignition 1000 usually works fine

All blade effects LED configuration volume level clash sensitivity etc are changed in the configh file located in lightsabergtconfig folder

To do that open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text Editor (Notepad - to see code correctly in Notepad

Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all text) and Delete it then Copy-and-Paste (Ctrl+C

Ctrl+V) your wiring diagram config code into empty _configh file and Save it under new name Follow the instructions on page 39 to

upload it to the board

Proffieboard config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)

volume level (0-3000)

clash sensitivity (adjust lower or higher with 01 step)

sound font folder nametrack name

Preset name

Blade style

LED configuration (use these XP-E2 LED templatesto define your LED)

for Red use 1 Ohm resistor for Green - no resistor for Blue use 024 Ohm

NoLED ndash no 4th led used

Preset 1

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 43

33

Blade Styles

StylePtrltInOutHelperltSimpleClashltLockupltBlastltOnSparkltAudioFlickerltRgblt02550gtRgblt501000gtgtRgblt2552550gt150gtRgblt255500gtgtAudioFlickerltRgblt1002550gtRgblt2550150gtgtgtRgblt255100150gt40gt200300Blackgtgt

ndash this is how the Blade Style code looks pasted in the configh file Preset (it sits inside a StylePtrltgt container)

ndash this is how the Blade Style code looks when editing it inside a Blade Style Editor

Each Blade Style is made of a variety of Effects each added effect goes instead of a base color in the previous effect

PROFFIEBOARD INSTRUCTIONS

CHANGING PARAMETERS

ProffieBoard and TeensySaber use Blade Styles for the main saber blade and any other accent leds to define all light effects (color changing

flashes flickering delays ignitionretraction timing etc)

Use Blade Style Editor to create and adjust Blade Styles Megtooth Sith Sabers did a great video tutorial where he shows and explains

how to use Blade Style Editor Also you can grab some pre-made Blade Styles or share yours here on TRA forums

A Blade Style example of simple flickering Green blade with Spark on start Clash Blaster Lockup and Drag IgnitionRetraction effects

InOutHelperltSimpleClashltLockupltBlastltOnSparkltAudioFlickerltRgblt02550gtRgblt501000gtgtRgblt2552550gt150gtRgblt255500gtgtAudioFlickerltRgblt1002550gtRgblt2550150gtgtgtRgblt255100150gt40gt200300Blackgt

InOutHelperltbase color200300Blackgt ndash base color can be defined by words (WHITE RED GREEN PURPLE etc) or by Rgblt0-2550-2550-255gt values for more

custom shades 200 is extension length in milliseconds 300 is retraction length in milliseconds Black is color when retracted (also can be any other color)

SimpleClashltbase colorclash color40gt ndash clash effect 40 is clash duration in milliseconds

Lockupltbase colorlockup colorgt ndash lockup effect

Blastltbase colorblast colorgt ndash blaster effect

OnSparkltbase colorspark color150gt ndash spark on ignition effect 150 is spark duration in milliseconds

AudioFlickerltrdquoArdquo colorrdquoBrdquo colorgt ndash flickering effect (blade flickers to the actual saber hum sound) the more difference between ldquoArdquo and ldquoBrdquo colors - the more

abrupt is flickering

Rgblt255500gt ndash actual color in RGB format (0 is no light 255 is the maximum brightness value for Red Green or Blue channel)

44 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

ndash SanDisk 4GB microSDHC Class 4 (Genuine) ndash SanDisk 4GB microSDHC Class 4 (Genuine)

130238 kbs = 1477 simultaneous audio streams 137812 kbs = 1562 simultaneous audio streams

ndash Patriot LX Series 16GB microSDHC UHS-IU1 Class 10 ndash Patriot LX Series 16GB microSDHC UHS-IU1 Class 10

133005 kbs = 1508 simultaneous audio streams

ndash GSkill 16GB microSDHC UHS-IU1 Class 10 ndash GSkill 16GB microSDHC UHS-IU1 Class 10

129534 kbs = 1469 simultaneous audio streams

ndash Kingston 16GB microSDHC UHS-IU1 Class 10 ndash Kingston 16GB microSDHC UHS-IU1 Class 10

128090 kbs = 1452 simultaneous audio streams

ndash SanDisk Ultra 16GB microSDHC UHS-IU1 A1 Class 10 ndash SanDisk Ultra 16GB microSDHC UHS-IU1 A1 Class 10

102663 kbs = 1164 simultaneous audio streams 11124 kbs = 1261 simultaneous audio streams

ndash SanDisk 8GB microSDHC Class 4 ndash SanDisk 8GB microSDHC Class 4

108506 kbs = 1230 simultaneous audio streams

ndash SanDisk 16GB microSDHC Class 4 ndash SanDisk 16GB microSDHC Class 4

102663 kbs = 1164 simultaneous audio streams 106957 kbs = 1213 simultaneous audio streams

ndash SanDisk Ultra 16GB microSDHC UHS-IU1 Class 10 ndash SanDisk Ultra 16GB microSDHC UHS-IU1 Class 10

102663 kbs = 1164 simultaneous audio streams 103909 kbs = 1178 simultaneous audio streams

ndash Smartbuy 4GB microSDHC Class 4 ndash Smartbuy 4GB microSDHC Class 4

75437 kbs = 855 simultaneous audio streams

ndash Kingston 8GB microSDHC Class 4 ndash Kingston 8GB microSDHC Class 4

75209 kbs = 822 simultaneous audio streams

ndash SanDisk 4GB microSDHC Class 4 (Fake) ndash SanDisk 4GB microSDHC Class 4 (Fake)

677 kbs = 769 simultaneous audio streams

Here is a list of tested micro SD cards speed with TeensySaber V3 and ProffieBoard Any card with speed over 900 kbs is recommended the

higher the speed is ndash the better Memory size of 4-16Gb is more than enough Cards were tested with a default firmware (1291) compiled

with ldquoSmallest Coderdquo under Optimize ldquodefault_proffieboard_confighrdquo file and default ProffieOS SD card sound files (7 folders)

To test your SD card speed simply hook up ProffieBoard to PC open Arduino IDE go to Tools and open Serial Monitor make sure you have

New Line and 9600 baud rate selected on the bottom of Serial Monitor window type and send sdtest command wait for the test result

4Recommended micro SD cards

BEST

TEENSYSABER PROFFIEBOARD

GOOD

BAD

PROFFIEBOARD INSTRUCTIONS

SD CARD RECOMMENDATIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 45

There are a lot of fake (chinese copies) microSD cards on the market from aliexpress ebay amazon etc They look very similar to genuine

cards but are a bit different though and have a twice lower writingreading speed Here is an example of a SanDisk 4Gb Class 4 card one is

genuine with 137812 kbs speed and the other one is fake with 677 kbs speed I got from ebay seller

Be carefull and pay attention to how the actual card looks if you are not sure ask seller for the real photo of SD card he sells

4Genuine and Fake SanDisk 4Gb Class 4 microSD

PROFFIEBOARD INSTRUCTIONS

SD CARD RECOMMENDATIONS

46 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

WIRE GAUGE GUIDE

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 47

RECHARGE PORTS AND KILL SWITCHES

48 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

NEOPIXEL STRIPS CURRENT DRAW

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 49

6TROUBLESHOOTING

For more help please check these linksProffieOSProffieBoardTeensySaber wiki on GitHubAsk your question on The Rebel Armory forumsAsk your question on FX-sabers forumsAsk your question in facebook group

How to solve most common issues

Quick troubleshooting tips

TeensySaber board or Proffieboard is not recognized by computer (nothing under Port selection in Arduino)

ndash Make sure a charged 37V battery is connected to the board micro-USB cable is a data transfer cable all plugins and drivers are installed ndash

check again pages 21 for TeensySaber or 40 for Proffieboard Try a different USB port on your computer

Sketch (code) compile error in Arduino IDE

ndash Check your define CONFIG_FILE ldquoconfig_confighrdquo line in opened lightsaberino file if itrsquos written correctly with config in it

Sketch (code) compile error in Arduino IDE

ndash Check if the _configh file you defined in the lightsaberino sketch file is same name as in the lightsaber-rdquofirmware versionrdquolightsaber

config folder and is located in this folder

Sketch (code) compile error in Arduino IDE

ndash Check your settings under Tools tab in Arduino IDE program Check again pages 21 for TeensySaber or 40 for Proffieboard

Sketch (code) compile error in Arduino IDE

ndash Check if your _configh file is correct Blade Styles Presets const unsigned int maxLedsPerStrip = 144 if BladeConfig blades[] = is correct

Sketch (code) compile error in Arduino IDE

ndash If nothing helps install Arduino IDE version 186 and try to compile and upload the firmware again

Sound doesnrsquot play

ndash Remove SD card and insert again check speaker wiring Make sure all sound files on SD card are correctly named (8 characters max long)

Re-format SD card in FAT32 load sound files and try again try another SD card

Board says ldquoLOW POWERrdquo

ndash Charge the battery

Serial Monitor shows info sent by the board but your commands donrsquot work

ndash In the bottom right corner of Serial Monitor window make sure the Line Ending drop down is set to New Line

Sound is weird and distorted

ndash Check your SD card speed (see page 44) Check speaker wiring try another good speaker

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 13

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

Basic Segmented string wiringldquoconfighrdquo file setup

ldquov3_confighrdquoNUM_BLADES 1NUM_BUTTONS 2VOLUME 1000CLASH_THRESHOLD_G 10StyleNormalPtrltCYAN WHITE 300 800gt()ltBlue3mmLED 20 White3mmLEDgt

TeensySaber V3 config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)Volume level (0-3000)Clash sensitivity (adjust lower or higher with 01 step)Blade styleLED string configuration(here you mention the color and type of leds usedin the main blade string segments and FoC string20 is the FoC signal pin (Blade ID pin))

Preset

LED string configuration

Use a given or build your wiring diagram on THIS PAGE then open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text

Editor (Notepad - to see code correctly in Notepad Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all

text) and Delete it then Copy-and-Paste (Ctrl+C Ctrl+V) your wiring diagram config code (example below) into empty _configh file and

Save it under new name Follow the instructions on page 22 to upload it to the board

14 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

Accent LEDs wiring diagram(optional)

Accent LEDs work with TeensySaber board as additional ldquobladesrdquo when powered by LED outputs 4 5 6 with FETs So they can have any effect

that blade can have If no effects needed accent led can be powered just by a 33V output pad (power-on led indication)

30-32 AWGRGB ledcommon-anode

4 ldquobladesrdquo1 main and 3 accent leds

main blade style (effects) main blade style (effects)

3 accent leds style (effects)accent led style (effects)

3 accent leds configurations

RGB accent led configuration

2 ldquobladesrdquo1 main and 1 RGB accent led

ldquoPower-onrdquo indicationaccent leds (no effects)

3 accent leds withindependent effects

+ 1 or more simple accent leds without effects

1 RGB accent led+ 1 or more simple accent leds

without effects

a) b)

b)

c)

c)

solder 3x FETs solder 3x FETs

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 15

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

OLED display wiring diagram(optional)

SSD1306 128x32 pixels OLED display allows to show battery level current preset name play different animations and even simple games It

can be wired to any blade configuration and requires just one additional line in the code to work You can get monochrome display in white

or blue color

SSD1306128x32OLED

SSD1306 ndash with blue or white display color selectSSD1306 ndash cheaper priceSSD1306 just screen ndash blue or white select

30-32 AWG

30-32 AWG

add this line to enable OLED display

display shows a preset name written in these quotes ldquoldquo

16 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

Bluetooth module wiring diagram(optional)

SOON

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 17

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

Blade ID resistor functions(optional)

SOON

18 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

website TeensySaber V3 FULL wiring diagrams link

Scroll the page down till you see the interactive diagram Above the diagram there are components selection options Build your saber setup

with it and follow diagram to wire your board Then you need to copy the configuration code below and paste it into your _configh file

Choose components you want

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

More wiring diagrams

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 19

20 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

How to use it

Blade ignitionretraction ndash assuming you have at least one button pressing it briefly should turn the saber on or off If you have an AUX button pressing it briefly should also turn the saber on and off If you have no buttons you can turn the saber on and off by twisting your wrist back and forth Note that the motion has to be done long enough to count so a very quick flick of the wrist will not workTurn On muted ndash double-click power buttonNext preset ndash while saber is off click the AUX buttonPrevious preset ndash hold AUX button and click the Activation buttonTrigger Clash ndash while saber is on hit the bladeTrigger Lockup ndash while saber is on hold Activation button then trigger a clash Lockup releases when you let go of the Acti-vation buttonTrigger Drag ndash like lockup but point saber mostly down before holding Activation buttonTrigger Force ndash long-click AUX buttonStart soundtrack ndash long-click the Activation buttonTrigger Blaster Block ndash while saber is on short-click AUX button

Serial Monitor commands

battery_voltage ndash gets current battery voltage valueget_volume ndash get current volume valuepow ndash power OnOff the saberon ndash power On the saberoff ndash power Off the saberset_volume lt0-3000gt ndash set volume value (example set_volume 500)play ndash play the default preset trackplay trackslttrack namegt ndash play a specific track from tracks folder (example play tracksvenuswav)stop ndash stop the playing trackforce ndash play ldquoforcerdquo sound effectsdrag ndash play ldquodragrdquo sound effectsblast ndash play ldquoblasterrdquo sound effectslock ndash play ldquolockuprdquo sound effectsclash ndash play ldquoclashrdquo sound effectsreset ndash reboot the boardn ndash switch to next presetp ndash switch to previous presetlist_presets ndash show all presetssdtest ndash test SD card speed

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 21

2TEENSYSABER V3 INSTRUCTIONS

FIRMWARE UPLOAD AND UPDATE2

Software installation and setup

To upload firmware to TeensySaber board Arduino IDE program is required Follow these steps to install it to your PC

1 Install latest Arduino IDE software (donrsquot use BETA)

Installing as Windows app also is not recommended

because it will be installed in a specific protected folder that

wonrsquot allow you to install Teensyduino software in it

If TeensySaber wonrsquot show up in COM port use

Arduino IDE 186 version

2 Install latest Teensyduino software in same directory

usually itrsquos CProgram Files (x86)Arduino on Windows

Follow installation instructions for your system

3 Select Teensy 32 31 in Tools -gt Board

USB Type ndash Serial CPU Speed ndash 96 MHz (overclock) Optimize ndash Smallest Code Port ndash COM(the number your PC assigned) (Teensy 32) Serial

Connect TeensySaber via USB cable to PC to be able to select

the Port donrsquot forget to connect battery first

22 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

1 Download the TeensySaber firmware and SD card content

Unzip lightsaber-1286zip to your Documents directory or to

Desktop but not to Arduino program folder or anywhere in

Programs directory where all programs are installed You will

see a lightsaber folder and files inside it Donrsquot move any of

these files to any other location outside the lightsaber folder

and donrsquot reorganize them Unzip ProffieOS_SD_Cardzip to the

folder where you keep lightsaber-1286 folder Copy all files

from ProffieOS_SD_Card folder to your SD card

2 Unhide file extensions in File Explorer settings to see h ending

of config files Donrsquot add ldquohrdquo to the config file name

Go to config folder and create you own configh file (see page

23 for how-to)

Double-click the lightsaberino file

3 Add the name of your configh file as shown and Save this

lightsaberino file Make sure the other config files are

commented out there should be only one CONFIG_FILE

without You can have multiple config files

in lightsabergtconfig folder and just define the one you need

in lightsaberino file and upload it again to TeensySaber board

4 Connect battery to TeensySaber board and hook up to your PC

with a data transfer micro-USB-to-USB cable

Press arrow button it will compile and upload firmware to the

board Wait for your PC to make a sound or TeensySaber will

play boot sound if speaker is connected Now you can unplug

the USB cable Done

If it gives an error instead this means your configh file has

issues define CONFIG_FILE name has mistakes configh file

is out of config folder your PC user name is non-latin

2TEENSYSABER V3 INSTRUCTIONS

FIRMWARE UPLOAD AND UPDATE2

Uploading firmware

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 23

2TEENSYSABER V3 INSTRUCTIONS

CHANGING PARAMETERS3

Changing sound board parameters

All sound files (sound fonts music tracks) are stored on the micro SD card Add required sound fonts folders (Plecter NEC and Smoothswing

fonts are supported no need to change WAV files names just copy and paste) to SD card root directory as itrsquos done in the default

ProffieOS_SD_Card content folder and music tracks to the tracks folder

Make sure to name all music tracks and sound fonts folders with latin characters and only up to 8 characters long without using any special

characters (like |[- etc)

Make sure you have a configini file in each sound font folder if there is none - copy one from some default TeensySaberProffieBoard sound

font and paste into newly added sound font folder It has only one parameter that you can modify - humstart It helps to match hum sound

start with blade ignition 1000 usually works fine

All blade effects LED configuration volume level clash sensitivity etc are changed in the configh file located in lightsabergtconfig folder

To do that open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text Editor (Notepad - to see code correctly in Notepad

Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all text) and Delete it then Copy-and-Paste (Ctrl+C

Ctrl+V) your wiring diagram config code into empty _configh file and Save it under new name Follow the instructions on page 22 to

upload it to the board

TeensySaber V3 config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)

volume level (0-3000)

clash sensitivity (adjust lower or higher with 01 step)

sound font folder nametrack name

Preset name

Blade style

LED configuration (use these XP-E2 LED templatesto define your LED)

for Red use 1 Ohm resistor for Green - no resistor for Blue use 024 Ohm

NoLED ndash no 4th led used

Preset 1

24 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

31

PROFFIEBOARD INSTRUCTIONS

Whatrsquos needed

ndash ProffieBoard

ndash micro SD-card (see page 44 for recommendations)

ndash a USB micro SD-card reader (to load sound files from PC to micro SD card)

ndash micro USB data transfer cable (CABLES THAT SUPPORT ONLY CHARGING WONrsquoT WORK)

ndash wires of different gauges (32-20 AWG) (PTFE coated copper stranded wires recommended) heat shrink

ndash ESD safe soldering station solder wire flux etc

ndash pliers helping hands etc

ndash isopropyl alcohol to clean pads before soldering (helps solder to stick better)

ndash Digital Multimeter (VERY USEFUL)

ndash computer running Windows Linux or Mac OS with internet access

ndash 37V Li-Ion Protected rechargeable battery switches recharge port speaker LEDs resistors chassis etc

ndash Smart Li-Ion CC-CV (Constant Current - Constant Voltage mode) battery charger for 37V (42V) cells

ndash patience

WIRING DIAGRAMS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 25

31

PROFFIEBOARD INSTRUCTIONS

Board pinout

Battery + ndash 26 to 45 volt input drives everything except the LEDs

Battery - ndash negative pad for LEDs needs to be at same level as GND when both are connected Both pads are internally connected

GND ndash ground for electronics except LEDs Note that there are two GND pads on the board that are internally connected

Speaker +- ndash hooks up to speaker

Activation (1) Aux (2) Aux2 button (3) ndash hook up to closing buttons or potentially touch buttons

Blade ID Neopixel Data 1 ndash normally used to measure the blade ID restor and if itrsquos a neopixel blade feed out neopixel data

Data 2 3 4 5 ndash additional neopixel data outputs or free for other purposes

LED 1 2 3 4 5 6 ndash hooks up to negative side of LED (positive side of LED hooks up directly to battery) These pads can handle

up to 30 volts

SDA SCL ndash these pins are used to wire OLED display or to communicate with the gyro and accelerometer chip

RX TX ndash these pins are used for wiring a bluetooth module for wireless control

SWDCLK SWDIO ndash can be hooked up to a ST-LINK device and lets you debug programs running on the ProffieBoard

+5V ndash generated by the ProffieBoard normally itrsquos only ON when sound is playing

+33V ndash generated by the ProffieBoard for powering OLED display Bluetooth module or some accent leds

BOOT RESET ndash buttons to put the ProffieBoard in bootloader mode if uploading doesnrsquot work

micro USB port ndash micro USB port used only for firmware upload and can be used for sound files upload to SD card (from firmware version

1291 and up) THIS PORT ISNrsquoT USED FOR CHARGING THE BATTERY

LED 4LED 3

LED 2

LED 1

LED 5

LED 6

RESETBOOT

Battery - Battery -

Speaker + (red dot or ldquo+rdquo mark on speaker)

Battery +

Aux button (2)Activation button (1)

Aux2 button (3)

Blade ID Neopixel Data 1

Data 5

Data 4Data 3Data 2

+33V

SWDIO

SWDCLK

+5V

TXRX

GND

GND

Reset

Speaker -

SCLSDA

micro USB port

WIRING DIAGRAMS

26 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Basic Tri-Cree wiring diagram(In-hilt LED)

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

+

+

-

-

26 AWG

26 A

WG

30-32 AWG

28-30 AWG

28-3

0 A

WG

30-32 AWG

Protected 36-37V (42V max at full charge) 10A 3500mAh battery recommended+18650 battery holder (optional)Keystone 1042P

AV switch with accent led(constantly ON no effects)

accent leds run mostly at10-15mA so resistors for them must be calculated accordingly

Main RGB led

additional RGB leds(optional)

In case no additional high power leds are needed LED channels 4 5 6 can be used for 3 controllable(programmable for different effects) accent leds So AV switch led can be wired to one of these channelsAccent leds also can be wired to Data pads 1-5 please see ldquoAccent LEDs wiring and setuprdquo page

LED Resistor Calculator

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 27

3WIRING DIAGRAMS1

Basic Tri-Cree wiring (In-hilt LED)ldquoconfighrdquo file setup

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

Use a given or build your wiring diagram on THIS PAGE then open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text

Editor (Notepad - to see code correctly in Notepad Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all

text) and Delete it then Copy-and-Paste (Ctrl+C Ctrl+V) your wiring diagram config code (example below) into empty _configh file and

Save it under new name Follow the instructions on page 22 to upload it to the board

ldquoproffieboard_v1_confighrdquoNUM_BLADES 2NUM_BUTTONS 2VOLUME 1000CLASH_THRESHOLD_G 10StyleNormalPtrltCYAN WHITE 300 800gt()StyleNormalPtrltCYAN WHITE 300 800gt()

CreeXPE2RedTemplatelt1000gtCreeXPE2GreenTemplatelt0gtCreeXPE2BlueTemplatelt240gtNoLED

ProffieBoard config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)Volume level (0-3000)Clash sensitivity (adjust lower or higher with 01 step)ldquoBlade 1rdquo styleldquoBlade 2rdquo style (in case only 1 blade is used you donrsquot need this line)LED configuration (use these XP-E2 LED templatesto define your LED If other LED resistors are used change these values to match Ohm1000=ltvaluegt)

where 1000 is 1 Ohm resistor 0 is no resistor240 is 024 Ohm resistorNoLED ndash no 4th led used

Preset 1

LED 1 configuration

LED 2 configuration

Preset 2 etc

PROFFIEBOARD INSTRUCTIONS

28 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Basic Neopixel wiring diagram

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

+

+

-

-

22 A

WG

22 AWG

x2 28 AWG

x2 26 AWG

22 A

WG

30-32 AWG30-32 AWG

Protected 36-37V (42V max at full charge) 10A 3500mAh or 15A 3120mAhbattery recommended+18650 battery holder (optional)Keystone 1042P

AV switch with accent led(constantly ON no effects)

accent leds run mostly at10-15mA so resistors for them must be calculated accordingly

Main Neopixel strip

additional Neopixelstrips(optional)

Neopixel bladeconnector

330 Ohm on the Blade pcb side

x3 28 AWGor x1 22 AWGfor Negative

330 Ohm on the Blade pcb side

arrows up

330 Ohm on the Blade pcb side

In case no additional Neopixel strips are needed LED channels 4 5 6 can be used for 3 controllable(programmable for different effects) accent leds So AV switch led can be wired to one of these channelsAccent leds also can be wired to Data pads 2-5 please see ldquoAccent LEDs wiring and setuprdquo page

Recommended power wire gauges (22 AWG) are given for 2-strip blade For 3-strip blade you gonna need at least 20 AWG wires

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 29

ldquoproffieboard_v1_confighrdquo

3WIRING DIAGRAMS1

Basic Neopixel wiringldquoconfighrdquo file setup

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

NUM_BLADES 3NUM_BUTTONS 2VOLUME 1000CLASH_THRESHOLD_G 10IgnitionDelaylt0 any blade stylegtIgnitionDelaylt800 any blade stylegtIgnitionDelaylt800 any blade stylegtWS2811BladePtrlt118 WS2811 800kHz | WS2811 GRBgt()WS2811BladePtrlt26 blade2Pin ltbladePowerPin4gtgt()WS2811BladePtrlt26 blade3Pin ltbladePowerPin5gtgt()

ProffieBoard config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)Volume level (0-3000)Clash sensitivity (adjust lower or higher with 01 step)ldquoBlade 1rdquo style (main blade with IgnitionDelay 0)ldquoBlade 2rdquo style (CG blade 1 with IgnitionDelay 800)ldquoBlade 3rdquo style (CG blade 2 with IgnitionDelay 800)

strip configuration (defines how many pixels it has and to which LED output and pin is wired)

Preset 1

any blade style

strip (blade) 1 configuration

adjust this number to match your strips leds count

strip (blade) 2 configuration

strip (blade) 3 configuration

Preset 2 etc

Use a given or build your wiring diagram on THIS PAGE then open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text

Editor (Notepad - to see code correctly in Notepad Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all

text) and Delete it then Copy-and-Paste (Ctrl+C Ctrl+V) your wiring diagram config code (example below) into empty _configh file and

Save it under new name Follow the instructions on page 22 to upload it to the board

PROFFIEBOARD INSTRUCTIONS

30 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Basic Segmented string wiring diagram

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

+

+

-

-

24 A

WG

28 AWG

30-32 AWG30-32 AWG

Protected 36-37V (42V max at full charge) 10A 3500mAh battery recommended+18650 battery holder (optional)Keystone 1042P

AV switch with accent led(constantly ON no effects)

accent leds run mostly at10-15mA so resistors for them must be calculated accordingly

6-segments string blade

FoC string

N-channel FET3A minimum

123456

Calculate resistors for each led segment of the blade string depending on which leds are used 5mm leds have max drive current around 25mA per led when 10mm leds can be 100mA and 200mA per ledSo pay attention to your led max current and Forward Voltage (Vf) when calculating a segment resistor resistence as well as its wattage Also choose wire gauges accordingly to meet segments and total blade max current draw level

LED Resistor Calculator

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 31

ldquoproffieboard_v1_confighrdquo

3WIRING DIAGRAMS1

Basic Segmented string wiringldquoconfighrdquo file setup

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

NUM_BLADES 1NUM_BUTTONS 2VOLUME 1000CLASH_THRESHOLD_G 10StyleNormalPtrltCYAN WHITE 300 800gt()ltBlue3mmLED BladePin White3mmLEDgt

ProffieBoard config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)Volume level (0-3000)Clash sensitivity (adjust lower or higher with 01 step)Blade styleLED string configuration(here you mention the color and type of leds usedin the main blade string segments and FoC stringBladePin is the FoC signal pin (Blade ID pin))

Preset

LED string configuration

Use a given or build your wiring diagram on THIS PAGE then open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text

Editor (Notepad - to see code correctly in Notepad Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all

text) and Delete it then Copy-and-Paste (Ctrl+C Ctrl+V) your wiring diagram config code (example below) into empty _configh file and

Save it under new name Follow the instructions on page 22 to upload it to the board

PROFFIEBOARD INSTRUCTIONS

32 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Accent LEDs wiring diagram(optional)

Accent LEDs work with ProffieBoard as additional ldquobladesrdquo when powered by LED outputs 4 5 6 or Data pads 1 2 3 5 as PWM So they can

have any effect that blade can have If no effects needed accent led can be powered just by a 33V output pad (power-on led indication)

30-32 AWG

with Neopixel blade setup these 4 outputsdonrsquot work for regular accent leds

Recommended resistors to use for accent leds at 33V power source and 15mA drive

ndash 100 Ohm for Red (lt100000gt value in the code)ndash 13 Ohm for Green (lt13000gt value in the code)ndash 13 Ohm for Blue (lt13000gt value in the code)ndash 100 Ohm for Yellow (lt100000gt value in the code)ndash 20 Ohm for White (lt20000gt value in the code)

RGB ledcommon-anode

8 ldquobladesrdquo1 main and 7 accent leds

main blade style (effects) main blade style (effects)

7 accent leds style (effects)accent led style (effects)

7 accent leds configurations

RGB accent led configuration

2 ldquobladesrdquo1 main and 1 RGB accent led

ldquoPower-onrdquo indicationaccent leds (no effects)

7 accent leds withindependent effects

RGB accent led

a) b)

b)

c)

c)

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 33

3WIRING DIAGRAMS1

Neopixel Accent LEDs wiring diagram(optional)

With Neopixel setup additional neopixel leds or arrays can be used as accent leds There are 2 ways to wire them using additional Data

pins 2 3 4 5 or ldquoSub-bladesrdquo wiring with just 1 Data output pin Same way Neopixel connectors with on-board leds ca be wired

Option 1 ndash with extra Data pins

Main Blade

some accent leds

D1

D2

crystal leds

330 Ohm

330 Ohm

330 Ohm

main blade style (effects)

main blade 144 leds Data pin 1

accent leds blade style (effects)

accent leds ldquobladerdquo 4 leds Data pin 2

crystal leds blade style (effects)

crystal leds ldquobladerdquo 2 leds Data pin 3

3 ldquobladesrdquo1 main 1 accent leds array and 1 crystal leds array

PROFFIEBOARD INSTRUCTIONS

D3

follow arrows direction

34 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Neopixel Accent LEDs wiring diagram(optional)

PROFFIEBOARD INSTRUCTIONS

Main Blade

some accent leds

1

3

5678

2

4

D1

crystal leds

follow arrows direction

330 Ohm

330 OhmData signal

With this setup a single array of neopixel leds is separated into a couple of sub-blades with their own style configuration and behaviour This

is really usefull when you want to use only one data pin More about ldquoSub-bladesrdquo on ProffieOS wiki page

Option 2 ndash with ldquoSub-bladesrdquo

main blade style (effects)

main blade sub-blade 140 leds (7-146) but from 6 to 145 in the code

accent leds blade style (effects)

accent leds sub-blade 4 leds (1-4) but from 0 to 3 in the code

crystal leds blade style (effects)

146 leds total used

crystal leds sub-blade 2 leds (5-6) but from 4 to 5 in the code

update default 144 to a higher total value if you get all accent leds +Main blade gt 144 Example update to 146 if you have 2 crystal leds +4 accent leds + 140 Main blade leds = 146

3 ldquobladesrdquo 1 main 1 accent leds array and 1 crystal leds array

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 35

3WIRING DIAGRAMS1

OLED display wiring diagram(optional)

SSD1306 128x32 pixels OLED display allows to show battery level current preset name play different animations and even simple games It

can be wired to any blade configuration and requires just one additional line in the code to work You can get monochrome display in white

or blue color

SSD1306128x32OLED

SSD1306 ndash with blue or white display color selectSSD1306 ndash cheaper priceSSD1306 just screen ndash blue or white select

30-32 AWG

30-32 AWG

add this line to enable OLED display

display shows a preset name written in these quotes ldquoldquo

PROFFIEBOARD INSTRUCTIONS

36 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Bluetooth module wiring diagram(optional)

SOON

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 37

3WIRING DIAGRAMS1

Blade ID resistor functions(optional)

SOON

PROFFIEBOARD INSTRUCTIONS

38 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

website ProffieBoard FULL wiring diagrams link

Scroll the page down till you see the interactive diagram Above the diagram there are components selection options Build your saber setup

with it and follow diagram to wire your board Then you need to copy the configuration code below and paste it into your _configh file

Choose components you want

3WIRING DIAGRAMS1

More wiring diagrams

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 39

3WIRING DIAGRAMS1

How to use it

PROFFIEBOARD INSTRUCTIONS

Blade ignitionretraction ndash assuming you have at least one button pressing it briefly should turn the saber on or off If you have an AUX button pressing it briefly should also turn the saber on and off If you have no buttons you can turn the saber on and off by twisting your wrist back and forth Note that the motion has to be done long enough to count so a very quick flick of the wrist will not workTurn On muted ndash double-click power buttonNext preset ndash while saber is off click the AUX buttonPrevious preset ndash hold AUX button and click the Activation buttonTrigger Clash ndash while saber is on hit the bladeTrigger Lockup ndash while saber is on hold Activation button then trigger a clash Lockup releases when you let go of the Acti-vation buttonTrigger Drag ndash like lockup but point saber mostly down before holding Activation buttonTrigger Force ndash long-click AUX buttonStart soundtrack ndash long-click the Activation buttonTrigger Blaster Block ndash while saber is on short-click AUX button

Serial Monitor commands

battery_voltage ndash gets current battery voltage valueget_volume ndash get current volume valuepow ndash power OnOff the saberon ndash power On the saberoff ndash power Off the saberset_volume lt0-3000gt ndash set volume value (example set_volume 500)play ndash play the default preset trackplay trackslttrack namegt ndash play a specific track from tracks folder (example play tracksvenuswav)stop ndash stop the playing trackforce ndash play ldquoforcerdquo sound effectsdrag ndash play ldquodragrdquo sound effectsblast ndash play ldquoblasterrdquo sound effectslock ndash play ldquolockuprdquo sound effectsclash ndash play ldquoclashrdquo sound effectsreset ndash reboot the boardn ndash switch to next presetp ndash switch to previous presetlist_presets ndash show all presetssdtest ndash test SD card speed

40 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3FIRMWARE UPLOAD AND UPDATE2

Software installation and setup

PROFFIEBOARD INSTRUCTIONS

To upload firmware to ProffieBoard Arduino IDE program is required Follow these steps to install it to your PC

1 Install latest Arduino IDE software (donrsquot use BETA)

Installing as Windows app also is not recommended

because it will be installed in a specific protected folder that

wonrsquot allow you to install any additional softwareplugin in it

If ProffieBoard wonrsquot show up in COM port use

Arduino IDE 186 version

2 Install the Proffieboard Arduino Plugin and Zadig software

Follow installation instructions

3 Select Proffieboard-STM32L433 in Tools -gt Board

USB Type ndash Serial CPU Speed ndash 80 MHz Optimize ndash Smallest Code DOSFS ndash SDCARD (SPI) Port ndash COM(the number your PC assigned) (Butterfly-L433CC)

Connect Proffieboard via USB cable to PC to be able to select

the Port

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 41

3FIRMWARE UPLOAD AND UPDATE2

Uploading firmware

PROFFIEBOARD INSTRUCTIONS

1 Download the ProffieBoard firmware and SD card content

Unzip lightsaber-1286zip to your Documents directory or to

Desktop but not to Arduino program folder or anywhere in

Programs directory where all programs are installed You will

see a lightsaber folder and files inside it Donrsquot move any of

these files to any other location outside the lightsaber folder

and donrsquot reorganize them Unzip ProffieOS_SD_Cardzip to the

folder where you keep lightsaber-1286 folder Copy all files

from ProffieOS_SD_Card folder to your SD card

2 Unhide file extensions in File Explorer settings to see h ending

of config files Donrsquot add ldquohrdquo to the config file name Go to config folder and create you own configh file (see page

42 for how-to)

Double-click the lightsaberino file

3 Add the name of your configh file as shown and Save this

lightsaberino file Make sure the other config files are

commented out there should be only one CONFIG_FILE

without You can have multiple config files

in lightsabergtconfig folder and just define the one you need

in lightsaberino file and upload it again to ProffieBoard

4 Connect battery to ProffieBoard and hook up to your PC

with a data transfer micro-USB-to-USB cable

Press arrow button it will compile and upload firmware to the

board Wait for red text progress bars to stop at 100

ProffieBoard will play boot sound if speaker is connected

Now you can unplug the USB cable Done

If it gives an error instead this means your configh file has

issues define CONFIG_FILE name has mistakes configh file

is out of config folder your PC user name is non-latin

42 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

33

configh file structure editing

PROFFIEBOARD INSTRUCTIONS

CHANGING PARAMETERS

All sound files (sound fonts music tracks) are stored on the micro SD card Add required sound fonts folders (Plecter NEC and Smoothswing

fonts are supported no need to change WAV files names just copy and paste) to SD card root directory as itrsquos done in the default

ProffieOS_SD_Card content folder and music tracks to the tracks folder

Make sure to name all music tracks and sound fonts folders with latin characters and only up to 8 characters long without using any special

characters (like |[- etc)

Make sure you have a configini file in each sound font folder if there is none - copy one from some default TeensySaberProffieBoard sound

font and paste into newly added sound font folder It has only one parameter that you can modify - humstart It helps to match hum sound

start with blade ignition 1000 usually works fine

All blade effects LED configuration volume level clash sensitivity etc are changed in the configh file located in lightsabergtconfig folder

To do that open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text Editor (Notepad - to see code correctly in Notepad

Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all text) and Delete it then Copy-and-Paste (Ctrl+C

Ctrl+V) your wiring diagram config code into empty _configh file and Save it under new name Follow the instructions on page 39 to

upload it to the board

Proffieboard config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)

volume level (0-3000)

clash sensitivity (adjust lower or higher with 01 step)

sound font folder nametrack name

Preset name

Blade style

LED configuration (use these XP-E2 LED templatesto define your LED)

for Red use 1 Ohm resistor for Green - no resistor for Blue use 024 Ohm

NoLED ndash no 4th led used

Preset 1

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 43

33

Blade Styles

StylePtrltInOutHelperltSimpleClashltLockupltBlastltOnSparkltAudioFlickerltRgblt02550gtRgblt501000gtgtRgblt2552550gt150gtRgblt255500gtgtAudioFlickerltRgblt1002550gtRgblt2550150gtgtgtRgblt255100150gt40gt200300Blackgtgt

ndash this is how the Blade Style code looks pasted in the configh file Preset (it sits inside a StylePtrltgt container)

ndash this is how the Blade Style code looks when editing it inside a Blade Style Editor

Each Blade Style is made of a variety of Effects each added effect goes instead of a base color in the previous effect

PROFFIEBOARD INSTRUCTIONS

CHANGING PARAMETERS

ProffieBoard and TeensySaber use Blade Styles for the main saber blade and any other accent leds to define all light effects (color changing

flashes flickering delays ignitionretraction timing etc)

Use Blade Style Editor to create and adjust Blade Styles Megtooth Sith Sabers did a great video tutorial where he shows and explains

how to use Blade Style Editor Also you can grab some pre-made Blade Styles or share yours here on TRA forums

A Blade Style example of simple flickering Green blade with Spark on start Clash Blaster Lockup and Drag IgnitionRetraction effects

InOutHelperltSimpleClashltLockupltBlastltOnSparkltAudioFlickerltRgblt02550gtRgblt501000gtgtRgblt2552550gt150gtRgblt255500gtgtAudioFlickerltRgblt1002550gtRgblt2550150gtgtgtRgblt255100150gt40gt200300Blackgt

InOutHelperltbase color200300Blackgt ndash base color can be defined by words (WHITE RED GREEN PURPLE etc) or by Rgblt0-2550-2550-255gt values for more

custom shades 200 is extension length in milliseconds 300 is retraction length in milliseconds Black is color when retracted (also can be any other color)

SimpleClashltbase colorclash color40gt ndash clash effect 40 is clash duration in milliseconds

Lockupltbase colorlockup colorgt ndash lockup effect

Blastltbase colorblast colorgt ndash blaster effect

OnSparkltbase colorspark color150gt ndash spark on ignition effect 150 is spark duration in milliseconds

AudioFlickerltrdquoArdquo colorrdquoBrdquo colorgt ndash flickering effect (blade flickers to the actual saber hum sound) the more difference between ldquoArdquo and ldquoBrdquo colors - the more

abrupt is flickering

Rgblt255500gt ndash actual color in RGB format (0 is no light 255 is the maximum brightness value for Red Green or Blue channel)

44 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

ndash SanDisk 4GB microSDHC Class 4 (Genuine) ndash SanDisk 4GB microSDHC Class 4 (Genuine)

130238 kbs = 1477 simultaneous audio streams 137812 kbs = 1562 simultaneous audio streams

ndash Patriot LX Series 16GB microSDHC UHS-IU1 Class 10 ndash Patriot LX Series 16GB microSDHC UHS-IU1 Class 10

133005 kbs = 1508 simultaneous audio streams

ndash GSkill 16GB microSDHC UHS-IU1 Class 10 ndash GSkill 16GB microSDHC UHS-IU1 Class 10

129534 kbs = 1469 simultaneous audio streams

ndash Kingston 16GB microSDHC UHS-IU1 Class 10 ndash Kingston 16GB microSDHC UHS-IU1 Class 10

128090 kbs = 1452 simultaneous audio streams

ndash SanDisk Ultra 16GB microSDHC UHS-IU1 A1 Class 10 ndash SanDisk Ultra 16GB microSDHC UHS-IU1 A1 Class 10

102663 kbs = 1164 simultaneous audio streams 11124 kbs = 1261 simultaneous audio streams

ndash SanDisk 8GB microSDHC Class 4 ndash SanDisk 8GB microSDHC Class 4

108506 kbs = 1230 simultaneous audio streams

ndash SanDisk 16GB microSDHC Class 4 ndash SanDisk 16GB microSDHC Class 4

102663 kbs = 1164 simultaneous audio streams 106957 kbs = 1213 simultaneous audio streams

ndash SanDisk Ultra 16GB microSDHC UHS-IU1 Class 10 ndash SanDisk Ultra 16GB microSDHC UHS-IU1 Class 10

102663 kbs = 1164 simultaneous audio streams 103909 kbs = 1178 simultaneous audio streams

ndash Smartbuy 4GB microSDHC Class 4 ndash Smartbuy 4GB microSDHC Class 4

75437 kbs = 855 simultaneous audio streams

ndash Kingston 8GB microSDHC Class 4 ndash Kingston 8GB microSDHC Class 4

75209 kbs = 822 simultaneous audio streams

ndash SanDisk 4GB microSDHC Class 4 (Fake) ndash SanDisk 4GB microSDHC Class 4 (Fake)

677 kbs = 769 simultaneous audio streams

Here is a list of tested micro SD cards speed with TeensySaber V3 and ProffieBoard Any card with speed over 900 kbs is recommended the

higher the speed is ndash the better Memory size of 4-16Gb is more than enough Cards were tested with a default firmware (1291) compiled

with ldquoSmallest Coderdquo under Optimize ldquodefault_proffieboard_confighrdquo file and default ProffieOS SD card sound files (7 folders)

To test your SD card speed simply hook up ProffieBoard to PC open Arduino IDE go to Tools and open Serial Monitor make sure you have

New Line and 9600 baud rate selected on the bottom of Serial Monitor window type and send sdtest command wait for the test result

4Recommended micro SD cards

BEST

TEENSYSABER PROFFIEBOARD

GOOD

BAD

PROFFIEBOARD INSTRUCTIONS

SD CARD RECOMMENDATIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 45

There are a lot of fake (chinese copies) microSD cards on the market from aliexpress ebay amazon etc They look very similar to genuine

cards but are a bit different though and have a twice lower writingreading speed Here is an example of a SanDisk 4Gb Class 4 card one is

genuine with 137812 kbs speed and the other one is fake with 677 kbs speed I got from ebay seller

Be carefull and pay attention to how the actual card looks if you are not sure ask seller for the real photo of SD card he sells

4Genuine and Fake SanDisk 4Gb Class 4 microSD

PROFFIEBOARD INSTRUCTIONS

SD CARD RECOMMENDATIONS

46 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

WIRE GAUGE GUIDE

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 47

RECHARGE PORTS AND KILL SWITCHES

48 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

NEOPIXEL STRIPS CURRENT DRAW

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 49

6TROUBLESHOOTING

For more help please check these linksProffieOSProffieBoardTeensySaber wiki on GitHubAsk your question on The Rebel Armory forumsAsk your question on FX-sabers forumsAsk your question in facebook group

How to solve most common issues

Quick troubleshooting tips

TeensySaber board or Proffieboard is not recognized by computer (nothing under Port selection in Arduino)

ndash Make sure a charged 37V battery is connected to the board micro-USB cable is a data transfer cable all plugins and drivers are installed ndash

check again pages 21 for TeensySaber or 40 for Proffieboard Try a different USB port on your computer

Sketch (code) compile error in Arduino IDE

ndash Check your define CONFIG_FILE ldquoconfig_confighrdquo line in opened lightsaberino file if itrsquos written correctly with config in it

Sketch (code) compile error in Arduino IDE

ndash Check if the _configh file you defined in the lightsaberino sketch file is same name as in the lightsaber-rdquofirmware versionrdquolightsaber

config folder and is located in this folder

Sketch (code) compile error in Arduino IDE

ndash Check your settings under Tools tab in Arduino IDE program Check again pages 21 for TeensySaber or 40 for Proffieboard

Sketch (code) compile error in Arduino IDE

ndash Check if your _configh file is correct Blade Styles Presets const unsigned int maxLedsPerStrip = 144 if BladeConfig blades[] = is correct

Sketch (code) compile error in Arduino IDE

ndash If nothing helps install Arduino IDE version 186 and try to compile and upload the firmware again

Sound doesnrsquot play

ndash Remove SD card and insert again check speaker wiring Make sure all sound files on SD card are correctly named (8 characters max long)

Re-format SD card in FAT32 load sound files and try again try another SD card

Board says ldquoLOW POWERrdquo

ndash Charge the battery

Serial Monitor shows info sent by the board but your commands donrsquot work

ndash In the bottom right corner of Serial Monitor window make sure the Line Ending drop down is set to New Line

Sound is weird and distorted

ndash Check your SD card speed (see page 44) Check speaker wiring try another good speaker

14 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

Accent LEDs wiring diagram(optional)

Accent LEDs work with TeensySaber board as additional ldquobladesrdquo when powered by LED outputs 4 5 6 with FETs So they can have any effect

that blade can have If no effects needed accent led can be powered just by a 33V output pad (power-on led indication)

30-32 AWGRGB ledcommon-anode

4 ldquobladesrdquo1 main and 3 accent leds

main blade style (effects) main blade style (effects)

3 accent leds style (effects)accent led style (effects)

3 accent leds configurations

RGB accent led configuration

2 ldquobladesrdquo1 main and 1 RGB accent led

ldquoPower-onrdquo indicationaccent leds (no effects)

3 accent leds withindependent effects

+ 1 or more simple accent leds without effects

1 RGB accent led+ 1 or more simple accent leds

without effects

a) b)

b)

c)

c)

solder 3x FETs solder 3x FETs

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 15

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

OLED display wiring diagram(optional)

SSD1306 128x32 pixels OLED display allows to show battery level current preset name play different animations and even simple games It

can be wired to any blade configuration and requires just one additional line in the code to work You can get monochrome display in white

or blue color

SSD1306128x32OLED

SSD1306 ndash with blue or white display color selectSSD1306 ndash cheaper priceSSD1306 just screen ndash blue or white select

30-32 AWG

30-32 AWG

add this line to enable OLED display

display shows a preset name written in these quotes ldquoldquo

16 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

Bluetooth module wiring diagram(optional)

SOON

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 17

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

Blade ID resistor functions(optional)

SOON

18 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

website TeensySaber V3 FULL wiring diagrams link

Scroll the page down till you see the interactive diagram Above the diagram there are components selection options Build your saber setup

with it and follow diagram to wire your board Then you need to copy the configuration code below and paste it into your _configh file

Choose components you want

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

More wiring diagrams

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 19

20 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

How to use it

Blade ignitionretraction ndash assuming you have at least one button pressing it briefly should turn the saber on or off If you have an AUX button pressing it briefly should also turn the saber on and off If you have no buttons you can turn the saber on and off by twisting your wrist back and forth Note that the motion has to be done long enough to count so a very quick flick of the wrist will not workTurn On muted ndash double-click power buttonNext preset ndash while saber is off click the AUX buttonPrevious preset ndash hold AUX button and click the Activation buttonTrigger Clash ndash while saber is on hit the bladeTrigger Lockup ndash while saber is on hold Activation button then trigger a clash Lockup releases when you let go of the Acti-vation buttonTrigger Drag ndash like lockup but point saber mostly down before holding Activation buttonTrigger Force ndash long-click AUX buttonStart soundtrack ndash long-click the Activation buttonTrigger Blaster Block ndash while saber is on short-click AUX button

Serial Monitor commands

battery_voltage ndash gets current battery voltage valueget_volume ndash get current volume valuepow ndash power OnOff the saberon ndash power On the saberoff ndash power Off the saberset_volume lt0-3000gt ndash set volume value (example set_volume 500)play ndash play the default preset trackplay trackslttrack namegt ndash play a specific track from tracks folder (example play tracksvenuswav)stop ndash stop the playing trackforce ndash play ldquoforcerdquo sound effectsdrag ndash play ldquodragrdquo sound effectsblast ndash play ldquoblasterrdquo sound effectslock ndash play ldquolockuprdquo sound effectsclash ndash play ldquoclashrdquo sound effectsreset ndash reboot the boardn ndash switch to next presetp ndash switch to previous presetlist_presets ndash show all presetssdtest ndash test SD card speed

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 21

2TEENSYSABER V3 INSTRUCTIONS

FIRMWARE UPLOAD AND UPDATE2

Software installation and setup

To upload firmware to TeensySaber board Arduino IDE program is required Follow these steps to install it to your PC

1 Install latest Arduino IDE software (donrsquot use BETA)

Installing as Windows app also is not recommended

because it will be installed in a specific protected folder that

wonrsquot allow you to install Teensyduino software in it

If TeensySaber wonrsquot show up in COM port use

Arduino IDE 186 version

2 Install latest Teensyduino software in same directory

usually itrsquos CProgram Files (x86)Arduino on Windows

Follow installation instructions for your system

3 Select Teensy 32 31 in Tools -gt Board

USB Type ndash Serial CPU Speed ndash 96 MHz (overclock) Optimize ndash Smallest Code Port ndash COM(the number your PC assigned) (Teensy 32) Serial

Connect TeensySaber via USB cable to PC to be able to select

the Port donrsquot forget to connect battery first

22 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

1 Download the TeensySaber firmware and SD card content

Unzip lightsaber-1286zip to your Documents directory or to

Desktop but not to Arduino program folder or anywhere in

Programs directory where all programs are installed You will

see a lightsaber folder and files inside it Donrsquot move any of

these files to any other location outside the lightsaber folder

and donrsquot reorganize them Unzip ProffieOS_SD_Cardzip to the

folder where you keep lightsaber-1286 folder Copy all files

from ProffieOS_SD_Card folder to your SD card

2 Unhide file extensions in File Explorer settings to see h ending

of config files Donrsquot add ldquohrdquo to the config file name

Go to config folder and create you own configh file (see page

23 for how-to)

Double-click the lightsaberino file

3 Add the name of your configh file as shown and Save this

lightsaberino file Make sure the other config files are

commented out there should be only one CONFIG_FILE

without You can have multiple config files

in lightsabergtconfig folder and just define the one you need

in lightsaberino file and upload it again to TeensySaber board

4 Connect battery to TeensySaber board and hook up to your PC

with a data transfer micro-USB-to-USB cable

Press arrow button it will compile and upload firmware to the

board Wait for your PC to make a sound or TeensySaber will

play boot sound if speaker is connected Now you can unplug

the USB cable Done

If it gives an error instead this means your configh file has

issues define CONFIG_FILE name has mistakes configh file

is out of config folder your PC user name is non-latin

2TEENSYSABER V3 INSTRUCTIONS

FIRMWARE UPLOAD AND UPDATE2

Uploading firmware

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 23

2TEENSYSABER V3 INSTRUCTIONS

CHANGING PARAMETERS3

Changing sound board parameters

All sound files (sound fonts music tracks) are stored on the micro SD card Add required sound fonts folders (Plecter NEC and Smoothswing

fonts are supported no need to change WAV files names just copy and paste) to SD card root directory as itrsquos done in the default

ProffieOS_SD_Card content folder and music tracks to the tracks folder

Make sure to name all music tracks and sound fonts folders with latin characters and only up to 8 characters long without using any special

characters (like |[- etc)

Make sure you have a configini file in each sound font folder if there is none - copy one from some default TeensySaberProffieBoard sound

font and paste into newly added sound font folder It has only one parameter that you can modify - humstart It helps to match hum sound

start with blade ignition 1000 usually works fine

All blade effects LED configuration volume level clash sensitivity etc are changed in the configh file located in lightsabergtconfig folder

To do that open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text Editor (Notepad - to see code correctly in Notepad

Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all text) and Delete it then Copy-and-Paste (Ctrl+C

Ctrl+V) your wiring diagram config code into empty _configh file and Save it under new name Follow the instructions on page 22 to

upload it to the board

TeensySaber V3 config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)

volume level (0-3000)

clash sensitivity (adjust lower or higher with 01 step)

sound font folder nametrack name

Preset name

Blade style

LED configuration (use these XP-E2 LED templatesto define your LED)

for Red use 1 Ohm resistor for Green - no resistor for Blue use 024 Ohm

NoLED ndash no 4th led used

Preset 1

24 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

31

PROFFIEBOARD INSTRUCTIONS

Whatrsquos needed

ndash ProffieBoard

ndash micro SD-card (see page 44 for recommendations)

ndash a USB micro SD-card reader (to load sound files from PC to micro SD card)

ndash micro USB data transfer cable (CABLES THAT SUPPORT ONLY CHARGING WONrsquoT WORK)

ndash wires of different gauges (32-20 AWG) (PTFE coated copper stranded wires recommended) heat shrink

ndash ESD safe soldering station solder wire flux etc

ndash pliers helping hands etc

ndash isopropyl alcohol to clean pads before soldering (helps solder to stick better)

ndash Digital Multimeter (VERY USEFUL)

ndash computer running Windows Linux or Mac OS with internet access

ndash 37V Li-Ion Protected rechargeable battery switches recharge port speaker LEDs resistors chassis etc

ndash Smart Li-Ion CC-CV (Constant Current - Constant Voltage mode) battery charger for 37V (42V) cells

ndash patience

WIRING DIAGRAMS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 25

31

PROFFIEBOARD INSTRUCTIONS

Board pinout

Battery + ndash 26 to 45 volt input drives everything except the LEDs

Battery - ndash negative pad for LEDs needs to be at same level as GND when both are connected Both pads are internally connected

GND ndash ground for electronics except LEDs Note that there are two GND pads on the board that are internally connected

Speaker +- ndash hooks up to speaker

Activation (1) Aux (2) Aux2 button (3) ndash hook up to closing buttons or potentially touch buttons

Blade ID Neopixel Data 1 ndash normally used to measure the blade ID restor and if itrsquos a neopixel blade feed out neopixel data

Data 2 3 4 5 ndash additional neopixel data outputs or free for other purposes

LED 1 2 3 4 5 6 ndash hooks up to negative side of LED (positive side of LED hooks up directly to battery) These pads can handle

up to 30 volts

SDA SCL ndash these pins are used to wire OLED display or to communicate with the gyro and accelerometer chip

RX TX ndash these pins are used for wiring a bluetooth module for wireless control

SWDCLK SWDIO ndash can be hooked up to a ST-LINK device and lets you debug programs running on the ProffieBoard

+5V ndash generated by the ProffieBoard normally itrsquos only ON when sound is playing

+33V ndash generated by the ProffieBoard for powering OLED display Bluetooth module or some accent leds

BOOT RESET ndash buttons to put the ProffieBoard in bootloader mode if uploading doesnrsquot work

micro USB port ndash micro USB port used only for firmware upload and can be used for sound files upload to SD card (from firmware version

1291 and up) THIS PORT ISNrsquoT USED FOR CHARGING THE BATTERY

LED 4LED 3

LED 2

LED 1

LED 5

LED 6

RESETBOOT

Battery - Battery -

Speaker + (red dot or ldquo+rdquo mark on speaker)

Battery +

Aux button (2)Activation button (1)

Aux2 button (3)

Blade ID Neopixel Data 1

Data 5

Data 4Data 3Data 2

+33V

SWDIO

SWDCLK

+5V

TXRX

GND

GND

Reset

Speaker -

SCLSDA

micro USB port

WIRING DIAGRAMS

26 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Basic Tri-Cree wiring diagram(In-hilt LED)

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

+

+

-

-

26 AWG

26 A

WG

30-32 AWG

28-30 AWG

28-3

0 A

WG

30-32 AWG

Protected 36-37V (42V max at full charge) 10A 3500mAh battery recommended+18650 battery holder (optional)Keystone 1042P

AV switch with accent led(constantly ON no effects)

accent leds run mostly at10-15mA so resistors for them must be calculated accordingly

Main RGB led

additional RGB leds(optional)

In case no additional high power leds are needed LED channels 4 5 6 can be used for 3 controllable(programmable for different effects) accent leds So AV switch led can be wired to one of these channelsAccent leds also can be wired to Data pads 1-5 please see ldquoAccent LEDs wiring and setuprdquo page

LED Resistor Calculator

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 27

3WIRING DIAGRAMS1

Basic Tri-Cree wiring (In-hilt LED)ldquoconfighrdquo file setup

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

Use a given or build your wiring diagram on THIS PAGE then open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text

Editor (Notepad - to see code correctly in Notepad Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all

text) and Delete it then Copy-and-Paste (Ctrl+C Ctrl+V) your wiring diagram config code (example below) into empty _configh file and

Save it under new name Follow the instructions on page 22 to upload it to the board

ldquoproffieboard_v1_confighrdquoNUM_BLADES 2NUM_BUTTONS 2VOLUME 1000CLASH_THRESHOLD_G 10StyleNormalPtrltCYAN WHITE 300 800gt()StyleNormalPtrltCYAN WHITE 300 800gt()

CreeXPE2RedTemplatelt1000gtCreeXPE2GreenTemplatelt0gtCreeXPE2BlueTemplatelt240gtNoLED

ProffieBoard config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)Volume level (0-3000)Clash sensitivity (adjust lower or higher with 01 step)ldquoBlade 1rdquo styleldquoBlade 2rdquo style (in case only 1 blade is used you donrsquot need this line)LED configuration (use these XP-E2 LED templatesto define your LED If other LED resistors are used change these values to match Ohm1000=ltvaluegt)

where 1000 is 1 Ohm resistor 0 is no resistor240 is 024 Ohm resistorNoLED ndash no 4th led used

Preset 1

LED 1 configuration

LED 2 configuration

Preset 2 etc

PROFFIEBOARD INSTRUCTIONS

28 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Basic Neopixel wiring diagram

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

+

+

-

-

22 A

WG

22 AWG

x2 28 AWG

x2 26 AWG

22 A

WG

30-32 AWG30-32 AWG

Protected 36-37V (42V max at full charge) 10A 3500mAh or 15A 3120mAhbattery recommended+18650 battery holder (optional)Keystone 1042P

AV switch with accent led(constantly ON no effects)

accent leds run mostly at10-15mA so resistors for them must be calculated accordingly

Main Neopixel strip

additional Neopixelstrips(optional)

Neopixel bladeconnector

330 Ohm on the Blade pcb side

x3 28 AWGor x1 22 AWGfor Negative

330 Ohm on the Blade pcb side

arrows up

330 Ohm on the Blade pcb side

In case no additional Neopixel strips are needed LED channels 4 5 6 can be used for 3 controllable(programmable for different effects) accent leds So AV switch led can be wired to one of these channelsAccent leds also can be wired to Data pads 2-5 please see ldquoAccent LEDs wiring and setuprdquo page

Recommended power wire gauges (22 AWG) are given for 2-strip blade For 3-strip blade you gonna need at least 20 AWG wires

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 29

ldquoproffieboard_v1_confighrdquo

3WIRING DIAGRAMS1

Basic Neopixel wiringldquoconfighrdquo file setup

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

NUM_BLADES 3NUM_BUTTONS 2VOLUME 1000CLASH_THRESHOLD_G 10IgnitionDelaylt0 any blade stylegtIgnitionDelaylt800 any blade stylegtIgnitionDelaylt800 any blade stylegtWS2811BladePtrlt118 WS2811 800kHz | WS2811 GRBgt()WS2811BladePtrlt26 blade2Pin ltbladePowerPin4gtgt()WS2811BladePtrlt26 blade3Pin ltbladePowerPin5gtgt()

ProffieBoard config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)Volume level (0-3000)Clash sensitivity (adjust lower or higher with 01 step)ldquoBlade 1rdquo style (main blade with IgnitionDelay 0)ldquoBlade 2rdquo style (CG blade 1 with IgnitionDelay 800)ldquoBlade 3rdquo style (CG blade 2 with IgnitionDelay 800)

strip configuration (defines how many pixels it has and to which LED output and pin is wired)

Preset 1

any blade style

strip (blade) 1 configuration

adjust this number to match your strips leds count

strip (blade) 2 configuration

strip (blade) 3 configuration

Preset 2 etc

Use a given or build your wiring diagram on THIS PAGE then open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text

Editor (Notepad - to see code correctly in Notepad Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all

text) and Delete it then Copy-and-Paste (Ctrl+C Ctrl+V) your wiring diagram config code (example below) into empty _configh file and

Save it under new name Follow the instructions on page 22 to upload it to the board

PROFFIEBOARD INSTRUCTIONS

30 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Basic Segmented string wiring diagram

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

+

+

-

-

24 A

WG

28 AWG

30-32 AWG30-32 AWG

Protected 36-37V (42V max at full charge) 10A 3500mAh battery recommended+18650 battery holder (optional)Keystone 1042P

AV switch with accent led(constantly ON no effects)

accent leds run mostly at10-15mA so resistors for them must be calculated accordingly

6-segments string blade

FoC string

N-channel FET3A minimum

123456

Calculate resistors for each led segment of the blade string depending on which leds are used 5mm leds have max drive current around 25mA per led when 10mm leds can be 100mA and 200mA per ledSo pay attention to your led max current and Forward Voltage (Vf) when calculating a segment resistor resistence as well as its wattage Also choose wire gauges accordingly to meet segments and total blade max current draw level

LED Resistor Calculator

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 31

ldquoproffieboard_v1_confighrdquo

3WIRING DIAGRAMS1

Basic Segmented string wiringldquoconfighrdquo file setup

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

NUM_BLADES 1NUM_BUTTONS 2VOLUME 1000CLASH_THRESHOLD_G 10StyleNormalPtrltCYAN WHITE 300 800gt()ltBlue3mmLED BladePin White3mmLEDgt

ProffieBoard config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)Volume level (0-3000)Clash sensitivity (adjust lower or higher with 01 step)Blade styleLED string configuration(here you mention the color and type of leds usedin the main blade string segments and FoC stringBladePin is the FoC signal pin (Blade ID pin))

Preset

LED string configuration

Use a given or build your wiring diagram on THIS PAGE then open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text

Editor (Notepad - to see code correctly in Notepad Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all

text) and Delete it then Copy-and-Paste (Ctrl+C Ctrl+V) your wiring diagram config code (example below) into empty _configh file and

Save it under new name Follow the instructions on page 22 to upload it to the board

PROFFIEBOARD INSTRUCTIONS

32 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Accent LEDs wiring diagram(optional)

Accent LEDs work with ProffieBoard as additional ldquobladesrdquo when powered by LED outputs 4 5 6 or Data pads 1 2 3 5 as PWM So they can

have any effect that blade can have If no effects needed accent led can be powered just by a 33V output pad (power-on led indication)

30-32 AWG

with Neopixel blade setup these 4 outputsdonrsquot work for regular accent leds

Recommended resistors to use for accent leds at 33V power source and 15mA drive

ndash 100 Ohm for Red (lt100000gt value in the code)ndash 13 Ohm for Green (lt13000gt value in the code)ndash 13 Ohm for Blue (lt13000gt value in the code)ndash 100 Ohm for Yellow (lt100000gt value in the code)ndash 20 Ohm for White (lt20000gt value in the code)

RGB ledcommon-anode

8 ldquobladesrdquo1 main and 7 accent leds

main blade style (effects) main blade style (effects)

7 accent leds style (effects)accent led style (effects)

7 accent leds configurations

RGB accent led configuration

2 ldquobladesrdquo1 main and 1 RGB accent led

ldquoPower-onrdquo indicationaccent leds (no effects)

7 accent leds withindependent effects

RGB accent led

a) b)

b)

c)

c)

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 33

3WIRING DIAGRAMS1

Neopixel Accent LEDs wiring diagram(optional)

With Neopixel setup additional neopixel leds or arrays can be used as accent leds There are 2 ways to wire them using additional Data

pins 2 3 4 5 or ldquoSub-bladesrdquo wiring with just 1 Data output pin Same way Neopixel connectors with on-board leds ca be wired

Option 1 ndash with extra Data pins

Main Blade

some accent leds

D1

D2

crystal leds

330 Ohm

330 Ohm

330 Ohm

main blade style (effects)

main blade 144 leds Data pin 1

accent leds blade style (effects)

accent leds ldquobladerdquo 4 leds Data pin 2

crystal leds blade style (effects)

crystal leds ldquobladerdquo 2 leds Data pin 3

3 ldquobladesrdquo1 main 1 accent leds array and 1 crystal leds array

PROFFIEBOARD INSTRUCTIONS

D3

follow arrows direction

34 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Neopixel Accent LEDs wiring diagram(optional)

PROFFIEBOARD INSTRUCTIONS

Main Blade

some accent leds

1

3

5678

2

4

D1

crystal leds

follow arrows direction

330 Ohm

330 OhmData signal

With this setup a single array of neopixel leds is separated into a couple of sub-blades with their own style configuration and behaviour This

is really usefull when you want to use only one data pin More about ldquoSub-bladesrdquo on ProffieOS wiki page

Option 2 ndash with ldquoSub-bladesrdquo

main blade style (effects)

main blade sub-blade 140 leds (7-146) but from 6 to 145 in the code

accent leds blade style (effects)

accent leds sub-blade 4 leds (1-4) but from 0 to 3 in the code

crystal leds blade style (effects)

146 leds total used

crystal leds sub-blade 2 leds (5-6) but from 4 to 5 in the code

update default 144 to a higher total value if you get all accent leds +Main blade gt 144 Example update to 146 if you have 2 crystal leds +4 accent leds + 140 Main blade leds = 146

3 ldquobladesrdquo 1 main 1 accent leds array and 1 crystal leds array

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 35

3WIRING DIAGRAMS1

OLED display wiring diagram(optional)

SSD1306 128x32 pixels OLED display allows to show battery level current preset name play different animations and even simple games It

can be wired to any blade configuration and requires just one additional line in the code to work You can get monochrome display in white

or blue color

SSD1306128x32OLED

SSD1306 ndash with blue or white display color selectSSD1306 ndash cheaper priceSSD1306 just screen ndash blue or white select

30-32 AWG

30-32 AWG

add this line to enable OLED display

display shows a preset name written in these quotes ldquoldquo

PROFFIEBOARD INSTRUCTIONS

36 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Bluetooth module wiring diagram(optional)

SOON

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 37

3WIRING DIAGRAMS1

Blade ID resistor functions(optional)

SOON

PROFFIEBOARD INSTRUCTIONS

38 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

website ProffieBoard FULL wiring diagrams link

Scroll the page down till you see the interactive diagram Above the diagram there are components selection options Build your saber setup

with it and follow diagram to wire your board Then you need to copy the configuration code below and paste it into your _configh file

Choose components you want

3WIRING DIAGRAMS1

More wiring diagrams

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 39

3WIRING DIAGRAMS1

How to use it

PROFFIEBOARD INSTRUCTIONS

Blade ignitionretraction ndash assuming you have at least one button pressing it briefly should turn the saber on or off If you have an AUX button pressing it briefly should also turn the saber on and off If you have no buttons you can turn the saber on and off by twisting your wrist back and forth Note that the motion has to be done long enough to count so a very quick flick of the wrist will not workTurn On muted ndash double-click power buttonNext preset ndash while saber is off click the AUX buttonPrevious preset ndash hold AUX button and click the Activation buttonTrigger Clash ndash while saber is on hit the bladeTrigger Lockup ndash while saber is on hold Activation button then trigger a clash Lockup releases when you let go of the Acti-vation buttonTrigger Drag ndash like lockup but point saber mostly down before holding Activation buttonTrigger Force ndash long-click AUX buttonStart soundtrack ndash long-click the Activation buttonTrigger Blaster Block ndash while saber is on short-click AUX button

Serial Monitor commands

battery_voltage ndash gets current battery voltage valueget_volume ndash get current volume valuepow ndash power OnOff the saberon ndash power On the saberoff ndash power Off the saberset_volume lt0-3000gt ndash set volume value (example set_volume 500)play ndash play the default preset trackplay trackslttrack namegt ndash play a specific track from tracks folder (example play tracksvenuswav)stop ndash stop the playing trackforce ndash play ldquoforcerdquo sound effectsdrag ndash play ldquodragrdquo sound effectsblast ndash play ldquoblasterrdquo sound effectslock ndash play ldquolockuprdquo sound effectsclash ndash play ldquoclashrdquo sound effectsreset ndash reboot the boardn ndash switch to next presetp ndash switch to previous presetlist_presets ndash show all presetssdtest ndash test SD card speed

40 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3FIRMWARE UPLOAD AND UPDATE2

Software installation and setup

PROFFIEBOARD INSTRUCTIONS

To upload firmware to ProffieBoard Arduino IDE program is required Follow these steps to install it to your PC

1 Install latest Arduino IDE software (donrsquot use BETA)

Installing as Windows app also is not recommended

because it will be installed in a specific protected folder that

wonrsquot allow you to install any additional softwareplugin in it

If ProffieBoard wonrsquot show up in COM port use

Arduino IDE 186 version

2 Install the Proffieboard Arduino Plugin and Zadig software

Follow installation instructions

3 Select Proffieboard-STM32L433 in Tools -gt Board

USB Type ndash Serial CPU Speed ndash 80 MHz Optimize ndash Smallest Code DOSFS ndash SDCARD (SPI) Port ndash COM(the number your PC assigned) (Butterfly-L433CC)

Connect Proffieboard via USB cable to PC to be able to select

the Port

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 41

3FIRMWARE UPLOAD AND UPDATE2

Uploading firmware

PROFFIEBOARD INSTRUCTIONS

1 Download the ProffieBoard firmware and SD card content

Unzip lightsaber-1286zip to your Documents directory or to

Desktop but not to Arduino program folder or anywhere in

Programs directory where all programs are installed You will

see a lightsaber folder and files inside it Donrsquot move any of

these files to any other location outside the lightsaber folder

and donrsquot reorganize them Unzip ProffieOS_SD_Cardzip to the

folder where you keep lightsaber-1286 folder Copy all files

from ProffieOS_SD_Card folder to your SD card

2 Unhide file extensions in File Explorer settings to see h ending

of config files Donrsquot add ldquohrdquo to the config file name Go to config folder and create you own configh file (see page

42 for how-to)

Double-click the lightsaberino file

3 Add the name of your configh file as shown and Save this

lightsaberino file Make sure the other config files are

commented out there should be only one CONFIG_FILE

without You can have multiple config files

in lightsabergtconfig folder and just define the one you need

in lightsaberino file and upload it again to ProffieBoard

4 Connect battery to ProffieBoard and hook up to your PC

with a data transfer micro-USB-to-USB cable

Press arrow button it will compile and upload firmware to the

board Wait for red text progress bars to stop at 100

ProffieBoard will play boot sound if speaker is connected

Now you can unplug the USB cable Done

If it gives an error instead this means your configh file has

issues define CONFIG_FILE name has mistakes configh file

is out of config folder your PC user name is non-latin

42 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

33

configh file structure editing

PROFFIEBOARD INSTRUCTIONS

CHANGING PARAMETERS

All sound files (sound fonts music tracks) are stored on the micro SD card Add required sound fonts folders (Plecter NEC and Smoothswing

fonts are supported no need to change WAV files names just copy and paste) to SD card root directory as itrsquos done in the default

ProffieOS_SD_Card content folder and music tracks to the tracks folder

Make sure to name all music tracks and sound fonts folders with latin characters and only up to 8 characters long without using any special

characters (like |[- etc)

Make sure you have a configini file in each sound font folder if there is none - copy one from some default TeensySaberProffieBoard sound

font and paste into newly added sound font folder It has only one parameter that you can modify - humstart It helps to match hum sound

start with blade ignition 1000 usually works fine

All blade effects LED configuration volume level clash sensitivity etc are changed in the configh file located in lightsabergtconfig folder

To do that open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text Editor (Notepad - to see code correctly in Notepad

Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all text) and Delete it then Copy-and-Paste (Ctrl+C

Ctrl+V) your wiring diagram config code into empty _configh file and Save it under new name Follow the instructions on page 39 to

upload it to the board

Proffieboard config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)

volume level (0-3000)

clash sensitivity (adjust lower or higher with 01 step)

sound font folder nametrack name

Preset name

Blade style

LED configuration (use these XP-E2 LED templatesto define your LED)

for Red use 1 Ohm resistor for Green - no resistor for Blue use 024 Ohm

NoLED ndash no 4th led used

Preset 1

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 43

33

Blade Styles

StylePtrltInOutHelperltSimpleClashltLockupltBlastltOnSparkltAudioFlickerltRgblt02550gtRgblt501000gtgtRgblt2552550gt150gtRgblt255500gtgtAudioFlickerltRgblt1002550gtRgblt2550150gtgtgtRgblt255100150gt40gt200300Blackgtgt

ndash this is how the Blade Style code looks pasted in the configh file Preset (it sits inside a StylePtrltgt container)

ndash this is how the Blade Style code looks when editing it inside a Blade Style Editor

Each Blade Style is made of a variety of Effects each added effect goes instead of a base color in the previous effect

PROFFIEBOARD INSTRUCTIONS

CHANGING PARAMETERS

ProffieBoard and TeensySaber use Blade Styles for the main saber blade and any other accent leds to define all light effects (color changing

flashes flickering delays ignitionretraction timing etc)

Use Blade Style Editor to create and adjust Blade Styles Megtooth Sith Sabers did a great video tutorial where he shows and explains

how to use Blade Style Editor Also you can grab some pre-made Blade Styles or share yours here on TRA forums

A Blade Style example of simple flickering Green blade with Spark on start Clash Blaster Lockup and Drag IgnitionRetraction effects

InOutHelperltSimpleClashltLockupltBlastltOnSparkltAudioFlickerltRgblt02550gtRgblt501000gtgtRgblt2552550gt150gtRgblt255500gtgtAudioFlickerltRgblt1002550gtRgblt2550150gtgtgtRgblt255100150gt40gt200300Blackgt

InOutHelperltbase color200300Blackgt ndash base color can be defined by words (WHITE RED GREEN PURPLE etc) or by Rgblt0-2550-2550-255gt values for more

custom shades 200 is extension length in milliseconds 300 is retraction length in milliseconds Black is color when retracted (also can be any other color)

SimpleClashltbase colorclash color40gt ndash clash effect 40 is clash duration in milliseconds

Lockupltbase colorlockup colorgt ndash lockup effect

Blastltbase colorblast colorgt ndash blaster effect

OnSparkltbase colorspark color150gt ndash spark on ignition effect 150 is spark duration in milliseconds

AudioFlickerltrdquoArdquo colorrdquoBrdquo colorgt ndash flickering effect (blade flickers to the actual saber hum sound) the more difference between ldquoArdquo and ldquoBrdquo colors - the more

abrupt is flickering

Rgblt255500gt ndash actual color in RGB format (0 is no light 255 is the maximum brightness value for Red Green or Blue channel)

44 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

ndash SanDisk 4GB microSDHC Class 4 (Genuine) ndash SanDisk 4GB microSDHC Class 4 (Genuine)

130238 kbs = 1477 simultaneous audio streams 137812 kbs = 1562 simultaneous audio streams

ndash Patriot LX Series 16GB microSDHC UHS-IU1 Class 10 ndash Patriot LX Series 16GB microSDHC UHS-IU1 Class 10

133005 kbs = 1508 simultaneous audio streams

ndash GSkill 16GB microSDHC UHS-IU1 Class 10 ndash GSkill 16GB microSDHC UHS-IU1 Class 10

129534 kbs = 1469 simultaneous audio streams

ndash Kingston 16GB microSDHC UHS-IU1 Class 10 ndash Kingston 16GB microSDHC UHS-IU1 Class 10

128090 kbs = 1452 simultaneous audio streams

ndash SanDisk Ultra 16GB microSDHC UHS-IU1 A1 Class 10 ndash SanDisk Ultra 16GB microSDHC UHS-IU1 A1 Class 10

102663 kbs = 1164 simultaneous audio streams 11124 kbs = 1261 simultaneous audio streams

ndash SanDisk 8GB microSDHC Class 4 ndash SanDisk 8GB microSDHC Class 4

108506 kbs = 1230 simultaneous audio streams

ndash SanDisk 16GB microSDHC Class 4 ndash SanDisk 16GB microSDHC Class 4

102663 kbs = 1164 simultaneous audio streams 106957 kbs = 1213 simultaneous audio streams

ndash SanDisk Ultra 16GB microSDHC UHS-IU1 Class 10 ndash SanDisk Ultra 16GB microSDHC UHS-IU1 Class 10

102663 kbs = 1164 simultaneous audio streams 103909 kbs = 1178 simultaneous audio streams

ndash Smartbuy 4GB microSDHC Class 4 ndash Smartbuy 4GB microSDHC Class 4

75437 kbs = 855 simultaneous audio streams

ndash Kingston 8GB microSDHC Class 4 ndash Kingston 8GB microSDHC Class 4

75209 kbs = 822 simultaneous audio streams

ndash SanDisk 4GB microSDHC Class 4 (Fake) ndash SanDisk 4GB microSDHC Class 4 (Fake)

677 kbs = 769 simultaneous audio streams

Here is a list of tested micro SD cards speed with TeensySaber V3 and ProffieBoard Any card with speed over 900 kbs is recommended the

higher the speed is ndash the better Memory size of 4-16Gb is more than enough Cards were tested with a default firmware (1291) compiled

with ldquoSmallest Coderdquo under Optimize ldquodefault_proffieboard_confighrdquo file and default ProffieOS SD card sound files (7 folders)

To test your SD card speed simply hook up ProffieBoard to PC open Arduino IDE go to Tools and open Serial Monitor make sure you have

New Line and 9600 baud rate selected on the bottom of Serial Monitor window type and send sdtest command wait for the test result

4Recommended micro SD cards

BEST

TEENSYSABER PROFFIEBOARD

GOOD

BAD

PROFFIEBOARD INSTRUCTIONS

SD CARD RECOMMENDATIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 45

There are a lot of fake (chinese copies) microSD cards on the market from aliexpress ebay amazon etc They look very similar to genuine

cards but are a bit different though and have a twice lower writingreading speed Here is an example of a SanDisk 4Gb Class 4 card one is

genuine with 137812 kbs speed and the other one is fake with 677 kbs speed I got from ebay seller

Be carefull and pay attention to how the actual card looks if you are not sure ask seller for the real photo of SD card he sells

4Genuine and Fake SanDisk 4Gb Class 4 microSD

PROFFIEBOARD INSTRUCTIONS

SD CARD RECOMMENDATIONS

46 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

WIRE GAUGE GUIDE

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 47

RECHARGE PORTS AND KILL SWITCHES

48 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

NEOPIXEL STRIPS CURRENT DRAW

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 49

6TROUBLESHOOTING

For more help please check these linksProffieOSProffieBoardTeensySaber wiki on GitHubAsk your question on The Rebel Armory forumsAsk your question on FX-sabers forumsAsk your question in facebook group

How to solve most common issues

Quick troubleshooting tips

TeensySaber board or Proffieboard is not recognized by computer (nothing under Port selection in Arduino)

ndash Make sure a charged 37V battery is connected to the board micro-USB cable is a data transfer cable all plugins and drivers are installed ndash

check again pages 21 for TeensySaber or 40 for Proffieboard Try a different USB port on your computer

Sketch (code) compile error in Arduino IDE

ndash Check your define CONFIG_FILE ldquoconfig_confighrdquo line in opened lightsaberino file if itrsquos written correctly with config in it

Sketch (code) compile error in Arduino IDE

ndash Check if the _configh file you defined in the lightsaberino sketch file is same name as in the lightsaber-rdquofirmware versionrdquolightsaber

config folder and is located in this folder

Sketch (code) compile error in Arduino IDE

ndash Check your settings under Tools tab in Arduino IDE program Check again pages 21 for TeensySaber or 40 for Proffieboard

Sketch (code) compile error in Arduino IDE

ndash Check if your _configh file is correct Blade Styles Presets const unsigned int maxLedsPerStrip = 144 if BladeConfig blades[] = is correct

Sketch (code) compile error in Arduino IDE

ndash If nothing helps install Arduino IDE version 186 and try to compile and upload the firmware again

Sound doesnrsquot play

ndash Remove SD card and insert again check speaker wiring Make sure all sound files on SD card are correctly named (8 characters max long)

Re-format SD card in FAT32 load sound files and try again try another SD card

Board says ldquoLOW POWERrdquo

ndash Charge the battery

Serial Monitor shows info sent by the board but your commands donrsquot work

ndash In the bottom right corner of Serial Monitor window make sure the Line Ending drop down is set to New Line

Sound is weird and distorted

ndash Check your SD card speed (see page 44) Check speaker wiring try another good speaker

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 15

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

OLED display wiring diagram(optional)

SSD1306 128x32 pixels OLED display allows to show battery level current preset name play different animations and even simple games It

can be wired to any blade configuration and requires just one additional line in the code to work You can get monochrome display in white

or blue color

SSD1306128x32OLED

SSD1306 ndash with blue or white display color selectSSD1306 ndash cheaper priceSSD1306 just screen ndash blue or white select

30-32 AWG

30-32 AWG

add this line to enable OLED display

display shows a preset name written in these quotes ldquoldquo

16 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

Bluetooth module wiring diagram(optional)

SOON

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 17

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

Blade ID resistor functions(optional)

SOON

18 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

website TeensySaber V3 FULL wiring diagrams link

Scroll the page down till you see the interactive diagram Above the diagram there are components selection options Build your saber setup

with it and follow diagram to wire your board Then you need to copy the configuration code below and paste it into your _configh file

Choose components you want

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

More wiring diagrams

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 19

20 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

How to use it

Blade ignitionretraction ndash assuming you have at least one button pressing it briefly should turn the saber on or off If you have an AUX button pressing it briefly should also turn the saber on and off If you have no buttons you can turn the saber on and off by twisting your wrist back and forth Note that the motion has to be done long enough to count so a very quick flick of the wrist will not workTurn On muted ndash double-click power buttonNext preset ndash while saber is off click the AUX buttonPrevious preset ndash hold AUX button and click the Activation buttonTrigger Clash ndash while saber is on hit the bladeTrigger Lockup ndash while saber is on hold Activation button then trigger a clash Lockup releases when you let go of the Acti-vation buttonTrigger Drag ndash like lockup but point saber mostly down before holding Activation buttonTrigger Force ndash long-click AUX buttonStart soundtrack ndash long-click the Activation buttonTrigger Blaster Block ndash while saber is on short-click AUX button

Serial Monitor commands

battery_voltage ndash gets current battery voltage valueget_volume ndash get current volume valuepow ndash power OnOff the saberon ndash power On the saberoff ndash power Off the saberset_volume lt0-3000gt ndash set volume value (example set_volume 500)play ndash play the default preset trackplay trackslttrack namegt ndash play a specific track from tracks folder (example play tracksvenuswav)stop ndash stop the playing trackforce ndash play ldquoforcerdquo sound effectsdrag ndash play ldquodragrdquo sound effectsblast ndash play ldquoblasterrdquo sound effectslock ndash play ldquolockuprdquo sound effectsclash ndash play ldquoclashrdquo sound effectsreset ndash reboot the boardn ndash switch to next presetp ndash switch to previous presetlist_presets ndash show all presetssdtest ndash test SD card speed

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 21

2TEENSYSABER V3 INSTRUCTIONS

FIRMWARE UPLOAD AND UPDATE2

Software installation and setup

To upload firmware to TeensySaber board Arduino IDE program is required Follow these steps to install it to your PC

1 Install latest Arduino IDE software (donrsquot use BETA)

Installing as Windows app also is not recommended

because it will be installed in a specific protected folder that

wonrsquot allow you to install Teensyduino software in it

If TeensySaber wonrsquot show up in COM port use

Arduino IDE 186 version

2 Install latest Teensyduino software in same directory

usually itrsquos CProgram Files (x86)Arduino on Windows

Follow installation instructions for your system

3 Select Teensy 32 31 in Tools -gt Board

USB Type ndash Serial CPU Speed ndash 96 MHz (overclock) Optimize ndash Smallest Code Port ndash COM(the number your PC assigned) (Teensy 32) Serial

Connect TeensySaber via USB cable to PC to be able to select

the Port donrsquot forget to connect battery first

22 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

1 Download the TeensySaber firmware and SD card content

Unzip lightsaber-1286zip to your Documents directory or to

Desktop but not to Arduino program folder or anywhere in

Programs directory where all programs are installed You will

see a lightsaber folder and files inside it Donrsquot move any of

these files to any other location outside the lightsaber folder

and donrsquot reorganize them Unzip ProffieOS_SD_Cardzip to the

folder where you keep lightsaber-1286 folder Copy all files

from ProffieOS_SD_Card folder to your SD card

2 Unhide file extensions in File Explorer settings to see h ending

of config files Donrsquot add ldquohrdquo to the config file name

Go to config folder and create you own configh file (see page

23 for how-to)

Double-click the lightsaberino file

3 Add the name of your configh file as shown and Save this

lightsaberino file Make sure the other config files are

commented out there should be only one CONFIG_FILE

without You can have multiple config files

in lightsabergtconfig folder and just define the one you need

in lightsaberino file and upload it again to TeensySaber board

4 Connect battery to TeensySaber board and hook up to your PC

with a data transfer micro-USB-to-USB cable

Press arrow button it will compile and upload firmware to the

board Wait for your PC to make a sound or TeensySaber will

play boot sound if speaker is connected Now you can unplug

the USB cable Done

If it gives an error instead this means your configh file has

issues define CONFIG_FILE name has mistakes configh file

is out of config folder your PC user name is non-latin

2TEENSYSABER V3 INSTRUCTIONS

FIRMWARE UPLOAD AND UPDATE2

Uploading firmware

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 23

2TEENSYSABER V3 INSTRUCTIONS

CHANGING PARAMETERS3

Changing sound board parameters

All sound files (sound fonts music tracks) are stored on the micro SD card Add required sound fonts folders (Plecter NEC and Smoothswing

fonts are supported no need to change WAV files names just copy and paste) to SD card root directory as itrsquos done in the default

ProffieOS_SD_Card content folder and music tracks to the tracks folder

Make sure to name all music tracks and sound fonts folders with latin characters and only up to 8 characters long without using any special

characters (like |[- etc)

Make sure you have a configini file in each sound font folder if there is none - copy one from some default TeensySaberProffieBoard sound

font and paste into newly added sound font folder It has only one parameter that you can modify - humstart It helps to match hum sound

start with blade ignition 1000 usually works fine

All blade effects LED configuration volume level clash sensitivity etc are changed in the configh file located in lightsabergtconfig folder

To do that open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text Editor (Notepad - to see code correctly in Notepad

Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all text) and Delete it then Copy-and-Paste (Ctrl+C

Ctrl+V) your wiring diagram config code into empty _configh file and Save it under new name Follow the instructions on page 22 to

upload it to the board

TeensySaber V3 config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)

volume level (0-3000)

clash sensitivity (adjust lower or higher with 01 step)

sound font folder nametrack name

Preset name

Blade style

LED configuration (use these XP-E2 LED templatesto define your LED)

for Red use 1 Ohm resistor for Green - no resistor for Blue use 024 Ohm

NoLED ndash no 4th led used

Preset 1

24 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

31

PROFFIEBOARD INSTRUCTIONS

Whatrsquos needed

ndash ProffieBoard

ndash micro SD-card (see page 44 for recommendations)

ndash a USB micro SD-card reader (to load sound files from PC to micro SD card)

ndash micro USB data transfer cable (CABLES THAT SUPPORT ONLY CHARGING WONrsquoT WORK)

ndash wires of different gauges (32-20 AWG) (PTFE coated copper stranded wires recommended) heat shrink

ndash ESD safe soldering station solder wire flux etc

ndash pliers helping hands etc

ndash isopropyl alcohol to clean pads before soldering (helps solder to stick better)

ndash Digital Multimeter (VERY USEFUL)

ndash computer running Windows Linux or Mac OS with internet access

ndash 37V Li-Ion Protected rechargeable battery switches recharge port speaker LEDs resistors chassis etc

ndash Smart Li-Ion CC-CV (Constant Current - Constant Voltage mode) battery charger for 37V (42V) cells

ndash patience

WIRING DIAGRAMS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 25

31

PROFFIEBOARD INSTRUCTIONS

Board pinout

Battery + ndash 26 to 45 volt input drives everything except the LEDs

Battery - ndash negative pad for LEDs needs to be at same level as GND when both are connected Both pads are internally connected

GND ndash ground for electronics except LEDs Note that there are two GND pads on the board that are internally connected

Speaker +- ndash hooks up to speaker

Activation (1) Aux (2) Aux2 button (3) ndash hook up to closing buttons or potentially touch buttons

Blade ID Neopixel Data 1 ndash normally used to measure the blade ID restor and if itrsquos a neopixel blade feed out neopixel data

Data 2 3 4 5 ndash additional neopixel data outputs or free for other purposes

LED 1 2 3 4 5 6 ndash hooks up to negative side of LED (positive side of LED hooks up directly to battery) These pads can handle

up to 30 volts

SDA SCL ndash these pins are used to wire OLED display or to communicate with the gyro and accelerometer chip

RX TX ndash these pins are used for wiring a bluetooth module for wireless control

SWDCLK SWDIO ndash can be hooked up to a ST-LINK device and lets you debug programs running on the ProffieBoard

+5V ndash generated by the ProffieBoard normally itrsquos only ON when sound is playing

+33V ndash generated by the ProffieBoard for powering OLED display Bluetooth module or some accent leds

BOOT RESET ndash buttons to put the ProffieBoard in bootloader mode if uploading doesnrsquot work

micro USB port ndash micro USB port used only for firmware upload and can be used for sound files upload to SD card (from firmware version

1291 and up) THIS PORT ISNrsquoT USED FOR CHARGING THE BATTERY

LED 4LED 3

LED 2

LED 1

LED 5

LED 6

RESETBOOT

Battery - Battery -

Speaker + (red dot or ldquo+rdquo mark on speaker)

Battery +

Aux button (2)Activation button (1)

Aux2 button (3)

Blade ID Neopixel Data 1

Data 5

Data 4Data 3Data 2

+33V

SWDIO

SWDCLK

+5V

TXRX

GND

GND

Reset

Speaker -

SCLSDA

micro USB port

WIRING DIAGRAMS

26 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Basic Tri-Cree wiring diagram(In-hilt LED)

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

+

+

-

-

26 AWG

26 A

WG

30-32 AWG

28-30 AWG

28-3

0 A

WG

30-32 AWG

Protected 36-37V (42V max at full charge) 10A 3500mAh battery recommended+18650 battery holder (optional)Keystone 1042P

AV switch with accent led(constantly ON no effects)

accent leds run mostly at10-15mA so resistors for them must be calculated accordingly

Main RGB led

additional RGB leds(optional)

In case no additional high power leds are needed LED channels 4 5 6 can be used for 3 controllable(programmable for different effects) accent leds So AV switch led can be wired to one of these channelsAccent leds also can be wired to Data pads 1-5 please see ldquoAccent LEDs wiring and setuprdquo page

LED Resistor Calculator

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 27

3WIRING DIAGRAMS1

Basic Tri-Cree wiring (In-hilt LED)ldquoconfighrdquo file setup

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

Use a given or build your wiring diagram on THIS PAGE then open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text

Editor (Notepad - to see code correctly in Notepad Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all

text) and Delete it then Copy-and-Paste (Ctrl+C Ctrl+V) your wiring diagram config code (example below) into empty _configh file and

Save it under new name Follow the instructions on page 22 to upload it to the board

ldquoproffieboard_v1_confighrdquoNUM_BLADES 2NUM_BUTTONS 2VOLUME 1000CLASH_THRESHOLD_G 10StyleNormalPtrltCYAN WHITE 300 800gt()StyleNormalPtrltCYAN WHITE 300 800gt()

CreeXPE2RedTemplatelt1000gtCreeXPE2GreenTemplatelt0gtCreeXPE2BlueTemplatelt240gtNoLED

ProffieBoard config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)Volume level (0-3000)Clash sensitivity (adjust lower or higher with 01 step)ldquoBlade 1rdquo styleldquoBlade 2rdquo style (in case only 1 blade is used you donrsquot need this line)LED configuration (use these XP-E2 LED templatesto define your LED If other LED resistors are used change these values to match Ohm1000=ltvaluegt)

where 1000 is 1 Ohm resistor 0 is no resistor240 is 024 Ohm resistorNoLED ndash no 4th led used

Preset 1

LED 1 configuration

LED 2 configuration

Preset 2 etc

PROFFIEBOARD INSTRUCTIONS

28 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Basic Neopixel wiring diagram

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

+

+

-

-

22 A

WG

22 AWG

x2 28 AWG

x2 26 AWG

22 A

WG

30-32 AWG30-32 AWG

Protected 36-37V (42V max at full charge) 10A 3500mAh or 15A 3120mAhbattery recommended+18650 battery holder (optional)Keystone 1042P

AV switch with accent led(constantly ON no effects)

accent leds run mostly at10-15mA so resistors for them must be calculated accordingly

Main Neopixel strip

additional Neopixelstrips(optional)

Neopixel bladeconnector

330 Ohm on the Blade pcb side

x3 28 AWGor x1 22 AWGfor Negative

330 Ohm on the Blade pcb side

arrows up

330 Ohm on the Blade pcb side

In case no additional Neopixel strips are needed LED channels 4 5 6 can be used for 3 controllable(programmable for different effects) accent leds So AV switch led can be wired to one of these channelsAccent leds also can be wired to Data pads 2-5 please see ldquoAccent LEDs wiring and setuprdquo page

Recommended power wire gauges (22 AWG) are given for 2-strip blade For 3-strip blade you gonna need at least 20 AWG wires

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 29

ldquoproffieboard_v1_confighrdquo

3WIRING DIAGRAMS1

Basic Neopixel wiringldquoconfighrdquo file setup

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

NUM_BLADES 3NUM_BUTTONS 2VOLUME 1000CLASH_THRESHOLD_G 10IgnitionDelaylt0 any blade stylegtIgnitionDelaylt800 any blade stylegtIgnitionDelaylt800 any blade stylegtWS2811BladePtrlt118 WS2811 800kHz | WS2811 GRBgt()WS2811BladePtrlt26 blade2Pin ltbladePowerPin4gtgt()WS2811BladePtrlt26 blade3Pin ltbladePowerPin5gtgt()

ProffieBoard config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)Volume level (0-3000)Clash sensitivity (adjust lower or higher with 01 step)ldquoBlade 1rdquo style (main blade with IgnitionDelay 0)ldquoBlade 2rdquo style (CG blade 1 with IgnitionDelay 800)ldquoBlade 3rdquo style (CG blade 2 with IgnitionDelay 800)

strip configuration (defines how many pixels it has and to which LED output and pin is wired)

Preset 1

any blade style

strip (blade) 1 configuration

adjust this number to match your strips leds count

strip (blade) 2 configuration

strip (blade) 3 configuration

Preset 2 etc

Use a given or build your wiring diagram on THIS PAGE then open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text

Editor (Notepad - to see code correctly in Notepad Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all

text) and Delete it then Copy-and-Paste (Ctrl+C Ctrl+V) your wiring diagram config code (example below) into empty _configh file and

Save it under new name Follow the instructions on page 22 to upload it to the board

PROFFIEBOARD INSTRUCTIONS

30 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Basic Segmented string wiring diagram

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

+

+

-

-

24 A

WG

28 AWG

30-32 AWG30-32 AWG

Protected 36-37V (42V max at full charge) 10A 3500mAh battery recommended+18650 battery holder (optional)Keystone 1042P

AV switch with accent led(constantly ON no effects)

accent leds run mostly at10-15mA so resistors for them must be calculated accordingly

6-segments string blade

FoC string

N-channel FET3A minimum

123456

Calculate resistors for each led segment of the blade string depending on which leds are used 5mm leds have max drive current around 25mA per led when 10mm leds can be 100mA and 200mA per ledSo pay attention to your led max current and Forward Voltage (Vf) when calculating a segment resistor resistence as well as its wattage Also choose wire gauges accordingly to meet segments and total blade max current draw level

LED Resistor Calculator

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 31

ldquoproffieboard_v1_confighrdquo

3WIRING DIAGRAMS1

Basic Segmented string wiringldquoconfighrdquo file setup

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

NUM_BLADES 1NUM_BUTTONS 2VOLUME 1000CLASH_THRESHOLD_G 10StyleNormalPtrltCYAN WHITE 300 800gt()ltBlue3mmLED BladePin White3mmLEDgt

ProffieBoard config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)Volume level (0-3000)Clash sensitivity (adjust lower or higher with 01 step)Blade styleLED string configuration(here you mention the color and type of leds usedin the main blade string segments and FoC stringBladePin is the FoC signal pin (Blade ID pin))

Preset

LED string configuration

Use a given or build your wiring diagram on THIS PAGE then open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text

Editor (Notepad - to see code correctly in Notepad Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all

text) and Delete it then Copy-and-Paste (Ctrl+C Ctrl+V) your wiring diagram config code (example below) into empty _configh file and

Save it under new name Follow the instructions on page 22 to upload it to the board

PROFFIEBOARD INSTRUCTIONS

32 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Accent LEDs wiring diagram(optional)

Accent LEDs work with ProffieBoard as additional ldquobladesrdquo when powered by LED outputs 4 5 6 or Data pads 1 2 3 5 as PWM So they can

have any effect that blade can have If no effects needed accent led can be powered just by a 33V output pad (power-on led indication)

30-32 AWG

with Neopixel blade setup these 4 outputsdonrsquot work for regular accent leds

Recommended resistors to use for accent leds at 33V power source and 15mA drive

ndash 100 Ohm for Red (lt100000gt value in the code)ndash 13 Ohm for Green (lt13000gt value in the code)ndash 13 Ohm for Blue (lt13000gt value in the code)ndash 100 Ohm for Yellow (lt100000gt value in the code)ndash 20 Ohm for White (lt20000gt value in the code)

RGB ledcommon-anode

8 ldquobladesrdquo1 main and 7 accent leds

main blade style (effects) main blade style (effects)

7 accent leds style (effects)accent led style (effects)

7 accent leds configurations

RGB accent led configuration

2 ldquobladesrdquo1 main and 1 RGB accent led

ldquoPower-onrdquo indicationaccent leds (no effects)

7 accent leds withindependent effects

RGB accent led

a) b)

b)

c)

c)

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 33

3WIRING DIAGRAMS1

Neopixel Accent LEDs wiring diagram(optional)

With Neopixel setup additional neopixel leds or arrays can be used as accent leds There are 2 ways to wire them using additional Data

pins 2 3 4 5 or ldquoSub-bladesrdquo wiring with just 1 Data output pin Same way Neopixel connectors with on-board leds ca be wired

Option 1 ndash with extra Data pins

Main Blade

some accent leds

D1

D2

crystal leds

330 Ohm

330 Ohm

330 Ohm

main blade style (effects)

main blade 144 leds Data pin 1

accent leds blade style (effects)

accent leds ldquobladerdquo 4 leds Data pin 2

crystal leds blade style (effects)

crystal leds ldquobladerdquo 2 leds Data pin 3

3 ldquobladesrdquo1 main 1 accent leds array and 1 crystal leds array

PROFFIEBOARD INSTRUCTIONS

D3

follow arrows direction

34 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Neopixel Accent LEDs wiring diagram(optional)

PROFFIEBOARD INSTRUCTIONS

Main Blade

some accent leds

1

3

5678

2

4

D1

crystal leds

follow arrows direction

330 Ohm

330 OhmData signal

With this setup a single array of neopixel leds is separated into a couple of sub-blades with their own style configuration and behaviour This

is really usefull when you want to use only one data pin More about ldquoSub-bladesrdquo on ProffieOS wiki page

Option 2 ndash with ldquoSub-bladesrdquo

main blade style (effects)

main blade sub-blade 140 leds (7-146) but from 6 to 145 in the code

accent leds blade style (effects)

accent leds sub-blade 4 leds (1-4) but from 0 to 3 in the code

crystal leds blade style (effects)

146 leds total used

crystal leds sub-blade 2 leds (5-6) but from 4 to 5 in the code

update default 144 to a higher total value if you get all accent leds +Main blade gt 144 Example update to 146 if you have 2 crystal leds +4 accent leds + 140 Main blade leds = 146

3 ldquobladesrdquo 1 main 1 accent leds array and 1 crystal leds array

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 35

3WIRING DIAGRAMS1

OLED display wiring diagram(optional)

SSD1306 128x32 pixels OLED display allows to show battery level current preset name play different animations and even simple games It

can be wired to any blade configuration and requires just one additional line in the code to work You can get monochrome display in white

or blue color

SSD1306128x32OLED

SSD1306 ndash with blue or white display color selectSSD1306 ndash cheaper priceSSD1306 just screen ndash blue or white select

30-32 AWG

30-32 AWG

add this line to enable OLED display

display shows a preset name written in these quotes ldquoldquo

PROFFIEBOARD INSTRUCTIONS

36 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Bluetooth module wiring diagram(optional)

SOON

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 37

3WIRING DIAGRAMS1

Blade ID resistor functions(optional)

SOON

PROFFIEBOARD INSTRUCTIONS

38 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

website ProffieBoard FULL wiring diagrams link

Scroll the page down till you see the interactive diagram Above the diagram there are components selection options Build your saber setup

with it and follow diagram to wire your board Then you need to copy the configuration code below and paste it into your _configh file

Choose components you want

3WIRING DIAGRAMS1

More wiring diagrams

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 39

3WIRING DIAGRAMS1

How to use it

PROFFIEBOARD INSTRUCTIONS

Blade ignitionretraction ndash assuming you have at least one button pressing it briefly should turn the saber on or off If you have an AUX button pressing it briefly should also turn the saber on and off If you have no buttons you can turn the saber on and off by twisting your wrist back and forth Note that the motion has to be done long enough to count so a very quick flick of the wrist will not workTurn On muted ndash double-click power buttonNext preset ndash while saber is off click the AUX buttonPrevious preset ndash hold AUX button and click the Activation buttonTrigger Clash ndash while saber is on hit the bladeTrigger Lockup ndash while saber is on hold Activation button then trigger a clash Lockup releases when you let go of the Acti-vation buttonTrigger Drag ndash like lockup but point saber mostly down before holding Activation buttonTrigger Force ndash long-click AUX buttonStart soundtrack ndash long-click the Activation buttonTrigger Blaster Block ndash while saber is on short-click AUX button

Serial Monitor commands

battery_voltage ndash gets current battery voltage valueget_volume ndash get current volume valuepow ndash power OnOff the saberon ndash power On the saberoff ndash power Off the saberset_volume lt0-3000gt ndash set volume value (example set_volume 500)play ndash play the default preset trackplay trackslttrack namegt ndash play a specific track from tracks folder (example play tracksvenuswav)stop ndash stop the playing trackforce ndash play ldquoforcerdquo sound effectsdrag ndash play ldquodragrdquo sound effectsblast ndash play ldquoblasterrdquo sound effectslock ndash play ldquolockuprdquo sound effectsclash ndash play ldquoclashrdquo sound effectsreset ndash reboot the boardn ndash switch to next presetp ndash switch to previous presetlist_presets ndash show all presetssdtest ndash test SD card speed

40 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3FIRMWARE UPLOAD AND UPDATE2

Software installation and setup

PROFFIEBOARD INSTRUCTIONS

To upload firmware to ProffieBoard Arduino IDE program is required Follow these steps to install it to your PC

1 Install latest Arduino IDE software (donrsquot use BETA)

Installing as Windows app also is not recommended

because it will be installed in a specific protected folder that

wonrsquot allow you to install any additional softwareplugin in it

If ProffieBoard wonrsquot show up in COM port use

Arduino IDE 186 version

2 Install the Proffieboard Arduino Plugin and Zadig software

Follow installation instructions

3 Select Proffieboard-STM32L433 in Tools -gt Board

USB Type ndash Serial CPU Speed ndash 80 MHz Optimize ndash Smallest Code DOSFS ndash SDCARD (SPI) Port ndash COM(the number your PC assigned) (Butterfly-L433CC)

Connect Proffieboard via USB cable to PC to be able to select

the Port

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 41

3FIRMWARE UPLOAD AND UPDATE2

Uploading firmware

PROFFIEBOARD INSTRUCTIONS

1 Download the ProffieBoard firmware and SD card content

Unzip lightsaber-1286zip to your Documents directory or to

Desktop but not to Arduino program folder or anywhere in

Programs directory where all programs are installed You will

see a lightsaber folder and files inside it Donrsquot move any of

these files to any other location outside the lightsaber folder

and donrsquot reorganize them Unzip ProffieOS_SD_Cardzip to the

folder where you keep lightsaber-1286 folder Copy all files

from ProffieOS_SD_Card folder to your SD card

2 Unhide file extensions in File Explorer settings to see h ending

of config files Donrsquot add ldquohrdquo to the config file name Go to config folder and create you own configh file (see page

42 for how-to)

Double-click the lightsaberino file

3 Add the name of your configh file as shown and Save this

lightsaberino file Make sure the other config files are

commented out there should be only one CONFIG_FILE

without You can have multiple config files

in lightsabergtconfig folder and just define the one you need

in lightsaberino file and upload it again to ProffieBoard

4 Connect battery to ProffieBoard and hook up to your PC

with a data transfer micro-USB-to-USB cable

Press arrow button it will compile and upload firmware to the

board Wait for red text progress bars to stop at 100

ProffieBoard will play boot sound if speaker is connected

Now you can unplug the USB cable Done

If it gives an error instead this means your configh file has

issues define CONFIG_FILE name has mistakes configh file

is out of config folder your PC user name is non-latin

42 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

33

configh file structure editing

PROFFIEBOARD INSTRUCTIONS

CHANGING PARAMETERS

All sound files (sound fonts music tracks) are stored on the micro SD card Add required sound fonts folders (Plecter NEC and Smoothswing

fonts are supported no need to change WAV files names just copy and paste) to SD card root directory as itrsquos done in the default

ProffieOS_SD_Card content folder and music tracks to the tracks folder

Make sure to name all music tracks and sound fonts folders with latin characters and only up to 8 characters long without using any special

characters (like |[- etc)

Make sure you have a configini file in each sound font folder if there is none - copy one from some default TeensySaberProffieBoard sound

font and paste into newly added sound font folder It has only one parameter that you can modify - humstart It helps to match hum sound

start with blade ignition 1000 usually works fine

All blade effects LED configuration volume level clash sensitivity etc are changed in the configh file located in lightsabergtconfig folder

To do that open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text Editor (Notepad - to see code correctly in Notepad

Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all text) and Delete it then Copy-and-Paste (Ctrl+C

Ctrl+V) your wiring diagram config code into empty _configh file and Save it under new name Follow the instructions on page 39 to

upload it to the board

Proffieboard config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)

volume level (0-3000)

clash sensitivity (adjust lower or higher with 01 step)

sound font folder nametrack name

Preset name

Blade style

LED configuration (use these XP-E2 LED templatesto define your LED)

for Red use 1 Ohm resistor for Green - no resistor for Blue use 024 Ohm

NoLED ndash no 4th led used

Preset 1

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 43

33

Blade Styles

StylePtrltInOutHelperltSimpleClashltLockupltBlastltOnSparkltAudioFlickerltRgblt02550gtRgblt501000gtgtRgblt2552550gt150gtRgblt255500gtgtAudioFlickerltRgblt1002550gtRgblt2550150gtgtgtRgblt255100150gt40gt200300Blackgtgt

ndash this is how the Blade Style code looks pasted in the configh file Preset (it sits inside a StylePtrltgt container)

ndash this is how the Blade Style code looks when editing it inside a Blade Style Editor

Each Blade Style is made of a variety of Effects each added effect goes instead of a base color in the previous effect

PROFFIEBOARD INSTRUCTIONS

CHANGING PARAMETERS

ProffieBoard and TeensySaber use Blade Styles for the main saber blade and any other accent leds to define all light effects (color changing

flashes flickering delays ignitionretraction timing etc)

Use Blade Style Editor to create and adjust Blade Styles Megtooth Sith Sabers did a great video tutorial where he shows and explains

how to use Blade Style Editor Also you can grab some pre-made Blade Styles or share yours here on TRA forums

A Blade Style example of simple flickering Green blade with Spark on start Clash Blaster Lockup and Drag IgnitionRetraction effects

InOutHelperltSimpleClashltLockupltBlastltOnSparkltAudioFlickerltRgblt02550gtRgblt501000gtgtRgblt2552550gt150gtRgblt255500gtgtAudioFlickerltRgblt1002550gtRgblt2550150gtgtgtRgblt255100150gt40gt200300Blackgt

InOutHelperltbase color200300Blackgt ndash base color can be defined by words (WHITE RED GREEN PURPLE etc) or by Rgblt0-2550-2550-255gt values for more

custom shades 200 is extension length in milliseconds 300 is retraction length in milliseconds Black is color when retracted (also can be any other color)

SimpleClashltbase colorclash color40gt ndash clash effect 40 is clash duration in milliseconds

Lockupltbase colorlockup colorgt ndash lockup effect

Blastltbase colorblast colorgt ndash blaster effect

OnSparkltbase colorspark color150gt ndash spark on ignition effect 150 is spark duration in milliseconds

AudioFlickerltrdquoArdquo colorrdquoBrdquo colorgt ndash flickering effect (blade flickers to the actual saber hum sound) the more difference between ldquoArdquo and ldquoBrdquo colors - the more

abrupt is flickering

Rgblt255500gt ndash actual color in RGB format (0 is no light 255 is the maximum brightness value for Red Green or Blue channel)

44 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

ndash SanDisk 4GB microSDHC Class 4 (Genuine) ndash SanDisk 4GB microSDHC Class 4 (Genuine)

130238 kbs = 1477 simultaneous audio streams 137812 kbs = 1562 simultaneous audio streams

ndash Patriot LX Series 16GB microSDHC UHS-IU1 Class 10 ndash Patriot LX Series 16GB microSDHC UHS-IU1 Class 10

133005 kbs = 1508 simultaneous audio streams

ndash GSkill 16GB microSDHC UHS-IU1 Class 10 ndash GSkill 16GB microSDHC UHS-IU1 Class 10

129534 kbs = 1469 simultaneous audio streams

ndash Kingston 16GB microSDHC UHS-IU1 Class 10 ndash Kingston 16GB microSDHC UHS-IU1 Class 10

128090 kbs = 1452 simultaneous audio streams

ndash SanDisk Ultra 16GB microSDHC UHS-IU1 A1 Class 10 ndash SanDisk Ultra 16GB microSDHC UHS-IU1 A1 Class 10

102663 kbs = 1164 simultaneous audio streams 11124 kbs = 1261 simultaneous audio streams

ndash SanDisk 8GB microSDHC Class 4 ndash SanDisk 8GB microSDHC Class 4

108506 kbs = 1230 simultaneous audio streams

ndash SanDisk 16GB microSDHC Class 4 ndash SanDisk 16GB microSDHC Class 4

102663 kbs = 1164 simultaneous audio streams 106957 kbs = 1213 simultaneous audio streams

ndash SanDisk Ultra 16GB microSDHC UHS-IU1 Class 10 ndash SanDisk Ultra 16GB microSDHC UHS-IU1 Class 10

102663 kbs = 1164 simultaneous audio streams 103909 kbs = 1178 simultaneous audio streams

ndash Smartbuy 4GB microSDHC Class 4 ndash Smartbuy 4GB microSDHC Class 4

75437 kbs = 855 simultaneous audio streams

ndash Kingston 8GB microSDHC Class 4 ndash Kingston 8GB microSDHC Class 4

75209 kbs = 822 simultaneous audio streams

ndash SanDisk 4GB microSDHC Class 4 (Fake) ndash SanDisk 4GB microSDHC Class 4 (Fake)

677 kbs = 769 simultaneous audio streams

Here is a list of tested micro SD cards speed with TeensySaber V3 and ProffieBoard Any card with speed over 900 kbs is recommended the

higher the speed is ndash the better Memory size of 4-16Gb is more than enough Cards were tested with a default firmware (1291) compiled

with ldquoSmallest Coderdquo under Optimize ldquodefault_proffieboard_confighrdquo file and default ProffieOS SD card sound files (7 folders)

To test your SD card speed simply hook up ProffieBoard to PC open Arduino IDE go to Tools and open Serial Monitor make sure you have

New Line and 9600 baud rate selected on the bottom of Serial Monitor window type and send sdtest command wait for the test result

4Recommended micro SD cards

BEST

TEENSYSABER PROFFIEBOARD

GOOD

BAD

PROFFIEBOARD INSTRUCTIONS

SD CARD RECOMMENDATIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 45

There are a lot of fake (chinese copies) microSD cards on the market from aliexpress ebay amazon etc They look very similar to genuine

cards but are a bit different though and have a twice lower writingreading speed Here is an example of a SanDisk 4Gb Class 4 card one is

genuine with 137812 kbs speed and the other one is fake with 677 kbs speed I got from ebay seller

Be carefull and pay attention to how the actual card looks if you are not sure ask seller for the real photo of SD card he sells

4Genuine and Fake SanDisk 4Gb Class 4 microSD

PROFFIEBOARD INSTRUCTIONS

SD CARD RECOMMENDATIONS

46 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

WIRE GAUGE GUIDE

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 47

RECHARGE PORTS AND KILL SWITCHES

48 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

NEOPIXEL STRIPS CURRENT DRAW

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 49

6TROUBLESHOOTING

For more help please check these linksProffieOSProffieBoardTeensySaber wiki on GitHubAsk your question on The Rebel Armory forumsAsk your question on FX-sabers forumsAsk your question in facebook group

How to solve most common issues

Quick troubleshooting tips

TeensySaber board or Proffieboard is not recognized by computer (nothing under Port selection in Arduino)

ndash Make sure a charged 37V battery is connected to the board micro-USB cable is a data transfer cable all plugins and drivers are installed ndash

check again pages 21 for TeensySaber or 40 for Proffieboard Try a different USB port on your computer

Sketch (code) compile error in Arduino IDE

ndash Check your define CONFIG_FILE ldquoconfig_confighrdquo line in opened lightsaberino file if itrsquos written correctly with config in it

Sketch (code) compile error in Arduino IDE

ndash Check if the _configh file you defined in the lightsaberino sketch file is same name as in the lightsaber-rdquofirmware versionrdquolightsaber

config folder and is located in this folder

Sketch (code) compile error in Arduino IDE

ndash Check your settings under Tools tab in Arduino IDE program Check again pages 21 for TeensySaber or 40 for Proffieboard

Sketch (code) compile error in Arduino IDE

ndash Check if your _configh file is correct Blade Styles Presets const unsigned int maxLedsPerStrip = 144 if BladeConfig blades[] = is correct

Sketch (code) compile error in Arduino IDE

ndash If nothing helps install Arduino IDE version 186 and try to compile and upload the firmware again

Sound doesnrsquot play

ndash Remove SD card and insert again check speaker wiring Make sure all sound files on SD card are correctly named (8 characters max long)

Re-format SD card in FAT32 load sound files and try again try another SD card

Board says ldquoLOW POWERrdquo

ndash Charge the battery

Serial Monitor shows info sent by the board but your commands donrsquot work

ndash In the bottom right corner of Serial Monitor window make sure the Line Ending drop down is set to New Line

Sound is weird and distorted

ndash Check your SD card speed (see page 44) Check speaker wiring try another good speaker

16 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

Bluetooth module wiring diagram(optional)

SOON

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 17

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

Blade ID resistor functions(optional)

SOON

18 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

website TeensySaber V3 FULL wiring diagrams link

Scroll the page down till you see the interactive diagram Above the diagram there are components selection options Build your saber setup

with it and follow diagram to wire your board Then you need to copy the configuration code below and paste it into your _configh file

Choose components you want

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

More wiring diagrams

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 19

20 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

How to use it

Blade ignitionretraction ndash assuming you have at least one button pressing it briefly should turn the saber on or off If you have an AUX button pressing it briefly should also turn the saber on and off If you have no buttons you can turn the saber on and off by twisting your wrist back and forth Note that the motion has to be done long enough to count so a very quick flick of the wrist will not workTurn On muted ndash double-click power buttonNext preset ndash while saber is off click the AUX buttonPrevious preset ndash hold AUX button and click the Activation buttonTrigger Clash ndash while saber is on hit the bladeTrigger Lockup ndash while saber is on hold Activation button then trigger a clash Lockup releases when you let go of the Acti-vation buttonTrigger Drag ndash like lockup but point saber mostly down before holding Activation buttonTrigger Force ndash long-click AUX buttonStart soundtrack ndash long-click the Activation buttonTrigger Blaster Block ndash while saber is on short-click AUX button

Serial Monitor commands

battery_voltage ndash gets current battery voltage valueget_volume ndash get current volume valuepow ndash power OnOff the saberon ndash power On the saberoff ndash power Off the saberset_volume lt0-3000gt ndash set volume value (example set_volume 500)play ndash play the default preset trackplay trackslttrack namegt ndash play a specific track from tracks folder (example play tracksvenuswav)stop ndash stop the playing trackforce ndash play ldquoforcerdquo sound effectsdrag ndash play ldquodragrdquo sound effectsblast ndash play ldquoblasterrdquo sound effectslock ndash play ldquolockuprdquo sound effectsclash ndash play ldquoclashrdquo sound effectsreset ndash reboot the boardn ndash switch to next presetp ndash switch to previous presetlist_presets ndash show all presetssdtest ndash test SD card speed

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 21

2TEENSYSABER V3 INSTRUCTIONS

FIRMWARE UPLOAD AND UPDATE2

Software installation and setup

To upload firmware to TeensySaber board Arduino IDE program is required Follow these steps to install it to your PC

1 Install latest Arduino IDE software (donrsquot use BETA)

Installing as Windows app also is not recommended

because it will be installed in a specific protected folder that

wonrsquot allow you to install Teensyduino software in it

If TeensySaber wonrsquot show up in COM port use

Arduino IDE 186 version

2 Install latest Teensyduino software in same directory

usually itrsquos CProgram Files (x86)Arduino on Windows

Follow installation instructions for your system

3 Select Teensy 32 31 in Tools -gt Board

USB Type ndash Serial CPU Speed ndash 96 MHz (overclock) Optimize ndash Smallest Code Port ndash COM(the number your PC assigned) (Teensy 32) Serial

Connect TeensySaber via USB cable to PC to be able to select

the Port donrsquot forget to connect battery first

22 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

1 Download the TeensySaber firmware and SD card content

Unzip lightsaber-1286zip to your Documents directory or to

Desktop but not to Arduino program folder or anywhere in

Programs directory where all programs are installed You will

see a lightsaber folder and files inside it Donrsquot move any of

these files to any other location outside the lightsaber folder

and donrsquot reorganize them Unzip ProffieOS_SD_Cardzip to the

folder where you keep lightsaber-1286 folder Copy all files

from ProffieOS_SD_Card folder to your SD card

2 Unhide file extensions in File Explorer settings to see h ending

of config files Donrsquot add ldquohrdquo to the config file name

Go to config folder and create you own configh file (see page

23 for how-to)

Double-click the lightsaberino file

3 Add the name of your configh file as shown and Save this

lightsaberino file Make sure the other config files are

commented out there should be only one CONFIG_FILE

without You can have multiple config files

in lightsabergtconfig folder and just define the one you need

in lightsaberino file and upload it again to TeensySaber board

4 Connect battery to TeensySaber board and hook up to your PC

with a data transfer micro-USB-to-USB cable

Press arrow button it will compile and upload firmware to the

board Wait for your PC to make a sound or TeensySaber will

play boot sound if speaker is connected Now you can unplug

the USB cable Done

If it gives an error instead this means your configh file has

issues define CONFIG_FILE name has mistakes configh file

is out of config folder your PC user name is non-latin

2TEENSYSABER V3 INSTRUCTIONS

FIRMWARE UPLOAD AND UPDATE2

Uploading firmware

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 23

2TEENSYSABER V3 INSTRUCTIONS

CHANGING PARAMETERS3

Changing sound board parameters

All sound files (sound fonts music tracks) are stored on the micro SD card Add required sound fonts folders (Plecter NEC and Smoothswing

fonts are supported no need to change WAV files names just copy and paste) to SD card root directory as itrsquos done in the default

ProffieOS_SD_Card content folder and music tracks to the tracks folder

Make sure to name all music tracks and sound fonts folders with latin characters and only up to 8 characters long without using any special

characters (like |[- etc)

Make sure you have a configini file in each sound font folder if there is none - copy one from some default TeensySaberProffieBoard sound

font and paste into newly added sound font folder It has only one parameter that you can modify - humstart It helps to match hum sound

start with blade ignition 1000 usually works fine

All blade effects LED configuration volume level clash sensitivity etc are changed in the configh file located in lightsabergtconfig folder

To do that open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text Editor (Notepad - to see code correctly in Notepad

Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all text) and Delete it then Copy-and-Paste (Ctrl+C

Ctrl+V) your wiring diagram config code into empty _configh file and Save it under new name Follow the instructions on page 22 to

upload it to the board

TeensySaber V3 config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)

volume level (0-3000)

clash sensitivity (adjust lower or higher with 01 step)

sound font folder nametrack name

Preset name

Blade style

LED configuration (use these XP-E2 LED templatesto define your LED)

for Red use 1 Ohm resistor for Green - no resistor for Blue use 024 Ohm

NoLED ndash no 4th led used

Preset 1

24 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

31

PROFFIEBOARD INSTRUCTIONS

Whatrsquos needed

ndash ProffieBoard

ndash micro SD-card (see page 44 for recommendations)

ndash a USB micro SD-card reader (to load sound files from PC to micro SD card)

ndash micro USB data transfer cable (CABLES THAT SUPPORT ONLY CHARGING WONrsquoT WORK)

ndash wires of different gauges (32-20 AWG) (PTFE coated copper stranded wires recommended) heat shrink

ndash ESD safe soldering station solder wire flux etc

ndash pliers helping hands etc

ndash isopropyl alcohol to clean pads before soldering (helps solder to stick better)

ndash Digital Multimeter (VERY USEFUL)

ndash computer running Windows Linux or Mac OS with internet access

ndash 37V Li-Ion Protected rechargeable battery switches recharge port speaker LEDs resistors chassis etc

ndash Smart Li-Ion CC-CV (Constant Current - Constant Voltage mode) battery charger for 37V (42V) cells

ndash patience

WIRING DIAGRAMS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 25

31

PROFFIEBOARD INSTRUCTIONS

Board pinout

Battery + ndash 26 to 45 volt input drives everything except the LEDs

Battery - ndash negative pad for LEDs needs to be at same level as GND when both are connected Both pads are internally connected

GND ndash ground for electronics except LEDs Note that there are two GND pads on the board that are internally connected

Speaker +- ndash hooks up to speaker

Activation (1) Aux (2) Aux2 button (3) ndash hook up to closing buttons or potentially touch buttons

Blade ID Neopixel Data 1 ndash normally used to measure the blade ID restor and if itrsquos a neopixel blade feed out neopixel data

Data 2 3 4 5 ndash additional neopixel data outputs or free for other purposes

LED 1 2 3 4 5 6 ndash hooks up to negative side of LED (positive side of LED hooks up directly to battery) These pads can handle

up to 30 volts

SDA SCL ndash these pins are used to wire OLED display or to communicate with the gyro and accelerometer chip

RX TX ndash these pins are used for wiring a bluetooth module for wireless control

SWDCLK SWDIO ndash can be hooked up to a ST-LINK device and lets you debug programs running on the ProffieBoard

+5V ndash generated by the ProffieBoard normally itrsquos only ON when sound is playing

+33V ndash generated by the ProffieBoard for powering OLED display Bluetooth module or some accent leds

BOOT RESET ndash buttons to put the ProffieBoard in bootloader mode if uploading doesnrsquot work

micro USB port ndash micro USB port used only for firmware upload and can be used for sound files upload to SD card (from firmware version

1291 and up) THIS PORT ISNrsquoT USED FOR CHARGING THE BATTERY

LED 4LED 3

LED 2

LED 1

LED 5

LED 6

RESETBOOT

Battery - Battery -

Speaker + (red dot or ldquo+rdquo mark on speaker)

Battery +

Aux button (2)Activation button (1)

Aux2 button (3)

Blade ID Neopixel Data 1

Data 5

Data 4Data 3Data 2

+33V

SWDIO

SWDCLK

+5V

TXRX

GND

GND

Reset

Speaker -

SCLSDA

micro USB port

WIRING DIAGRAMS

26 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Basic Tri-Cree wiring diagram(In-hilt LED)

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

+

+

-

-

26 AWG

26 A

WG

30-32 AWG

28-30 AWG

28-3

0 A

WG

30-32 AWG

Protected 36-37V (42V max at full charge) 10A 3500mAh battery recommended+18650 battery holder (optional)Keystone 1042P

AV switch with accent led(constantly ON no effects)

accent leds run mostly at10-15mA so resistors for them must be calculated accordingly

Main RGB led

additional RGB leds(optional)

In case no additional high power leds are needed LED channels 4 5 6 can be used for 3 controllable(programmable for different effects) accent leds So AV switch led can be wired to one of these channelsAccent leds also can be wired to Data pads 1-5 please see ldquoAccent LEDs wiring and setuprdquo page

LED Resistor Calculator

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 27

3WIRING DIAGRAMS1

Basic Tri-Cree wiring (In-hilt LED)ldquoconfighrdquo file setup

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

Use a given or build your wiring diagram on THIS PAGE then open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text

Editor (Notepad - to see code correctly in Notepad Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all

text) and Delete it then Copy-and-Paste (Ctrl+C Ctrl+V) your wiring diagram config code (example below) into empty _configh file and

Save it under new name Follow the instructions on page 22 to upload it to the board

ldquoproffieboard_v1_confighrdquoNUM_BLADES 2NUM_BUTTONS 2VOLUME 1000CLASH_THRESHOLD_G 10StyleNormalPtrltCYAN WHITE 300 800gt()StyleNormalPtrltCYAN WHITE 300 800gt()

CreeXPE2RedTemplatelt1000gtCreeXPE2GreenTemplatelt0gtCreeXPE2BlueTemplatelt240gtNoLED

ProffieBoard config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)Volume level (0-3000)Clash sensitivity (adjust lower or higher with 01 step)ldquoBlade 1rdquo styleldquoBlade 2rdquo style (in case only 1 blade is used you donrsquot need this line)LED configuration (use these XP-E2 LED templatesto define your LED If other LED resistors are used change these values to match Ohm1000=ltvaluegt)

where 1000 is 1 Ohm resistor 0 is no resistor240 is 024 Ohm resistorNoLED ndash no 4th led used

Preset 1

LED 1 configuration

LED 2 configuration

Preset 2 etc

PROFFIEBOARD INSTRUCTIONS

28 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Basic Neopixel wiring diagram

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

+

+

-

-

22 A

WG

22 AWG

x2 28 AWG

x2 26 AWG

22 A

WG

30-32 AWG30-32 AWG

Protected 36-37V (42V max at full charge) 10A 3500mAh or 15A 3120mAhbattery recommended+18650 battery holder (optional)Keystone 1042P

AV switch with accent led(constantly ON no effects)

accent leds run mostly at10-15mA so resistors for them must be calculated accordingly

Main Neopixel strip

additional Neopixelstrips(optional)

Neopixel bladeconnector

330 Ohm on the Blade pcb side

x3 28 AWGor x1 22 AWGfor Negative

330 Ohm on the Blade pcb side

arrows up

330 Ohm on the Blade pcb side

In case no additional Neopixel strips are needed LED channels 4 5 6 can be used for 3 controllable(programmable for different effects) accent leds So AV switch led can be wired to one of these channelsAccent leds also can be wired to Data pads 2-5 please see ldquoAccent LEDs wiring and setuprdquo page

Recommended power wire gauges (22 AWG) are given for 2-strip blade For 3-strip blade you gonna need at least 20 AWG wires

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 29

ldquoproffieboard_v1_confighrdquo

3WIRING DIAGRAMS1

Basic Neopixel wiringldquoconfighrdquo file setup

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

NUM_BLADES 3NUM_BUTTONS 2VOLUME 1000CLASH_THRESHOLD_G 10IgnitionDelaylt0 any blade stylegtIgnitionDelaylt800 any blade stylegtIgnitionDelaylt800 any blade stylegtWS2811BladePtrlt118 WS2811 800kHz | WS2811 GRBgt()WS2811BladePtrlt26 blade2Pin ltbladePowerPin4gtgt()WS2811BladePtrlt26 blade3Pin ltbladePowerPin5gtgt()

ProffieBoard config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)Volume level (0-3000)Clash sensitivity (adjust lower or higher with 01 step)ldquoBlade 1rdquo style (main blade with IgnitionDelay 0)ldquoBlade 2rdquo style (CG blade 1 with IgnitionDelay 800)ldquoBlade 3rdquo style (CG blade 2 with IgnitionDelay 800)

strip configuration (defines how many pixels it has and to which LED output and pin is wired)

Preset 1

any blade style

strip (blade) 1 configuration

adjust this number to match your strips leds count

strip (blade) 2 configuration

strip (blade) 3 configuration

Preset 2 etc

Use a given or build your wiring diagram on THIS PAGE then open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text

Editor (Notepad - to see code correctly in Notepad Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all

text) and Delete it then Copy-and-Paste (Ctrl+C Ctrl+V) your wiring diagram config code (example below) into empty _configh file and

Save it under new name Follow the instructions on page 22 to upload it to the board

PROFFIEBOARD INSTRUCTIONS

30 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Basic Segmented string wiring diagram

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

+

+

-

-

24 A

WG

28 AWG

30-32 AWG30-32 AWG

Protected 36-37V (42V max at full charge) 10A 3500mAh battery recommended+18650 battery holder (optional)Keystone 1042P

AV switch with accent led(constantly ON no effects)

accent leds run mostly at10-15mA so resistors for them must be calculated accordingly

6-segments string blade

FoC string

N-channel FET3A minimum

123456

Calculate resistors for each led segment of the blade string depending on which leds are used 5mm leds have max drive current around 25mA per led when 10mm leds can be 100mA and 200mA per ledSo pay attention to your led max current and Forward Voltage (Vf) when calculating a segment resistor resistence as well as its wattage Also choose wire gauges accordingly to meet segments and total blade max current draw level

LED Resistor Calculator

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 31

ldquoproffieboard_v1_confighrdquo

3WIRING DIAGRAMS1

Basic Segmented string wiringldquoconfighrdquo file setup

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

NUM_BLADES 1NUM_BUTTONS 2VOLUME 1000CLASH_THRESHOLD_G 10StyleNormalPtrltCYAN WHITE 300 800gt()ltBlue3mmLED BladePin White3mmLEDgt

ProffieBoard config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)Volume level (0-3000)Clash sensitivity (adjust lower or higher with 01 step)Blade styleLED string configuration(here you mention the color and type of leds usedin the main blade string segments and FoC stringBladePin is the FoC signal pin (Blade ID pin))

Preset

LED string configuration

Use a given or build your wiring diagram on THIS PAGE then open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text

Editor (Notepad - to see code correctly in Notepad Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all

text) and Delete it then Copy-and-Paste (Ctrl+C Ctrl+V) your wiring diagram config code (example below) into empty _configh file and

Save it under new name Follow the instructions on page 22 to upload it to the board

PROFFIEBOARD INSTRUCTIONS

32 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Accent LEDs wiring diagram(optional)

Accent LEDs work with ProffieBoard as additional ldquobladesrdquo when powered by LED outputs 4 5 6 or Data pads 1 2 3 5 as PWM So they can

have any effect that blade can have If no effects needed accent led can be powered just by a 33V output pad (power-on led indication)

30-32 AWG

with Neopixel blade setup these 4 outputsdonrsquot work for regular accent leds

Recommended resistors to use for accent leds at 33V power source and 15mA drive

ndash 100 Ohm for Red (lt100000gt value in the code)ndash 13 Ohm for Green (lt13000gt value in the code)ndash 13 Ohm for Blue (lt13000gt value in the code)ndash 100 Ohm for Yellow (lt100000gt value in the code)ndash 20 Ohm for White (lt20000gt value in the code)

RGB ledcommon-anode

8 ldquobladesrdquo1 main and 7 accent leds

main blade style (effects) main blade style (effects)

7 accent leds style (effects)accent led style (effects)

7 accent leds configurations

RGB accent led configuration

2 ldquobladesrdquo1 main and 1 RGB accent led

ldquoPower-onrdquo indicationaccent leds (no effects)

7 accent leds withindependent effects

RGB accent led

a) b)

b)

c)

c)

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 33

3WIRING DIAGRAMS1

Neopixel Accent LEDs wiring diagram(optional)

With Neopixel setup additional neopixel leds or arrays can be used as accent leds There are 2 ways to wire them using additional Data

pins 2 3 4 5 or ldquoSub-bladesrdquo wiring with just 1 Data output pin Same way Neopixel connectors with on-board leds ca be wired

Option 1 ndash with extra Data pins

Main Blade

some accent leds

D1

D2

crystal leds

330 Ohm

330 Ohm

330 Ohm

main blade style (effects)

main blade 144 leds Data pin 1

accent leds blade style (effects)

accent leds ldquobladerdquo 4 leds Data pin 2

crystal leds blade style (effects)

crystal leds ldquobladerdquo 2 leds Data pin 3

3 ldquobladesrdquo1 main 1 accent leds array and 1 crystal leds array

PROFFIEBOARD INSTRUCTIONS

D3

follow arrows direction

34 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Neopixel Accent LEDs wiring diagram(optional)

PROFFIEBOARD INSTRUCTIONS

Main Blade

some accent leds

1

3

5678

2

4

D1

crystal leds

follow arrows direction

330 Ohm

330 OhmData signal

With this setup a single array of neopixel leds is separated into a couple of sub-blades with their own style configuration and behaviour This

is really usefull when you want to use only one data pin More about ldquoSub-bladesrdquo on ProffieOS wiki page

Option 2 ndash with ldquoSub-bladesrdquo

main blade style (effects)

main blade sub-blade 140 leds (7-146) but from 6 to 145 in the code

accent leds blade style (effects)

accent leds sub-blade 4 leds (1-4) but from 0 to 3 in the code

crystal leds blade style (effects)

146 leds total used

crystal leds sub-blade 2 leds (5-6) but from 4 to 5 in the code

update default 144 to a higher total value if you get all accent leds +Main blade gt 144 Example update to 146 if you have 2 crystal leds +4 accent leds + 140 Main blade leds = 146

3 ldquobladesrdquo 1 main 1 accent leds array and 1 crystal leds array

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 35

3WIRING DIAGRAMS1

OLED display wiring diagram(optional)

SSD1306 128x32 pixels OLED display allows to show battery level current preset name play different animations and even simple games It

can be wired to any blade configuration and requires just one additional line in the code to work You can get monochrome display in white

or blue color

SSD1306128x32OLED

SSD1306 ndash with blue or white display color selectSSD1306 ndash cheaper priceSSD1306 just screen ndash blue or white select

30-32 AWG

30-32 AWG

add this line to enable OLED display

display shows a preset name written in these quotes ldquoldquo

PROFFIEBOARD INSTRUCTIONS

36 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Bluetooth module wiring diagram(optional)

SOON

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 37

3WIRING DIAGRAMS1

Blade ID resistor functions(optional)

SOON

PROFFIEBOARD INSTRUCTIONS

38 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

website ProffieBoard FULL wiring diagrams link

Scroll the page down till you see the interactive diagram Above the diagram there are components selection options Build your saber setup

with it and follow diagram to wire your board Then you need to copy the configuration code below and paste it into your _configh file

Choose components you want

3WIRING DIAGRAMS1

More wiring diagrams

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 39

3WIRING DIAGRAMS1

How to use it

PROFFIEBOARD INSTRUCTIONS

Blade ignitionretraction ndash assuming you have at least one button pressing it briefly should turn the saber on or off If you have an AUX button pressing it briefly should also turn the saber on and off If you have no buttons you can turn the saber on and off by twisting your wrist back and forth Note that the motion has to be done long enough to count so a very quick flick of the wrist will not workTurn On muted ndash double-click power buttonNext preset ndash while saber is off click the AUX buttonPrevious preset ndash hold AUX button and click the Activation buttonTrigger Clash ndash while saber is on hit the bladeTrigger Lockup ndash while saber is on hold Activation button then trigger a clash Lockup releases when you let go of the Acti-vation buttonTrigger Drag ndash like lockup but point saber mostly down before holding Activation buttonTrigger Force ndash long-click AUX buttonStart soundtrack ndash long-click the Activation buttonTrigger Blaster Block ndash while saber is on short-click AUX button

Serial Monitor commands

battery_voltage ndash gets current battery voltage valueget_volume ndash get current volume valuepow ndash power OnOff the saberon ndash power On the saberoff ndash power Off the saberset_volume lt0-3000gt ndash set volume value (example set_volume 500)play ndash play the default preset trackplay trackslttrack namegt ndash play a specific track from tracks folder (example play tracksvenuswav)stop ndash stop the playing trackforce ndash play ldquoforcerdquo sound effectsdrag ndash play ldquodragrdquo sound effectsblast ndash play ldquoblasterrdquo sound effectslock ndash play ldquolockuprdquo sound effectsclash ndash play ldquoclashrdquo sound effectsreset ndash reboot the boardn ndash switch to next presetp ndash switch to previous presetlist_presets ndash show all presetssdtest ndash test SD card speed

40 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3FIRMWARE UPLOAD AND UPDATE2

Software installation and setup

PROFFIEBOARD INSTRUCTIONS

To upload firmware to ProffieBoard Arduino IDE program is required Follow these steps to install it to your PC

1 Install latest Arduino IDE software (donrsquot use BETA)

Installing as Windows app also is not recommended

because it will be installed in a specific protected folder that

wonrsquot allow you to install any additional softwareplugin in it

If ProffieBoard wonrsquot show up in COM port use

Arduino IDE 186 version

2 Install the Proffieboard Arduino Plugin and Zadig software

Follow installation instructions

3 Select Proffieboard-STM32L433 in Tools -gt Board

USB Type ndash Serial CPU Speed ndash 80 MHz Optimize ndash Smallest Code DOSFS ndash SDCARD (SPI) Port ndash COM(the number your PC assigned) (Butterfly-L433CC)

Connect Proffieboard via USB cable to PC to be able to select

the Port

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 41

3FIRMWARE UPLOAD AND UPDATE2

Uploading firmware

PROFFIEBOARD INSTRUCTIONS

1 Download the ProffieBoard firmware and SD card content

Unzip lightsaber-1286zip to your Documents directory or to

Desktop but not to Arduino program folder or anywhere in

Programs directory where all programs are installed You will

see a lightsaber folder and files inside it Donrsquot move any of

these files to any other location outside the lightsaber folder

and donrsquot reorganize them Unzip ProffieOS_SD_Cardzip to the

folder where you keep lightsaber-1286 folder Copy all files

from ProffieOS_SD_Card folder to your SD card

2 Unhide file extensions in File Explorer settings to see h ending

of config files Donrsquot add ldquohrdquo to the config file name Go to config folder and create you own configh file (see page

42 for how-to)

Double-click the lightsaberino file

3 Add the name of your configh file as shown and Save this

lightsaberino file Make sure the other config files are

commented out there should be only one CONFIG_FILE

without You can have multiple config files

in lightsabergtconfig folder and just define the one you need

in lightsaberino file and upload it again to ProffieBoard

4 Connect battery to ProffieBoard and hook up to your PC

with a data transfer micro-USB-to-USB cable

Press arrow button it will compile and upload firmware to the

board Wait for red text progress bars to stop at 100

ProffieBoard will play boot sound if speaker is connected

Now you can unplug the USB cable Done

If it gives an error instead this means your configh file has

issues define CONFIG_FILE name has mistakes configh file

is out of config folder your PC user name is non-latin

42 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

33

configh file structure editing

PROFFIEBOARD INSTRUCTIONS

CHANGING PARAMETERS

All sound files (sound fonts music tracks) are stored on the micro SD card Add required sound fonts folders (Plecter NEC and Smoothswing

fonts are supported no need to change WAV files names just copy and paste) to SD card root directory as itrsquos done in the default

ProffieOS_SD_Card content folder and music tracks to the tracks folder

Make sure to name all music tracks and sound fonts folders with latin characters and only up to 8 characters long without using any special

characters (like |[- etc)

Make sure you have a configini file in each sound font folder if there is none - copy one from some default TeensySaberProffieBoard sound

font and paste into newly added sound font folder It has only one parameter that you can modify - humstart It helps to match hum sound

start with blade ignition 1000 usually works fine

All blade effects LED configuration volume level clash sensitivity etc are changed in the configh file located in lightsabergtconfig folder

To do that open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text Editor (Notepad - to see code correctly in Notepad

Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all text) and Delete it then Copy-and-Paste (Ctrl+C

Ctrl+V) your wiring diagram config code into empty _configh file and Save it under new name Follow the instructions on page 39 to

upload it to the board

Proffieboard config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)

volume level (0-3000)

clash sensitivity (adjust lower or higher with 01 step)

sound font folder nametrack name

Preset name

Blade style

LED configuration (use these XP-E2 LED templatesto define your LED)

for Red use 1 Ohm resistor for Green - no resistor for Blue use 024 Ohm

NoLED ndash no 4th led used

Preset 1

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 43

33

Blade Styles

StylePtrltInOutHelperltSimpleClashltLockupltBlastltOnSparkltAudioFlickerltRgblt02550gtRgblt501000gtgtRgblt2552550gt150gtRgblt255500gtgtAudioFlickerltRgblt1002550gtRgblt2550150gtgtgtRgblt255100150gt40gt200300Blackgtgt

ndash this is how the Blade Style code looks pasted in the configh file Preset (it sits inside a StylePtrltgt container)

ndash this is how the Blade Style code looks when editing it inside a Blade Style Editor

Each Blade Style is made of a variety of Effects each added effect goes instead of a base color in the previous effect

PROFFIEBOARD INSTRUCTIONS

CHANGING PARAMETERS

ProffieBoard and TeensySaber use Blade Styles for the main saber blade and any other accent leds to define all light effects (color changing

flashes flickering delays ignitionretraction timing etc)

Use Blade Style Editor to create and adjust Blade Styles Megtooth Sith Sabers did a great video tutorial where he shows and explains

how to use Blade Style Editor Also you can grab some pre-made Blade Styles or share yours here on TRA forums

A Blade Style example of simple flickering Green blade with Spark on start Clash Blaster Lockup and Drag IgnitionRetraction effects

InOutHelperltSimpleClashltLockupltBlastltOnSparkltAudioFlickerltRgblt02550gtRgblt501000gtgtRgblt2552550gt150gtRgblt255500gtgtAudioFlickerltRgblt1002550gtRgblt2550150gtgtgtRgblt255100150gt40gt200300Blackgt

InOutHelperltbase color200300Blackgt ndash base color can be defined by words (WHITE RED GREEN PURPLE etc) or by Rgblt0-2550-2550-255gt values for more

custom shades 200 is extension length in milliseconds 300 is retraction length in milliseconds Black is color when retracted (also can be any other color)

SimpleClashltbase colorclash color40gt ndash clash effect 40 is clash duration in milliseconds

Lockupltbase colorlockup colorgt ndash lockup effect

Blastltbase colorblast colorgt ndash blaster effect

OnSparkltbase colorspark color150gt ndash spark on ignition effect 150 is spark duration in milliseconds

AudioFlickerltrdquoArdquo colorrdquoBrdquo colorgt ndash flickering effect (blade flickers to the actual saber hum sound) the more difference between ldquoArdquo and ldquoBrdquo colors - the more

abrupt is flickering

Rgblt255500gt ndash actual color in RGB format (0 is no light 255 is the maximum brightness value for Red Green or Blue channel)

44 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

ndash SanDisk 4GB microSDHC Class 4 (Genuine) ndash SanDisk 4GB microSDHC Class 4 (Genuine)

130238 kbs = 1477 simultaneous audio streams 137812 kbs = 1562 simultaneous audio streams

ndash Patriot LX Series 16GB microSDHC UHS-IU1 Class 10 ndash Patriot LX Series 16GB microSDHC UHS-IU1 Class 10

133005 kbs = 1508 simultaneous audio streams

ndash GSkill 16GB microSDHC UHS-IU1 Class 10 ndash GSkill 16GB microSDHC UHS-IU1 Class 10

129534 kbs = 1469 simultaneous audio streams

ndash Kingston 16GB microSDHC UHS-IU1 Class 10 ndash Kingston 16GB microSDHC UHS-IU1 Class 10

128090 kbs = 1452 simultaneous audio streams

ndash SanDisk Ultra 16GB microSDHC UHS-IU1 A1 Class 10 ndash SanDisk Ultra 16GB microSDHC UHS-IU1 A1 Class 10

102663 kbs = 1164 simultaneous audio streams 11124 kbs = 1261 simultaneous audio streams

ndash SanDisk 8GB microSDHC Class 4 ndash SanDisk 8GB microSDHC Class 4

108506 kbs = 1230 simultaneous audio streams

ndash SanDisk 16GB microSDHC Class 4 ndash SanDisk 16GB microSDHC Class 4

102663 kbs = 1164 simultaneous audio streams 106957 kbs = 1213 simultaneous audio streams

ndash SanDisk Ultra 16GB microSDHC UHS-IU1 Class 10 ndash SanDisk Ultra 16GB microSDHC UHS-IU1 Class 10

102663 kbs = 1164 simultaneous audio streams 103909 kbs = 1178 simultaneous audio streams

ndash Smartbuy 4GB microSDHC Class 4 ndash Smartbuy 4GB microSDHC Class 4

75437 kbs = 855 simultaneous audio streams

ndash Kingston 8GB microSDHC Class 4 ndash Kingston 8GB microSDHC Class 4

75209 kbs = 822 simultaneous audio streams

ndash SanDisk 4GB microSDHC Class 4 (Fake) ndash SanDisk 4GB microSDHC Class 4 (Fake)

677 kbs = 769 simultaneous audio streams

Here is a list of tested micro SD cards speed with TeensySaber V3 and ProffieBoard Any card with speed over 900 kbs is recommended the

higher the speed is ndash the better Memory size of 4-16Gb is more than enough Cards were tested with a default firmware (1291) compiled

with ldquoSmallest Coderdquo under Optimize ldquodefault_proffieboard_confighrdquo file and default ProffieOS SD card sound files (7 folders)

To test your SD card speed simply hook up ProffieBoard to PC open Arduino IDE go to Tools and open Serial Monitor make sure you have

New Line and 9600 baud rate selected on the bottom of Serial Monitor window type and send sdtest command wait for the test result

4Recommended micro SD cards

BEST

TEENSYSABER PROFFIEBOARD

GOOD

BAD

PROFFIEBOARD INSTRUCTIONS

SD CARD RECOMMENDATIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 45

There are a lot of fake (chinese copies) microSD cards on the market from aliexpress ebay amazon etc They look very similar to genuine

cards but are a bit different though and have a twice lower writingreading speed Here is an example of a SanDisk 4Gb Class 4 card one is

genuine with 137812 kbs speed and the other one is fake with 677 kbs speed I got from ebay seller

Be carefull and pay attention to how the actual card looks if you are not sure ask seller for the real photo of SD card he sells

4Genuine and Fake SanDisk 4Gb Class 4 microSD

PROFFIEBOARD INSTRUCTIONS

SD CARD RECOMMENDATIONS

46 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

WIRE GAUGE GUIDE

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 47

RECHARGE PORTS AND KILL SWITCHES

48 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

NEOPIXEL STRIPS CURRENT DRAW

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 49

6TROUBLESHOOTING

For more help please check these linksProffieOSProffieBoardTeensySaber wiki on GitHubAsk your question on The Rebel Armory forumsAsk your question on FX-sabers forumsAsk your question in facebook group

How to solve most common issues

Quick troubleshooting tips

TeensySaber board or Proffieboard is not recognized by computer (nothing under Port selection in Arduino)

ndash Make sure a charged 37V battery is connected to the board micro-USB cable is a data transfer cable all plugins and drivers are installed ndash

check again pages 21 for TeensySaber or 40 for Proffieboard Try a different USB port on your computer

Sketch (code) compile error in Arduino IDE

ndash Check your define CONFIG_FILE ldquoconfig_confighrdquo line in opened lightsaberino file if itrsquos written correctly with config in it

Sketch (code) compile error in Arduino IDE

ndash Check if the _configh file you defined in the lightsaberino sketch file is same name as in the lightsaber-rdquofirmware versionrdquolightsaber

config folder and is located in this folder

Sketch (code) compile error in Arduino IDE

ndash Check your settings under Tools tab in Arduino IDE program Check again pages 21 for TeensySaber or 40 for Proffieboard

Sketch (code) compile error in Arduino IDE

ndash Check if your _configh file is correct Blade Styles Presets const unsigned int maxLedsPerStrip = 144 if BladeConfig blades[] = is correct

Sketch (code) compile error in Arduino IDE

ndash If nothing helps install Arduino IDE version 186 and try to compile and upload the firmware again

Sound doesnrsquot play

ndash Remove SD card and insert again check speaker wiring Make sure all sound files on SD card are correctly named (8 characters max long)

Re-format SD card in FAT32 load sound files and try again try another SD card

Board says ldquoLOW POWERrdquo

ndash Charge the battery

Serial Monitor shows info sent by the board but your commands donrsquot work

ndash In the bottom right corner of Serial Monitor window make sure the Line Ending drop down is set to New Line

Sound is weird and distorted

ndash Check your SD card speed (see page 44) Check speaker wiring try another good speaker

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 17

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

Blade ID resistor functions(optional)

SOON

18 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

website TeensySaber V3 FULL wiring diagrams link

Scroll the page down till you see the interactive diagram Above the diagram there are components selection options Build your saber setup

with it and follow diagram to wire your board Then you need to copy the configuration code below and paste it into your _configh file

Choose components you want

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

More wiring diagrams

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 19

20 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

How to use it

Blade ignitionretraction ndash assuming you have at least one button pressing it briefly should turn the saber on or off If you have an AUX button pressing it briefly should also turn the saber on and off If you have no buttons you can turn the saber on and off by twisting your wrist back and forth Note that the motion has to be done long enough to count so a very quick flick of the wrist will not workTurn On muted ndash double-click power buttonNext preset ndash while saber is off click the AUX buttonPrevious preset ndash hold AUX button and click the Activation buttonTrigger Clash ndash while saber is on hit the bladeTrigger Lockup ndash while saber is on hold Activation button then trigger a clash Lockup releases when you let go of the Acti-vation buttonTrigger Drag ndash like lockup but point saber mostly down before holding Activation buttonTrigger Force ndash long-click AUX buttonStart soundtrack ndash long-click the Activation buttonTrigger Blaster Block ndash while saber is on short-click AUX button

Serial Monitor commands

battery_voltage ndash gets current battery voltage valueget_volume ndash get current volume valuepow ndash power OnOff the saberon ndash power On the saberoff ndash power Off the saberset_volume lt0-3000gt ndash set volume value (example set_volume 500)play ndash play the default preset trackplay trackslttrack namegt ndash play a specific track from tracks folder (example play tracksvenuswav)stop ndash stop the playing trackforce ndash play ldquoforcerdquo sound effectsdrag ndash play ldquodragrdquo sound effectsblast ndash play ldquoblasterrdquo sound effectslock ndash play ldquolockuprdquo sound effectsclash ndash play ldquoclashrdquo sound effectsreset ndash reboot the boardn ndash switch to next presetp ndash switch to previous presetlist_presets ndash show all presetssdtest ndash test SD card speed

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 21

2TEENSYSABER V3 INSTRUCTIONS

FIRMWARE UPLOAD AND UPDATE2

Software installation and setup

To upload firmware to TeensySaber board Arduino IDE program is required Follow these steps to install it to your PC

1 Install latest Arduino IDE software (donrsquot use BETA)

Installing as Windows app also is not recommended

because it will be installed in a specific protected folder that

wonrsquot allow you to install Teensyduino software in it

If TeensySaber wonrsquot show up in COM port use

Arduino IDE 186 version

2 Install latest Teensyduino software in same directory

usually itrsquos CProgram Files (x86)Arduino on Windows

Follow installation instructions for your system

3 Select Teensy 32 31 in Tools -gt Board

USB Type ndash Serial CPU Speed ndash 96 MHz (overclock) Optimize ndash Smallest Code Port ndash COM(the number your PC assigned) (Teensy 32) Serial

Connect TeensySaber via USB cable to PC to be able to select

the Port donrsquot forget to connect battery first

22 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

1 Download the TeensySaber firmware and SD card content

Unzip lightsaber-1286zip to your Documents directory or to

Desktop but not to Arduino program folder or anywhere in

Programs directory where all programs are installed You will

see a lightsaber folder and files inside it Donrsquot move any of

these files to any other location outside the lightsaber folder

and donrsquot reorganize them Unzip ProffieOS_SD_Cardzip to the

folder where you keep lightsaber-1286 folder Copy all files

from ProffieOS_SD_Card folder to your SD card

2 Unhide file extensions in File Explorer settings to see h ending

of config files Donrsquot add ldquohrdquo to the config file name

Go to config folder and create you own configh file (see page

23 for how-to)

Double-click the lightsaberino file

3 Add the name of your configh file as shown and Save this

lightsaberino file Make sure the other config files are

commented out there should be only one CONFIG_FILE

without You can have multiple config files

in lightsabergtconfig folder and just define the one you need

in lightsaberino file and upload it again to TeensySaber board

4 Connect battery to TeensySaber board and hook up to your PC

with a data transfer micro-USB-to-USB cable

Press arrow button it will compile and upload firmware to the

board Wait for your PC to make a sound or TeensySaber will

play boot sound if speaker is connected Now you can unplug

the USB cable Done

If it gives an error instead this means your configh file has

issues define CONFIG_FILE name has mistakes configh file

is out of config folder your PC user name is non-latin

2TEENSYSABER V3 INSTRUCTIONS

FIRMWARE UPLOAD AND UPDATE2

Uploading firmware

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 23

2TEENSYSABER V3 INSTRUCTIONS

CHANGING PARAMETERS3

Changing sound board parameters

All sound files (sound fonts music tracks) are stored on the micro SD card Add required sound fonts folders (Plecter NEC and Smoothswing

fonts are supported no need to change WAV files names just copy and paste) to SD card root directory as itrsquos done in the default

ProffieOS_SD_Card content folder and music tracks to the tracks folder

Make sure to name all music tracks and sound fonts folders with latin characters and only up to 8 characters long without using any special

characters (like |[- etc)

Make sure you have a configini file in each sound font folder if there is none - copy one from some default TeensySaberProffieBoard sound

font and paste into newly added sound font folder It has only one parameter that you can modify - humstart It helps to match hum sound

start with blade ignition 1000 usually works fine

All blade effects LED configuration volume level clash sensitivity etc are changed in the configh file located in lightsabergtconfig folder

To do that open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text Editor (Notepad - to see code correctly in Notepad

Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all text) and Delete it then Copy-and-Paste (Ctrl+C

Ctrl+V) your wiring diagram config code into empty _configh file and Save it under new name Follow the instructions on page 22 to

upload it to the board

TeensySaber V3 config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)

volume level (0-3000)

clash sensitivity (adjust lower or higher with 01 step)

sound font folder nametrack name

Preset name

Blade style

LED configuration (use these XP-E2 LED templatesto define your LED)

for Red use 1 Ohm resistor for Green - no resistor for Blue use 024 Ohm

NoLED ndash no 4th led used

Preset 1

24 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

31

PROFFIEBOARD INSTRUCTIONS

Whatrsquos needed

ndash ProffieBoard

ndash micro SD-card (see page 44 for recommendations)

ndash a USB micro SD-card reader (to load sound files from PC to micro SD card)

ndash micro USB data transfer cable (CABLES THAT SUPPORT ONLY CHARGING WONrsquoT WORK)

ndash wires of different gauges (32-20 AWG) (PTFE coated copper stranded wires recommended) heat shrink

ndash ESD safe soldering station solder wire flux etc

ndash pliers helping hands etc

ndash isopropyl alcohol to clean pads before soldering (helps solder to stick better)

ndash Digital Multimeter (VERY USEFUL)

ndash computer running Windows Linux or Mac OS with internet access

ndash 37V Li-Ion Protected rechargeable battery switches recharge port speaker LEDs resistors chassis etc

ndash Smart Li-Ion CC-CV (Constant Current - Constant Voltage mode) battery charger for 37V (42V) cells

ndash patience

WIRING DIAGRAMS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 25

31

PROFFIEBOARD INSTRUCTIONS

Board pinout

Battery + ndash 26 to 45 volt input drives everything except the LEDs

Battery - ndash negative pad for LEDs needs to be at same level as GND when both are connected Both pads are internally connected

GND ndash ground for electronics except LEDs Note that there are two GND pads on the board that are internally connected

Speaker +- ndash hooks up to speaker

Activation (1) Aux (2) Aux2 button (3) ndash hook up to closing buttons or potentially touch buttons

Blade ID Neopixel Data 1 ndash normally used to measure the blade ID restor and if itrsquos a neopixel blade feed out neopixel data

Data 2 3 4 5 ndash additional neopixel data outputs or free for other purposes

LED 1 2 3 4 5 6 ndash hooks up to negative side of LED (positive side of LED hooks up directly to battery) These pads can handle

up to 30 volts

SDA SCL ndash these pins are used to wire OLED display or to communicate with the gyro and accelerometer chip

RX TX ndash these pins are used for wiring a bluetooth module for wireless control

SWDCLK SWDIO ndash can be hooked up to a ST-LINK device and lets you debug programs running on the ProffieBoard

+5V ndash generated by the ProffieBoard normally itrsquos only ON when sound is playing

+33V ndash generated by the ProffieBoard for powering OLED display Bluetooth module or some accent leds

BOOT RESET ndash buttons to put the ProffieBoard in bootloader mode if uploading doesnrsquot work

micro USB port ndash micro USB port used only for firmware upload and can be used for sound files upload to SD card (from firmware version

1291 and up) THIS PORT ISNrsquoT USED FOR CHARGING THE BATTERY

LED 4LED 3

LED 2

LED 1

LED 5

LED 6

RESETBOOT

Battery - Battery -

Speaker + (red dot or ldquo+rdquo mark on speaker)

Battery +

Aux button (2)Activation button (1)

Aux2 button (3)

Blade ID Neopixel Data 1

Data 5

Data 4Data 3Data 2

+33V

SWDIO

SWDCLK

+5V

TXRX

GND

GND

Reset

Speaker -

SCLSDA

micro USB port

WIRING DIAGRAMS

26 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Basic Tri-Cree wiring diagram(In-hilt LED)

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

+

+

-

-

26 AWG

26 A

WG

30-32 AWG

28-30 AWG

28-3

0 A

WG

30-32 AWG

Protected 36-37V (42V max at full charge) 10A 3500mAh battery recommended+18650 battery holder (optional)Keystone 1042P

AV switch with accent led(constantly ON no effects)

accent leds run mostly at10-15mA so resistors for them must be calculated accordingly

Main RGB led

additional RGB leds(optional)

In case no additional high power leds are needed LED channels 4 5 6 can be used for 3 controllable(programmable for different effects) accent leds So AV switch led can be wired to one of these channelsAccent leds also can be wired to Data pads 1-5 please see ldquoAccent LEDs wiring and setuprdquo page

LED Resistor Calculator

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 27

3WIRING DIAGRAMS1

Basic Tri-Cree wiring (In-hilt LED)ldquoconfighrdquo file setup

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

Use a given or build your wiring diagram on THIS PAGE then open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text

Editor (Notepad - to see code correctly in Notepad Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all

text) and Delete it then Copy-and-Paste (Ctrl+C Ctrl+V) your wiring diagram config code (example below) into empty _configh file and

Save it under new name Follow the instructions on page 22 to upload it to the board

ldquoproffieboard_v1_confighrdquoNUM_BLADES 2NUM_BUTTONS 2VOLUME 1000CLASH_THRESHOLD_G 10StyleNormalPtrltCYAN WHITE 300 800gt()StyleNormalPtrltCYAN WHITE 300 800gt()

CreeXPE2RedTemplatelt1000gtCreeXPE2GreenTemplatelt0gtCreeXPE2BlueTemplatelt240gtNoLED

ProffieBoard config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)Volume level (0-3000)Clash sensitivity (adjust lower or higher with 01 step)ldquoBlade 1rdquo styleldquoBlade 2rdquo style (in case only 1 blade is used you donrsquot need this line)LED configuration (use these XP-E2 LED templatesto define your LED If other LED resistors are used change these values to match Ohm1000=ltvaluegt)

where 1000 is 1 Ohm resistor 0 is no resistor240 is 024 Ohm resistorNoLED ndash no 4th led used

Preset 1

LED 1 configuration

LED 2 configuration

Preset 2 etc

PROFFIEBOARD INSTRUCTIONS

28 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Basic Neopixel wiring diagram

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

+

+

-

-

22 A

WG

22 AWG

x2 28 AWG

x2 26 AWG

22 A

WG

30-32 AWG30-32 AWG

Protected 36-37V (42V max at full charge) 10A 3500mAh or 15A 3120mAhbattery recommended+18650 battery holder (optional)Keystone 1042P

AV switch with accent led(constantly ON no effects)

accent leds run mostly at10-15mA so resistors for them must be calculated accordingly

Main Neopixel strip

additional Neopixelstrips(optional)

Neopixel bladeconnector

330 Ohm on the Blade pcb side

x3 28 AWGor x1 22 AWGfor Negative

330 Ohm on the Blade pcb side

arrows up

330 Ohm on the Blade pcb side

In case no additional Neopixel strips are needed LED channels 4 5 6 can be used for 3 controllable(programmable for different effects) accent leds So AV switch led can be wired to one of these channelsAccent leds also can be wired to Data pads 2-5 please see ldquoAccent LEDs wiring and setuprdquo page

Recommended power wire gauges (22 AWG) are given for 2-strip blade For 3-strip blade you gonna need at least 20 AWG wires

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 29

ldquoproffieboard_v1_confighrdquo

3WIRING DIAGRAMS1

Basic Neopixel wiringldquoconfighrdquo file setup

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

NUM_BLADES 3NUM_BUTTONS 2VOLUME 1000CLASH_THRESHOLD_G 10IgnitionDelaylt0 any blade stylegtIgnitionDelaylt800 any blade stylegtIgnitionDelaylt800 any blade stylegtWS2811BladePtrlt118 WS2811 800kHz | WS2811 GRBgt()WS2811BladePtrlt26 blade2Pin ltbladePowerPin4gtgt()WS2811BladePtrlt26 blade3Pin ltbladePowerPin5gtgt()

ProffieBoard config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)Volume level (0-3000)Clash sensitivity (adjust lower or higher with 01 step)ldquoBlade 1rdquo style (main blade with IgnitionDelay 0)ldquoBlade 2rdquo style (CG blade 1 with IgnitionDelay 800)ldquoBlade 3rdquo style (CG blade 2 with IgnitionDelay 800)

strip configuration (defines how many pixels it has and to which LED output and pin is wired)

Preset 1

any blade style

strip (blade) 1 configuration

adjust this number to match your strips leds count

strip (blade) 2 configuration

strip (blade) 3 configuration

Preset 2 etc

Use a given or build your wiring diagram on THIS PAGE then open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text

Editor (Notepad - to see code correctly in Notepad Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all

text) and Delete it then Copy-and-Paste (Ctrl+C Ctrl+V) your wiring diagram config code (example below) into empty _configh file and

Save it under new name Follow the instructions on page 22 to upload it to the board

PROFFIEBOARD INSTRUCTIONS

30 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Basic Segmented string wiring diagram

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

+

+

-

-

24 A

WG

28 AWG

30-32 AWG30-32 AWG

Protected 36-37V (42V max at full charge) 10A 3500mAh battery recommended+18650 battery holder (optional)Keystone 1042P

AV switch with accent led(constantly ON no effects)

accent leds run mostly at10-15mA so resistors for them must be calculated accordingly

6-segments string blade

FoC string

N-channel FET3A minimum

123456

Calculate resistors for each led segment of the blade string depending on which leds are used 5mm leds have max drive current around 25mA per led when 10mm leds can be 100mA and 200mA per ledSo pay attention to your led max current and Forward Voltage (Vf) when calculating a segment resistor resistence as well as its wattage Also choose wire gauges accordingly to meet segments and total blade max current draw level

LED Resistor Calculator

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 31

ldquoproffieboard_v1_confighrdquo

3WIRING DIAGRAMS1

Basic Segmented string wiringldquoconfighrdquo file setup

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

NUM_BLADES 1NUM_BUTTONS 2VOLUME 1000CLASH_THRESHOLD_G 10StyleNormalPtrltCYAN WHITE 300 800gt()ltBlue3mmLED BladePin White3mmLEDgt

ProffieBoard config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)Volume level (0-3000)Clash sensitivity (adjust lower or higher with 01 step)Blade styleLED string configuration(here you mention the color and type of leds usedin the main blade string segments and FoC stringBladePin is the FoC signal pin (Blade ID pin))

Preset

LED string configuration

Use a given or build your wiring diagram on THIS PAGE then open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text

Editor (Notepad - to see code correctly in Notepad Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all

text) and Delete it then Copy-and-Paste (Ctrl+C Ctrl+V) your wiring diagram config code (example below) into empty _configh file and

Save it under new name Follow the instructions on page 22 to upload it to the board

PROFFIEBOARD INSTRUCTIONS

32 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Accent LEDs wiring diagram(optional)

Accent LEDs work with ProffieBoard as additional ldquobladesrdquo when powered by LED outputs 4 5 6 or Data pads 1 2 3 5 as PWM So they can

have any effect that blade can have If no effects needed accent led can be powered just by a 33V output pad (power-on led indication)

30-32 AWG

with Neopixel blade setup these 4 outputsdonrsquot work for regular accent leds

Recommended resistors to use for accent leds at 33V power source and 15mA drive

ndash 100 Ohm for Red (lt100000gt value in the code)ndash 13 Ohm for Green (lt13000gt value in the code)ndash 13 Ohm for Blue (lt13000gt value in the code)ndash 100 Ohm for Yellow (lt100000gt value in the code)ndash 20 Ohm for White (lt20000gt value in the code)

RGB ledcommon-anode

8 ldquobladesrdquo1 main and 7 accent leds

main blade style (effects) main blade style (effects)

7 accent leds style (effects)accent led style (effects)

7 accent leds configurations

RGB accent led configuration

2 ldquobladesrdquo1 main and 1 RGB accent led

ldquoPower-onrdquo indicationaccent leds (no effects)

7 accent leds withindependent effects

RGB accent led

a) b)

b)

c)

c)

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 33

3WIRING DIAGRAMS1

Neopixel Accent LEDs wiring diagram(optional)

With Neopixel setup additional neopixel leds or arrays can be used as accent leds There are 2 ways to wire them using additional Data

pins 2 3 4 5 or ldquoSub-bladesrdquo wiring with just 1 Data output pin Same way Neopixel connectors with on-board leds ca be wired

Option 1 ndash with extra Data pins

Main Blade

some accent leds

D1

D2

crystal leds

330 Ohm

330 Ohm

330 Ohm

main blade style (effects)

main blade 144 leds Data pin 1

accent leds blade style (effects)

accent leds ldquobladerdquo 4 leds Data pin 2

crystal leds blade style (effects)

crystal leds ldquobladerdquo 2 leds Data pin 3

3 ldquobladesrdquo1 main 1 accent leds array and 1 crystal leds array

PROFFIEBOARD INSTRUCTIONS

D3

follow arrows direction

34 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Neopixel Accent LEDs wiring diagram(optional)

PROFFIEBOARD INSTRUCTIONS

Main Blade

some accent leds

1

3

5678

2

4

D1

crystal leds

follow arrows direction

330 Ohm

330 OhmData signal

With this setup a single array of neopixel leds is separated into a couple of sub-blades with their own style configuration and behaviour This

is really usefull when you want to use only one data pin More about ldquoSub-bladesrdquo on ProffieOS wiki page

Option 2 ndash with ldquoSub-bladesrdquo

main blade style (effects)

main blade sub-blade 140 leds (7-146) but from 6 to 145 in the code

accent leds blade style (effects)

accent leds sub-blade 4 leds (1-4) but from 0 to 3 in the code

crystal leds blade style (effects)

146 leds total used

crystal leds sub-blade 2 leds (5-6) but from 4 to 5 in the code

update default 144 to a higher total value if you get all accent leds +Main blade gt 144 Example update to 146 if you have 2 crystal leds +4 accent leds + 140 Main blade leds = 146

3 ldquobladesrdquo 1 main 1 accent leds array and 1 crystal leds array

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 35

3WIRING DIAGRAMS1

OLED display wiring diagram(optional)

SSD1306 128x32 pixels OLED display allows to show battery level current preset name play different animations and even simple games It

can be wired to any blade configuration and requires just one additional line in the code to work You can get monochrome display in white

or blue color

SSD1306128x32OLED

SSD1306 ndash with blue or white display color selectSSD1306 ndash cheaper priceSSD1306 just screen ndash blue or white select

30-32 AWG

30-32 AWG

add this line to enable OLED display

display shows a preset name written in these quotes ldquoldquo

PROFFIEBOARD INSTRUCTIONS

36 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Bluetooth module wiring diagram(optional)

SOON

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 37

3WIRING DIAGRAMS1

Blade ID resistor functions(optional)

SOON

PROFFIEBOARD INSTRUCTIONS

38 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

website ProffieBoard FULL wiring diagrams link

Scroll the page down till you see the interactive diagram Above the diagram there are components selection options Build your saber setup

with it and follow diagram to wire your board Then you need to copy the configuration code below and paste it into your _configh file

Choose components you want

3WIRING DIAGRAMS1

More wiring diagrams

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 39

3WIRING DIAGRAMS1

How to use it

PROFFIEBOARD INSTRUCTIONS

Blade ignitionretraction ndash assuming you have at least one button pressing it briefly should turn the saber on or off If you have an AUX button pressing it briefly should also turn the saber on and off If you have no buttons you can turn the saber on and off by twisting your wrist back and forth Note that the motion has to be done long enough to count so a very quick flick of the wrist will not workTurn On muted ndash double-click power buttonNext preset ndash while saber is off click the AUX buttonPrevious preset ndash hold AUX button and click the Activation buttonTrigger Clash ndash while saber is on hit the bladeTrigger Lockup ndash while saber is on hold Activation button then trigger a clash Lockup releases when you let go of the Acti-vation buttonTrigger Drag ndash like lockup but point saber mostly down before holding Activation buttonTrigger Force ndash long-click AUX buttonStart soundtrack ndash long-click the Activation buttonTrigger Blaster Block ndash while saber is on short-click AUX button

Serial Monitor commands

battery_voltage ndash gets current battery voltage valueget_volume ndash get current volume valuepow ndash power OnOff the saberon ndash power On the saberoff ndash power Off the saberset_volume lt0-3000gt ndash set volume value (example set_volume 500)play ndash play the default preset trackplay trackslttrack namegt ndash play a specific track from tracks folder (example play tracksvenuswav)stop ndash stop the playing trackforce ndash play ldquoforcerdquo sound effectsdrag ndash play ldquodragrdquo sound effectsblast ndash play ldquoblasterrdquo sound effectslock ndash play ldquolockuprdquo sound effectsclash ndash play ldquoclashrdquo sound effectsreset ndash reboot the boardn ndash switch to next presetp ndash switch to previous presetlist_presets ndash show all presetssdtest ndash test SD card speed

40 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3FIRMWARE UPLOAD AND UPDATE2

Software installation and setup

PROFFIEBOARD INSTRUCTIONS

To upload firmware to ProffieBoard Arduino IDE program is required Follow these steps to install it to your PC

1 Install latest Arduino IDE software (donrsquot use BETA)

Installing as Windows app also is not recommended

because it will be installed in a specific protected folder that

wonrsquot allow you to install any additional softwareplugin in it

If ProffieBoard wonrsquot show up in COM port use

Arduino IDE 186 version

2 Install the Proffieboard Arduino Plugin and Zadig software

Follow installation instructions

3 Select Proffieboard-STM32L433 in Tools -gt Board

USB Type ndash Serial CPU Speed ndash 80 MHz Optimize ndash Smallest Code DOSFS ndash SDCARD (SPI) Port ndash COM(the number your PC assigned) (Butterfly-L433CC)

Connect Proffieboard via USB cable to PC to be able to select

the Port

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 41

3FIRMWARE UPLOAD AND UPDATE2

Uploading firmware

PROFFIEBOARD INSTRUCTIONS

1 Download the ProffieBoard firmware and SD card content

Unzip lightsaber-1286zip to your Documents directory or to

Desktop but not to Arduino program folder or anywhere in

Programs directory where all programs are installed You will

see a lightsaber folder and files inside it Donrsquot move any of

these files to any other location outside the lightsaber folder

and donrsquot reorganize them Unzip ProffieOS_SD_Cardzip to the

folder where you keep lightsaber-1286 folder Copy all files

from ProffieOS_SD_Card folder to your SD card

2 Unhide file extensions in File Explorer settings to see h ending

of config files Donrsquot add ldquohrdquo to the config file name Go to config folder and create you own configh file (see page

42 for how-to)

Double-click the lightsaberino file

3 Add the name of your configh file as shown and Save this

lightsaberino file Make sure the other config files are

commented out there should be only one CONFIG_FILE

without You can have multiple config files

in lightsabergtconfig folder and just define the one you need

in lightsaberino file and upload it again to ProffieBoard

4 Connect battery to ProffieBoard and hook up to your PC

with a data transfer micro-USB-to-USB cable

Press arrow button it will compile and upload firmware to the

board Wait for red text progress bars to stop at 100

ProffieBoard will play boot sound if speaker is connected

Now you can unplug the USB cable Done

If it gives an error instead this means your configh file has

issues define CONFIG_FILE name has mistakes configh file

is out of config folder your PC user name is non-latin

42 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

33

configh file structure editing

PROFFIEBOARD INSTRUCTIONS

CHANGING PARAMETERS

All sound files (sound fonts music tracks) are stored on the micro SD card Add required sound fonts folders (Plecter NEC and Smoothswing

fonts are supported no need to change WAV files names just copy and paste) to SD card root directory as itrsquos done in the default

ProffieOS_SD_Card content folder and music tracks to the tracks folder

Make sure to name all music tracks and sound fonts folders with latin characters and only up to 8 characters long without using any special

characters (like |[- etc)

Make sure you have a configini file in each sound font folder if there is none - copy one from some default TeensySaberProffieBoard sound

font and paste into newly added sound font folder It has only one parameter that you can modify - humstart It helps to match hum sound

start with blade ignition 1000 usually works fine

All blade effects LED configuration volume level clash sensitivity etc are changed in the configh file located in lightsabergtconfig folder

To do that open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text Editor (Notepad - to see code correctly in Notepad

Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all text) and Delete it then Copy-and-Paste (Ctrl+C

Ctrl+V) your wiring diagram config code into empty _configh file and Save it under new name Follow the instructions on page 39 to

upload it to the board

Proffieboard config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)

volume level (0-3000)

clash sensitivity (adjust lower or higher with 01 step)

sound font folder nametrack name

Preset name

Blade style

LED configuration (use these XP-E2 LED templatesto define your LED)

for Red use 1 Ohm resistor for Green - no resistor for Blue use 024 Ohm

NoLED ndash no 4th led used

Preset 1

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 43

33

Blade Styles

StylePtrltInOutHelperltSimpleClashltLockupltBlastltOnSparkltAudioFlickerltRgblt02550gtRgblt501000gtgtRgblt2552550gt150gtRgblt255500gtgtAudioFlickerltRgblt1002550gtRgblt2550150gtgtgtRgblt255100150gt40gt200300Blackgtgt

ndash this is how the Blade Style code looks pasted in the configh file Preset (it sits inside a StylePtrltgt container)

ndash this is how the Blade Style code looks when editing it inside a Blade Style Editor

Each Blade Style is made of a variety of Effects each added effect goes instead of a base color in the previous effect

PROFFIEBOARD INSTRUCTIONS

CHANGING PARAMETERS

ProffieBoard and TeensySaber use Blade Styles for the main saber blade and any other accent leds to define all light effects (color changing

flashes flickering delays ignitionretraction timing etc)

Use Blade Style Editor to create and adjust Blade Styles Megtooth Sith Sabers did a great video tutorial where he shows and explains

how to use Blade Style Editor Also you can grab some pre-made Blade Styles or share yours here on TRA forums

A Blade Style example of simple flickering Green blade with Spark on start Clash Blaster Lockup and Drag IgnitionRetraction effects

InOutHelperltSimpleClashltLockupltBlastltOnSparkltAudioFlickerltRgblt02550gtRgblt501000gtgtRgblt2552550gt150gtRgblt255500gtgtAudioFlickerltRgblt1002550gtRgblt2550150gtgtgtRgblt255100150gt40gt200300Blackgt

InOutHelperltbase color200300Blackgt ndash base color can be defined by words (WHITE RED GREEN PURPLE etc) or by Rgblt0-2550-2550-255gt values for more

custom shades 200 is extension length in milliseconds 300 is retraction length in milliseconds Black is color when retracted (also can be any other color)

SimpleClashltbase colorclash color40gt ndash clash effect 40 is clash duration in milliseconds

Lockupltbase colorlockup colorgt ndash lockup effect

Blastltbase colorblast colorgt ndash blaster effect

OnSparkltbase colorspark color150gt ndash spark on ignition effect 150 is spark duration in milliseconds

AudioFlickerltrdquoArdquo colorrdquoBrdquo colorgt ndash flickering effect (blade flickers to the actual saber hum sound) the more difference between ldquoArdquo and ldquoBrdquo colors - the more

abrupt is flickering

Rgblt255500gt ndash actual color in RGB format (0 is no light 255 is the maximum brightness value for Red Green or Blue channel)

44 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

ndash SanDisk 4GB microSDHC Class 4 (Genuine) ndash SanDisk 4GB microSDHC Class 4 (Genuine)

130238 kbs = 1477 simultaneous audio streams 137812 kbs = 1562 simultaneous audio streams

ndash Patriot LX Series 16GB microSDHC UHS-IU1 Class 10 ndash Patriot LX Series 16GB microSDHC UHS-IU1 Class 10

133005 kbs = 1508 simultaneous audio streams

ndash GSkill 16GB microSDHC UHS-IU1 Class 10 ndash GSkill 16GB microSDHC UHS-IU1 Class 10

129534 kbs = 1469 simultaneous audio streams

ndash Kingston 16GB microSDHC UHS-IU1 Class 10 ndash Kingston 16GB microSDHC UHS-IU1 Class 10

128090 kbs = 1452 simultaneous audio streams

ndash SanDisk Ultra 16GB microSDHC UHS-IU1 A1 Class 10 ndash SanDisk Ultra 16GB microSDHC UHS-IU1 A1 Class 10

102663 kbs = 1164 simultaneous audio streams 11124 kbs = 1261 simultaneous audio streams

ndash SanDisk 8GB microSDHC Class 4 ndash SanDisk 8GB microSDHC Class 4

108506 kbs = 1230 simultaneous audio streams

ndash SanDisk 16GB microSDHC Class 4 ndash SanDisk 16GB microSDHC Class 4

102663 kbs = 1164 simultaneous audio streams 106957 kbs = 1213 simultaneous audio streams

ndash SanDisk Ultra 16GB microSDHC UHS-IU1 Class 10 ndash SanDisk Ultra 16GB microSDHC UHS-IU1 Class 10

102663 kbs = 1164 simultaneous audio streams 103909 kbs = 1178 simultaneous audio streams

ndash Smartbuy 4GB microSDHC Class 4 ndash Smartbuy 4GB microSDHC Class 4

75437 kbs = 855 simultaneous audio streams

ndash Kingston 8GB microSDHC Class 4 ndash Kingston 8GB microSDHC Class 4

75209 kbs = 822 simultaneous audio streams

ndash SanDisk 4GB microSDHC Class 4 (Fake) ndash SanDisk 4GB microSDHC Class 4 (Fake)

677 kbs = 769 simultaneous audio streams

Here is a list of tested micro SD cards speed with TeensySaber V3 and ProffieBoard Any card with speed over 900 kbs is recommended the

higher the speed is ndash the better Memory size of 4-16Gb is more than enough Cards were tested with a default firmware (1291) compiled

with ldquoSmallest Coderdquo under Optimize ldquodefault_proffieboard_confighrdquo file and default ProffieOS SD card sound files (7 folders)

To test your SD card speed simply hook up ProffieBoard to PC open Arduino IDE go to Tools and open Serial Monitor make sure you have

New Line and 9600 baud rate selected on the bottom of Serial Monitor window type and send sdtest command wait for the test result

4Recommended micro SD cards

BEST

TEENSYSABER PROFFIEBOARD

GOOD

BAD

PROFFIEBOARD INSTRUCTIONS

SD CARD RECOMMENDATIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 45

There are a lot of fake (chinese copies) microSD cards on the market from aliexpress ebay amazon etc They look very similar to genuine

cards but are a bit different though and have a twice lower writingreading speed Here is an example of a SanDisk 4Gb Class 4 card one is

genuine with 137812 kbs speed and the other one is fake with 677 kbs speed I got from ebay seller

Be carefull and pay attention to how the actual card looks if you are not sure ask seller for the real photo of SD card he sells

4Genuine and Fake SanDisk 4Gb Class 4 microSD

PROFFIEBOARD INSTRUCTIONS

SD CARD RECOMMENDATIONS

46 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

WIRE GAUGE GUIDE

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 47

RECHARGE PORTS AND KILL SWITCHES

48 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

NEOPIXEL STRIPS CURRENT DRAW

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 49

6TROUBLESHOOTING

For more help please check these linksProffieOSProffieBoardTeensySaber wiki on GitHubAsk your question on The Rebel Armory forumsAsk your question on FX-sabers forumsAsk your question in facebook group

How to solve most common issues

Quick troubleshooting tips

TeensySaber board or Proffieboard is not recognized by computer (nothing under Port selection in Arduino)

ndash Make sure a charged 37V battery is connected to the board micro-USB cable is a data transfer cable all plugins and drivers are installed ndash

check again pages 21 for TeensySaber or 40 for Proffieboard Try a different USB port on your computer

Sketch (code) compile error in Arduino IDE

ndash Check your define CONFIG_FILE ldquoconfig_confighrdquo line in opened lightsaberino file if itrsquos written correctly with config in it

Sketch (code) compile error in Arduino IDE

ndash Check if the _configh file you defined in the lightsaberino sketch file is same name as in the lightsaber-rdquofirmware versionrdquolightsaber

config folder and is located in this folder

Sketch (code) compile error in Arduino IDE

ndash Check your settings under Tools tab in Arduino IDE program Check again pages 21 for TeensySaber or 40 for Proffieboard

Sketch (code) compile error in Arduino IDE

ndash Check if your _configh file is correct Blade Styles Presets const unsigned int maxLedsPerStrip = 144 if BladeConfig blades[] = is correct

Sketch (code) compile error in Arduino IDE

ndash If nothing helps install Arduino IDE version 186 and try to compile and upload the firmware again

Sound doesnrsquot play

ndash Remove SD card and insert again check speaker wiring Make sure all sound files on SD card are correctly named (8 characters max long)

Re-format SD card in FAT32 load sound files and try again try another SD card

Board says ldquoLOW POWERrdquo

ndash Charge the battery

Serial Monitor shows info sent by the board but your commands donrsquot work

ndash In the bottom right corner of Serial Monitor window make sure the Line Ending drop down is set to New Line

Sound is weird and distorted

ndash Check your SD card speed (see page 44) Check speaker wiring try another good speaker

18 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

website TeensySaber V3 FULL wiring diagrams link

Scroll the page down till you see the interactive diagram Above the diagram there are components selection options Build your saber setup

with it and follow diagram to wire your board Then you need to copy the configuration code below and paste it into your _configh file

Choose components you want

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

More wiring diagrams

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 19

20 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

How to use it

Blade ignitionretraction ndash assuming you have at least one button pressing it briefly should turn the saber on or off If you have an AUX button pressing it briefly should also turn the saber on and off If you have no buttons you can turn the saber on and off by twisting your wrist back and forth Note that the motion has to be done long enough to count so a very quick flick of the wrist will not workTurn On muted ndash double-click power buttonNext preset ndash while saber is off click the AUX buttonPrevious preset ndash hold AUX button and click the Activation buttonTrigger Clash ndash while saber is on hit the bladeTrigger Lockup ndash while saber is on hold Activation button then trigger a clash Lockup releases when you let go of the Acti-vation buttonTrigger Drag ndash like lockup but point saber mostly down before holding Activation buttonTrigger Force ndash long-click AUX buttonStart soundtrack ndash long-click the Activation buttonTrigger Blaster Block ndash while saber is on short-click AUX button

Serial Monitor commands

battery_voltage ndash gets current battery voltage valueget_volume ndash get current volume valuepow ndash power OnOff the saberon ndash power On the saberoff ndash power Off the saberset_volume lt0-3000gt ndash set volume value (example set_volume 500)play ndash play the default preset trackplay trackslttrack namegt ndash play a specific track from tracks folder (example play tracksvenuswav)stop ndash stop the playing trackforce ndash play ldquoforcerdquo sound effectsdrag ndash play ldquodragrdquo sound effectsblast ndash play ldquoblasterrdquo sound effectslock ndash play ldquolockuprdquo sound effectsclash ndash play ldquoclashrdquo sound effectsreset ndash reboot the boardn ndash switch to next presetp ndash switch to previous presetlist_presets ndash show all presetssdtest ndash test SD card speed

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 21

2TEENSYSABER V3 INSTRUCTIONS

FIRMWARE UPLOAD AND UPDATE2

Software installation and setup

To upload firmware to TeensySaber board Arduino IDE program is required Follow these steps to install it to your PC

1 Install latest Arduino IDE software (donrsquot use BETA)

Installing as Windows app also is not recommended

because it will be installed in a specific protected folder that

wonrsquot allow you to install Teensyduino software in it

If TeensySaber wonrsquot show up in COM port use

Arduino IDE 186 version

2 Install latest Teensyduino software in same directory

usually itrsquos CProgram Files (x86)Arduino on Windows

Follow installation instructions for your system

3 Select Teensy 32 31 in Tools -gt Board

USB Type ndash Serial CPU Speed ndash 96 MHz (overclock) Optimize ndash Smallest Code Port ndash COM(the number your PC assigned) (Teensy 32) Serial

Connect TeensySaber via USB cable to PC to be able to select

the Port donrsquot forget to connect battery first

22 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

1 Download the TeensySaber firmware and SD card content

Unzip lightsaber-1286zip to your Documents directory or to

Desktop but not to Arduino program folder or anywhere in

Programs directory where all programs are installed You will

see a lightsaber folder and files inside it Donrsquot move any of

these files to any other location outside the lightsaber folder

and donrsquot reorganize them Unzip ProffieOS_SD_Cardzip to the

folder where you keep lightsaber-1286 folder Copy all files

from ProffieOS_SD_Card folder to your SD card

2 Unhide file extensions in File Explorer settings to see h ending

of config files Donrsquot add ldquohrdquo to the config file name

Go to config folder and create you own configh file (see page

23 for how-to)

Double-click the lightsaberino file

3 Add the name of your configh file as shown and Save this

lightsaberino file Make sure the other config files are

commented out there should be only one CONFIG_FILE

without You can have multiple config files

in lightsabergtconfig folder and just define the one you need

in lightsaberino file and upload it again to TeensySaber board

4 Connect battery to TeensySaber board and hook up to your PC

with a data transfer micro-USB-to-USB cable

Press arrow button it will compile and upload firmware to the

board Wait for your PC to make a sound or TeensySaber will

play boot sound if speaker is connected Now you can unplug

the USB cable Done

If it gives an error instead this means your configh file has

issues define CONFIG_FILE name has mistakes configh file

is out of config folder your PC user name is non-latin

2TEENSYSABER V3 INSTRUCTIONS

FIRMWARE UPLOAD AND UPDATE2

Uploading firmware

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 23

2TEENSYSABER V3 INSTRUCTIONS

CHANGING PARAMETERS3

Changing sound board parameters

All sound files (sound fonts music tracks) are stored on the micro SD card Add required sound fonts folders (Plecter NEC and Smoothswing

fonts are supported no need to change WAV files names just copy and paste) to SD card root directory as itrsquos done in the default

ProffieOS_SD_Card content folder and music tracks to the tracks folder

Make sure to name all music tracks and sound fonts folders with latin characters and only up to 8 characters long without using any special

characters (like |[- etc)

Make sure you have a configini file in each sound font folder if there is none - copy one from some default TeensySaberProffieBoard sound

font and paste into newly added sound font folder It has only one parameter that you can modify - humstart It helps to match hum sound

start with blade ignition 1000 usually works fine

All blade effects LED configuration volume level clash sensitivity etc are changed in the configh file located in lightsabergtconfig folder

To do that open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text Editor (Notepad - to see code correctly in Notepad

Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all text) and Delete it then Copy-and-Paste (Ctrl+C

Ctrl+V) your wiring diagram config code into empty _configh file and Save it under new name Follow the instructions on page 22 to

upload it to the board

TeensySaber V3 config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)

volume level (0-3000)

clash sensitivity (adjust lower or higher with 01 step)

sound font folder nametrack name

Preset name

Blade style

LED configuration (use these XP-E2 LED templatesto define your LED)

for Red use 1 Ohm resistor for Green - no resistor for Blue use 024 Ohm

NoLED ndash no 4th led used

Preset 1

24 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

31

PROFFIEBOARD INSTRUCTIONS

Whatrsquos needed

ndash ProffieBoard

ndash micro SD-card (see page 44 for recommendations)

ndash a USB micro SD-card reader (to load sound files from PC to micro SD card)

ndash micro USB data transfer cable (CABLES THAT SUPPORT ONLY CHARGING WONrsquoT WORK)

ndash wires of different gauges (32-20 AWG) (PTFE coated copper stranded wires recommended) heat shrink

ndash ESD safe soldering station solder wire flux etc

ndash pliers helping hands etc

ndash isopropyl alcohol to clean pads before soldering (helps solder to stick better)

ndash Digital Multimeter (VERY USEFUL)

ndash computer running Windows Linux or Mac OS with internet access

ndash 37V Li-Ion Protected rechargeable battery switches recharge port speaker LEDs resistors chassis etc

ndash Smart Li-Ion CC-CV (Constant Current - Constant Voltage mode) battery charger for 37V (42V) cells

ndash patience

WIRING DIAGRAMS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 25

31

PROFFIEBOARD INSTRUCTIONS

Board pinout

Battery + ndash 26 to 45 volt input drives everything except the LEDs

Battery - ndash negative pad for LEDs needs to be at same level as GND when both are connected Both pads are internally connected

GND ndash ground for electronics except LEDs Note that there are two GND pads on the board that are internally connected

Speaker +- ndash hooks up to speaker

Activation (1) Aux (2) Aux2 button (3) ndash hook up to closing buttons or potentially touch buttons

Blade ID Neopixel Data 1 ndash normally used to measure the blade ID restor and if itrsquos a neopixel blade feed out neopixel data

Data 2 3 4 5 ndash additional neopixel data outputs or free for other purposes

LED 1 2 3 4 5 6 ndash hooks up to negative side of LED (positive side of LED hooks up directly to battery) These pads can handle

up to 30 volts

SDA SCL ndash these pins are used to wire OLED display or to communicate with the gyro and accelerometer chip

RX TX ndash these pins are used for wiring a bluetooth module for wireless control

SWDCLK SWDIO ndash can be hooked up to a ST-LINK device and lets you debug programs running on the ProffieBoard

+5V ndash generated by the ProffieBoard normally itrsquos only ON when sound is playing

+33V ndash generated by the ProffieBoard for powering OLED display Bluetooth module or some accent leds

BOOT RESET ndash buttons to put the ProffieBoard in bootloader mode if uploading doesnrsquot work

micro USB port ndash micro USB port used only for firmware upload and can be used for sound files upload to SD card (from firmware version

1291 and up) THIS PORT ISNrsquoT USED FOR CHARGING THE BATTERY

LED 4LED 3

LED 2

LED 1

LED 5

LED 6

RESETBOOT

Battery - Battery -

Speaker + (red dot or ldquo+rdquo mark on speaker)

Battery +

Aux button (2)Activation button (1)

Aux2 button (3)

Blade ID Neopixel Data 1

Data 5

Data 4Data 3Data 2

+33V

SWDIO

SWDCLK

+5V

TXRX

GND

GND

Reset

Speaker -

SCLSDA

micro USB port

WIRING DIAGRAMS

26 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Basic Tri-Cree wiring diagram(In-hilt LED)

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

+

+

-

-

26 AWG

26 A

WG

30-32 AWG

28-30 AWG

28-3

0 A

WG

30-32 AWG

Protected 36-37V (42V max at full charge) 10A 3500mAh battery recommended+18650 battery holder (optional)Keystone 1042P

AV switch with accent led(constantly ON no effects)

accent leds run mostly at10-15mA so resistors for them must be calculated accordingly

Main RGB led

additional RGB leds(optional)

In case no additional high power leds are needed LED channels 4 5 6 can be used for 3 controllable(programmable for different effects) accent leds So AV switch led can be wired to one of these channelsAccent leds also can be wired to Data pads 1-5 please see ldquoAccent LEDs wiring and setuprdquo page

LED Resistor Calculator

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 27

3WIRING DIAGRAMS1

Basic Tri-Cree wiring (In-hilt LED)ldquoconfighrdquo file setup

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

Use a given or build your wiring diagram on THIS PAGE then open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text

Editor (Notepad - to see code correctly in Notepad Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all

text) and Delete it then Copy-and-Paste (Ctrl+C Ctrl+V) your wiring diagram config code (example below) into empty _configh file and

Save it under new name Follow the instructions on page 22 to upload it to the board

ldquoproffieboard_v1_confighrdquoNUM_BLADES 2NUM_BUTTONS 2VOLUME 1000CLASH_THRESHOLD_G 10StyleNormalPtrltCYAN WHITE 300 800gt()StyleNormalPtrltCYAN WHITE 300 800gt()

CreeXPE2RedTemplatelt1000gtCreeXPE2GreenTemplatelt0gtCreeXPE2BlueTemplatelt240gtNoLED

ProffieBoard config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)Volume level (0-3000)Clash sensitivity (adjust lower or higher with 01 step)ldquoBlade 1rdquo styleldquoBlade 2rdquo style (in case only 1 blade is used you donrsquot need this line)LED configuration (use these XP-E2 LED templatesto define your LED If other LED resistors are used change these values to match Ohm1000=ltvaluegt)

where 1000 is 1 Ohm resistor 0 is no resistor240 is 024 Ohm resistorNoLED ndash no 4th led used

Preset 1

LED 1 configuration

LED 2 configuration

Preset 2 etc

PROFFIEBOARD INSTRUCTIONS

28 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Basic Neopixel wiring diagram

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

+

+

-

-

22 A

WG

22 AWG

x2 28 AWG

x2 26 AWG

22 A

WG

30-32 AWG30-32 AWG

Protected 36-37V (42V max at full charge) 10A 3500mAh or 15A 3120mAhbattery recommended+18650 battery holder (optional)Keystone 1042P

AV switch with accent led(constantly ON no effects)

accent leds run mostly at10-15mA so resistors for them must be calculated accordingly

Main Neopixel strip

additional Neopixelstrips(optional)

Neopixel bladeconnector

330 Ohm on the Blade pcb side

x3 28 AWGor x1 22 AWGfor Negative

330 Ohm on the Blade pcb side

arrows up

330 Ohm on the Blade pcb side

In case no additional Neopixel strips are needed LED channels 4 5 6 can be used for 3 controllable(programmable for different effects) accent leds So AV switch led can be wired to one of these channelsAccent leds also can be wired to Data pads 2-5 please see ldquoAccent LEDs wiring and setuprdquo page

Recommended power wire gauges (22 AWG) are given for 2-strip blade For 3-strip blade you gonna need at least 20 AWG wires

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 29

ldquoproffieboard_v1_confighrdquo

3WIRING DIAGRAMS1

Basic Neopixel wiringldquoconfighrdquo file setup

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

NUM_BLADES 3NUM_BUTTONS 2VOLUME 1000CLASH_THRESHOLD_G 10IgnitionDelaylt0 any blade stylegtIgnitionDelaylt800 any blade stylegtIgnitionDelaylt800 any blade stylegtWS2811BladePtrlt118 WS2811 800kHz | WS2811 GRBgt()WS2811BladePtrlt26 blade2Pin ltbladePowerPin4gtgt()WS2811BladePtrlt26 blade3Pin ltbladePowerPin5gtgt()

ProffieBoard config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)Volume level (0-3000)Clash sensitivity (adjust lower or higher with 01 step)ldquoBlade 1rdquo style (main blade with IgnitionDelay 0)ldquoBlade 2rdquo style (CG blade 1 with IgnitionDelay 800)ldquoBlade 3rdquo style (CG blade 2 with IgnitionDelay 800)

strip configuration (defines how many pixels it has and to which LED output and pin is wired)

Preset 1

any blade style

strip (blade) 1 configuration

adjust this number to match your strips leds count

strip (blade) 2 configuration

strip (blade) 3 configuration

Preset 2 etc

Use a given or build your wiring diagram on THIS PAGE then open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text

Editor (Notepad - to see code correctly in Notepad Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all

text) and Delete it then Copy-and-Paste (Ctrl+C Ctrl+V) your wiring diagram config code (example below) into empty _configh file and

Save it under new name Follow the instructions on page 22 to upload it to the board

PROFFIEBOARD INSTRUCTIONS

30 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Basic Segmented string wiring diagram

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

+

+

-

-

24 A

WG

28 AWG

30-32 AWG30-32 AWG

Protected 36-37V (42V max at full charge) 10A 3500mAh battery recommended+18650 battery holder (optional)Keystone 1042P

AV switch with accent led(constantly ON no effects)

accent leds run mostly at10-15mA so resistors for them must be calculated accordingly

6-segments string blade

FoC string

N-channel FET3A minimum

123456

Calculate resistors for each led segment of the blade string depending on which leds are used 5mm leds have max drive current around 25mA per led when 10mm leds can be 100mA and 200mA per ledSo pay attention to your led max current and Forward Voltage (Vf) when calculating a segment resistor resistence as well as its wattage Also choose wire gauges accordingly to meet segments and total blade max current draw level

LED Resistor Calculator

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 31

ldquoproffieboard_v1_confighrdquo

3WIRING DIAGRAMS1

Basic Segmented string wiringldquoconfighrdquo file setup

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

NUM_BLADES 1NUM_BUTTONS 2VOLUME 1000CLASH_THRESHOLD_G 10StyleNormalPtrltCYAN WHITE 300 800gt()ltBlue3mmLED BladePin White3mmLEDgt

ProffieBoard config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)Volume level (0-3000)Clash sensitivity (adjust lower or higher with 01 step)Blade styleLED string configuration(here you mention the color and type of leds usedin the main blade string segments and FoC stringBladePin is the FoC signal pin (Blade ID pin))

Preset

LED string configuration

Use a given or build your wiring diagram on THIS PAGE then open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text

Editor (Notepad - to see code correctly in Notepad Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all

text) and Delete it then Copy-and-Paste (Ctrl+C Ctrl+V) your wiring diagram config code (example below) into empty _configh file and

Save it under new name Follow the instructions on page 22 to upload it to the board

PROFFIEBOARD INSTRUCTIONS

32 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Accent LEDs wiring diagram(optional)

Accent LEDs work with ProffieBoard as additional ldquobladesrdquo when powered by LED outputs 4 5 6 or Data pads 1 2 3 5 as PWM So they can

have any effect that blade can have If no effects needed accent led can be powered just by a 33V output pad (power-on led indication)

30-32 AWG

with Neopixel blade setup these 4 outputsdonrsquot work for regular accent leds

Recommended resistors to use for accent leds at 33V power source and 15mA drive

ndash 100 Ohm for Red (lt100000gt value in the code)ndash 13 Ohm for Green (lt13000gt value in the code)ndash 13 Ohm for Blue (lt13000gt value in the code)ndash 100 Ohm for Yellow (lt100000gt value in the code)ndash 20 Ohm for White (lt20000gt value in the code)

RGB ledcommon-anode

8 ldquobladesrdquo1 main and 7 accent leds

main blade style (effects) main blade style (effects)

7 accent leds style (effects)accent led style (effects)

7 accent leds configurations

RGB accent led configuration

2 ldquobladesrdquo1 main and 1 RGB accent led

ldquoPower-onrdquo indicationaccent leds (no effects)

7 accent leds withindependent effects

RGB accent led

a) b)

b)

c)

c)

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 33

3WIRING DIAGRAMS1

Neopixel Accent LEDs wiring diagram(optional)

With Neopixel setup additional neopixel leds or arrays can be used as accent leds There are 2 ways to wire them using additional Data

pins 2 3 4 5 or ldquoSub-bladesrdquo wiring with just 1 Data output pin Same way Neopixel connectors with on-board leds ca be wired

Option 1 ndash with extra Data pins

Main Blade

some accent leds

D1

D2

crystal leds

330 Ohm

330 Ohm

330 Ohm

main blade style (effects)

main blade 144 leds Data pin 1

accent leds blade style (effects)

accent leds ldquobladerdquo 4 leds Data pin 2

crystal leds blade style (effects)

crystal leds ldquobladerdquo 2 leds Data pin 3

3 ldquobladesrdquo1 main 1 accent leds array and 1 crystal leds array

PROFFIEBOARD INSTRUCTIONS

D3

follow arrows direction

34 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Neopixel Accent LEDs wiring diagram(optional)

PROFFIEBOARD INSTRUCTIONS

Main Blade

some accent leds

1

3

5678

2

4

D1

crystal leds

follow arrows direction

330 Ohm

330 OhmData signal

With this setup a single array of neopixel leds is separated into a couple of sub-blades with their own style configuration and behaviour This

is really usefull when you want to use only one data pin More about ldquoSub-bladesrdquo on ProffieOS wiki page

Option 2 ndash with ldquoSub-bladesrdquo

main blade style (effects)

main blade sub-blade 140 leds (7-146) but from 6 to 145 in the code

accent leds blade style (effects)

accent leds sub-blade 4 leds (1-4) but from 0 to 3 in the code

crystal leds blade style (effects)

146 leds total used

crystal leds sub-blade 2 leds (5-6) but from 4 to 5 in the code

update default 144 to a higher total value if you get all accent leds +Main blade gt 144 Example update to 146 if you have 2 crystal leds +4 accent leds + 140 Main blade leds = 146

3 ldquobladesrdquo 1 main 1 accent leds array and 1 crystal leds array

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 35

3WIRING DIAGRAMS1

OLED display wiring diagram(optional)

SSD1306 128x32 pixels OLED display allows to show battery level current preset name play different animations and even simple games It

can be wired to any blade configuration and requires just one additional line in the code to work You can get monochrome display in white

or blue color

SSD1306128x32OLED

SSD1306 ndash with blue or white display color selectSSD1306 ndash cheaper priceSSD1306 just screen ndash blue or white select

30-32 AWG

30-32 AWG

add this line to enable OLED display

display shows a preset name written in these quotes ldquoldquo

PROFFIEBOARD INSTRUCTIONS

36 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Bluetooth module wiring diagram(optional)

SOON

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 37

3WIRING DIAGRAMS1

Blade ID resistor functions(optional)

SOON

PROFFIEBOARD INSTRUCTIONS

38 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

website ProffieBoard FULL wiring diagrams link

Scroll the page down till you see the interactive diagram Above the diagram there are components selection options Build your saber setup

with it and follow diagram to wire your board Then you need to copy the configuration code below and paste it into your _configh file

Choose components you want

3WIRING DIAGRAMS1

More wiring diagrams

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 39

3WIRING DIAGRAMS1

How to use it

PROFFIEBOARD INSTRUCTIONS

Blade ignitionretraction ndash assuming you have at least one button pressing it briefly should turn the saber on or off If you have an AUX button pressing it briefly should also turn the saber on and off If you have no buttons you can turn the saber on and off by twisting your wrist back and forth Note that the motion has to be done long enough to count so a very quick flick of the wrist will not workTurn On muted ndash double-click power buttonNext preset ndash while saber is off click the AUX buttonPrevious preset ndash hold AUX button and click the Activation buttonTrigger Clash ndash while saber is on hit the bladeTrigger Lockup ndash while saber is on hold Activation button then trigger a clash Lockup releases when you let go of the Acti-vation buttonTrigger Drag ndash like lockup but point saber mostly down before holding Activation buttonTrigger Force ndash long-click AUX buttonStart soundtrack ndash long-click the Activation buttonTrigger Blaster Block ndash while saber is on short-click AUX button

Serial Monitor commands

battery_voltage ndash gets current battery voltage valueget_volume ndash get current volume valuepow ndash power OnOff the saberon ndash power On the saberoff ndash power Off the saberset_volume lt0-3000gt ndash set volume value (example set_volume 500)play ndash play the default preset trackplay trackslttrack namegt ndash play a specific track from tracks folder (example play tracksvenuswav)stop ndash stop the playing trackforce ndash play ldquoforcerdquo sound effectsdrag ndash play ldquodragrdquo sound effectsblast ndash play ldquoblasterrdquo sound effectslock ndash play ldquolockuprdquo sound effectsclash ndash play ldquoclashrdquo sound effectsreset ndash reboot the boardn ndash switch to next presetp ndash switch to previous presetlist_presets ndash show all presetssdtest ndash test SD card speed

40 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3FIRMWARE UPLOAD AND UPDATE2

Software installation and setup

PROFFIEBOARD INSTRUCTIONS

To upload firmware to ProffieBoard Arduino IDE program is required Follow these steps to install it to your PC

1 Install latest Arduino IDE software (donrsquot use BETA)

Installing as Windows app also is not recommended

because it will be installed in a specific protected folder that

wonrsquot allow you to install any additional softwareplugin in it

If ProffieBoard wonrsquot show up in COM port use

Arduino IDE 186 version

2 Install the Proffieboard Arduino Plugin and Zadig software

Follow installation instructions

3 Select Proffieboard-STM32L433 in Tools -gt Board

USB Type ndash Serial CPU Speed ndash 80 MHz Optimize ndash Smallest Code DOSFS ndash SDCARD (SPI) Port ndash COM(the number your PC assigned) (Butterfly-L433CC)

Connect Proffieboard via USB cable to PC to be able to select

the Port

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 41

3FIRMWARE UPLOAD AND UPDATE2

Uploading firmware

PROFFIEBOARD INSTRUCTIONS

1 Download the ProffieBoard firmware and SD card content

Unzip lightsaber-1286zip to your Documents directory or to

Desktop but not to Arduino program folder or anywhere in

Programs directory where all programs are installed You will

see a lightsaber folder and files inside it Donrsquot move any of

these files to any other location outside the lightsaber folder

and donrsquot reorganize them Unzip ProffieOS_SD_Cardzip to the

folder where you keep lightsaber-1286 folder Copy all files

from ProffieOS_SD_Card folder to your SD card

2 Unhide file extensions in File Explorer settings to see h ending

of config files Donrsquot add ldquohrdquo to the config file name Go to config folder and create you own configh file (see page

42 for how-to)

Double-click the lightsaberino file

3 Add the name of your configh file as shown and Save this

lightsaberino file Make sure the other config files are

commented out there should be only one CONFIG_FILE

without You can have multiple config files

in lightsabergtconfig folder and just define the one you need

in lightsaberino file and upload it again to ProffieBoard

4 Connect battery to ProffieBoard and hook up to your PC

with a data transfer micro-USB-to-USB cable

Press arrow button it will compile and upload firmware to the

board Wait for red text progress bars to stop at 100

ProffieBoard will play boot sound if speaker is connected

Now you can unplug the USB cable Done

If it gives an error instead this means your configh file has

issues define CONFIG_FILE name has mistakes configh file

is out of config folder your PC user name is non-latin

42 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

33

configh file structure editing

PROFFIEBOARD INSTRUCTIONS

CHANGING PARAMETERS

All sound files (sound fonts music tracks) are stored on the micro SD card Add required sound fonts folders (Plecter NEC and Smoothswing

fonts are supported no need to change WAV files names just copy and paste) to SD card root directory as itrsquos done in the default

ProffieOS_SD_Card content folder and music tracks to the tracks folder

Make sure to name all music tracks and sound fonts folders with latin characters and only up to 8 characters long without using any special

characters (like |[- etc)

Make sure you have a configini file in each sound font folder if there is none - copy one from some default TeensySaberProffieBoard sound

font and paste into newly added sound font folder It has only one parameter that you can modify - humstart It helps to match hum sound

start with blade ignition 1000 usually works fine

All blade effects LED configuration volume level clash sensitivity etc are changed in the configh file located in lightsabergtconfig folder

To do that open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text Editor (Notepad - to see code correctly in Notepad

Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all text) and Delete it then Copy-and-Paste (Ctrl+C

Ctrl+V) your wiring diagram config code into empty _configh file and Save it under new name Follow the instructions on page 39 to

upload it to the board

Proffieboard config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)

volume level (0-3000)

clash sensitivity (adjust lower or higher with 01 step)

sound font folder nametrack name

Preset name

Blade style

LED configuration (use these XP-E2 LED templatesto define your LED)

for Red use 1 Ohm resistor for Green - no resistor for Blue use 024 Ohm

NoLED ndash no 4th led used

Preset 1

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 43

33

Blade Styles

StylePtrltInOutHelperltSimpleClashltLockupltBlastltOnSparkltAudioFlickerltRgblt02550gtRgblt501000gtgtRgblt2552550gt150gtRgblt255500gtgtAudioFlickerltRgblt1002550gtRgblt2550150gtgtgtRgblt255100150gt40gt200300Blackgtgt

ndash this is how the Blade Style code looks pasted in the configh file Preset (it sits inside a StylePtrltgt container)

ndash this is how the Blade Style code looks when editing it inside a Blade Style Editor

Each Blade Style is made of a variety of Effects each added effect goes instead of a base color in the previous effect

PROFFIEBOARD INSTRUCTIONS

CHANGING PARAMETERS

ProffieBoard and TeensySaber use Blade Styles for the main saber blade and any other accent leds to define all light effects (color changing

flashes flickering delays ignitionretraction timing etc)

Use Blade Style Editor to create and adjust Blade Styles Megtooth Sith Sabers did a great video tutorial where he shows and explains

how to use Blade Style Editor Also you can grab some pre-made Blade Styles or share yours here on TRA forums

A Blade Style example of simple flickering Green blade with Spark on start Clash Blaster Lockup and Drag IgnitionRetraction effects

InOutHelperltSimpleClashltLockupltBlastltOnSparkltAudioFlickerltRgblt02550gtRgblt501000gtgtRgblt2552550gt150gtRgblt255500gtgtAudioFlickerltRgblt1002550gtRgblt2550150gtgtgtRgblt255100150gt40gt200300Blackgt

InOutHelperltbase color200300Blackgt ndash base color can be defined by words (WHITE RED GREEN PURPLE etc) or by Rgblt0-2550-2550-255gt values for more

custom shades 200 is extension length in milliseconds 300 is retraction length in milliseconds Black is color when retracted (also can be any other color)

SimpleClashltbase colorclash color40gt ndash clash effect 40 is clash duration in milliseconds

Lockupltbase colorlockup colorgt ndash lockup effect

Blastltbase colorblast colorgt ndash blaster effect

OnSparkltbase colorspark color150gt ndash spark on ignition effect 150 is spark duration in milliseconds

AudioFlickerltrdquoArdquo colorrdquoBrdquo colorgt ndash flickering effect (blade flickers to the actual saber hum sound) the more difference between ldquoArdquo and ldquoBrdquo colors - the more

abrupt is flickering

Rgblt255500gt ndash actual color in RGB format (0 is no light 255 is the maximum brightness value for Red Green or Blue channel)

44 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

ndash SanDisk 4GB microSDHC Class 4 (Genuine) ndash SanDisk 4GB microSDHC Class 4 (Genuine)

130238 kbs = 1477 simultaneous audio streams 137812 kbs = 1562 simultaneous audio streams

ndash Patriot LX Series 16GB microSDHC UHS-IU1 Class 10 ndash Patriot LX Series 16GB microSDHC UHS-IU1 Class 10

133005 kbs = 1508 simultaneous audio streams

ndash GSkill 16GB microSDHC UHS-IU1 Class 10 ndash GSkill 16GB microSDHC UHS-IU1 Class 10

129534 kbs = 1469 simultaneous audio streams

ndash Kingston 16GB microSDHC UHS-IU1 Class 10 ndash Kingston 16GB microSDHC UHS-IU1 Class 10

128090 kbs = 1452 simultaneous audio streams

ndash SanDisk Ultra 16GB microSDHC UHS-IU1 A1 Class 10 ndash SanDisk Ultra 16GB microSDHC UHS-IU1 A1 Class 10

102663 kbs = 1164 simultaneous audio streams 11124 kbs = 1261 simultaneous audio streams

ndash SanDisk 8GB microSDHC Class 4 ndash SanDisk 8GB microSDHC Class 4

108506 kbs = 1230 simultaneous audio streams

ndash SanDisk 16GB microSDHC Class 4 ndash SanDisk 16GB microSDHC Class 4

102663 kbs = 1164 simultaneous audio streams 106957 kbs = 1213 simultaneous audio streams

ndash SanDisk Ultra 16GB microSDHC UHS-IU1 Class 10 ndash SanDisk Ultra 16GB microSDHC UHS-IU1 Class 10

102663 kbs = 1164 simultaneous audio streams 103909 kbs = 1178 simultaneous audio streams

ndash Smartbuy 4GB microSDHC Class 4 ndash Smartbuy 4GB microSDHC Class 4

75437 kbs = 855 simultaneous audio streams

ndash Kingston 8GB microSDHC Class 4 ndash Kingston 8GB microSDHC Class 4

75209 kbs = 822 simultaneous audio streams

ndash SanDisk 4GB microSDHC Class 4 (Fake) ndash SanDisk 4GB microSDHC Class 4 (Fake)

677 kbs = 769 simultaneous audio streams

Here is a list of tested micro SD cards speed with TeensySaber V3 and ProffieBoard Any card with speed over 900 kbs is recommended the

higher the speed is ndash the better Memory size of 4-16Gb is more than enough Cards were tested with a default firmware (1291) compiled

with ldquoSmallest Coderdquo under Optimize ldquodefault_proffieboard_confighrdquo file and default ProffieOS SD card sound files (7 folders)

To test your SD card speed simply hook up ProffieBoard to PC open Arduino IDE go to Tools and open Serial Monitor make sure you have

New Line and 9600 baud rate selected on the bottom of Serial Monitor window type and send sdtest command wait for the test result

4Recommended micro SD cards

BEST

TEENSYSABER PROFFIEBOARD

GOOD

BAD

PROFFIEBOARD INSTRUCTIONS

SD CARD RECOMMENDATIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 45

There are a lot of fake (chinese copies) microSD cards on the market from aliexpress ebay amazon etc They look very similar to genuine

cards but are a bit different though and have a twice lower writingreading speed Here is an example of a SanDisk 4Gb Class 4 card one is

genuine with 137812 kbs speed and the other one is fake with 677 kbs speed I got from ebay seller

Be carefull and pay attention to how the actual card looks if you are not sure ask seller for the real photo of SD card he sells

4Genuine and Fake SanDisk 4Gb Class 4 microSD

PROFFIEBOARD INSTRUCTIONS

SD CARD RECOMMENDATIONS

46 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

WIRE GAUGE GUIDE

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 47

RECHARGE PORTS AND KILL SWITCHES

48 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

NEOPIXEL STRIPS CURRENT DRAW

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 49

6TROUBLESHOOTING

For more help please check these linksProffieOSProffieBoardTeensySaber wiki on GitHubAsk your question on The Rebel Armory forumsAsk your question on FX-sabers forumsAsk your question in facebook group

How to solve most common issues

Quick troubleshooting tips

TeensySaber board or Proffieboard is not recognized by computer (nothing under Port selection in Arduino)

ndash Make sure a charged 37V battery is connected to the board micro-USB cable is a data transfer cable all plugins and drivers are installed ndash

check again pages 21 for TeensySaber or 40 for Proffieboard Try a different USB port on your computer

Sketch (code) compile error in Arduino IDE

ndash Check your define CONFIG_FILE ldquoconfig_confighrdquo line in opened lightsaberino file if itrsquos written correctly with config in it

Sketch (code) compile error in Arduino IDE

ndash Check if the _configh file you defined in the lightsaberino sketch file is same name as in the lightsaber-rdquofirmware versionrdquolightsaber

config folder and is located in this folder

Sketch (code) compile error in Arduino IDE

ndash Check your settings under Tools tab in Arduino IDE program Check again pages 21 for TeensySaber or 40 for Proffieboard

Sketch (code) compile error in Arduino IDE

ndash Check if your _configh file is correct Blade Styles Presets const unsigned int maxLedsPerStrip = 144 if BladeConfig blades[] = is correct

Sketch (code) compile error in Arduino IDE

ndash If nothing helps install Arduino IDE version 186 and try to compile and upload the firmware again

Sound doesnrsquot play

ndash Remove SD card and insert again check speaker wiring Make sure all sound files on SD card are correctly named (8 characters max long)

Re-format SD card in FAT32 load sound files and try again try another SD card

Board says ldquoLOW POWERrdquo

ndash Charge the battery

Serial Monitor shows info sent by the board but your commands donrsquot work

ndash In the bottom right corner of Serial Monitor window make sure the Line Ending drop down is set to New Line

Sound is weird and distorted

ndash Check your SD card speed (see page 44) Check speaker wiring try another good speaker

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 19

20 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

How to use it

Blade ignitionretraction ndash assuming you have at least one button pressing it briefly should turn the saber on or off If you have an AUX button pressing it briefly should also turn the saber on and off If you have no buttons you can turn the saber on and off by twisting your wrist back and forth Note that the motion has to be done long enough to count so a very quick flick of the wrist will not workTurn On muted ndash double-click power buttonNext preset ndash while saber is off click the AUX buttonPrevious preset ndash hold AUX button and click the Activation buttonTrigger Clash ndash while saber is on hit the bladeTrigger Lockup ndash while saber is on hold Activation button then trigger a clash Lockup releases when you let go of the Acti-vation buttonTrigger Drag ndash like lockup but point saber mostly down before holding Activation buttonTrigger Force ndash long-click AUX buttonStart soundtrack ndash long-click the Activation buttonTrigger Blaster Block ndash while saber is on short-click AUX button

Serial Monitor commands

battery_voltage ndash gets current battery voltage valueget_volume ndash get current volume valuepow ndash power OnOff the saberon ndash power On the saberoff ndash power Off the saberset_volume lt0-3000gt ndash set volume value (example set_volume 500)play ndash play the default preset trackplay trackslttrack namegt ndash play a specific track from tracks folder (example play tracksvenuswav)stop ndash stop the playing trackforce ndash play ldquoforcerdquo sound effectsdrag ndash play ldquodragrdquo sound effectsblast ndash play ldquoblasterrdquo sound effectslock ndash play ldquolockuprdquo sound effectsclash ndash play ldquoclashrdquo sound effectsreset ndash reboot the boardn ndash switch to next presetp ndash switch to previous presetlist_presets ndash show all presetssdtest ndash test SD card speed

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 21

2TEENSYSABER V3 INSTRUCTIONS

FIRMWARE UPLOAD AND UPDATE2

Software installation and setup

To upload firmware to TeensySaber board Arduino IDE program is required Follow these steps to install it to your PC

1 Install latest Arduino IDE software (donrsquot use BETA)

Installing as Windows app also is not recommended

because it will be installed in a specific protected folder that

wonrsquot allow you to install Teensyduino software in it

If TeensySaber wonrsquot show up in COM port use

Arduino IDE 186 version

2 Install latest Teensyduino software in same directory

usually itrsquos CProgram Files (x86)Arduino on Windows

Follow installation instructions for your system

3 Select Teensy 32 31 in Tools -gt Board

USB Type ndash Serial CPU Speed ndash 96 MHz (overclock) Optimize ndash Smallest Code Port ndash COM(the number your PC assigned) (Teensy 32) Serial

Connect TeensySaber via USB cable to PC to be able to select

the Port donrsquot forget to connect battery first

22 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

1 Download the TeensySaber firmware and SD card content

Unzip lightsaber-1286zip to your Documents directory or to

Desktop but not to Arduino program folder or anywhere in

Programs directory where all programs are installed You will

see a lightsaber folder and files inside it Donrsquot move any of

these files to any other location outside the lightsaber folder

and donrsquot reorganize them Unzip ProffieOS_SD_Cardzip to the

folder where you keep lightsaber-1286 folder Copy all files

from ProffieOS_SD_Card folder to your SD card

2 Unhide file extensions in File Explorer settings to see h ending

of config files Donrsquot add ldquohrdquo to the config file name

Go to config folder and create you own configh file (see page

23 for how-to)

Double-click the lightsaberino file

3 Add the name of your configh file as shown and Save this

lightsaberino file Make sure the other config files are

commented out there should be only one CONFIG_FILE

without You can have multiple config files

in lightsabergtconfig folder and just define the one you need

in lightsaberino file and upload it again to TeensySaber board

4 Connect battery to TeensySaber board and hook up to your PC

with a data transfer micro-USB-to-USB cable

Press arrow button it will compile and upload firmware to the

board Wait for your PC to make a sound or TeensySaber will

play boot sound if speaker is connected Now you can unplug

the USB cable Done

If it gives an error instead this means your configh file has

issues define CONFIG_FILE name has mistakes configh file

is out of config folder your PC user name is non-latin

2TEENSYSABER V3 INSTRUCTIONS

FIRMWARE UPLOAD AND UPDATE2

Uploading firmware

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 23

2TEENSYSABER V3 INSTRUCTIONS

CHANGING PARAMETERS3

Changing sound board parameters

All sound files (sound fonts music tracks) are stored on the micro SD card Add required sound fonts folders (Plecter NEC and Smoothswing

fonts are supported no need to change WAV files names just copy and paste) to SD card root directory as itrsquos done in the default

ProffieOS_SD_Card content folder and music tracks to the tracks folder

Make sure to name all music tracks and sound fonts folders with latin characters and only up to 8 characters long without using any special

characters (like |[- etc)

Make sure you have a configini file in each sound font folder if there is none - copy one from some default TeensySaberProffieBoard sound

font and paste into newly added sound font folder It has only one parameter that you can modify - humstart It helps to match hum sound

start with blade ignition 1000 usually works fine

All blade effects LED configuration volume level clash sensitivity etc are changed in the configh file located in lightsabergtconfig folder

To do that open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text Editor (Notepad - to see code correctly in Notepad

Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all text) and Delete it then Copy-and-Paste (Ctrl+C

Ctrl+V) your wiring diagram config code into empty _configh file and Save it under new name Follow the instructions on page 22 to

upload it to the board

TeensySaber V3 config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)

volume level (0-3000)

clash sensitivity (adjust lower or higher with 01 step)

sound font folder nametrack name

Preset name

Blade style

LED configuration (use these XP-E2 LED templatesto define your LED)

for Red use 1 Ohm resistor for Green - no resistor for Blue use 024 Ohm

NoLED ndash no 4th led used

Preset 1

24 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

31

PROFFIEBOARD INSTRUCTIONS

Whatrsquos needed

ndash ProffieBoard

ndash micro SD-card (see page 44 for recommendations)

ndash a USB micro SD-card reader (to load sound files from PC to micro SD card)

ndash micro USB data transfer cable (CABLES THAT SUPPORT ONLY CHARGING WONrsquoT WORK)

ndash wires of different gauges (32-20 AWG) (PTFE coated copper stranded wires recommended) heat shrink

ndash ESD safe soldering station solder wire flux etc

ndash pliers helping hands etc

ndash isopropyl alcohol to clean pads before soldering (helps solder to stick better)

ndash Digital Multimeter (VERY USEFUL)

ndash computer running Windows Linux or Mac OS with internet access

ndash 37V Li-Ion Protected rechargeable battery switches recharge port speaker LEDs resistors chassis etc

ndash Smart Li-Ion CC-CV (Constant Current - Constant Voltage mode) battery charger for 37V (42V) cells

ndash patience

WIRING DIAGRAMS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 25

31

PROFFIEBOARD INSTRUCTIONS

Board pinout

Battery + ndash 26 to 45 volt input drives everything except the LEDs

Battery - ndash negative pad for LEDs needs to be at same level as GND when both are connected Both pads are internally connected

GND ndash ground for electronics except LEDs Note that there are two GND pads on the board that are internally connected

Speaker +- ndash hooks up to speaker

Activation (1) Aux (2) Aux2 button (3) ndash hook up to closing buttons or potentially touch buttons

Blade ID Neopixel Data 1 ndash normally used to measure the blade ID restor and if itrsquos a neopixel blade feed out neopixel data

Data 2 3 4 5 ndash additional neopixel data outputs or free for other purposes

LED 1 2 3 4 5 6 ndash hooks up to negative side of LED (positive side of LED hooks up directly to battery) These pads can handle

up to 30 volts

SDA SCL ndash these pins are used to wire OLED display or to communicate with the gyro and accelerometer chip

RX TX ndash these pins are used for wiring a bluetooth module for wireless control

SWDCLK SWDIO ndash can be hooked up to a ST-LINK device and lets you debug programs running on the ProffieBoard

+5V ndash generated by the ProffieBoard normally itrsquos only ON when sound is playing

+33V ndash generated by the ProffieBoard for powering OLED display Bluetooth module or some accent leds

BOOT RESET ndash buttons to put the ProffieBoard in bootloader mode if uploading doesnrsquot work

micro USB port ndash micro USB port used only for firmware upload and can be used for sound files upload to SD card (from firmware version

1291 and up) THIS PORT ISNrsquoT USED FOR CHARGING THE BATTERY

LED 4LED 3

LED 2

LED 1

LED 5

LED 6

RESETBOOT

Battery - Battery -

Speaker + (red dot or ldquo+rdquo mark on speaker)

Battery +

Aux button (2)Activation button (1)

Aux2 button (3)

Blade ID Neopixel Data 1

Data 5

Data 4Data 3Data 2

+33V

SWDIO

SWDCLK

+5V

TXRX

GND

GND

Reset

Speaker -

SCLSDA

micro USB port

WIRING DIAGRAMS

26 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Basic Tri-Cree wiring diagram(In-hilt LED)

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

+

+

-

-

26 AWG

26 A

WG

30-32 AWG

28-30 AWG

28-3

0 A

WG

30-32 AWG

Protected 36-37V (42V max at full charge) 10A 3500mAh battery recommended+18650 battery holder (optional)Keystone 1042P

AV switch with accent led(constantly ON no effects)

accent leds run mostly at10-15mA so resistors for them must be calculated accordingly

Main RGB led

additional RGB leds(optional)

In case no additional high power leds are needed LED channels 4 5 6 can be used for 3 controllable(programmable for different effects) accent leds So AV switch led can be wired to one of these channelsAccent leds also can be wired to Data pads 1-5 please see ldquoAccent LEDs wiring and setuprdquo page

LED Resistor Calculator

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 27

3WIRING DIAGRAMS1

Basic Tri-Cree wiring (In-hilt LED)ldquoconfighrdquo file setup

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

Use a given or build your wiring diagram on THIS PAGE then open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text

Editor (Notepad - to see code correctly in Notepad Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all

text) and Delete it then Copy-and-Paste (Ctrl+C Ctrl+V) your wiring diagram config code (example below) into empty _configh file and

Save it under new name Follow the instructions on page 22 to upload it to the board

ldquoproffieboard_v1_confighrdquoNUM_BLADES 2NUM_BUTTONS 2VOLUME 1000CLASH_THRESHOLD_G 10StyleNormalPtrltCYAN WHITE 300 800gt()StyleNormalPtrltCYAN WHITE 300 800gt()

CreeXPE2RedTemplatelt1000gtCreeXPE2GreenTemplatelt0gtCreeXPE2BlueTemplatelt240gtNoLED

ProffieBoard config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)Volume level (0-3000)Clash sensitivity (adjust lower or higher with 01 step)ldquoBlade 1rdquo styleldquoBlade 2rdquo style (in case only 1 blade is used you donrsquot need this line)LED configuration (use these XP-E2 LED templatesto define your LED If other LED resistors are used change these values to match Ohm1000=ltvaluegt)

where 1000 is 1 Ohm resistor 0 is no resistor240 is 024 Ohm resistorNoLED ndash no 4th led used

Preset 1

LED 1 configuration

LED 2 configuration

Preset 2 etc

PROFFIEBOARD INSTRUCTIONS

28 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Basic Neopixel wiring diagram

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

+

+

-

-

22 A

WG

22 AWG

x2 28 AWG

x2 26 AWG

22 A

WG

30-32 AWG30-32 AWG

Protected 36-37V (42V max at full charge) 10A 3500mAh or 15A 3120mAhbattery recommended+18650 battery holder (optional)Keystone 1042P

AV switch with accent led(constantly ON no effects)

accent leds run mostly at10-15mA so resistors for them must be calculated accordingly

Main Neopixel strip

additional Neopixelstrips(optional)

Neopixel bladeconnector

330 Ohm on the Blade pcb side

x3 28 AWGor x1 22 AWGfor Negative

330 Ohm on the Blade pcb side

arrows up

330 Ohm on the Blade pcb side

In case no additional Neopixel strips are needed LED channels 4 5 6 can be used for 3 controllable(programmable for different effects) accent leds So AV switch led can be wired to one of these channelsAccent leds also can be wired to Data pads 2-5 please see ldquoAccent LEDs wiring and setuprdquo page

Recommended power wire gauges (22 AWG) are given for 2-strip blade For 3-strip blade you gonna need at least 20 AWG wires

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 29

ldquoproffieboard_v1_confighrdquo

3WIRING DIAGRAMS1

Basic Neopixel wiringldquoconfighrdquo file setup

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

NUM_BLADES 3NUM_BUTTONS 2VOLUME 1000CLASH_THRESHOLD_G 10IgnitionDelaylt0 any blade stylegtIgnitionDelaylt800 any blade stylegtIgnitionDelaylt800 any blade stylegtWS2811BladePtrlt118 WS2811 800kHz | WS2811 GRBgt()WS2811BladePtrlt26 blade2Pin ltbladePowerPin4gtgt()WS2811BladePtrlt26 blade3Pin ltbladePowerPin5gtgt()

ProffieBoard config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)Volume level (0-3000)Clash sensitivity (adjust lower or higher with 01 step)ldquoBlade 1rdquo style (main blade with IgnitionDelay 0)ldquoBlade 2rdquo style (CG blade 1 with IgnitionDelay 800)ldquoBlade 3rdquo style (CG blade 2 with IgnitionDelay 800)

strip configuration (defines how many pixels it has and to which LED output and pin is wired)

Preset 1

any blade style

strip (blade) 1 configuration

adjust this number to match your strips leds count

strip (blade) 2 configuration

strip (blade) 3 configuration

Preset 2 etc

Use a given or build your wiring diagram on THIS PAGE then open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text

Editor (Notepad - to see code correctly in Notepad Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all

text) and Delete it then Copy-and-Paste (Ctrl+C Ctrl+V) your wiring diagram config code (example below) into empty _configh file and

Save it under new name Follow the instructions on page 22 to upload it to the board

PROFFIEBOARD INSTRUCTIONS

30 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Basic Segmented string wiring diagram

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

+

+

-

-

24 A

WG

28 AWG

30-32 AWG30-32 AWG

Protected 36-37V (42V max at full charge) 10A 3500mAh battery recommended+18650 battery holder (optional)Keystone 1042P

AV switch with accent led(constantly ON no effects)

accent leds run mostly at10-15mA so resistors for them must be calculated accordingly

6-segments string blade

FoC string

N-channel FET3A minimum

123456

Calculate resistors for each led segment of the blade string depending on which leds are used 5mm leds have max drive current around 25mA per led when 10mm leds can be 100mA and 200mA per ledSo pay attention to your led max current and Forward Voltage (Vf) when calculating a segment resistor resistence as well as its wattage Also choose wire gauges accordingly to meet segments and total blade max current draw level

LED Resistor Calculator

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 31

ldquoproffieboard_v1_confighrdquo

3WIRING DIAGRAMS1

Basic Segmented string wiringldquoconfighrdquo file setup

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

NUM_BLADES 1NUM_BUTTONS 2VOLUME 1000CLASH_THRESHOLD_G 10StyleNormalPtrltCYAN WHITE 300 800gt()ltBlue3mmLED BladePin White3mmLEDgt

ProffieBoard config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)Volume level (0-3000)Clash sensitivity (adjust lower or higher with 01 step)Blade styleLED string configuration(here you mention the color and type of leds usedin the main blade string segments and FoC stringBladePin is the FoC signal pin (Blade ID pin))

Preset

LED string configuration

Use a given or build your wiring diagram on THIS PAGE then open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text

Editor (Notepad - to see code correctly in Notepad Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all

text) and Delete it then Copy-and-Paste (Ctrl+C Ctrl+V) your wiring diagram config code (example below) into empty _configh file and

Save it under new name Follow the instructions on page 22 to upload it to the board

PROFFIEBOARD INSTRUCTIONS

32 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Accent LEDs wiring diagram(optional)

Accent LEDs work with ProffieBoard as additional ldquobladesrdquo when powered by LED outputs 4 5 6 or Data pads 1 2 3 5 as PWM So they can

have any effect that blade can have If no effects needed accent led can be powered just by a 33V output pad (power-on led indication)

30-32 AWG

with Neopixel blade setup these 4 outputsdonrsquot work for regular accent leds

Recommended resistors to use for accent leds at 33V power source and 15mA drive

ndash 100 Ohm for Red (lt100000gt value in the code)ndash 13 Ohm for Green (lt13000gt value in the code)ndash 13 Ohm for Blue (lt13000gt value in the code)ndash 100 Ohm for Yellow (lt100000gt value in the code)ndash 20 Ohm for White (lt20000gt value in the code)

RGB ledcommon-anode

8 ldquobladesrdquo1 main and 7 accent leds

main blade style (effects) main blade style (effects)

7 accent leds style (effects)accent led style (effects)

7 accent leds configurations

RGB accent led configuration

2 ldquobladesrdquo1 main and 1 RGB accent led

ldquoPower-onrdquo indicationaccent leds (no effects)

7 accent leds withindependent effects

RGB accent led

a) b)

b)

c)

c)

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 33

3WIRING DIAGRAMS1

Neopixel Accent LEDs wiring diagram(optional)

With Neopixel setup additional neopixel leds or arrays can be used as accent leds There are 2 ways to wire them using additional Data

pins 2 3 4 5 or ldquoSub-bladesrdquo wiring with just 1 Data output pin Same way Neopixel connectors with on-board leds ca be wired

Option 1 ndash with extra Data pins

Main Blade

some accent leds

D1

D2

crystal leds

330 Ohm

330 Ohm

330 Ohm

main blade style (effects)

main blade 144 leds Data pin 1

accent leds blade style (effects)

accent leds ldquobladerdquo 4 leds Data pin 2

crystal leds blade style (effects)

crystal leds ldquobladerdquo 2 leds Data pin 3

3 ldquobladesrdquo1 main 1 accent leds array and 1 crystal leds array

PROFFIEBOARD INSTRUCTIONS

D3

follow arrows direction

34 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Neopixel Accent LEDs wiring diagram(optional)

PROFFIEBOARD INSTRUCTIONS

Main Blade

some accent leds

1

3

5678

2

4

D1

crystal leds

follow arrows direction

330 Ohm

330 OhmData signal

With this setup a single array of neopixel leds is separated into a couple of sub-blades with their own style configuration and behaviour This

is really usefull when you want to use only one data pin More about ldquoSub-bladesrdquo on ProffieOS wiki page

Option 2 ndash with ldquoSub-bladesrdquo

main blade style (effects)

main blade sub-blade 140 leds (7-146) but from 6 to 145 in the code

accent leds blade style (effects)

accent leds sub-blade 4 leds (1-4) but from 0 to 3 in the code

crystal leds blade style (effects)

146 leds total used

crystal leds sub-blade 2 leds (5-6) but from 4 to 5 in the code

update default 144 to a higher total value if you get all accent leds +Main blade gt 144 Example update to 146 if you have 2 crystal leds +4 accent leds + 140 Main blade leds = 146

3 ldquobladesrdquo 1 main 1 accent leds array and 1 crystal leds array

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 35

3WIRING DIAGRAMS1

OLED display wiring diagram(optional)

SSD1306 128x32 pixels OLED display allows to show battery level current preset name play different animations and even simple games It

can be wired to any blade configuration and requires just one additional line in the code to work You can get monochrome display in white

or blue color

SSD1306128x32OLED

SSD1306 ndash with blue or white display color selectSSD1306 ndash cheaper priceSSD1306 just screen ndash blue or white select

30-32 AWG

30-32 AWG

add this line to enable OLED display

display shows a preset name written in these quotes ldquoldquo

PROFFIEBOARD INSTRUCTIONS

36 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Bluetooth module wiring diagram(optional)

SOON

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 37

3WIRING DIAGRAMS1

Blade ID resistor functions(optional)

SOON

PROFFIEBOARD INSTRUCTIONS

38 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

website ProffieBoard FULL wiring diagrams link

Scroll the page down till you see the interactive diagram Above the diagram there are components selection options Build your saber setup

with it and follow diagram to wire your board Then you need to copy the configuration code below and paste it into your _configh file

Choose components you want

3WIRING DIAGRAMS1

More wiring diagrams

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 39

3WIRING DIAGRAMS1

How to use it

PROFFIEBOARD INSTRUCTIONS

Blade ignitionretraction ndash assuming you have at least one button pressing it briefly should turn the saber on or off If you have an AUX button pressing it briefly should also turn the saber on and off If you have no buttons you can turn the saber on and off by twisting your wrist back and forth Note that the motion has to be done long enough to count so a very quick flick of the wrist will not workTurn On muted ndash double-click power buttonNext preset ndash while saber is off click the AUX buttonPrevious preset ndash hold AUX button and click the Activation buttonTrigger Clash ndash while saber is on hit the bladeTrigger Lockup ndash while saber is on hold Activation button then trigger a clash Lockup releases when you let go of the Acti-vation buttonTrigger Drag ndash like lockup but point saber mostly down before holding Activation buttonTrigger Force ndash long-click AUX buttonStart soundtrack ndash long-click the Activation buttonTrigger Blaster Block ndash while saber is on short-click AUX button

Serial Monitor commands

battery_voltage ndash gets current battery voltage valueget_volume ndash get current volume valuepow ndash power OnOff the saberon ndash power On the saberoff ndash power Off the saberset_volume lt0-3000gt ndash set volume value (example set_volume 500)play ndash play the default preset trackplay trackslttrack namegt ndash play a specific track from tracks folder (example play tracksvenuswav)stop ndash stop the playing trackforce ndash play ldquoforcerdquo sound effectsdrag ndash play ldquodragrdquo sound effectsblast ndash play ldquoblasterrdquo sound effectslock ndash play ldquolockuprdquo sound effectsclash ndash play ldquoclashrdquo sound effectsreset ndash reboot the boardn ndash switch to next presetp ndash switch to previous presetlist_presets ndash show all presetssdtest ndash test SD card speed

40 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3FIRMWARE UPLOAD AND UPDATE2

Software installation and setup

PROFFIEBOARD INSTRUCTIONS

To upload firmware to ProffieBoard Arduino IDE program is required Follow these steps to install it to your PC

1 Install latest Arduino IDE software (donrsquot use BETA)

Installing as Windows app also is not recommended

because it will be installed in a specific protected folder that

wonrsquot allow you to install any additional softwareplugin in it

If ProffieBoard wonrsquot show up in COM port use

Arduino IDE 186 version

2 Install the Proffieboard Arduino Plugin and Zadig software

Follow installation instructions

3 Select Proffieboard-STM32L433 in Tools -gt Board

USB Type ndash Serial CPU Speed ndash 80 MHz Optimize ndash Smallest Code DOSFS ndash SDCARD (SPI) Port ndash COM(the number your PC assigned) (Butterfly-L433CC)

Connect Proffieboard via USB cable to PC to be able to select

the Port

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 41

3FIRMWARE UPLOAD AND UPDATE2

Uploading firmware

PROFFIEBOARD INSTRUCTIONS

1 Download the ProffieBoard firmware and SD card content

Unzip lightsaber-1286zip to your Documents directory or to

Desktop but not to Arduino program folder or anywhere in

Programs directory where all programs are installed You will

see a lightsaber folder and files inside it Donrsquot move any of

these files to any other location outside the lightsaber folder

and donrsquot reorganize them Unzip ProffieOS_SD_Cardzip to the

folder where you keep lightsaber-1286 folder Copy all files

from ProffieOS_SD_Card folder to your SD card

2 Unhide file extensions in File Explorer settings to see h ending

of config files Donrsquot add ldquohrdquo to the config file name Go to config folder and create you own configh file (see page

42 for how-to)

Double-click the lightsaberino file

3 Add the name of your configh file as shown and Save this

lightsaberino file Make sure the other config files are

commented out there should be only one CONFIG_FILE

without You can have multiple config files

in lightsabergtconfig folder and just define the one you need

in lightsaberino file and upload it again to ProffieBoard

4 Connect battery to ProffieBoard and hook up to your PC

with a data transfer micro-USB-to-USB cable

Press arrow button it will compile and upload firmware to the

board Wait for red text progress bars to stop at 100

ProffieBoard will play boot sound if speaker is connected

Now you can unplug the USB cable Done

If it gives an error instead this means your configh file has

issues define CONFIG_FILE name has mistakes configh file

is out of config folder your PC user name is non-latin

42 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

33

configh file structure editing

PROFFIEBOARD INSTRUCTIONS

CHANGING PARAMETERS

All sound files (sound fonts music tracks) are stored on the micro SD card Add required sound fonts folders (Plecter NEC and Smoothswing

fonts are supported no need to change WAV files names just copy and paste) to SD card root directory as itrsquos done in the default

ProffieOS_SD_Card content folder and music tracks to the tracks folder

Make sure to name all music tracks and sound fonts folders with latin characters and only up to 8 characters long without using any special

characters (like |[- etc)

Make sure you have a configini file in each sound font folder if there is none - copy one from some default TeensySaberProffieBoard sound

font and paste into newly added sound font folder It has only one parameter that you can modify - humstart It helps to match hum sound

start with blade ignition 1000 usually works fine

All blade effects LED configuration volume level clash sensitivity etc are changed in the configh file located in lightsabergtconfig folder

To do that open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text Editor (Notepad - to see code correctly in Notepad

Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all text) and Delete it then Copy-and-Paste (Ctrl+C

Ctrl+V) your wiring diagram config code into empty _configh file and Save it under new name Follow the instructions on page 39 to

upload it to the board

Proffieboard config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)

volume level (0-3000)

clash sensitivity (adjust lower or higher with 01 step)

sound font folder nametrack name

Preset name

Blade style

LED configuration (use these XP-E2 LED templatesto define your LED)

for Red use 1 Ohm resistor for Green - no resistor for Blue use 024 Ohm

NoLED ndash no 4th led used

Preset 1

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 43

33

Blade Styles

StylePtrltInOutHelperltSimpleClashltLockupltBlastltOnSparkltAudioFlickerltRgblt02550gtRgblt501000gtgtRgblt2552550gt150gtRgblt255500gtgtAudioFlickerltRgblt1002550gtRgblt2550150gtgtgtRgblt255100150gt40gt200300Blackgtgt

ndash this is how the Blade Style code looks pasted in the configh file Preset (it sits inside a StylePtrltgt container)

ndash this is how the Blade Style code looks when editing it inside a Blade Style Editor

Each Blade Style is made of a variety of Effects each added effect goes instead of a base color in the previous effect

PROFFIEBOARD INSTRUCTIONS

CHANGING PARAMETERS

ProffieBoard and TeensySaber use Blade Styles for the main saber blade and any other accent leds to define all light effects (color changing

flashes flickering delays ignitionretraction timing etc)

Use Blade Style Editor to create and adjust Blade Styles Megtooth Sith Sabers did a great video tutorial where he shows and explains

how to use Blade Style Editor Also you can grab some pre-made Blade Styles or share yours here on TRA forums

A Blade Style example of simple flickering Green blade with Spark on start Clash Blaster Lockup and Drag IgnitionRetraction effects

InOutHelperltSimpleClashltLockupltBlastltOnSparkltAudioFlickerltRgblt02550gtRgblt501000gtgtRgblt2552550gt150gtRgblt255500gtgtAudioFlickerltRgblt1002550gtRgblt2550150gtgtgtRgblt255100150gt40gt200300Blackgt

InOutHelperltbase color200300Blackgt ndash base color can be defined by words (WHITE RED GREEN PURPLE etc) or by Rgblt0-2550-2550-255gt values for more

custom shades 200 is extension length in milliseconds 300 is retraction length in milliseconds Black is color when retracted (also can be any other color)

SimpleClashltbase colorclash color40gt ndash clash effect 40 is clash duration in milliseconds

Lockupltbase colorlockup colorgt ndash lockup effect

Blastltbase colorblast colorgt ndash blaster effect

OnSparkltbase colorspark color150gt ndash spark on ignition effect 150 is spark duration in milliseconds

AudioFlickerltrdquoArdquo colorrdquoBrdquo colorgt ndash flickering effect (blade flickers to the actual saber hum sound) the more difference between ldquoArdquo and ldquoBrdquo colors - the more

abrupt is flickering

Rgblt255500gt ndash actual color in RGB format (0 is no light 255 is the maximum brightness value for Red Green or Blue channel)

44 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

ndash SanDisk 4GB microSDHC Class 4 (Genuine) ndash SanDisk 4GB microSDHC Class 4 (Genuine)

130238 kbs = 1477 simultaneous audio streams 137812 kbs = 1562 simultaneous audio streams

ndash Patriot LX Series 16GB microSDHC UHS-IU1 Class 10 ndash Patriot LX Series 16GB microSDHC UHS-IU1 Class 10

133005 kbs = 1508 simultaneous audio streams

ndash GSkill 16GB microSDHC UHS-IU1 Class 10 ndash GSkill 16GB microSDHC UHS-IU1 Class 10

129534 kbs = 1469 simultaneous audio streams

ndash Kingston 16GB microSDHC UHS-IU1 Class 10 ndash Kingston 16GB microSDHC UHS-IU1 Class 10

128090 kbs = 1452 simultaneous audio streams

ndash SanDisk Ultra 16GB microSDHC UHS-IU1 A1 Class 10 ndash SanDisk Ultra 16GB microSDHC UHS-IU1 A1 Class 10

102663 kbs = 1164 simultaneous audio streams 11124 kbs = 1261 simultaneous audio streams

ndash SanDisk 8GB microSDHC Class 4 ndash SanDisk 8GB microSDHC Class 4

108506 kbs = 1230 simultaneous audio streams

ndash SanDisk 16GB microSDHC Class 4 ndash SanDisk 16GB microSDHC Class 4

102663 kbs = 1164 simultaneous audio streams 106957 kbs = 1213 simultaneous audio streams

ndash SanDisk Ultra 16GB microSDHC UHS-IU1 Class 10 ndash SanDisk Ultra 16GB microSDHC UHS-IU1 Class 10

102663 kbs = 1164 simultaneous audio streams 103909 kbs = 1178 simultaneous audio streams

ndash Smartbuy 4GB microSDHC Class 4 ndash Smartbuy 4GB microSDHC Class 4

75437 kbs = 855 simultaneous audio streams

ndash Kingston 8GB microSDHC Class 4 ndash Kingston 8GB microSDHC Class 4

75209 kbs = 822 simultaneous audio streams

ndash SanDisk 4GB microSDHC Class 4 (Fake) ndash SanDisk 4GB microSDHC Class 4 (Fake)

677 kbs = 769 simultaneous audio streams

Here is a list of tested micro SD cards speed with TeensySaber V3 and ProffieBoard Any card with speed over 900 kbs is recommended the

higher the speed is ndash the better Memory size of 4-16Gb is more than enough Cards were tested with a default firmware (1291) compiled

with ldquoSmallest Coderdquo under Optimize ldquodefault_proffieboard_confighrdquo file and default ProffieOS SD card sound files (7 folders)

To test your SD card speed simply hook up ProffieBoard to PC open Arduino IDE go to Tools and open Serial Monitor make sure you have

New Line and 9600 baud rate selected on the bottom of Serial Monitor window type and send sdtest command wait for the test result

4Recommended micro SD cards

BEST

TEENSYSABER PROFFIEBOARD

GOOD

BAD

PROFFIEBOARD INSTRUCTIONS

SD CARD RECOMMENDATIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 45

There are a lot of fake (chinese copies) microSD cards on the market from aliexpress ebay amazon etc They look very similar to genuine

cards but are a bit different though and have a twice lower writingreading speed Here is an example of a SanDisk 4Gb Class 4 card one is

genuine with 137812 kbs speed and the other one is fake with 677 kbs speed I got from ebay seller

Be carefull and pay attention to how the actual card looks if you are not sure ask seller for the real photo of SD card he sells

4Genuine and Fake SanDisk 4Gb Class 4 microSD

PROFFIEBOARD INSTRUCTIONS

SD CARD RECOMMENDATIONS

46 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

WIRE GAUGE GUIDE

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 47

RECHARGE PORTS AND KILL SWITCHES

48 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

NEOPIXEL STRIPS CURRENT DRAW

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 49

6TROUBLESHOOTING

For more help please check these linksProffieOSProffieBoardTeensySaber wiki on GitHubAsk your question on The Rebel Armory forumsAsk your question on FX-sabers forumsAsk your question in facebook group

How to solve most common issues

Quick troubleshooting tips

TeensySaber board or Proffieboard is not recognized by computer (nothing under Port selection in Arduino)

ndash Make sure a charged 37V battery is connected to the board micro-USB cable is a data transfer cable all plugins and drivers are installed ndash

check again pages 21 for TeensySaber or 40 for Proffieboard Try a different USB port on your computer

Sketch (code) compile error in Arduino IDE

ndash Check your define CONFIG_FILE ldquoconfig_confighrdquo line in opened lightsaberino file if itrsquos written correctly with config in it

Sketch (code) compile error in Arduino IDE

ndash Check if the _configh file you defined in the lightsaberino sketch file is same name as in the lightsaber-rdquofirmware versionrdquolightsaber

config folder and is located in this folder

Sketch (code) compile error in Arduino IDE

ndash Check your settings under Tools tab in Arduino IDE program Check again pages 21 for TeensySaber or 40 for Proffieboard

Sketch (code) compile error in Arduino IDE

ndash Check if your _configh file is correct Blade Styles Presets const unsigned int maxLedsPerStrip = 144 if BladeConfig blades[] = is correct

Sketch (code) compile error in Arduino IDE

ndash If nothing helps install Arduino IDE version 186 and try to compile and upload the firmware again

Sound doesnrsquot play

ndash Remove SD card and insert again check speaker wiring Make sure all sound files on SD card are correctly named (8 characters max long)

Re-format SD card in FAT32 load sound files and try again try another SD card

Board says ldquoLOW POWERrdquo

ndash Charge the battery

Serial Monitor shows info sent by the board but your commands donrsquot work

ndash In the bottom right corner of Serial Monitor window make sure the Line Ending drop down is set to New Line

Sound is weird and distorted

ndash Check your SD card speed (see page 44) Check speaker wiring try another good speaker

20 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

2TEENSYSABER V3 INSTRUCTIONS

WIRING DIAGRAMS1

How to use it

Blade ignitionretraction ndash assuming you have at least one button pressing it briefly should turn the saber on or off If you have an AUX button pressing it briefly should also turn the saber on and off If you have no buttons you can turn the saber on and off by twisting your wrist back and forth Note that the motion has to be done long enough to count so a very quick flick of the wrist will not workTurn On muted ndash double-click power buttonNext preset ndash while saber is off click the AUX buttonPrevious preset ndash hold AUX button and click the Activation buttonTrigger Clash ndash while saber is on hit the bladeTrigger Lockup ndash while saber is on hold Activation button then trigger a clash Lockup releases when you let go of the Acti-vation buttonTrigger Drag ndash like lockup but point saber mostly down before holding Activation buttonTrigger Force ndash long-click AUX buttonStart soundtrack ndash long-click the Activation buttonTrigger Blaster Block ndash while saber is on short-click AUX button

Serial Monitor commands

battery_voltage ndash gets current battery voltage valueget_volume ndash get current volume valuepow ndash power OnOff the saberon ndash power On the saberoff ndash power Off the saberset_volume lt0-3000gt ndash set volume value (example set_volume 500)play ndash play the default preset trackplay trackslttrack namegt ndash play a specific track from tracks folder (example play tracksvenuswav)stop ndash stop the playing trackforce ndash play ldquoforcerdquo sound effectsdrag ndash play ldquodragrdquo sound effectsblast ndash play ldquoblasterrdquo sound effectslock ndash play ldquolockuprdquo sound effectsclash ndash play ldquoclashrdquo sound effectsreset ndash reboot the boardn ndash switch to next presetp ndash switch to previous presetlist_presets ndash show all presetssdtest ndash test SD card speed

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 21

2TEENSYSABER V3 INSTRUCTIONS

FIRMWARE UPLOAD AND UPDATE2

Software installation and setup

To upload firmware to TeensySaber board Arduino IDE program is required Follow these steps to install it to your PC

1 Install latest Arduino IDE software (donrsquot use BETA)

Installing as Windows app also is not recommended

because it will be installed in a specific protected folder that

wonrsquot allow you to install Teensyduino software in it

If TeensySaber wonrsquot show up in COM port use

Arduino IDE 186 version

2 Install latest Teensyduino software in same directory

usually itrsquos CProgram Files (x86)Arduino on Windows

Follow installation instructions for your system

3 Select Teensy 32 31 in Tools -gt Board

USB Type ndash Serial CPU Speed ndash 96 MHz (overclock) Optimize ndash Smallest Code Port ndash COM(the number your PC assigned) (Teensy 32) Serial

Connect TeensySaber via USB cable to PC to be able to select

the Port donrsquot forget to connect battery first

22 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

1 Download the TeensySaber firmware and SD card content

Unzip lightsaber-1286zip to your Documents directory or to

Desktop but not to Arduino program folder or anywhere in

Programs directory where all programs are installed You will

see a lightsaber folder and files inside it Donrsquot move any of

these files to any other location outside the lightsaber folder

and donrsquot reorganize them Unzip ProffieOS_SD_Cardzip to the

folder where you keep lightsaber-1286 folder Copy all files

from ProffieOS_SD_Card folder to your SD card

2 Unhide file extensions in File Explorer settings to see h ending

of config files Donrsquot add ldquohrdquo to the config file name

Go to config folder and create you own configh file (see page

23 for how-to)

Double-click the lightsaberino file

3 Add the name of your configh file as shown and Save this

lightsaberino file Make sure the other config files are

commented out there should be only one CONFIG_FILE

without You can have multiple config files

in lightsabergtconfig folder and just define the one you need

in lightsaberino file and upload it again to TeensySaber board

4 Connect battery to TeensySaber board and hook up to your PC

with a data transfer micro-USB-to-USB cable

Press arrow button it will compile and upload firmware to the

board Wait for your PC to make a sound or TeensySaber will

play boot sound if speaker is connected Now you can unplug

the USB cable Done

If it gives an error instead this means your configh file has

issues define CONFIG_FILE name has mistakes configh file

is out of config folder your PC user name is non-latin

2TEENSYSABER V3 INSTRUCTIONS

FIRMWARE UPLOAD AND UPDATE2

Uploading firmware

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 23

2TEENSYSABER V3 INSTRUCTIONS

CHANGING PARAMETERS3

Changing sound board parameters

All sound files (sound fonts music tracks) are stored on the micro SD card Add required sound fonts folders (Plecter NEC and Smoothswing

fonts are supported no need to change WAV files names just copy and paste) to SD card root directory as itrsquos done in the default

ProffieOS_SD_Card content folder and music tracks to the tracks folder

Make sure to name all music tracks and sound fonts folders with latin characters and only up to 8 characters long without using any special

characters (like |[- etc)

Make sure you have a configini file in each sound font folder if there is none - copy one from some default TeensySaberProffieBoard sound

font and paste into newly added sound font folder It has only one parameter that you can modify - humstart It helps to match hum sound

start with blade ignition 1000 usually works fine

All blade effects LED configuration volume level clash sensitivity etc are changed in the configh file located in lightsabergtconfig folder

To do that open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text Editor (Notepad - to see code correctly in Notepad

Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all text) and Delete it then Copy-and-Paste (Ctrl+C

Ctrl+V) your wiring diagram config code into empty _configh file and Save it under new name Follow the instructions on page 22 to

upload it to the board

TeensySaber V3 config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)

volume level (0-3000)

clash sensitivity (adjust lower or higher with 01 step)

sound font folder nametrack name

Preset name

Blade style

LED configuration (use these XP-E2 LED templatesto define your LED)

for Red use 1 Ohm resistor for Green - no resistor for Blue use 024 Ohm

NoLED ndash no 4th led used

Preset 1

24 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

31

PROFFIEBOARD INSTRUCTIONS

Whatrsquos needed

ndash ProffieBoard

ndash micro SD-card (see page 44 for recommendations)

ndash a USB micro SD-card reader (to load sound files from PC to micro SD card)

ndash micro USB data transfer cable (CABLES THAT SUPPORT ONLY CHARGING WONrsquoT WORK)

ndash wires of different gauges (32-20 AWG) (PTFE coated copper stranded wires recommended) heat shrink

ndash ESD safe soldering station solder wire flux etc

ndash pliers helping hands etc

ndash isopropyl alcohol to clean pads before soldering (helps solder to stick better)

ndash Digital Multimeter (VERY USEFUL)

ndash computer running Windows Linux or Mac OS with internet access

ndash 37V Li-Ion Protected rechargeable battery switches recharge port speaker LEDs resistors chassis etc

ndash Smart Li-Ion CC-CV (Constant Current - Constant Voltage mode) battery charger for 37V (42V) cells

ndash patience

WIRING DIAGRAMS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 25

31

PROFFIEBOARD INSTRUCTIONS

Board pinout

Battery + ndash 26 to 45 volt input drives everything except the LEDs

Battery - ndash negative pad for LEDs needs to be at same level as GND when both are connected Both pads are internally connected

GND ndash ground for electronics except LEDs Note that there are two GND pads on the board that are internally connected

Speaker +- ndash hooks up to speaker

Activation (1) Aux (2) Aux2 button (3) ndash hook up to closing buttons or potentially touch buttons

Blade ID Neopixel Data 1 ndash normally used to measure the blade ID restor and if itrsquos a neopixel blade feed out neopixel data

Data 2 3 4 5 ndash additional neopixel data outputs or free for other purposes

LED 1 2 3 4 5 6 ndash hooks up to negative side of LED (positive side of LED hooks up directly to battery) These pads can handle

up to 30 volts

SDA SCL ndash these pins are used to wire OLED display or to communicate with the gyro and accelerometer chip

RX TX ndash these pins are used for wiring a bluetooth module for wireless control

SWDCLK SWDIO ndash can be hooked up to a ST-LINK device and lets you debug programs running on the ProffieBoard

+5V ndash generated by the ProffieBoard normally itrsquos only ON when sound is playing

+33V ndash generated by the ProffieBoard for powering OLED display Bluetooth module or some accent leds

BOOT RESET ndash buttons to put the ProffieBoard in bootloader mode if uploading doesnrsquot work

micro USB port ndash micro USB port used only for firmware upload and can be used for sound files upload to SD card (from firmware version

1291 and up) THIS PORT ISNrsquoT USED FOR CHARGING THE BATTERY

LED 4LED 3

LED 2

LED 1

LED 5

LED 6

RESETBOOT

Battery - Battery -

Speaker + (red dot or ldquo+rdquo mark on speaker)

Battery +

Aux button (2)Activation button (1)

Aux2 button (3)

Blade ID Neopixel Data 1

Data 5

Data 4Data 3Data 2

+33V

SWDIO

SWDCLK

+5V

TXRX

GND

GND

Reset

Speaker -

SCLSDA

micro USB port

WIRING DIAGRAMS

26 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Basic Tri-Cree wiring diagram(In-hilt LED)

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

+

+

-

-

26 AWG

26 A

WG

30-32 AWG

28-30 AWG

28-3

0 A

WG

30-32 AWG

Protected 36-37V (42V max at full charge) 10A 3500mAh battery recommended+18650 battery holder (optional)Keystone 1042P

AV switch with accent led(constantly ON no effects)

accent leds run mostly at10-15mA so resistors for them must be calculated accordingly

Main RGB led

additional RGB leds(optional)

In case no additional high power leds are needed LED channels 4 5 6 can be used for 3 controllable(programmable for different effects) accent leds So AV switch led can be wired to one of these channelsAccent leds also can be wired to Data pads 1-5 please see ldquoAccent LEDs wiring and setuprdquo page

LED Resistor Calculator

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 27

3WIRING DIAGRAMS1

Basic Tri-Cree wiring (In-hilt LED)ldquoconfighrdquo file setup

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

Use a given or build your wiring diagram on THIS PAGE then open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text

Editor (Notepad - to see code correctly in Notepad Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all

text) and Delete it then Copy-and-Paste (Ctrl+C Ctrl+V) your wiring diagram config code (example below) into empty _configh file and

Save it under new name Follow the instructions on page 22 to upload it to the board

ldquoproffieboard_v1_confighrdquoNUM_BLADES 2NUM_BUTTONS 2VOLUME 1000CLASH_THRESHOLD_G 10StyleNormalPtrltCYAN WHITE 300 800gt()StyleNormalPtrltCYAN WHITE 300 800gt()

CreeXPE2RedTemplatelt1000gtCreeXPE2GreenTemplatelt0gtCreeXPE2BlueTemplatelt240gtNoLED

ProffieBoard config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)Volume level (0-3000)Clash sensitivity (adjust lower or higher with 01 step)ldquoBlade 1rdquo styleldquoBlade 2rdquo style (in case only 1 blade is used you donrsquot need this line)LED configuration (use these XP-E2 LED templatesto define your LED If other LED resistors are used change these values to match Ohm1000=ltvaluegt)

where 1000 is 1 Ohm resistor 0 is no resistor240 is 024 Ohm resistorNoLED ndash no 4th led used

Preset 1

LED 1 configuration

LED 2 configuration

Preset 2 etc

PROFFIEBOARD INSTRUCTIONS

28 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Basic Neopixel wiring diagram

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

+

+

-

-

22 A

WG

22 AWG

x2 28 AWG

x2 26 AWG

22 A

WG

30-32 AWG30-32 AWG

Protected 36-37V (42V max at full charge) 10A 3500mAh or 15A 3120mAhbattery recommended+18650 battery holder (optional)Keystone 1042P

AV switch with accent led(constantly ON no effects)

accent leds run mostly at10-15mA so resistors for them must be calculated accordingly

Main Neopixel strip

additional Neopixelstrips(optional)

Neopixel bladeconnector

330 Ohm on the Blade pcb side

x3 28 AWGor x1 22 AWGfor Negative

330 Ohm on the Blade pcb side

arrows up

330 Ohm on the Blade pcb side

In case no additional Neopixel strips are needed LED channels 4 5 6 can be used for 3 controllable(programmable for different effects) accent leds So AV switch led can be wired to one of these channelsAccent leds also can be wired to Data pads 2-5 please see ldquoAccent LEDs wiring and setuprdquo page

Recommended power wire gauges (22 AWG) are given for 2-strip blade For 3-strip blade you gonna need at least 20 AWG wires

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 29

ldquoproffieboard_v1_confighrdquo

3WIRING DIAGRAMS1

Basic Neopixel wiringldquoconfighrdquo file setup

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

NUM_BLADES 3NUM_BUTTONS 2VOLUME 1000CLASH_THRESHOLD_G 10IgnitionDelaylt0 any blade stylegtIgnitionDelaylt800 any blade stylegtIgnitionDelaylt800 any blade stylegtWS2811BladePtrlt118 WS2811 800kHz | WS2811 GRBgt()WS2811BladePtrlt26 blade2Pin ltbladePowerPin4gtgt()WS2811BladePtrlt26 blade3Pin ltbladePowerPin5gtgt()

ProffieBoard config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)Volume level (0-3000)Clash sensitivity (adjust lower or higher with 01 step)ldquoBlade 1rdquo style (main blade with IgnitionDelay 0)ldquoBlade 2rdquo style (CG blade 1 with IgnitionDelay 800)ldquoBlade 3rdquo style (CG blade 2 with IgnitionDelay 800)

strip configuration (defines how many pixels it has and to which LED output and pin is wired)

Preset 1

any blade style

strip (blade) 1 configuration

adjust this number to match your strips leds count

strip (blade) 2 configuration

strip (blade) 3 configuration

Preset 2 etc

Use a given or build your wiring diagram on THIS PAGE then open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text

Editor (Notepad - to see code correctly in Notepad Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all

text) and Delete it then Copy-and-Paste (Ctrl+C Ctrl+V) your wiring diagram config code (example below) into empty _configh file and

Save it under new name Follow the instructions on page 22 to upload it to the board

PROFFIEBOARD INSTRUCTIONS

30 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Basic Segmented string wiring diagram

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

+

+

-

-

24 A

WG

28 AWG

30-32 AWG30-32 AWG

Protected 36-37V (42V max at full charge) 10A 3500mAh battery recommended+18650 battery holder (optional)Keystone 1042P

AV switch with accent led(constantly ON no effects)

accent leds run mostly at10-15mA so resistors for them must be calculated accordingly

6-segments string blade

FoC string

N-channel FET3A minimum

123456

Calculate resistors for each led segment of the blade string depending on which leds are used 5mm leds have max drive current around 25mA per led when 10mm leds can be 100mA and 200mA per ledSo pay attention to your led max current and Forward Voltage (Vf) when calculating a segment resistor resistence as well as its wattage Also choose wire gauges accordingly to meet segments and total blade max current draw level

LED Resistor Calculator

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 31

ldquoproffieboard_v1_confighrdquo

3WIRING DIAGRAMS1

Basic Segmented string wiringldquoconfighrdquo file setup

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

NUM_BLADES 1NUM_BUTTONS 2VOLUME 1000CLASH_THRESHOLD_G 10StyleNormalPtrltCYAN WHITE 300 800gt()ltBlue3mmLED BladePin White3mmLEDgt

ProffieBoard config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)Volume level (0-3000)Clash sensitivity (adjust lower or higher with 01 step)Blade styleLED string configuration(here you mention the color and type of leds usedin the main blade string segments and FoC stringBladePin is the FoC signal pin (Blade ID pin))

Preset

LED string configuration

Use a given or build your wiring diagram on THIS PAGE then open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text

Editor (Notepad - to see code correctly in Notepad Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all

text) and Delete it then Copy-and-Paste (Ctrl+C Ctrl+V) your wiring diagram config code (example below) into empty _configh file and

Save it under new name Follow the instructions on page 22 to upload it to the board

PROFFIEBOARD INSTRUCTIONS

32 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Accent LEDs wiring diagram(optional)

Accent LEDs work with ProffieBoard as additional ldquobladesrdquo when powered by LED outputs 4 5 6 or Data pads 1 2 3 5 as PWM So they can

have any effect that blade can have If no effects needed accent led can be powered just by a 33V output pad (power-on led indication)

30-32 AWG

with Neopixel blade setup these 4 outputsdonrsquot work for regular accent leds

Recommended resistors to use for accent leds at 33V power source and 15mA drive

ndash 100 Ohm for Red (lt100000gt value in the code)ndash 13 Ohm for Green (lt13000gt value in the code)ndash 13 Ohm for Blue (lt13000gt value in the code)ndash 100 Ohm for Yellow (lt100000gt value in the code)ndash 20 Ohm for White (lt20000gt value in the code)

RGB ledcommon-anode

8 ldquobladesrdquo1 main and 7 accent leds

main blade style (effects) main blade style (effects)

7 accent leds style (effects)accent led style (effects)

7 accent leds configurations

RGB accent led configuration

2 ldquobladesrdquo1 main and 1 RGB accent led

ldquoPower-onrdquo indicationaccent leds (no effects)

7 accent leds withindependent effects

RGB accent led

a) b)

b)

c)

c)

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 33

3WIRING DIAGRAMS1

Neopixel Accent LEDs wiring diagram(optional)

With Neopixel setup additional neopixel leds or arrays can be used as accent leds There are 2 ways to wire them using additional Data

pins 2 3 4 5 or ldquoSub-bladesrdquo wiring with just 1 Data output pin Same way Neopixel connectors with on-board leds ca be wired

Option 1 ndash with extra Data pins

Main Blade

some accent leds

D1

D2

crystal leds

330 Ohm

330 Ohm

330 Ohm

main blade style (effects)

main blade 144 leds Data pin 1

accent leds blade style (effects)

accent leds ldquobladerdquo 4 leds Data pin 2

crystal leds blade style (effects)

crystal leds ldquobladerdquo 2 leds Data pin 3

3 ldquobladesrdquo1 main 1 accent leds array and 1 crystal leds array

PROFFIEBOARD INSTRUCTIONS

D3

follow arrows direction

34 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Neopixel Accent LEDs wiring diagram(optional)

PROFFIEBOARD INSTRUCTIONS

Main Blade

some accent leds

1

3

5678

2

4

D1

crystal leds

follow arrows direction

330 Ohm

330 OhmData signal

With this setup a single array of neopixel leds is separated into a couple of sub-blades with their own style configuration and behaviour This

is really usefull when you want to use only one data pin More about ldquoSub-bladesrdquo on ProffieOS wiki page

Option 2 ndash with ldquoSub-bladesrdquo

main blade style (effects)

main blade sub-blade 140 leds (7-146) but from 6 to 145 in the code

accent leds blade style (effects)

accent leds sub-blade 4 leds (1-4) but from 0 to 3 in the code

crystal leds blade style (effects)

146 leds total used

crystal leds sub-blade 2 leds (5-6) but from 4 to 5 in the code

update default 144 to a higher total value if you get all accent leds +Main blade gt 144 Example update to 146 if you have 2 crystal leds +4 accent leds + 140 Main blade leds = 146

3 ldquobladesrdquo 1 main 1 accent leds array and 1 crystal leds array

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 35

3WIRING DIAGRAMS1

OLED display wiring diagram(optional)

SSD1306 128x32 pixels OLED display allows to show battery level current preset name play different animations and even simple games It

can be wired to any blade configuration and requires just one additional line in the code to work You can get monochrome display in white

or blue color

SSD1306128x32OLED

SSD1306 ndash with blue or white display color selectSSD1306 ndash cheaper priceSSD1306 just screen ndash blue or white select

30-32 AWG

30-32 AWG

add this line to enable OLED display

display shows a preset name written in these quotes ldquoldquo

PROFFIEBOARD INSTRUCTIONS

36 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Bluetooth module wiring diagram(optional)

SOON

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 37

3WIRING DIAGRAMS1

Blade ID resistor functions(optional)

SOON

PROFFIEBOARD INSTRUCTIONS

38 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

website ProffieBoard FULL wiring diagrams link

Scroll the page down till you see the interactive diagram Above the diagram there are components selection options Build your saber setup

with it and follow diagram to wire your board Then you need to copy the configuration code below and paste it into your _configh file

Choose components you want

3WIRING DIAGRAMS1

More wiring diagrams

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 39

3WIRING DIAGRAMS1

How to use it

PROFFIEBOARD INSTRUCTIONS

Blade ignitionretraction ndash assuming you have at least one button pressing it briefly should turn the saber on or off If you have an AUX button pressing it briefly should also turn the saber on and off If you have no buttons you can turn the saber on and off by twisting your wrist back and forth Note that the motion has to be done long enough to count so a very quick flick of the wrist will not workTurn On muted ndash double-click power buttonNext preset ndash while saber is off click the AUX buttonPrevious preset ndash hold AUX button and click the Activation buttonTrigger Clash ndash while saber is on hit the bladeTrigger Lockup ndash while saber is on hold Activation button then trigger a clash Lockup releases when you let go of the Acti-vation buttonTrigger Drag ndash like lockup but point saber mostly down before holding Activation buttonTrigger Force ndash long-click AUX buttonStart soundtrack ndash long-click the Activation buttonTrigger Blaster Block ndash while saber is on short-click AUX button

Serial Monitor commands

battery_voltage ndash gets current battery voltage valueget_volume ndash get current volume valuepow ndash power OnOff the saberon ndash power On the saberoff ndash power Off the saberset_volume lt0-3000gt ndash set volume value (example set_volume 500)play ndash play the default preset trackplay trackslttrack namegt ndash play a specific track from tracks folder (example play tracksvenuswav)stop ndash stop the playing trackforce ndash play ldquoforcerdquo sound effectsdrag ndash play ldquodragrdquo sound effectsblast ndash play ldquoblasterrdquo sound effectslock ndash play ldquolockuprdquo sound effectsclash ndash play ldquoclashrdquo sound effectsreset ndash reboot the boardn ndash switch to next presetp ndash switch to previous presetlist_presets ndash show all presetssdtest ndash test SD card speed

40 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3FIRMWARE UPLOAD AND UPDATE2

Software installation and setup

PROFFIEBOARD INSTRUCTIONS

To upload firmware to ProffieBoard Arduino IDE program is required Follow these steps to install it to your PC

1 Install latest Arduino IDE software (donrsquot use BETA)

Installing as Windows app also is not recommended

because it will be installed in a specific protected folder that

wonrsquot allow you to install any additional softwareplugin in it

If ProffieBoard wonrsquot show up in COM port use

Arduino IDE 186 version

2 Install the Proffieboard Arduino Plugin and Zadig software

Follow installation instructions

3 Select Proffieboard-STM32L433 in Tools -gt Board

USB Type ndash Serial CPU Speed ndash 80 MHz Optimize ndash Smallest Code DOSFS ndash SDCARD (SPI) Port ndash COM(the number your PC assigned) (Butterfly-L433CC)

Connect Proffieboard via USB cable to PC to be able to select

the Port

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 41

3FIRMWARE UPLOAD AND UPDATE2

Uploading firmware

PROFFIEBOARD INSTRUCTIONS

1 Download the ProffieBoard firmware and SD card content

Unzip lightsaber-1286zip to your Documents directory or to

Desktop but not to Arduino program folder or anywhere in

Programs directory where all programs are installed You will

see a lightsaber folder and files inside it Donrsquot move any of

these files to any other location outside the lightsaber folder

and donrsquot reorganize them Unzip ProffieOS_SD_Cardzip to the

folder where you keep lightsaber-1286 folder Copy all files

from ProffieOS_SD_Card folder to your SD card

2 Unhide file extensions in File Explorer settings to see h ending

of config files Donrsquot add ldquohrdquo to the config file name Go to config folder and create you own configh file (see page

42 for how-to)

Double-click the lightsaberino file

3 Add the name of your configh file as shown and Save this

lightsaberino file Make sure the other config files are

commented out there should be only one CONFIG_FILE

without You can have multiple config files

in lightsabergtconfig folder and just define the one you need

in lightsaberino file and upload it again to ProffieBoard

4 Connect battery to ProffieBoard and hook up to your PC

with a data transfer micro-USB-to-USB cable

Press arrow button it will compile and upload firmware to the

board Wait for red text progress bars to stop at 100

ProffieBoard will play boot sound if speaker is connected

Now you can unplug the USB cable Done

If it gives an error instead this means your configh file has

issues define CONFIG_FILE name has mistakes configh file

is out of config folder your PC user name is non-latin

42 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

33

configh file structure editing

PROFFIEBOARD INSTRUCTIONS

CHANGING PARAMETERS

All sound files (sound fonts music tracks) are stored on the micro SD card Add required sound fonts folders (Plecter NEC and Smoothswing

fonts are supported no need to change WAV files names just copy and paste) to SD card root directory as itrsquos done in the default

ProffieOS_SD_Card content folder and music tracks to the tracks folder

Make sure to name all music tracks and sound fonts folders with latin characters and only up to 8 characters long without using any special

characters (like |[- etc)

Make sure you have a configini file in each sound font folder if there is none - copy one from some default TeensySaberProffieBoard sound

font and paste into newly added sound font folder It has only one parameter that you can modify - humstart It helps to match hum sound

start with blade ignition 1000 usually works fine

All blade effects LED configuration volume level clash sensitivity etc are changed in the configh file located in lightsabergtconfig folder

To do that open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text Editor (Notepad - to see code correctly in Notepad

Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all text) and Delete it then Copy-and-Paste (Ctrl+C

Ctrl+V) your wiring diagram config code into empty _configh file and Save it under new name Follow the instructions on page 39 to

upload it to the board

Proffieboard config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)

volume level (0-3000)

clash sensitivity (adjust lower or higher with 01 step)

sound font folder nametrack name

Preset name

Blade style

LED configuration (use these XP-E2 LED templatesto define your LED)

for Red use 1 Ohm resistor for Green - no resistor for Blue use 024 Ohm

NoLED ndash no 4th led used

Preset 1

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 43

33

Blade Styles

StylePtrltInOutHelperltSimpleClashltLockupltBlastltOnSparkltAudioFlickerltRgblt02550gtRgblt501000gtgtRgblt2552550gt150gtRgblt255500gtgtAudioFlickerltRgblt1002550gtRgblt2550150gtgtgtRgblt255100150gt40gt200300Blackgtgt

ndash this is how the Blade Style code looks pasted in the configh file Preset (it sits inside a StylePtrltgt container)

ndash this is how the Blade Style code looks when editing it inside a Blade Style Editor

Each Blade Style is made of a variety of Effects each added effect goes instead of a base color in the previous effect

PROFFIEBOARD INSTRUCTIONS

CHANGING PARAMETERS

ProffieBoard and TeensySaber use Blade Styles for the main saber blade and any other accent leds to define all light effects (color changing

flashes flickering delays ignitionretraction timing etc)

Use Blade Style Editor to create and adjust Blade Styles Megtooth Sith Sabers did a great video tutorial where he shows and explains

how to use Blade Style Editor Also you can grab some pre-made Blade Styles or share yours here on TRA forums

A Blade Style example of simple flickering Green blade with Spark on start Clash Blaster Lockup and Drag IgnitionRetraction effects

InOutHelperltSimpleClashltLockupltBlastltOnSparkltAudioFlickerltRgblt02550gtRgblt501000gtgtRgblt2552550gt150gtRgblt255500gtgtAudioFlickerltRgblt1002550gtRgblt2550150gtgtgtRgblt255100150gt40gt200300Blackgt

InOutHelperltbase color200300Blackgt ndash base color can be defined by words (WHITE RED GREEN PURPLE etc) or by Rgblt0-2550-2550-255gt values for more

custom shades 200 is extension length in milliseconds 300 is retraction length in milliseconds Black is color when retracted (also can be any other color)

SimpleClashltbase colorclash color40gt ndash clash effect 40 is clash duration in milliseconds

Lockupltbase colorlockup colorgt ndash lockup effect

Blastltbase colorblast colorgt ndash blaster effect

OnSparkltbase colorspark color150gt ndash spark on ignition effect 150 is spark duration in milliseconds

AudioFlickerltrdquoArdquo colorrdquoBrdquo colorgt ndash flickering effect (blade flickers to the actual saber hum sound) the more difference between ldquoArdquo and ldquoBrdquo colors - the more

abrupt is flickering

Rgblt255500gt ndash actual color in RGB format (0 is no light 255 is the maximum brightness value for Red Green or Blue channel)

44 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

ndash SanDisk 4GB microSDHC Class 4 (Genuine) ndash SanDisk 4GB microSDHC Class 4 (Genuine)

130238 kbs = 1477 simultaneous audio streams 137812 kbs = 1562 simultaneous audio streams

ndash Patriot LX Series 16GB microSDHC UHS-IU1 Class 10 ndash Patriot LX Series 16GB microSDHC UHS-IU1 Class 10

133005 kbs = 1508 simultaneous audio streams

ndash GSkill 16GB microSDHC UHS-IU1 Class 10 ndash GSkill 16GB microSDHC UHS-IU1 Class 10

129534 kbs = 1469 simultaneous audio streams

ndash Kingston 16GB microSDHC UHS-IU1 Class 10 ndash Kingston 16GB microSDHC UHS-IU1 Class 10

128090 kbs = 1452 simultaneous audio streams

ndash SanDisk Ultra 16GB microSDHC UHS-IU1 A1 Class 10 ndash SanDisk Ultra 16GB microSDHC UHS-IU1 A1 Class 10

102663 kbs = 1164 simultaneous audio streams 11124 kbs = 1261 simultaneous audio streams

ndash SanDisk 8GB microSDHC Class 4 ndash SanDisk 8GB microSDHC Class 4

108506 kbs = 1230 simultaneous audio streams

ndash SanDisk 16GB microSDHC Class 4 ndash SanDisk 16GB microSDHC Class 4

102663 kbs = 1164 simultaneous audio streams 106957 kbs = 1213 simultaneous audio streams

ndash SanDisk Ultra 16GB microSDHC UHS-IU1 Class 10 ndash SanDisk Ultra 16GB microSDHC UHS-IU1 Class 10

102663 kbs = 1164 simultaneous audio streams 103909 kbs = 1178 simultaneous audio streams

ndash Smartbuy 4GB microSDHC Class 4 ndash Smartbuy 4GB microSDHC Class 4

75437 kbs = 855 simultaneous audio streams

ndash Kingston 8GB microSDHC Class 4 ndash Kingston 8GB microSDHC Class 4

75209 kbs = 822 simultaneous audio streams

ndash SanDisk 4GB microSDHC Class 4 (Fake) ndash SanDisk 4GB microSDHC Class 4 (Fake)

677 kbs = 769 simultaneous audio streams

Here is a list of tested micro SD cards speed with TeensySaber V3 and ProffieBoard Any card with speed over 900 kbs is recommended the

higher the speed is ndash the better Memory size of 4-16Gb is more than enough Cards were tested with a default firmware (1291) compiled

with ldquoSmallest Coderdquo under Optimize ldquodefault_proffieboard_confighrdquo file and default ProffieOS SD card sound files (7 folders)

To test your SD card speed simply hook up ProffieBoard to PC open Arduino IDE go to Tools and open Serial Monitor make sure you have

New Line and 9600 baud rate selected on the bottom of Serial Monitor window type and send sdtest command wait for the test result

4Recommended micro SD cards

BEST

TEENSYSABER PROFFIEBOARD

GOOD

BAD

PROFFIEBOARD INSTRUCTIONS

SD CARD RECOMMENDATIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 45

There are a lot of fake (chinese copies) microSD cards on the market from aliexpress ebay amazon etc They look very similar to genuine

cards but are a bit different though and have a twice lower writingreading speed Here is an example of a SanDisk 4Gb Class 4 card one is

genuine with 137812 kbs speed and the other one is fake with 677 kbs speed I got from ebay seller

Be carefull and pay attention to how the actual card looks if you are not sure ask seller for the real photo of SD card he sells

4Genuine and Fake SanDisk 4Gb Class 4 microSD

PROFFIEBOARD INSTRUCTIONS

SD CARD RECOMMENDATIONS

46 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

WIRE GAUGE GUIDE

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 47

RECHARGE PORTS AND KILL SWITCHES

48 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

NEOPIXEL STRIPS CURRENT DRAW

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 49

6TROUBLESHOOTING

For more help please check these linksProffieOSProffieBoardTeensySaber wiki on GitHubAsk your question on The Rebel Armory forumsAsk your question on FX-sabers forumsAsk your question in facebook group

How to solve most common issues

Quick troubleshooting tips

TeensySaber board or Proffieboard is not recognized by computer (nothing under Port selection in Arduino)

ndash Make sure a charged 37V battery is connected to the board micro-USB cable is a data transfer cable all plugins and drivers are installed ndash

check again pages 21 for TeensySaber or 40 for Proffieboard Try a different USB port on your computer

Sketch (code) compile error in Arduino IDE

ndash Check your define CONFIG_FILE ldquoconfig_confighrdquo line in opened lightsaberino file if itrsquos written correctly with config in it

Sketch (code) compile error in Arduino IDE

ndash Check if the _configh file you defined in the lightsaberino sketch file is same name as in the lightsaber-rdquofirmware versionrdquolightsaber

config folder and is located in this folder

Sketch (code) compile error in Arduino IDE

ndash Check your settings under Tools tab in Arduino IDE program Check again pages 21 for TeensySaber or 40 for Proffieboard

Sketch (code) compile error in Arduino IDE

ndash Check if your _configh file is correct Blade Styles Presets const unsigned int maxLedsPerStrip = 144 if BladeConfig blades[] = is correct

Sketch (code) compile error in Arduino IDE

ndash If nothing helps install Arduino IDE version 186 and try to compile and upload the firmware again

Sound doesnrsquot play

ndash Remove SD card and insert again check speaker wiring Make sure all sound files on SD card are correctly named (8 characters max long)

Re-format SD card in FAT32 load sound files and try again try another SD card

Board says ldquoLOW POWERrdquo

ndash Charge the battery

Serial Monitor shows info sent by the board but your commands donrsquot work

ndash In the bottom right corner of Serial Monitor window make sure the Line Ending drop down is set to New Line

Sound is weird and distorted

ndash Check your SD card speed (see page 44) Check speaker wiring try another good speaker

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 21

2TEENSYSABER V3 INSTRUCTIONS

FIRMWARE UPLOAD AND UPDATE2

Software installation and setup

To upload firmware to TeensySaber board Arduino IDE program is required Follow these steps to install it to your PC

1 Install latest Arduino IDE software (donrsquot use BETA)

Installing as Windows app also is not recommended

because it will be installed in a specific protected folder that

wonrsquot allow you to install Teensyduino software in it

If TeensySaber wonrsquot show up in COM port use

Arduino IDE 186 version

2 Install latest Teensyduino software in same directory

usually itrsquos CProgram Files (x86)Arduino on Windows

Follow installation instructions for your system

3 Select Teensy 32 31 in Tools -gt Board

USB Type ndash Serial CPU Speed ndash 96 MHz (overclock) Optimize ndash Smallest Code Port ndash COM(the number your PC assigned) (Teensy 32) Serial

Connect TeensySaber via USB cable to PC to be able to select

the Port donrsquot forget to connect battery first

22 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

1 Download the TeensySaber firmware and SD card content

Unzip lightsaber-1286zip to your Documents directory or to

Desktop but not to Arduino program folder or anywhere in

Programs directory where all programs are installed You will

see a lightsaber folder and files inside it Donrsquot move any of

these files to any other location outside the lightsaber folder

and donrsquot reorganize them Unzip ProffieOS_SD_Cardzip to the

folder where you keep lightsaber-1286 folder Copy all files

from ProffieOS_SD_Card folder to your SD card

2 Unhide file extensions in File Explorer settings to see h ending

of config files Donrsquot add ldquohrdquo to the config file name

Go to config folder and create you own configh file (see page

23 for how-to)

Double-click the lightsaberino file

3 Add the name of your configh file as shown and Save this

lightsaberino file Make sure the other config files are

commented out there should be only one CONFIG_FILE

without You can have multiple config files

in lightsabergtconfig folder and just define the one you need

in lightsaberino file and upload it again to TeensySaber board

4 Connect battery to TeensySaber board and hook up to your PC

with a data transfer micro-USB-to-USB cable

Press arrow button it will compile and upload firmware to the

board Wait for your PC to make a sound or TeensySaber will

play boot sound if speaker is connected Now you can unplug

the USB cable Done

If it gives an error instead this means your configh file has

issues define CONFIG_FILE name has mistakes configh file

is out of config folder your PC user name is non-latin

2TEENSYSABER V3 INSTRUCTIONS

FIRMWARE UPLOAD AND UPDATE2

Uploading firmware

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 23

2TEENSYSABER V3 INSTRUCTIONS

CHANGING PARAMETERS3

Changing sound board parameters

All sound files (sound fonts music tracks) are stored on the micro SD card Add required sound fonts folders (Plecter NEC and Smoothswing

fonts are supported no need to change WAV files names just copy and paste) to SD card root directory as itrsquos done in the default

ProffieOS_SD_Card content folder and music tracks to the tracks folder

Make sure to name all music tracks and sound fonts folders with latin characters and only up to 8 characters long without using any special

characters (like |[- etc)

Make sure you have a configini file in each sound font folder if there is none - copy one from some default TeensySaberProffieBoard sound

font and paste into newly added sound font folder It has only one parameter that you can modify - humstart It helps to match hum sound

start with blade ignition 1000 usually works fine

All blade effects LED configuration volume level clash sensitivity etc are changed in the configh file located in lightsabergtconfig folder

To do that open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text Editor (Notepad - to see code correctly in Notepad

Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all text) and Delete it then Copy-and-Paste (Ctrl+C

Ctrl+V) your wiring diagram config code into empty _configh file and Save it under new name Follow the instructions on page 22 to

upload it to the board

TeensySaber V3 config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)

volume level (0-3000)

clash sensitivity (adjust lower or higher with 01 step)

sound font folder nametrack name

Preset name

Blade style

LED configuration (use these XP-E2 LED templatesto define your LED)

for Red use 1 Ohm resistor for Green - no resistor for Blue use 024 Ohm

NoLED ndash no 4th led used

Preset 1

24 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

31

PROFFIEBOARD INSTRUCTIONS

Whatrsquos needed

ndash ProffieBoard

ndash micro SD-card (see page 44 for recommendations)

ndash a USB micro SD-card reader (to load sound files from PC to micro SD card)

ndash micro USB data transfer cable (CABLES THAT SUPPORT ONLY CHARGING WONrsquoT WORK)

ndash wires of different gauges (32-20 AWG) (PTFE coated copper stranded wires recommended) heat shrink

ndash ESD safe soldering station solder wire flux etc

ndash pliers helping hands etc

ndash isopropyl alcohol to clean pads before soldering (helps solder to stick better)

ndash Digital Multimeter (VERY USEFUL)

ndash computer running Windows Linux or Mac OS with internet access

ndash 37V Li-Ion Protected rechargeable battery switches recharge port speaker LEDs resistors chassis etc

ndash Smart Li-Ion CC-CV (Constant Current - Constant Voltage mode) battery charger for 37V (42V) cells

ndash patience

WIRING DIAGRAMS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 25

31

PROFFIEBOARD INSTRUCTIONS

Board pinout

Battery + ndash 26 to 45 volt input drives everything except the LEDs

Battery - ndash negative pad for LEDs needs to be at same level as GND when both are connected Both pads are internally connected

GND ndash ground for electronics except LEDs Note that there are two GND pads on the board that are internally connected

Speaker +- ndash hooks up to speaker

Activation (1) Aux (2) Aux2 button (3) ndash hook up to closing buttons or potentially touch buttons

Blade ID Neopixel Data 1 ndash normally used to measure the blade ID restor and if itrsquos a neopixel blade feed out neopixel data

Data 2 3 4 5 ndash additional neopixel data outputs or free for other purposes

LED 1 2 3 4 5 6 ndash hooks up to negative side of LED (positive side of LED hooks up directly to battery) These pads can handle

up to 30 volts

SDA SCL ndash these pins are used to wire OLED display or to communicate with the gyro and accelerometer chip

RX TX ndash these pins are used for wiring a bluetooth module for wireless control

SWDCLK SWDIO ndash can be hooked up to a ST-LINK device and lets you debug programs running on the ProffieBoard

+5V ndash generated by the ProffieBoard normally itrsquos only ON when sound is playing

+33V ndash generated by the ProffieBoard for powering OLED display Bluetooth module or some accent leds

BOOT RESET ndash buttons to put the ProffieBoard in bootloader mode if uploading doesnrsquot work

micro USB port ndash micro USB port used only for firmware upload and can be used for sound files upload to SD card (from firmware version

1291 and up) THIS PORT ISNrsquoT USED FOR CHARGING THE BATTERY

LED 4LED 3

LED 2

LED 1

LED 5

LED 6

RESETBOOT

Battery - Battery -

Speaker + (red dot or ldquo+rdquo mark on speaker)

Battery +

Aux button (2)Activation button (1)

Aux2 button (3)

Blade ID Neopixel Data 1

Data 5

Data 4Data 3Data 2

+33V

SWDIO

SWDCLK

+5V

TXRX

GND

GND

Reset

Speaker -

SCLSDA

micro USB port

WIRING DIAGRAMS

26 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Basic Tri-Cree wiring diagram(In-hilt LED)

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

+

+

-

-

26 AWG

26 A

WG

30-32 AWG

28-30 AWG

28-3

0 A

WG

30-32 AWG

Protected 36-37V (42V max at full charge) 10A 3500mAh battery recommended+18650 battery holder (optional)Keystone 1042P

AV switch with accent led(constantly ON no effects)

accent leds run mostly at10-15mA so resistors for them must be calculated accordingly

Main RGB led

additional RGB leds(optional)

In case no additional high power leds are needed LED channels 4 5 6 can be used for 3 controllable(programmable for different effects) accent leds So AV switch led can be wired to one of these channelsAccent leds also can be wired to Data pads 1-5 please see ldquoAccent LEDs wiring and setuprdquo page

LED Resistor Calculator

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 27

3WIRING DIAGRAMS1

Basic Tri-Cree wiring (In-hilt LED)ldquoconfighrdquo file setup

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

Use a given or build your wiring diagram on THIS PAGE then open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text

Editor (Notepad - to see code correctly in Notepad Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all

text) and Delete it then Copy-and-Paste (Ctrl+C Ctrl+V) your wiring diagram config code (example below) into empty _configh file and

Save it under new name Follow the instructions on page 22 to upload it to the board

ldquoproffieboard_v1_confighrdquoNUM_BLADES 2NUM_BUTTONS 2VOLUME 1000CLASH_THRESHOLD_G 10StyleNormalPtrltCYAN WHITE 300 800gt()StyleNormalPtrltCYAN WHITE 300 800gt()

CreeXPE2RedTemplatelt1000gtCreeXPE2GreenTemplatelt0gtCreeXPE2BlueTemplatelt240gtNoLED

ProffieBoard config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)Volume level (0-3000)Clash sensitivity (adjust lower or higher with 01 step)ldquoBlade 1rdquo styleldquoBlade 2rdquo style (in case only 1 blade is used you donrsquot need this line)LED configuration (use these XP-E2 LED templatesto define your LED If other LED resistors are used change these values to match Ohm1000=ltvaluegt)

where 1000 is 1 Ohm resistor 0 is no resistor240 is 024 Ohm resistorNoLED ndash no 4th led used

Preset 1

LED 1 configuration

LED 2 configuration

Preset 2 etc

PROFFIEBOARD INSTRUCTIONS

28 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Basic Neopixel wiring diagram

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

+

+

-

-

22 A

WG

22 AWG

x2 28 AWG

x2 26 AWG

22 A

WG

30-32 AWG30-32 AWG

Protected 36-37V (42V max at full charge) 10A 3500mAh or 15A 3120mAhbattery recommended+18650 battery holder (optional)Keystone 1042P

AV switch with accent led(constantly ON no effects)

accent leds run mostly at10-15mA so resistors for them must be calculated accordingly

Main Neopixel strip

additional Neopixelstrips(optional)

Neopixel bladeconnector

330 Ohm on the Blade pcb side

x3 28 AWGor x1 22 AWGfor Negative

330 Ohm on the Blade pcb side

arrows up

330 Ohm on the Blade pcb side

In case no additional Neopixel strips are needed LED channels 4 5 6 can be used for 3 controllable(programmable for different effects) accent leds So AV switch led can be wired to one of these channelsAccent leds also can be wired to Data pads 2-5 please see ldquoAccent LEDs wiring and setuprdquo page

Recommended power wire gauges (22 AWG) are given for 2-strip blade For 3-strip blade you gonna need at least 20 AWG wires

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 29

ldquoproffieboard_v1_confighrdquo

3WIRING DIAGRAMS1

Basic Neopixel wiringldquoconfighrdquo file setup

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

NUM_BLADES 3NUM_BUTTONS 2VOLUME 1000CLASH_THRESHOLD_G 10IgnitionDelaylt0 any blade stylegtIgnitionDelaylt800 any blade stylegtIgnitionDelaylt800 any blade stylegtWS2811BladePtrlt118 WS2811 800kHz | WS2811 GRBgt()WS2811BladePtrlt26 blade2Pin ltbladePowerPin4gtgt()WS2811BladePtrlt26 blade3Pin ltbladePowerPin5gtgt()

ProffieBoard config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)Volume level (0-3000)Clash sensitivity (adjust lower or higher with 01 step)ldquoBlade 1rdquo style (main blade with IgnitionDelay 0)ldquoBlade 2rdquo style (CG blade 1 with IgnitionDelay 800)ldquoBlade 3rdquo style (CG blade 2 with IgnitionDelay 800)

strip configuration (defines how many pixels it has and to which LED output and pin is wired)

Preset 1

any blade style

strip (blade) 1 configuration

adjust this number to match your strips leds count

strip (blade) 2 configuration

strip (blade) 3 configuration

Preset 2 etc

Use a given or build your wiring diagram on THIS PAGE then open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text

Editor (Notepad - to see code correctly in Notepad Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all

text) and Delete it then Copy-and-Paste (Ctrl+C Ctrl+V) your wiring diagram config code (example below) into empty _configh file and

Save it under new name Follow the instructions on page 22 to upload it to the board

PROFFIEBOARD INSTRUCTIONS

30 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Basic Segmented string wiring diagram

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

+

+

-

-

24 A

WG

28 AWG

30-32 AWG30-32 AWG

Protected 36-37V (42V max at full charge) 10A 3500mAh battery recommended+18650 battery holder (optional)Keystone 1042P

AV switch with accent led(constantly ON no effects)

accent leds run mostly at10-15mA so resistors for them must be calculated accordingly

6-segments string blade

FoC string

N-channel FET3A minimum

123456

Calculate resistors for each led segment of the blade string depending on which leds are used 5mm leds have max drive current around 25mA per led when 10mm leds can be 100mA and 200mA per ledSo pay attention to your led max current and Forward Voltage (Vf) when calculating a segment resistor resistence as well as its wattage Also choose wire gauges accordingly to meet segments and total blade max current draw level

LED Resistor Calculator

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 31

ldquoproffieboard_v1_confighrdquo

3WIRING DIAGRAMS1

Basic Segmented string wiringldquoconfighrdquo file setup

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

NUM_BLADES 1NUM_BUTTONS 2VOLUME 1000CLASH_THRESHOLD_G 10StyleNormalPtrltCYAN WHITE 300 800gt()ltBlue3mmLED BladePin White3mmLEDgt

ProffieBoard config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)Volume level (0-3000)Clash sensitivity (adjust lower or higher with 01 step)Blade styleLED string configuration(here you mention the color and type of leds usedin the main blade string segments and FoC stringBladePin is the FoC signal pin (Blade ID pin))

Preset

LED string configuration

Use a given or build your wiring diagram on THIS PAGE then open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text

Editor (Notepad - to see code correctly in Notepad Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all

text) and Delete it then Copy-and-Paste (Ctrl+C Ctrl+V) your wiring diagram config code (example below) into empty _configh file and

Save it under new name Follow the instructions on page 22 to upload it to the board

PROFFIEBOARD INSTRUCTIONS

32 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Accent LEDs wiring diagram(optional)

Accent LEDs work with ProffieBoard as additional ldquobladesrdquo when powered by LED outputs 4 5 6 or Data pads 1 2 3 5 as PWM So they can

have any effect that blade can have If no effects needed accent led can be powered just by a 33V output pad (power-on led indication)

30-32 AWG

with Neopixel blade setup these 4 outputsdonrsquot work for regular accent leds

Recommended resistors to use for accent leds at 33V power source and 15mA drive

ndash 100 Ohm for Red (lt100000gt value in the code)ndash 13 Ohm for Green (lt13000gt value in the code)ndash 13 Ohm for Blue (lt13000gt value in the code)ndash 100 Ohm for Yellow (lt100000gt value in the code)ndash 20 Ohm for White (lt20000gt value in the code)

RGB ledcommon-anode

8 ldquobladesrdquo1 main and 7 accent leds

main blade style (effects) main blade style (effects)

7 accent leds style (effects)accent led style (effects)

7 accent leds configurations

RGB accent led configuration

2 ldquobladesrdquo1 main and 1 RGB accent led

ldquoPower-onrdquo indicationaccent leds (no effects)

7 accent leds withindependent effects

RGB accent led

a) b)

b)

c)

c)

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 33

3WIRING DIAGRAMS1

Neopixel Accent LEDs wiring diagram(optional)

With Neopixel setup additional neopixel leds or arrays can be used as accent leds There are 2 ways to wire them using additional Data

pins 2 3 4 5 or ldquoSub-bladesrdquo wiring with just 1 Data output pin Same way Neopixel connectors with on-board leds ca be wired

Option 1 ndash with extra Data pins

Main Blade

some accent leds

D1

D2

crystal leds

330 Ohm

330 Ohm

330 Ohm

main blade style (effects)

main blade 144 leds Data pin 1

accent leds blade style (effects)

accent leds ldquobladerdquo 4 leds Data pin 2

crystal leds blade style (effects)

crystal leds ldquobladerdquo 2 leds Data pin 3

3 ldquobladesrdquo1 main 1 accent leds array and 1 crystal leds array

PROFFIEBOARD INSTRUCTIONS

D3

follow arrows direction

34 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Neopixel Accent LEDs wiring diagram(optional)

PROFFIEBOARD INSTRUCTIONS

Main Blade

some accent leds

1

3

5678

2

4

D1

crystal leds

follow arrows direction

330 Ohm

330 OhmData signal

With this setup a single array of neopixel leds is separated into a couple of sub-blades with their own style configuration and behaviour This

is really usefull when you want to use only one data pin More about ldquoSub-bladesrdquo on ProffieOS wiki page

Option 2 ndash with ldquoSub-bladesrdquo

main blade style (effects)

main blade sub-blade 140 leds (7-146) but from 6 to 145 in the code

accent leds blade style (effects)

accent leds sub-blade 4 leds (1-4) but from 0 to 3 in the code

crystal leds blade style (effects)

146 leds total used

crystal leds sub-blade 2 leds (5-6) but from 4 to 5 in the code

update default 144 to a higher total value if you get all accent leds +Main blade gt 144 Example update to 146 if you have 2 crystal leds +4 accent leds + 140 Main blade leds = 146

3 ldquobladesrdquo 1 main 1 accent leds array and 1 crystal leds array

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 35

3WIRING DIAGRAMS1

OLED display wiring diagram(optional)

SSD1306 128x32 pixels OLED display allows to show battery level current preset name play different animations and even simple games It

can be wired to any blade configuration and requires just one additional line in the code to work You can get monochrome display in white

or blue color

SSD1306128x32OLED

SSD1306 ndash with blue or white display color selectSSD1306 ndash cheaper priceSSD1306 just screen ndash blue or white select

30-32 AWG

30-32 AWG

add this line to enable OLED display

display shows a preset name written in these quotes ldquoldquo

PROFFIEBOARD INSTRUCTIONS

36 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Bluetooth module wiring diagram(optional)

SOON

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 37

3WIRING DIAGRAMS1

Blade ID resistor functions(optional)

SOON

PROFFIEBOARD INSTRUCTIONS

38 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

website ProffieBoard FULL wiring diagrams link

Scroll the page down till you see the interactive diagram Above the diagram there are components selection options Build your saber setup

with it and follow diagram to wire your board Then you need to copy the configuration code below and paste it into your _configh file

Choose components you want

3WIRING DIAGRAMS1

More wiring diagrams

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 39

3WIRING DIAGRAMS1

How to use it

PROFFIEBOARD INSTRUCTIONS

Blade ignitionretraction ndash assuming you have at least one button pressing it briefly should turn the saber on or off If you have an AUX button pressing it briefly should also turn the saber on and off If you have no buttons you can turn the saber on and off by twisting your wrist back and forth Note that the motion has to be done long enough to count so a very quick flick of the wrist will not workTurn On muted ndash double-click power buttonNext preset ndash while saber is off click the AUX buttonPrevious preset ndash hold AUX button and click the Activation buttonTrigger Clash ndash while saber is on hit the bladeTrigger Lockup ndash while saber is on hold Activation button then trigger a clash Lockup releases when you let go of the Acti-vation buttonTrigger Drag ndash like lockup but point saber mostly down before holding Activation buttonTrigger Force ndash long-click AUX buttonStart soundtrack ndash long-click the Activation buttonTrigger Blaster Block ndash while saber is on short-click AUX button

Serial Monitor commands

battery_voltage ndash gets current battery voltage valueget_volume ndash get current volume valuepow ndash power OnOff the saberon ndash power On the saberoff ndash power Off the saberset_volume lt0-3000gt ndash set volume value (example set_volume 500)play ndash play the default preset trackplay trackslttrack namegt ndash play a specific track from tracks folder (example play tracksvenuswav)stop ndash stop the playing trackforce ndash play ldquoforcerdquo sound effectsdrag ndash play ldquodragrdquo sound effectsblast ndash play ldquoblasterrdquo sound effectslock ndash play ldquolockuprdquo sound effectsclash ndash play ldquoclashrdquo sound effectsreset ndash reboot the boardn ndash switch to next presetp ndash switch to previous presetlist_presets ndash show all presetssdtest ndash test SD card speed

40 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3FIRMWARE UPLOAD AND UPDATE2

Software installation and setup

PROFFIEBOARD INSTRUCTIONS

To upload firmware to ProffieBoard Arduino IDE program is required Follow these steps to install it to your PC

1 Install latest Arduino IDE software (donrsquot use BETA)

Installing as Windows app also is not recommended

because it will be installed in a specific protected folder that

wonrsquot allow you to install any additional softwareplugin in it

If ProffieBoard wonrsquot show up in COM port use

Arduino IDE 186 version

2 Install the Proffieboard Arduino Plugin and Zadig software

Follow installation instructions

3 Select Proffieboard-STM32L433 in Tools -gt Board

USB Type ndash Serial CPU Speed ndash 80 MHz Optimize ndash Smallest Code DOSFS ndash SDCARD (SPI) Port ndash COM(the number your PC assigned) (Butterfly-L433CC)

Connect Proffieboard via USB cable to PC to be able to select

the Port

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 41

3FIRMWARE UPLOAD AND UPDATE2

Uploading firmware

PROFFIEBOARD INSTRUCTIONS

1 Download the ProffieBoard firmware and SD card content

Unzip lightsaber-1286zip to your Documents directory or to

Desktop but not to Arduino program folder or anywhere in

Programs directory where all programs are installed You will

see a lightsaber folder and files inside it Donrsquot move any of

these files to any other location outside the lightsaber folder

and donrsquot reorganize them Unzip ProffieOS_SD_Cardzip to the

folder where you keep lightsaber-1286 folder Copy all files

from ProffieOS_SD_Card folder to your SD card

2 Unhide file extensions in File Explorer settings to see h ending

of config files Donrsquot add ldquohrdquo to the config file name Go to config folder and create you own configh file (see page

42 for how-to)

Double-click the lightsaberino file

3 Add the name of your configh file as shown and Save this

lightsaberino file Make sure the other config files are

commented out there should be only one CONFIG_FILE

without You can have multiple config files

in lightsabergtconfig folder and just define the one you need

in lightsaberino file and upload it again to ProffieBoard

4 Connect battery to ProffieBoard and hook up to your PC

with a data transfer micro-USB-to-USB cable

Press arrow button it will compile and upload firmware to the

board Wait for red text progress bars to stop at 100

ProffieBoard will play boot sound if speaker is connected

Now you can unplug the USB cable Done

If it gives an error instead this means your configh file has

issues define CONFIG_FILE name has mistakes configh file

is out of config folder your PC user name is non-latin

42 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

33

configh file structure editing

PROFFIEBOARD INSTRUCTIONS

CHANGING PARAMETERS

All sound files (sound fonts music tracks) are stored on the micro SD card Add required sound fonts folders (Plecter NEC and Smoothswing

fonts are supported no need to change WAV files names just copy and paste) to SD card root directory as itrsquos done in the default

ProffieOS_SD_Card content folder and music tracks to the tracks folder

Make sure to name all music tracks and sound fonts folders with latin characters and only up to 8 characters long without using any special

characters (like |[- etc)

Make sure you have a configini file in each sound font folder if there is none - copy one from some default TeensySaberProffieBoard sound

font and paste into newly added sound font folder It has only one parameter that you can modify - humstart It helps to match hum sound

start with blade ignition 1000 usually works fine

All blade effects LED configuration volume level clash sensitivity etc are changed in the configh file located in lightsabergtconfig folder

To do that open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text Editor (Notepad - to see code correctly in Notepad

Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all text) and Delete it then Copy-and-Paste (Ctrl+C

Ctrl+V) your wiring diagram config code into empty _configh file and Save it under new name Follow the instructions on page 39 to

upload it to the board

Proffieboard config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)

volume level (0-3000)

clash sensitivity (adjust lower or higher with 01 step)

sound font folder nametrack name

Preset name

Blade style

LED configuration (use these XP-E2 LED templatesto define your LED)

for Red use 1 Ohm resistor for Green - no resistor for Blue use 024 Ohm

NoLED ndash no 4th led used

Preset 1

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 43

33

Blade Styles

StylePtrltInOutHelperltSimpleClashltLockupltBlastltOnSparkltAudioFlickerltRgblt02550gtRgblt501000gtgtRgblt2552550gt150gtRgblt255500gtgtAudioFlickerltRgblt1002550gtRgblt2550150gtgtgtRgblt255100150gt40gt200300Blackgtgt

ndash this is how the Blade Style code looks pasted in the configh file Preset (it sits inside a StylePtrltgt container)

ndash this is how the Blade Style code looks when editing it inside a Blade Style Editor

Each Blade Style is made of a variety of Effects each added effect goes instead of a base color in the previous effect

PROFFIEBOARD INSTRUCTIONS

CHANGING PARAMETERS

ProffieBoard and TeensySaber use Blade Styles for the main saber blade and any other accent leds to define all light effects (color changing

flashes flickering delays ignitionretraction timing etc)

Use Blade Style Editor to create and adjust Blade Styles Megtooth Sith Sabers did a great video tutorial where he shows and explains

how to use Blade Style Editor Also you can grab some pre-made Blade Styles or share yours here on TRA forums

A Blade Style example of simple flickering Green blade with Spark on start Clash Blaster Lockup and Drag IgnitionRetraction effects

InOutHelperltSimpleClashltLockupltBlastltOnSparkltAudioFlickerltRgblt02550gtRgblt501000gtgtRgblt2552550gt150gtRgblt255500gtgtAudioFlickerltRgblt1002550gtRgblt2550150gtgtgtRgblt255100150gt40gt200300Blackgt

InOutHelperltbase color200300Blackgt ndash base color can be defined by words (WHITE RED GREEN PURPLE etc) or by Rgblt0-2550-2550-255gt values for more

custom shades 200 is extension length in milliseconds 300 is retraction length in milliseconds Black is color when retracted (also can be any other color)

SimpleClashltbase colorclash color40gt ndash clash effect 40 is clash duration in milliseconds

Lockupltbase colorlockup colorgt ndash lockup effect

Blastltbase colorblast colorgt ndash blaster effect

OnSparkltbase colorspark color150gt ndash spark on ignition effect 150 is spark duration in milliseconds

AudioFlickerltrdquoArdquo colorrdquoBrdquo colorgt ndash flickering effect (blade flickers to the actual saber hum sound) the more difference between ldquoArdquo and ldquoBrdquo colors - the more

abrupt is flickering

Rgblt255500gt ndash actual color in RGB format (0 is no light 255 is the maximum brightness value for Red Green or Blue channel)

44 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

ndash SanDisk 4GB microSDHC Class 4 (Genuine) ndash SanDisk 4GB microSDHC Class 4 (Genuine)

130238 kbs = 1477 simultaneous audio streams 137812 kbs = 1562 simultaneous audio streams

ndash Patriot LX Series 16GB microSDHC UHS-IU1 Class 10 ndash Patriot LX Series 16GB microSDHC UHS-IU1 Class 10

133005 kbs = 1508 simultaneous audio streams

ndash GSkill 16GB microSDHC UHS-IU1 Class 10 ndash GSkill 16GB microSDHC UHS-IU1 Class 10

129534 kbs = 1469 simultaneous audio streams

ndash Kingston 16GB microSDHC UHS-IU1 Class 10 ndash Kingston 16GB microSDHC UHS-IU1 Class 10

128090 kbs = 1452 simultaneous audio streams

ndash SanDisk Ultra 16GB microSDHC UHS-IU1 A1 Class 10 ndash SanDisk Ultra 16GB microSDHC UHS-IU1 A1 Class 10

102663 kbs = 1164 simultaneous audio streams 11124 kbs = 1261 simultaneous audio streams

ndash SanDisk 8GB microSDHC Class 4 ndash SanDisk 8GB microSDHC Class 4

108506 kbs = 1230 simultaneous audio streams

ndash SanDisk 16GB microSDHC Class 4 ndash SanDisk 16GB microSDHC Class 4

102663 kbs = 1164 simultaneous audio streams 106957 kbs = 1213 simultaneous audio streams

ndash SanDisk Ultra 16GB microSDHC UHS-IU1 Class 10 ndash SanDisk Ultra 16GB microSDHC UHS-IU1 Class 10

102663 kbs = 1164 simultaneous audio streams 103909 kbs = 1178 simultaneous audio streams

ndash Smartbuy 4GB microSDHC Class 4 ndash Smartbuy 4GB microSDHC Class 4

75437 kbs = 855 simultaneous audio streams

ndash Kingston 8GB microSDHC Class 4 ndash Kingston 8GB microSDHC Class 4

75209 kbs = 822 simultaneous audio streams

ndash SanDisk 4GB microSDHC Class 4 (Fake) ndash SanDisk 4GB microSDHC Class 4 (Fake)

677 kbs = 769 simultaneous audio streams

Here is a list of tested micro SD cards speed with TeensySaber V3 and ProffieBoard Any card with speed over 900 kbs is recommended the

higher the speed is ndash the better Memory size of 4-16Gb is more than enough Cards were tested with a default firmware (1291) compiled

with ldquoSmallest Coderdquo under Optimize ldquodefault_proffieboard_confighrdquo file and default ProffieOS SD card sound files (7 folders)

To test your SD card speed simply hook up ProffieBoard to PC open Arduino IDE go to Tools and open Serial Monitor make sure you have

New Line and 9600 baud rate selected on the bottom of Serial Monitor window type and send sdtest command wait for the test result

4Recommended micro SD cards

BEST

TEENSYSABER PROFFIEBOARD

GOOD

BAD

PROFFIEBOARD INSTRUCTIONS

SD CARD RECOMMENDATIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 45

There are a lot of fake (chinese copies) microSD cards on the market from aliexpress ebay amazon etc They look very similar to genuine

cards but are a bit different though and have a twice lower writingreading speed Here is an example of a SanDisk 4Gb Class 4 card one is

genuine with 137812 kbs speed and the other one is fake with 677 kbs speed I got from ebay seller

Be carefull and pay attention to how the actual card looks if you are not sure ask seller for the real photo of SD card he sells

4Genuine and Fake SanDisk 4Gb Class 4 microSD

PROFFIEBOARD INSTRUCTIONS

SD CARD RECOMMENDATIONS

46 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

WIRE GAUGE GUIDE

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 47

RECHARGE PORTS AND KILL SWITCHES

48 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

NEOPIXEL STRIPS CURRENT DRAW

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 49

6TROUBLESHOOTING

For more help please check these linksProffieOSProffieBoardTeensySaber wiki on GitHubAsk your question on The Rebel Armory forumsAsk your question on FX-sabers forumsAsk your question in facebook group

How to solve most common issues

Quick troubleshooting tips

TeensySaber board or Proffieboard is not recognized by computer (nothing under Port selection in Arduino)

ndash Make sure a charged 37V battery is connected to the board micro-USB cable is a data transfer cable all plugins and drivers are installed ndash

check again pages 21 for TeensySaber or 40 for Proffieboard Try a different USB port on your computer

Sketch (code) compile error in Arduino IDE

ndash Check your define CONFIG_FILE ldquoconfig_confighrdquo line in opened lightsaberino file if itrsquos written correctly with config in it

Sketch (code) compile error in Arduino IDE

ndash Check if the _configh file you defined in the lightsaberino sketch file is same name as in the lightsaber-rdquofirmware versionrdquolightsaber

config folder and is located in this folder

Sketch (code) compile error in Arduino IDE

ndash Check your settings under Tools tab in Arduino IDE program Check again pages 21 for TeensySaber or 40 for Proffieboard

Sketch (code) compile error in Arduino IDE

ndash Check if your _configh file is correct Blade Styles Presets const unsigned int maxLedsPerStrip = 144 if BladeConfig blades[] = is correct

Sketch (code) compile error in Arduino IDE

ndash If nothing helps install Arduino IDE version 186 and try to compile and upload the firmware again

Sound doesnrsquot play

ndash Remove SD card and insert again check speaker wiring Make sure all sound files on SD card are correctly named (8 characters max long)

Re-format SD card in FAT32 load sound files and try again try another SD card

Board says ldquoLOW POWERrdquo

ndash Charge the battery

Serial Monitor shows info sent by the board but your commands donrsquot work

ndash In the bottom right corner of Serial Monitor window make sure the Line Ending drop down is set to New Line

Sound is weird and distorted

ndash Check your SD card speed (see page 44) Check speaker wiring try another good speaker

22 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

1 Download the TeensySaber firmware and SD card content

Unzip lightsaber-1286zip to your Documents directory or to

Desktop but not to Arduino program folder or anywhere in

Programs directory where all programs are installed You will

see a lightsaber folder and files inside it Donrsquot move any of

these files to any other location outside the lightsaber folder

and donrsquot reorganize them Unzip ProffieOS_SD_Cardzip to the

folder where you keep lightsaber-1286 folder Copy all files

from ProffieOS_SD_Card folder to your SD card

2 Unhide file extensions in File Explorer settings to see h ending

of config files Donrsquot add ldquohrdquo to the config file name

Go to config folder and create you own configh file (see page

23 for how-to)

Double-click the lightsaberino file

3 Add the name of your configh file as shown and Save this

lightsaberino file Make sure the other config files are

commented out there should be only one CONFIG_FILE

without You can have multiple config files

in lightsabergtconfig folder and just define the one you need

in lightsaberino file and upload it again to TeensySaber board

4 Connect battery to TeensySaber board and hook up to your PC

with a data transfer micro-USB-to-USB cable

Press arrow button it will compile and upload firmware to the

board Wait for your PC to make a sound or TeensySaber will

play boot sound if speaker is connected Now you can unplug

the USB cable Done

If it gives an error instead this means your configh file has

issues define CONFIG_FILE name has mistakes configh file

is out of config folder your PC user name is non-latin

2TEENSYSABER V3 INSTRUCTIONS

FIRMWARE UPLOAD AND UPDATE2

Uploading firmware

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 23

2TEENSYSABER V3 INSTRUCTIONS

CHANGING PARAMETERS3

Changing sound board parameters

All sound files (sound fonts music tracks) are stored on the micro SD card Add required sound fonts folders (Plecter NEC and Smoothswing

fonts are supported no need to change WAV files names just copy and paste) to SD card root directory as itrsquos done in the default

ProffieOS_SD_Card content folder and music tracks to the tracks folder

Make sure to name all music tracks and sound fonts folders with latin characters and only up to 8 characters long without using any special

characters (like |[- etc)

Make sure you have a configini file in each sound font folder if there is none - copy one from some default TeensySaberProffieBoard sound

font and paste into newly added sound font folder It has only one parameter that you can modify - humstart It helps to match hum sound

start with blade ignition 1000 usually works fine

All blade effects LED configuration volume level clash sensitivity etc are changed in the configh file located in lightsabergtconfig folder

To do that open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text Editor (Notepad - to see code correctly in Notepad

Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all text) and Delete it then Copy-and-Paste (Ctrl+C

Ctrl+V) your wiring diagram config code into empty _configh file and Save it under new name Follow the instructions on page 22 to

upload it to the board

TeensySaber V3 config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)

volume level (0-3000)

clash sensitivity (adjust lower or higher with 01 step)

sound font folder nametrack name

Preset name

Blade style

LED configuration (use these XP-E2 LED templatesto define your LED)

for Red use 1 Ohm resistor for Green - no resistor for Blue use 024 Ohm

NoLED ndash no 4th led used

Preset 1

24 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

31

PROFFIEBOARD INSTRUCTIONS

Whatrsquos needed

ndash ProffieBoard

ndash micro SD-card (see page 44 for recommendations)

ndash a USB micro SD-card reader (to load sound files from PC to micro SD card)

ndash micro USB data transfer cable (CABLES THAT SUPPORT ONLY CHARGING WONrsquoT WORK)

ndash wires of different gauges (32-20 AWG) (PTFE coated copper stranded wires recommended) heat shrink

ndash ESD safe soldering station solder wire flux etc

ndash pliers helping hands etc

ndash isopropyl alcohol to clean pads before soldering (helps solder to stick better)

ndash Digital Multimeter (VERY USEFUL)

ndash computer running Windows Linux or Mac OS with internet access

ndash 37V Li-Ion Protected rechargeable battery switches recharge port speaker LEDs resistors chassis etc

ndash Smart Li-Ion CC-CV (Constant Current - Constant Voltage mode) battery charger for 37V (42V) cells

ndash patience

WIRING DIAGRAMS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 25

31

PROFFIEBOARD INSTRUCTIONS

Board pinout

Battery + ndash 26 to 45 volt input drives everything except the LEDs

Battery - ndash negative pad for LEDs needs to be at same level as GND when both are connected Both pads are internally connected

GND ndash ground for electronics except LEDs Note that there are two GND pads on the board that are internally connected

Speaker +- ndash hooks up to speaker

Activation (1) Aux (2) Aux2 button (3) ndash hook up to closing buttons or potentially touch buttons

Blade ID Neopixel Data 1 ndash normally used to measure the blade ID restor and if itrsquos a neopixel blade feed out neopixel data

Data 2 3 4 5 ndash additional neopixel data outputs or free for other purposes

LED 1 2 3 4 5 6 ndash hooks up to negative side of LED (positive side of LED hooks up directly to battery) These pads can handle

up to 30 volts

SDA SCL ndash these pins are used to wire OLED display or to communicate with the gyro and accelerometer chip

RX TX ndash these pins are used for wiring a bluetooth module for wireless control

SWDCLK SWDIO ndash can be hooked up to a ST-LINK device and lets you debug programs running on the ProffieBoard

+5V ndash generated by the ProffieBoard normally itrsquos only ON when sound is playing

+33V ndash generated by the ProffieBoard for powering OLED display Bluetooth module or some accent leds

BOOT RESET ndash buttons to put the ProffieBoard in bootloader mode if uploading doesnrsquot work

micro USB port ndash micro USB port used only for firmware upload and can be used for sound files upload to SD card (from firmware version

1291 and up) THIS PORT ISNrsquoT USED FOR CHARGING THE BATTERY

LED 4LED 3

LED 2

LED 1

LED 5

LED 6

RESETBOOT

Battery - Battery -

Speaker + (red dot or ldquo+rdquo mark on speaker)

Battery +

Aux button (2)Activation button (1)

Aux2 button (3)

Blade ID Neopixel Data 1

Data 5

Data 4Data 3Data 2

+33V

SWDIO

SWDCLK

+5V

TXRX

GND

GND

Reset

Speaker -

SCLSDA

micro USB port

WIRING DIAGRAMS

26 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Basic Tri-Cree wiring diagram(In-hilt LED)

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

+

+

-

-

26 AWG

26 A

WG

30-32 AWG

28-30 AWG

28-3

0 A

WG

30-32 AWG

Protected 36-37V (42V max at full charge) 10A 3500mAh battery recommended+18650 battery holder (optional)Keystone 1042P

AV switch with accent led(constantly ON no effects)

accent leds run mostly at10-15mA so resistors for them must be calculated accordingly

Main RGB led

additional RGB leds(optional)

In case no additional high power leds are needed LED channels 4 5 6 can be used for 3 controllable(programmable for different effects) accent leds So AV switch led can be wired to one of these channelsAccent leds also can be wired to Data pads 1-5 please see ldquoAccent LEDs wiring and setuprdquo page

LED Resistor Calculator

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 27

3WIRING DIAGRAMS1

Basic Tri-Cree wiring (In-hilt LED)ldquoconfighrdquo file setup

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

Use a given or build your wiring diagram on THIS PAGE then open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text

Editor (Notepad - to see code correctly in Notepad Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all

text) and Delete it then Copy-and-Paste (Ctrl+C Ctrl+V) your wiring diagram config code (example below) into empty _configh file and

Save it under new name Follow the instructions on page 22 to upload it to the board

ldquoproffieboard_v1_confighrdquoNUM_BLADES 2NUM_BUTTONS 2VOLUME 1000CLASH_THRESHOLD_G 10StyleNormalPtrltCYAN WHITE 300 800gt()StyleNormalPtrltCYAN WHITE 300 800gt()

CreeXPE2RedTemplatelt1000gtCreeXPE2GreenTemplatelt0gtCreeXPE2BlueTemplatelt240gtNoLED

ProffieBoard config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)Volume level (0-3000)Clash sensitivity (adjust lower or higher with 01 step)ldquoBlade 1rdquo styleldquoBlade 2rdquo style (in case only 1 blade is used you donrsquot need this line)LED configuration (use these XP-E2 LED templatesto define your LED If other LED resistors are used change these values to match Ohm1000=ltvaluegt)

where 1000 is 1 Ohm resistor 0 is no resistor240 is 024 Ohm resistorNoLED ndash no 4th led used

Preset 1

LED 1 configuration

LED 2 configuration

Preset 2 etc

PROFFIEBOARD INSTRUCTIONS

28 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Basic Neopixel wiring diagram

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

+

+

-

-

22 A

WG

22 AWG

x2 28 AWG

x2 26 AWG

22 A

WG

30-32 AWG30-32 AWG

Protected 36-37V (42V max at full charge) 10A 3500mAh or 15A 3120mAhbattery recommended+18650 battery holder (optional)Keystone 1042P

AV switch with accent led(constantly ON no effects)

accent leds run mostly at10-15mA so resistors for them must be calculated accordingly

Main Neopixel strip

additional Neopixelstrips(optional)

Neopixel bladeconnector

330 Ohm on the Blade pcb side

x3 28 AWGor x1 22 AWGfor Negative

330 Ohm on the Blade pcb side

arrows up

330 Ohm on the Blade pcb side

In case no additional Neopixel strips are needed LED channels 4 5 6 can be used for 3 controllable(programmable for different effects) accent leds So AV switch led can be wired to one of these channelsAccent leds also can be wired to Data pads 2-5 please see ldquoAccent LEDs wiring and setuprdquo page

Recommended power wire gauges (22 AWG) are given for 2-strip blade For 3-strip blade you gonna need at least 20 AWG wires

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 29

ldquoproffieboard_v1_confighrdquo

3WIRING DIAGRAMS1

Basic Neopixel wiringldquoconfighrdquo file setup

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

NUM_BLADES 3NUM_BUTTONS 2VOLUME 1000CLASH_THRESHOLD_G 10IgnitionDelaylt0 any blade stylegtIgnitionDelaylt800 any blade stylegtIgnitionDelaylt800 any blade stylegtWS2811BladePtrlt118 WS2811 800kHz | WS2811 GRBgt()WS2811BladePtrlt26 blade2Pin ltbladePowerPin4gtgt()WS2811BladePtrlt26 blade3Pin ltbladePowerPin5gtgt()

ProffieBoard config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)Volume level (0-3000)Clash sensitivity (adjust lower or higher with 01 step)ldquoBlade 1rdquo style (main blade with IgnitionDelay 0)ldquoBlade 2rdquo style (CG blade 1 with IgnitionDelay 800)ldquoBlade 3rdquo style (CG blade 2 with IgnitionDelay 800)

strip configuration (defines how many pixels it has and to which LED output and pin is wired)

Preset 1

any blade style

strip (blade) 1 configuration

adjust this number to match your strips leds count

strip (blade) 2 configuration

strip (blade) 3 configuration

Preset 2 etc

Use a given or build your wiring diagram on THIS PAGE then open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text

Editor (Notepad - to see code correctly in Notepad Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all

text) and Delete it then Copy-and-Paste (Ctrl+C Ctrl+V) your wiring diagram config code (example below) into empty _configh file and

Save it under new name Follow the instructions on page 22 to upload it to the board

PROFFIEBOARD INSTRUCTIONS

30 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Basic Segmented string wiring diagram

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

+

+

-

-

24 A

WG

28 AWG

30-32 AWG30-32 AWG

Protected 36-37V (42V max at full charge) 10A 3500mAh battery recommended+18650 battery holder (optional)Keystone 1042P

AV switch with accent led(constantly ON no effects)

accent leds run mostly at10-15mA so resistors for them must be calculated accordingly

6-segments string blade

FoC string

N-channel FET3A minimum

123456

Calculate resistors for each led segment of the blade string depending on which leds are used 5mm leds have max drive current around 25mA per led when 10mm leds can be 100mA and 200mA per ledSo pay attention to your led max current and Forward Voltage (Vf) when calculating a segment resistor resistence as well as its wattage Also choose wire gauges accordingly to meet segments and total blade max current draw level

LED Resistor Calculator

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 31

ldquoproffieboard_v1_confighrdquo

3WIRING DIAGRAMS1

Basic Segmented string wiringldquoconfighrdquo file setup

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

NUM_BLADES 1NUM_BUTTONS 2VOLUME 1000CLASH_THRESHOLD_G 10StyleNormalPtrltCYAN WHITE 300 800gt()ltBlue3mmLED BladePin White3mmLEDgt

ProffieBoard config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)Volume level (0-3000)Clash sensitivity (adjust lower or higher with 01 step)Blade styleLED string configuration(here you mention the color and type of leds usedin the main blade string segments and FoC stringBladePin is the FoC signal pin (Blade ID pin))

Preset

LED string configuration

Use a given or build your wiring diagram on THIS PAGE then open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text

Editor (Notepad - to see code correctly in Notepad Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all

text) and Delete it then Copy-and-Paste (Ctrl+C Ctrl+V) your wiring diagram config code (example below) into empty _configh file and

Save it under new name Follow the instructions on page 22 to upload it to the board

PROFFIEBOARD INSTRUCTIONS

32 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Accent LEDs wiring diagram(optional)

Accent LEDs work with ProffieBoard as additional ldquobladesrdquo when powered by LED outputs 4 5 6 or Data pads 1 2 3 5 as PWM So they can

have any effect that blade can have If no effects needed accent led can be powered just by a 33V output pad (power-on led indication)

30-32 AWG

with Neopixel blade setup these 4 outputsdonrsquot work for regular accent leds

Recommended resistors to use for accent leds at 33V power source and 15mA drive

ndash 100 Ohm for Red (lt100000gt value in the code)ndash 13 Ohm for Green (lt13000gt value in the code)ndash 13 Ohm for Blue (lt13000gt value in the code)ndash 100 Ohm for Yellow (lt100000gt value in the code)ndash 20 Ohm for White (lt20000gt value in the code)

RGB ledcommon-anode

8 ldquobladesrdquo1 main and 7 accent leds

main blade style (effects) main blade style (effects)

7 accent leds style (effects)accent led style (effects)

7 accent leds configurations

RGB accent led configuration

2 ldquobladesrdquo1 main and 1 RGB accent led

ldquoPower-onrdquo indicationaccent leds (no effects)

7 accent leds withindependent effects

RGB accent led

a) b)

b)

c)

c)

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 33

3WIRING DIAGRAMS1

Neopixel Accent LEDs wiring diagram(optional)

With Neopixel setup additional neopixel leds or arrays can be used as accent leds There are 2 ways to wire them using additional Data

pins 2 3 4 5 or ldquoSub-bladesrdquo wiring with just 1 Data output pin Same way Neopixel connectors with on-board leds ca be wired

Option 1 ndash with extra Data pins

Main Blade

some accent leds

D1

D2

crystal leds

330 Ohm

330 Ohm

330 Ohm

main blade style (effects)

main blade 144 leds Data pin 1

accent leds blade style (effects)

accent leds ldquobladerdquo 4 leds Data pin 2

crystal leds blade style (effects)

crystal leds ldquobladerdquo 2 leds Data pin 3

3 ldquobladesrdquo1 main 1 accent leds array and 1 crystal leds array

PROFFIEBOARD INSTRUCTIONS

D3

follow arrows direction

34 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Neopixel Accent LEDs wiring diagram(optional)

PROFFIEBOARD INSTRUCTIONS

Main Blade

some accent leds

1

3

5678

2

4

D1

crystal leds

follow arrows direction

330 Ohm

330 OhmData signal

With this setup a single array of neopixel leds is separated into a couple of sub-blades with their own style configuration and behaviour This

is really usefull when you want to use only one data pin More about ldquoSub-bladesrdquo on ProffieOS wiki page

Option 2 ndash with ldquoSub-bladesrdquo

main blade style (effects)

main blade sub-blade 140 leds (7-146) but from 6 to 145 in the code

accent leds blade style (effects)

accent leds sub-blade 4 leds (1-4) but from 0 to 3 in the code

crystal leds blade style (effects)

146 leds total used

crystal leds sub-blade 2 leds (5-6) but from 4 to 5 in the code

update default 144 to a higher total value if you get all accent leds +Main blade gt 144 Example update to 146 if you have 2 crystal leds +4 accent leds + 140 Main blade leds = 146

3 ldquobladesrdquo 1 main 1 accent leds array and 1 crystal leds array

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 35

3WIRING DIAGRAMS1

OLED display wiring diagram(optional)

SSD1306 128x32 pixels OLED display allows to show battery level current preset name play different animations and even simple games It

can be wired to any blade configuration and requires just one additional line in the code to work You can get monochrome display in white

or blue color

SSD1306128x32OLED

SSD1306 ndash with blue or white display color selectSSD1306 ndash cheaper priceSSD1306 just screen ndash blue or white select

30-32 AWG

30-32 AWG

add this line to enable OLED display

display shows a preset name written in these quotes ldquoldquo

PROFFIEBOARD INSTRUCTIONS

36 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Bluetooth module wiring diagram(optional)

SOON

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 37

3WIRING DIAGRAMS1

Blade ID resistor functions(optional)

SOON

PROFFIEBOARD INSTRUCTIONS

38 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

website ProffieBoard FULL wiring diagrams link

Scroll the page down till you see the interactive diagram Above the diagram there are components selection options Build your saber setup

with it and follow diagram to wire your board Then you need to copy the configuration code below and paste it into your _configh file

Choose components you want

3WIRING DIAGRAMS1

More wiring diagrams

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 39

3WIRING DIAGRAMS1

How to use it

PROFFIEBOARD INSTRUCTIONS

Blade ignitionretraction ndash assuming you have at least one button pressing it briefly should turn the saber on or off If you have an AUX button pressing it briefly should also turn the saber on and off If you have no buttons you can turn the saber on and off by twisting your wrist back and forth Note that the motion has to be done long enough to count so a very quick flick of the wrist will not workTurn On muted ndash double-click power buttonNext preset ndash while saber is off click the AUX buttonPrevious preset ndash hold AUX button and click the Activation buttonTrigger Clash ndash while saber is on hit the bladeTrigger Lockup ndash while saber is on hold Activation button then trigger a clash Lockup releases when you let go of the Acti-vation buttonTrigger Drag ndash like lockup but point saber mostly down before holding Activation buttonTrigger Force ndash long-click AUX buttonStart soundtrack ndash long-click the Activation buttonTrigger Blaster Block ndash while saber is on short-click AUX button

Serial Monitor commands

battery_voltage ndash gets current battery voltage valueget_volume ndash get current volume valuepow ndash power OnOff the saberon ndash power On the saberoff ndash power Off the saberset_volume lt0-3000gt ndash set volume value (example set_volume 500)play ndash play the default preset trackplay trackslttrack namegt ndash play a specific track from tracks folder (example play tracksvenuswav)stop ndash stop the playing trackforce ndash play ldquoforcerdquo sound effectsdrag ndash play ldquodragrdquo sound effectsblast ndash play ldquoblasterrdquo sound effectslock ndash play ldquolockuprdquo sound effectsclash ndash play ldquoclashrdquo sound effectsreset ndash reboot the boardn ndash switch to next presetp ndash switch to previous presetlist_presets ndash show all presetssdtest ndash test SD card speed

40 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3FIRMWARE UPLOAD AND UPDATE2

Software installation and setup

PROFFIEBOARD INSTRUCTIONS

To upload firmware to ProffieBoard Arduino IDE program is required Follow these steps to install it to your PC

1 Install latest Arduino IDE software (donrsquot use BETA)

Installing as Windows app also is not recommended

because it will be installed in a specific protected folder that

wonrsquot allow you to install any additional softwareplugin in it

If ProffieBoard wonrsquot show up in COM port use

Arduino IDE 186 version

2 Install the Proffieboard Arduino Plugin and Zadig software

Follow installation instructions

3 Select Proffieboard-STM32L433 in Tools -gt Board

USB Type ndash Serial CPU Speed ndash 80 MHz Optimize ndash Smallest Code DOSFS ndash SDCARD (SPI) Port ndash COM(the number your PC assigned) (Butterfly-L433CC)

Connect Proffieboard via USB cable to PC to be able to select

the Port

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 41

3FIRMWARE UPLOAD AND UPDATE2

Uploading firmware

PROFFIEBOARD INSTRUCTIONS

1 Download the ProffieBoard firmware and SD card content

Unzip lightsaber-1286zip to your Documents directory or to

Desktop but not to Arduino program folder or anywhere in

Programs directory where all programs are installed You will

see a lightsaber folder and files inside it Donrsquot move any of

these files to any other location outside the lightsaber folder

and donrsquot reorganize them Unzip ProffieOS_SD_Cardzip to the

folder where you keep lightsaber-1286 folder Copy all files

from ProffieOS_SD_Card folder to your SD card

2 Unhide file extensions in File Explorer settings to see h ending

of config files Donrsquot add ldquohrdquo to the config file name Go to config folder and create you own configh file (see page

42 for how-to)

Double-click the lightsaberino file

3 Add the name of your configh file as shown and Save this

lightsaberino file Make sure the other config files are

commented out there should be only one CONFIG_FILE

without You can have multiple config files

in lightsabergtconfig folder and just define the one you need

in lightsaberino file and upload it again to ProffieBoard

4 Connect battery to ProffieBoard and hook up to your PC

with a data transfer micro-USB-to-USB cable

Press arrow button it will compile and upload firmware to the

board Wait for red text progress bars to stop at 100

ProffieBoard will play boot sound if speaker is connected

Now you can unplug the USB cable Done

If it gives an error instead this means your configh file has

issues define CONFIG_FILE name has mistakes configh file

is out of config folder your PC user name is non-latin

42 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

33

configh file structure editing

PROFFIEBOARD INSTRUCTIONS

CHANGING PARAMETERS

All sound files (sound fonts music tracks) are stored on the micro SD card Add required sound fonts folders (Plecter NEC and Smoothswing

fonts are supported no need to change WAV files names just copy and paste) to SD card root directory as itrsquos done in the default

ProffieOS_SD_Card content folder and music tracks to the tracks folder

Make sure to name all music tracks and sound fonts folders with latin characters and only up to 8 characters long without using any special

characters (like |[- etc)

Make sure you have a configini file in each sound font folder if there is none - copy one from some default TeensySaberProffieBoard sound

font and paste into newly added sound font folder It has only one parameter that you can modify - humstart It helps to match hum sound

start with blade ignition 1000 usually works fine

All blade effects LED configuration volume level clash sensitivity etc are changed in the configh file located in lightsabergtconfig folder

To do that open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text Editor (Notepad - to see code correctly in Notepad

Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all text) and Delete it then Copy-and-Paste (Ctrl+C

Ctrl+V) your wiring diagram config code into empty _configh file and Save it under new name Follow the instructions on page 39 to

upload it to the board

Proffieboard config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)

volume level (0-3000)

clash sensitivity (adjust lower or higher with 01 step)

sound font folder nametrack name

Preset name

Blade style

LED configuration (use these XP-E2 LED templatesto define your LED)

for Red use 1 Ohm resistor for Green - no resistor for Blue use 024 Ohm

NoLED ndash no 4th led used

Preset 1

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 43

33

Blade Styles

StylePtrltInOutHelperltSimpleClashltLockupltBlastltOnSparkltAudioFlickerltRgblt02550gtRgblt501000gtgtRgblt2552550gt150gtRgblt255500gtgtAudioFlickerltRgblt1002550gtRgblt2550150gtgtgtRgblt255100150gt40gt200300Blackgtgt

ndash this is how the Blade Style code looks pasted in the configh file Preset (it sits inside a StylePtrltgt container)

ndash this is how the Blade Style code looks when editing it inside a Blade Style Editor

Each Blade Style is made of a variety of Effects each added effect goes instead of a base color in the previous effect

PROFFIEBOARD INSTRUCTIONS

CHANGING PARAMETERS

ProffieBoard and TeensySaber use Blade Styles for the main saber blade and any other accent leds to define all light effects (color changing

flashes flickering delays ignitionretraction timing etc)

Use Blade Style Editor to create and adjust Blade Styles Megtooth Sith Sabers did a great video tutorial where he shows and explains

how to use Blade Style Editor Also you can grab some pre-made Blade Styles or share yours here on TRA forums

A Blade Style example of simple flickering Green blade with Spark on start Clash Blaster Lockup and Drag IgnitionRetraction effects

InOutHelperltSimpleClashltLockupltBlastltOnSparkltAudioFlickerltRgblt02550gtRgblt501000gtgtRgblt2552550gt150gtRgblt255500gtgtAudioFlickerltRgblt1002550gtRgblt2550150gtgtgtRgblt255100150gt40gt200300Blackgt

InOutHelperltbase color200300Blackgt ndash base color can be defined by words (WHITE RED GREEN PURPLE etc) or by Rgblt0-2550-2550-255gt values for more

custom shades 200 is extension length in milliseconds 300 is retraction length in milliseconds Black is color when retracted (also can be any other color)

SimpleClashltbase colorclash color40gt ndash clash effect 40 is clash duration in milliseconds

Lockupltbase colorlockup colorgt ndash lockup effect

Blastltbase colorblast colorgt ndash blaster effect

OnSparkltbase colorspark color150gt ndash spark on ignition effect 150 is spark duration in milliseconds

AudioFlickerltrdquoArdquo colorrdquoBrdquo colorgt ndash flickering effect (blade flickers to the actual saber hum sound) the more difference between ldquoArdquo and ldquoBrdquo colors - the more

abrupt is flickering

Rgblt255500gt ndash actual color in RGB format (0 is no light 255 is the maximum brightness value for Red Green or Blue channel)

44 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

ndash SanDisk 4GB microSDHC Class 4 (Genuine) ndash SanDisk 4GB microSDHC Class 4 (Genuine)

130238 kbs = 1477 simultaneous audio streams 137812 kbs = 1562 simultaneous audio streams

ndash Patriot LX Series 16GB microSDHC UHS-IU1 Class 10 ndash Patriot LX Series 16GB microSDHC UHS-IU1 Class 10

133005 kbs = 1508 simultaneous audio streams

ndash GSkill 16GB microSDHC UHS-IU1 Class 10 ndash GSkill 16GB microSDHC UHS-IU1 Class 10

129534 kbs = 1469 simultaneous audio streams

ndash Kingston 16GB microSDHC UHS-IU1 Class 10 ndash Kingston 16GB microSDHC UHS-IU1 Class 10

128090 kbs = 1452 simultaneous audio streams

ndash SanDisk Ultra 16GB microSDHC UHS-IU1 A1 Class 10 ndash SanDisk Ultra 16GB microSDHC UHS-IU1 A1 Class 10

102663 kbs = 1164 simultaneous audio streams 11124 kbs = 1261 simultaneous audio streams

ndash SanDisk 8GB microSDHC Class 4 ndash SanDisk 8GB microSDHC Class 4

108506 kbs = 1230 simultaneous audio streams

ndash SanDisk 16GB microSDHC Class 4 ndash SanDisk 16GB microSDHC Class 4

102663 kbs = 1164 simultaneous audio streams 106957 kbs = 1213 simultaneous audio streams

ndash SanDisk Ultra 16GB microSDHC UHS-IU1 Class 10 ndash SanDisk Ultra 16GB microSDHC UHS-IU1 Class 10

102663 kbs = 1164 simultaneous audio streams 103909 kbs = 1178 simultaneous audio streams

ndash Smartbuy 4GB microSDHC Class 4 ndash Smartbuy 4GB microSDHC Class 4

75437 kbs = 855 simultaneous audio streams

ndash Kingston 8GB microSDHC Class 4 ndash Kingston 8GB microSDHC Class 4

75209 kbs = 822 simultaneous audio streams

ndash SanDisk 4GB microSDHC Class 4 (Fake) ndash SanDisk 4GB microSDHC Class 4 (Fake)

677 kbs = 769 simultaneous audio streams

Here is a list of tested micro SD cards speed with TeensySaber V3 and ProffieBoard Any card with speed over 900 kbs is recommended the

higher the speed is ndash the better Memory size of 4-16Gb is more than enough Cards were tested with a default firmware (1291) compiled

with ldquoSmallest Coderdquo under Optimize ldquodefault_proffieboard_confighrdquo file and default ProffieOS SD card sound files (7 folders)

To test your SD card speed simply hook up ProffieBoard to PC open Arduino IDE go to Tools and open Serial Monitor make sure you have

New Line and 9600 baud rate selected on the bottom of Serial Monitor window type and send sdtest command wait for the test result

4Recommended micro SD cards

BEST

TEENSYSABER PROFFIEBOARD

GOOD

BAD

PROFFIEBOARD INSTRUCTIONS

SD CARD RECOMMENDATIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 45

There are a lot of fake (chinese copies) microSD cards on the market from aliexpress ebay amazon etc They look very similar to genuine

cards but are a bit different though and have a twice lower writingreading speed Here is an example of a SanDisk 4Gb Class 4 card one is

genuine with 137812 kbs speed and the other one is fake with 677 kbs speed I got from ebay seller

Be carefull and pay attention to how the actual card looks if you are not sure ask seller for the real photo of SD card he sells

4Genuine and Fake SanDisk 4Gb Class 4 microSD

PROFFIEBOARD INSTRUCTIONS

SD CARD RECOMMENDATIONS

46 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

WIRE GAUGE GUIDE

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 47

RECHARGE PORTS AND KILL SWITCHES

48 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

NEOPIXEL STRIPS CURRENT DRAW

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 49

6TROUBLESHOOTING

For more help please check these linksProffieOSProffieBoardTeensySaber wiki on GitHubAsk your question on The Rebel Armory forumsAsk your question on FX-sabers forumsAsk your question in facebook group

How to solve most common issues

Quick troubleshooting tips

TeensySaber board or Proffieboard is not recognized by computer (nothing under Port selection in Arduino)

ndash Make sure a charged 37V battery is connected to the board micro-USB cable is a data transfer cable all plugins and drivers are installed ndash

check again pages 21 for TeensySaber or 40 for Proffieboard Try a different USB port on your computer

Sketch (code) compile error in Arduino IDE

ndash Check your define CONFIG_FILE ldquoconfig_confighrdquo line in opened lightsaberino file if itrsquos written correctly with config in it

Sketch (code) compile error in Arduino IDE

ndash Check if the _configh file you defined in the lightsaberino sketch file is same name as in the lightsaber-rdquofirmware versionrdquolightsaber

config folder and is located in this folder

Sketch (code) compile error in Arduino IDE

ndash Check your settings under Tools tab in Arduino IDE program Check again pages 21 for TeensySaber or 40 for Proffieboard

Sketch (code) compile error in Arduino IDE

ndash Check if your _configh file is correct Blade Styles Presets const unsigned int maxLedsPerStrip = 144 if BladeConfig blades[] = is correct

Sketch (code) compile error in Arduino IDE

ndash If nothing helps install Arduino IDE version 186 and try to compile and upload the firmware again

Sound doesnrsquot play

ndash Remove SD card and insert again check speaker wiring Make sure all sound files on SD card are correctly named (8 characters max long)

Re-format SD card in FAT32 load sound files and try again try another SD card

Board says ldquoLOW POWERrdquo

ndash Charge the battery

Serial Monitor shows info sent by the board but your commands donrsquot work

ndash In the bottom right corner of Serial Monitor window make sure the Line Ending drop down is set to New Line

Sound is weird and distorted

ndash Check your SD card speed (see page 44) Check speaker wiring try another good speaker

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 23

2TEENSYSABER V3 INSTRUCTIONS

CHANGING PARAMETERS3

Changing sound board parameters

All sound files (sound fonts music tracks) are stored on the micro SD card Add required sound fonts folders (Plecter NEC and Smoothswing

fonts are supported no need to change WAV files names just copy and paste) to SD card root directory as itrsquos done in the default

ProffieOS_SD_Card content folder and music tracks to the tracks folder

Make sure to name all music tracks and sound fonts folders with latin characters and only up to 8 characters long without using any special

characters (like |[- etc)

Make sure you have a configini file in each sound font folder if there is none - copy one from some default TeensySaberProffieBoard sound

font and paste into newly added sound font folder It has only one parameter that you can modify - humstart It helps to match hum sound

start with blade ignition 1000 usually works fine

All blade effects LED configuration volume level clash sensitivity etc are changed in the configh file located in lightsabergtconfig folder

To do that open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text Editor (Notepad - to see code correctly in Notepad

Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all text) and Delete it then Copy-and-Paste (Ctrl+C

Ctrl+V) your wiring diagram config code into empty _configh file and Save it under new name Follow the instructions on page 22 to

upload it to the board

TeensySaber V3 config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)

volume level (0-3000)

clash sensitivity (adjust lower or higher with 01 step)

sound font folder nametrack name

Preset name

Blade style

LED configuration (use these XP-E2 LED templatesto define your LED)

for Red use 1 Ohm resistor for Green - no resistor for Blue use 024 Ohm

NoLED ndash no 4th led used

Preset 1

24 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

31

PROFFIEBOARD INSTRUCTIONS

Whatrsquos needed

ndash ProffieBoard

ndash micro SD-card (see page 44 for recommendations)

ndash a USB micro SD-card reader (to load sound files from PC to micro SD card)

ndash micro USB data transfer cable (CABLES THAT SUPPORT ONLY CHARGING WONrsquoT WORK)

ndash wires of different gauges (32-20 AWG) (PTFE coated copper stranded wires recommended) heat shrink

ndash ESD safe soldering station solder wire flux etc

ndash pliers helping hands etc

ndash isopropyl alcohol to clean pads before soldering (helps solder to stick better)

ndash Digital Multimeter (VERY USEFUL)

ndash computer running Windows Linux or Mac OS with internet access

ndash 37V Li-Ion Protected rechargeable battery switches recharge port speaker LEDs resistors chassis etc

ndash Smart Li-Ion CC-CV (Constant Current - Constant Voltage mode) battery charger for 37V (42V) cells

ndash patience

WIRING DIAGRAMS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 25

31

PROFFIEBOARD INSTRUCTIONS

Board pinout

Battery + ndash 26 to 45 volt input drives everything except the LEDs

Battery - ndash negative pad for LEDs needs to be at same level as GND when both are connected Both pads are internally connected

GND ndash ground for electronics except LEDs Note that there are two GND pads on the board that are internally connected

Speaker +- ndash hooks up to speaker

Activation (1) Aux (2) Aux2 button (3) ndash hook up to closing buttons or potentially touch buttons

Blade ID Neopixel Data 1 ndash normally used to measure the blade ID restor and if itrsquos a neopixel blade feed out neopixel data

Data 2 3 4 5 ndash additional neopixel data outputs or free for other purposes

LED 1 2 3 4 5 6 ndash hooks up to negative side of LED (positive side of LED hooks up directly to battery) These pads can handle

up to 30 volts

SDA SCL ndash these pins are used to wire OLED display or to communicate with the gyro and accelerometer chip

RX TX ndash these pins are used for wiring a bluetooth module for wireless control

SWDCLK SWDIO ndash can be hooked up to a ST-LINK device and lets you debug programs running on the ProffieBoard

+5V ndash generated by the ProffieBoard normally itrsquos only ON when sound is playing

+33V ndash generated by the ProffieBoard for powering OLED display Bluetooth module or some accent leds

BOOT RESET ndash buttons to put the ProffieBoard in bootloader mode if uploading doesnrsquot work

micro USB port ndash micro USB port used only for firmware upload and can be used for sound files upload to SD card (from firmware version

1291 and up) THIS PORT ISNrsquoT USED FOR CHARGING THE BATTERY

LED 4LED 3

LED 2

LED 1

LED 5

LED 6

RESETBOOT

Battery - Battery -

Speaker + (red dot or ldquo+rdquo mark on speaker)

Battery +

Aux button (2)Activation button (1)

Aux2 button (3)

Blade ID Neopixel Data 1

Data 5

Data 4Data 3Data 2

+33V

SWDIO

SWDCLK

+5V

TXRX

GND

GND

Reset

Speaker -

SCLSDA

micro USB port

WIRING DIAGRAMS

26 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Basic Tri-Cree wiring diagram(In-hilt LED)

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

+

+

-

-

26 AWG

26 A

WG

30-32 AWG

28-30 AWG

28-3

0 A

WG

30-32 AWG

Protected 36-37V (42V max at full charge) 10A 3500mAh battery recommended+18650 battery holder (optional)Keystone 1042P

AV switch with accent led(constantly ON no effects)

accent leds run mostly at10-15mA so resistors for them must be calculated accordingly

Main RGB led

additional RGB leds(optional)

In case no additional high power leds are needed LED channels 4 5 6 can be used for 3 controllable(programmable for different effects) accent leds So AV switch led can be wired to one of these channelsAccent leds also can be wired to Data pads 1-5 please see ldquoAccent LEDs wiring and setuprdquo page

LED Resistor Calculator

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 27

3WIRING DIAGRAMS1

Basic Tri-Cree wiring (In-hilt LED)ldquoconfighrdquo file setup

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

Use a given or build your wiring diagram on THIS PAGE then open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text

Editor (Notepad - to see code correctly in Notepad Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all

text) and Delete it then Copy-and-Paste (Ctrl+C Ctrl+V) your wiring diagram config code (example below) into empty _configh file and

Save it under new name Follow the instructions on page 22 to upload it to the board

ldquoproffieboard_v1_confighrdquoNUM_BLADES 2NUM_BUTTONS 2VOLUME 1000CLASH_THRESHOLD_G 10StyleNormalPtrltCYAN WHITE 300 800gt()StyleNormalPtrltCYAN WHITE 300 800gt()

CreeXPE2RedTemplatelt1000gtCreeXPE2GreenTemplatelt0gtCreeXPE2BlueTemplatelt240gtNoLED

ProffieBoard config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)Volume level (0-3000)Clash sensitivity (adjust lower or higher with 01 step)ldquoBlade 1rdquo styleldquoBlade 2rdquo style (in case only 1 blade is used you donrsquot need this line)LED configuration (use these XP-E2 LED templatesto define your LED If other LED resistors are used change these values to match Ohm1000=ltvaluegt)

where 1000 is 1 Ohm resistor 0 is no resistor240 is 024 Ohm resistorNoLED ndash no 4th led used

Preset 1

LED 1 configuration

LED 2 configuration

Preset 2 etc

PROFFIEBOARD INSTRUCTIONS

28 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Basic Neopixel wiring diagram

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

+

+

-

-

22 A

WG

22 AWG

x2 28 AWG

x2 26 AWG

22 A

WG

30-32 AWG30-32 AWG

Protected 36-37V (42V max at full charge) 10A 3500mAh or 15A 3120mAhbattery recommended+18650 battery holder (optional)Keystone 1042P

AV switch with accent led(constantly ON no effects)

accent leds run mostly at10-15mA so resistors for them must be calculated accordingly

Main Neopixel strip

additional Neopixelstrips(optional)

Neopixel bladeconnector

330 Ohm on the Blade pcb side

x3 28 AWGor x1 22 AWGfor Negative

330 Ohm on the Blade pcb side

arrows up

330 Ohm on the Blade pcb side

In case no additional Neopixel strips are needed LED channels 4 5 6 can be used for 3 controllable(programmable for different effects) accent leds So AV switch led can be wired to one of these channelsAccent leds also can be wired to Data pads 2-5 please see ldquoAccent LEDs wiring and setuprdquo page

Recommended power wire gauges (22 AWG) are given for 2-strip blade For 3-strip blade you gonna need at least 20 AWG wires

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 29

ldquoproffieboard_v1_confighrdquo

3WIRING DIAGRAMS1

Basic Neopixel wiringldquoconfighrdquo file setup

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

NUM_BLADES 3NUM_BUTTONS 2VOLUME 1000CLASH_THRESHOLD_G 10IgnitionDelaylt0 any blade stylegtIgnitionDelaylt800 any blade stylegtIgnitionDelaylt800 any blade stylegtWS2811BladePtrlt118 WS2811 800kHz | WS2811 GRBgt()WS2811BladePtrlt26 blade2Pin ltbladePowerPin4gtgt()WS2811BladePtrlt26 blade3Pin ltbladePowerPin5gtgt()

ProffieBoard config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)Volume level (0-3000)Clash sensitivity (adjust lower or higher with 01 step)ldquoBlade 1rdquo style (main blade with IgnitionDelay 0)ldquoBlade 2rdquo style (CG blade 1 with IgnitionDelay 800)ldquoBlade 3rdquo style (CG blade 2 with IgnitionDelay 800)

strip configuration (defines how many pixels it has and to which LED output and pin is wired)

Preset 1

any blade style

strip (blade) 1 configuration

adjust this number to match your strips leds count

strip (blade) 2 configuration

strip (blade) 3 configuration

Preset 2 etc

Use a given or build your wiring diagram on THIS PAGE then open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text

Editor (Notepad - to see code correctly in Notepad Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all

text) and Delete it then Copy-and-Paste (Ctrl+C Ctrl+V) your wiring diagram config code (example below) into empty _configh file and

Save it under new name Follow the instructions on page 22 to upload it to the board

PROFFIEBOARD INSTRUCTIONS

30 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Basic Segmented string wiring diagram

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

+

+

-

-

24 A

WG

28 AWG

30-32 AWG30-32 AWG

Protected 36-37V (42V max at full charge) 10A 3500mAh battery recommended+18650 battery holder (optional)Keystone 1042P

AV switch with accent led(constantly ON no effects)

accent leds run mostly at10-15mA so resistors for them must be calculated accordingly

6-segments string blade

FoC string

N-channel FET3A minimum

123456

Calculate resistors for each led segment of the blade string depending on which leds are used 5mm leds have max drive current around 25mA per led when 10mm leds can be 100mA and 200mA per ledSo pay attention to your led max current and Forward Voltage (Vf) when calculating a segment resistor resistence as well as its wattage Also choose wire gauges accordingly to meet segments and total blade max current draw level

LED Resistor Calculator

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 31

ldquoproffieboard_v1_confighrdquo

3WIRING DIAGRAMS1

Basic Segmented string wiringldquoconfighrdquo file setup

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

NUM_BLADES 1NUM_BUTTONS 2VOLUME 1000CLASH_THRESHOLD_G 10StyleNormalPtrltCYAN WHITE 300 800gt()ltBlue3mmLED BladePin White3mmLEDgt

ProffieBoard config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)Volume level (0-3000)Clash sensitivity (adjust lower or higher with 01 step)Blade styleLED string configuration(here you mention the color and type of leds usedin the main blade string segments and FoC stringBladePin is the FoC signal pin (Blade ID pin))

Preset

LED string configuration

Use a given or build your wiring diagram on THIS PAGE then open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text

Editor (Notepad - to see code correctly in Notepad Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all

text) and Delete it then Copy-and-Paste (Ctrl+C Ctrl+V) your wiring diagram config code (example below) into empty _configh file and

Save it under new name Follow the instructions on page 22 to upload it to the board

PROFFIEBOARD INSTRUCTIONS

32 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Accent LEDs wiring diagram(optional)

Accent LEDs work with ProffieBoard as additional ldquobladesrdquo when powered by LED outputs 4 5 6 or Data pads 1 2 3 5 as PWM So they can

have any effect that blade can have If no effects needed accent led can be powered just by a 33V output pad (power-on led indication)

30-32 AWG

with Neopixel blade setup these 4 outputsdonrsquot work for regular accent leds

Recommended resistors to use for accent leds at 33V power source and 15mA drive

ndash 100 Ohm for Red (lt100000gt value in the code)ndash 13 Ohm for Green (lt13000gt value in the code)ndash 13 Ohm for Blue (lt13000gt value in the code)ndash 100 Ohm for Yellow (lt100000gt value in the code)ndash 20 Ohm for White (lt20000gt value in the code)

RGB ledcommon-anode

8 ldquobladesrdquo1 main and 7 accent leds

main blade style (effects) main blade style (effects)

7 accent leds style (effects)accent led style (effects)

7 accent leds configurations

RGB accent led configuration

2 ldquobladesrdquo1 main and 1 RGB accent led

ldquoPower-onrdquo indicationaccent leds (no effects)

7 accent leds withindependent effects

RGB accent led

a) b)

b)

c)

c)

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 33

3WIRING DIAGRAMS1

Neopixel Accent LEDs wiring diagram(optional)

With Neopixel setup additional neopixel leds or arrays can be used as accent leds There are 2 ways to wire them using additional Data

pins 2 3 4 5 or ldquoSub-bladesrdquo wiring with just 1 Data output pin Same way Neopixel connectors with on-board leds ca be wired

Option 1 ndash with extra Data pins

Main Blade

some accent leds

D1

D2

crystal leds

330 Ohm

330 Ohm

330 Ohm

main blade style (effects)

main blade 144 leds Data pin 1

accent leds blade style (effects)

accent leds ldquobladerdquo 4 leds Data pin 2

crystal leds blade style (effects)

crystal leds ldquobladerdquo 2 leds Data pin 3

3 ldquobladesrdquo1 main 1 accent leds array and 1 crystal leds array

PROFFIEBOARD INSTRUCTIONS

D3

follow arrows direction

34 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Neopixel Accent LEDs wiring diagram(optional)

PROFFIEBOARD INSTRUCTIONS

Main Blade

some accent leds

1

3

5678

2

4

D1

crystal leds

follow arrows direction

330 Ohm

330 OhmData signal

With this setup a single array of neopixel leds is separated into a couple of sub-blades with their own style configuration and behaviour This

is really usefull when you want to use only one data pin More about ldquoSub-bladesrdquo on ProffieOS wiki page

Option 2 ndash with ldquoSub-bladesrdquo

main blade style (effects)

main blade sub-blade 140 leds (7-146) but from 6 to 145 in the code

accent leds blade style (effects)

accent leds sub-blade 4 leds (1-4) but from 0 to 3 in the code

crystal leds blade style (effects)

146 leds total used

crystal leds sub-blade 2 leds (5-6) but from 4 to 5 in the code

update default 144 to a higher total value if you get all accent leds +Main blade gt 144 Example update to 146 if you have 2 crystal leds +4 accent leds + 140 Main blade leds = 146

3 ldquobladesrdquo 1 main 1 accent leds array and 1 crystal leds array

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 35

3WIRING DIAGRAMS1

OLED display wiring diagram(optional)

SSD1306 128x32 pixels OLED display allows to show battery level current preset name play different animations and even simple games It

can be wired to any blade configuration and requires just one additional line in the code to work You can get monochrome display in white

or blue color

SSD1306128x32OLED

SSD1306 ndash with blue or white display color selectSSD1306 ndash cheaper priceSSD1306 just screen ndash blue or white select

30-32 AWG

30-32 AWG

add this line to enable OLED display

display shows a preset name written in these quotes ldquoldquo

PROFFIEBOARD INSTRUCTIONS

36 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Bluetooth module wiring diagram(optional)

SOON

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 37

3WIRING DIAGRAMS1

Blade ID resistor functions(optional)

SOON

PROFFIEBOARD INSTRUCTIONS

38 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

website ProffieBoard FULL wiring diagrams link

Scroll the page down till you see the interactive diagram Above the diagram there are components selection options Build your saber setup

with it and follow diagram to wire your board Then you need to copy the configuration code below and paste it into your _configh file

Choose components you want

3WIRING DIAGRAMS1

More wiring diagrams

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 39

3WIRING DIAGRAMS1

How to use it

PROFFIEBOARD INSTRUCTIONS

Blade ignitionretraction ndash assuming you have at least one button pressing it briefly should turn the saber on or off If you have an AUX button pressing it briefly should also turn the saber on and off If you have no buttons you can turn the saber on and off by twisting your wrist back and forth Note that the motion has to be done long enough to count so a very quick flick of the wrist will not workTurn On muted ndash double-click power buttonNext preset ndash while saber is off click the AUX buttonPrevious preset ndash hold AUX button and click the Activation buttonTrigger Clash ndash while saber is on hit the bladeTrigger Lockup ndash while saber is on hold Activation button then trigger a clash Lockup releases when you let go of the Acti-vation buttonTrigger Drag ndash like lockup but point saber mostly down before holding Activation buttonTrigger Force ndash long-click AUX buttonStart soundtrack ndash long-click the Activation buttonTrigger Blaster Block ndash while saber is on short-click AUX button

Serial Monitor commands

battery_voltage ndash gets current battery voltage valueget_volume ndash get current volume valuepow ndash power OnOff the saberon ndash power On the saberoff ndash power Off the saberset_volume lt0-3000gt ndash set volume value (example set_volume 500)play ndash play the default preset trackplay trackslttrack namegt ndash play a specific track from tracks folder (example play tracksvenuswav)stop ndash stop the playing trackforce ndash play ldquoforcerdquo sound effectsdrag ndash play ldquodragrdquo sound effectsblast ndash play ldquoblasterrdquo sound effectslock ndash play ldquolockuprdquo sound effectsclash ndash play ldquoclashrdquo sound effectsreset ndash reboot the boardn ndash switch to next presetp ndash switch to previous presetlist_presets ndash show all presetssdtest ndash test SD card speed

40 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3FIRMWARE UPLOAD AND UPDATE2

Software installation and setup

PROFFIEBOARD INSTRUCTIONS

To upload firmware to ProffieBoard Arduino IDE program is required Follow these steps to install it to your PC

1 Install latest Arduino IDE software (donrsquot use BETA)

Installing as Windows app also is not recommended

because it will be installed in a specific protected folder that

wonrsquot allow you to install any additional softwareplugin in it

If ProffieBoard wonrsquot show up in COM port use

Arduino IDE 186 version

2 Install the Proffieboard Arduino Plugin and Zadig software

Follow installation instructions

3 Select Proffieboard-STM32L433 in Tools -gt Board

USB Type ndash Serial CPU Speed ndash 80 MHz Optimize ndash Smallest Code DOSFS ndash SDCARD (SPI) Port ndash COM(the number your PC assigned) (Butterfly-L433CC)

Connect Proffieboard via USB cable to PC to be able to select

the Port

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 41

3FIRMWARE UPLOAD AND UPDATE2

Uploading firmware

PROFFIEBOARD INSTRUCTIONS

1 Download the ProffieBoard firmware and SD card content

Unzip lightsaber-1286zip to your Documents directory or to

Desktop but not to Arduino program folder or anywhere in

Programs directory where all programs are installed You will

see a lightsaber folder and files inside it Donrsquot move any of

these files to any other location outside the lightsaber folder

and donrsquot reorganize them Unzip ProffieOS_SD_Cardzip to the

folder where you keep lightsaber-1286 folder Copy all files

from ProffieOS_SD_Card folder to your SD card

2 Unhide file extensions in File Explorer settings to see h ending

of config files Donrsquot add ldquohrdquo to the config file name Go to config folder and create you own configh file (see page

42 for how-to)

Double-click the lightsaberino file

3 Add the name of your configh file as shown and Save this

lightsaberino file Make sure the other config files are

commented out there should be only one CONFIG_FILE

without You can have multiple config files

in lightsabergtconfig folder and just define the one you need

in lightsaberino file and upload it again to ProffieBoard

4 Connect battery to ProffieBoard and hook up to your PC

with a data transfer micro-USB-to-USB cable

Press arrow button it will compile and upload firmware to the

board Wait for red text progress bars to stop at 100

ProffieBoard will play boot sound if speaker is connected

Now you can unplug the USB cable Done

If it gives an error instead this means your configh file has

issues define CONFIG_FILE name has mistakes configh file

is out of config folder your PC user name is non-latin

42 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

33

configh file structure editing

PROFFIEBOARD INSTRUCTIONS

CHANGING PARAMETERS

All sound files (sound fonts music tracks) are stored on the micro SD card Add required sound fonts folders (Plecter NEC and Smoothswing

fonts are supported no need to change WAV files names just copy and paste) to SD card root directory as itrsquos done in the default

ProffieOS_SD_Card content folder and music tracks to the tracks folder

Make sure to name all music tracks and sound fonts folders with latin characters and only up to 8 characters long without using any special

characters (like |[- etc)

Make sure you have a configini file in each sound font folder if there is none - copy one from some default TeensySaberProffieBoard sound

font and paste into newly added sound font folder It has only one parameter that you can modify - humstart It helps to match hum sound

start with blade ignition 1000 usually works fine

All blade effects LED configuration volume level clash sensitivity etc are changed in the configh file located in lightsabergtconfig folder

To do that open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text Editor (Notepad - to see code correctly in Notepad

Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all text) and Delete it then Copy-and-Paste (Ctrl+C

Ctrl+V) your wiring diagram config code into empty _configh file and Save it under new name Follow the instructions on page 39 to

upload it to the board

Proffieboard config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)

volume level (0-3000)

clash sensitivity (adjust lower or higher with 01 step)

sound font folder nametrack name

Preset name

Blade style

LED configuration (use these XP-E2 LED templatesto define your LED)

for Red use 1 Ohm resistor for Green - no resistor for Blue use 024 Ohm

NoLED ndash no 4th led used

Preset 1

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 43

33

Blade Styles

StylePtrltInOutHelperltSimpleClashltLockupltBlastltOnSparkltAudioFlickerltRgblt02550gtRgblt501000gtgtRgblt2552550gt150gtRgblt255500gtgtAudioFlickerltRgblt1002550gtRgblt2550150gtgtgtRgblt255100150gt40gt200300Blackgtgt

ndash this is how the Blade Style code looks pasted in the configh file Preset (it sits inside a StylePtrltgt container)

ndash this is how the Blade Style code looks when editing it inside a Blade Style Editor

Each Blade Style is made of a variety of Effects each added effect goes instead of a base color in the previous effect

PROFFIEBOARD INSTRUCTIONS

CHANGING PARAMETERS

ProffieBoard and TeensySaber use Blade Styles for the main saber blade and any other accent leds to define all light effects (color changing

flashes flickering delays ignitionretraction timing etc)

Use Blade Style Editor to create and adjust Blade Styles Megtooth Sith Sabers did a great video tutorial where he shows and explains

how to use Blade Style Editor Also you can grab some pre-made Blade Styles or share yours here on TRA forums

A Blade Style example of simple flickering Green blade with Spark on start Clash Blaster Lockup and Drag IgnitionRetraction effects

InOutHelperltSimpleClashltLockupltBlastltOnSparkltAudioFlickerltRgblt02550gtRgblt501000gtgtRgblt2552550gt150gtRgblt255500gtgtAudioFlickerltRgblt1002550gtRgblt2550150gtgtgtRgblt255100150gt40gt200300Blackgt

InOutHelperltbase color200300Blackgt ndash base color can be defined by words (WHITE RED GREEN PURPLE etc) or by Rgblt0-2550-2550-255gt values for more

custom shades 200 is extension length in milliseconds 300 is retraction length in milliseconds Black is color when retracted (also can be any other color)

SimpleClashltbase colorclash color40gt ndash clash effect 40 is clash duration in milliseconds

Lockupltbase colorlockup colorgt ndash lockup effect

Blastltbase colorblast colorgt ndash blaster effect

OnSparkltbase colorspark color150gt ndash spark on ignition effect 150 is spark duration in milliseconds

AudioFlickerltrdquoArdquo colorrdquoBrdquo colorgt ndash flickering effect (blade flickers to the actual saber hum sound) the more difference between ldquoArdquo and ldquoBrdquo colors - the more

abrupt is flickering

Rgblt255500gt ndash actual color in RGB format (0 is no light 255 is the maximum brightness value for Red Green or Blue channel)

44 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

ndash SanDisk 4GB microSDHC Class 4 (Genuine) ndash SanDisk 4GB microSDHC Class 4 (Genuine)

130238 kbs = 1477 simultaneous audio streams 137812 kbs = 1562 simultaneous audio streams

ndash Patriot LX Series 16GB microSDHC UHS-IU1 Class 10 ndash Patriot LX Series 16GB microSDHC UHS-IU1 Class 10

133005 kbs = 1508 simultaneous audio streams

ndash GSkill 16GB microSDHC UHS-IU1 Class 10 ndash GSkill 16GB microSDHC UHS-IU1 Class 10

129534 kbs = 1469 simultaneous audio streams

ndash Kingston 16GB microSDHC UHS-IU1 Class 10 ndash Kingston 16GB microSDHC UHS-IU1 Class 10

128090 kbs = 1452 simultaneous audio streams

ndash SanDisk Ultra 16GB microSDHC UHS-IU1 A1 Class 10 ndash SanDisk Ultra 16GB microSDHC UHS-IU1 A1 Class 10

102663 kbs = 1164 simultaneous audio streams 11124 kbs = 1261 simultaneous audio streams

ndash SanDisk 8GB microSDHC Class 4 ndash SanDisk 8GB microSDHC Class 4

108506 kbs = 1230 simultaneous audio streams

ndash SanDisk 16GB microSDHC Class 4 ndash SanDisk 16GB microSDHC Class 4

102663 kbs = 1164 simultaneous audio streams 106957 kbs = 1213 simultaneous audio streams

ndash SanDisk Ultra 16GB microSDHC UHS-IU1 Class 10 ndash SanDisk Ultra 16GB microSDHC UHS-IU1 Class 10

102663 kbs = 1164 simultaneous audio streams 103909 kbs = 1178 simultaneous audio streams

ndash Smartbuy 4GB microSDHC Class 4 ndash Smartbuy 4GB microSDHC Class 4

75437 kbs = 855 simultaneous audio streams

ndash Kingston 8GB microSDHC Class 4 ndash Kingston 8GB microSDHC Class 4

75209 kbs = 822 simultaneous audio streams

ndash SanDisk 4GB microSDHC Class 4 (Fake) ndash SanDisk 4GB microSDHC Class 4 (Fake)

677 kbs = 769 simultaneous audio streams

Here is a list of tested micro SD cards speed with TeensySaber V3 and ProffieBoard Any card with speed over 900 kbs is recommended the

higher the speed is ndash the better Memory size of 4-16Gb is more than enough Cards were tested with a default firmware (1291) compiled

with ldquoSmallest Coderdquo under Optimize ldquodefault_proffieboard_confighrdquo file and default ProffieOS SD card sound files (7 folders)

To test your SD card speed simply hook up ProffieBoard to PC open Arduino IDE go to Tools and open Serial Monitor make sure you have

New Line and 9600 baud rate selected on the bottom of Serial Monitor window type and send sdtest command wait for the test result

4Recommended micro SD cards

BEST

TEENSYSABER PROFFIEBOARD

GOOD

BAD

PROFFIEBOARD INSTRUCTIONS

SD CARD RECOMMENDATIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 45

There are a lot of fake (chinese copies) microSD cards on the market from aliexpress ebay amazon etc They look very similar to genuine

cards but are a bit different though and have a twice lower writingreading speed Here is an example of a SanDisk 4Gb Class 4 card one is

genuine with 137812 kbs speed and the other one is fake with 677 kbs speed I got from ebay seller

Be carefull and pay attention to how the actual card looks if you are not sure ask seller for the real photo of SD card he sells

4Genuine and Fake SanDisk 4Gb Class 4 microSD

PROFFIEBOARD INSTRUCTIONS

SD CARD RECOMMENDATIONS

46 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

WIRE GAUGE GUIDE

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 47

RECHARGE PORTS AND KILL SWITCHES

48 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

NEOPIXEL STRIPS CURRENT DRAW

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 49

6TROUBLESHOOTING

For more help please check these linksProffieOSProffieBoardTeensySaber wiki on GitHubAsk your question on The Rebel Armory forumsAsk your question on FX-sabers forumsAsk your question in facebook group

How to solve most common issues

Quick troubleshooting tips

TeensySaber board or Proffieboard is not recognized by computer (nothing under Port selection in Arduino)

ndash Make sure a charged 37V battery is connected to the board micro-USB cable is a data transfer cable all plugins and drivers are installed ndash

check again pages 21 for TeensySaber or 40 for Proffieboard Try a different USB port on your computer

Sketch (code) compile error in Arduino IDE

ndash Check your define CONFIG_FILE ldquoconfig_confighrdquo line in opened lightsaberino file if itrsquos written correctly with config in it

Sketch (code) compile error in Arduino IDE

ndash Check if the _configh file you defined in the lightsaberino sketch file is same name as in the lightsaber-rdquofirmware versionrdquolightsaber

config folder and is located in this folder

Sketch (code) compile error in Arduino IDE

ndash Check your settings under Tools tab in Arduino IDE program Check again pages 21 for TeensySaber or 40 for Proffieboard

Sketch (code) compile error in Arduino IDE

ndash Check if your _configh file is correct Blade Styles Presets const unsigned int maxLedsPerStrip = 144 if BladeConfig blades[] = is correct

Sketch (code) compile error in Arduino IDE

ndash If nothing helps install Arduino IDE version 186 and try to compile and upload the firmware again

Sound doesnrsquot play

ndash Remove SD card and insert again check speaker wiring Make sure all sound files on SD card are correctly named (8 characters max long)

Re-format SD card in FAT32 load sound files and try again try another SD card

Board says ldquoLOW POWERrdquo

ndash Charge the battery

Serial Monitor shows info sent by the board but your commands donrsquot work

ndash In the bottom right corner of Serial Monitor window make sure the Line Ending drop down is set to New Line

Sound is weird and distorted

ndash Check your SD card speed (see page 44) Check speaker wiring try another good speaker

24 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

31

PROFFIEBOARD INSTRUCTIONS

Whatrsquos needed

ndash ProffieBoard

ndash micro SD-card (see page 44 for recommendations)

ndash a USB micro SD-card reader (to load sound files from PC to micro SD card)

ndash micro USB data transfer cable (CABLES THAT SUPPORT ONLY CHARGING WONrsquoT WORK)

ndash wires of different gauges (32-20 AWG) (PTFE coated copper stranded wires recommended) heat shrink

ndash ESD safe soldering station solder wire flux etc

ndash pliers helping hands etc

ndash isopropyl alcohol to clean pads before soldering (helps solder to stick better)

ndash Digital Multimeter (VERY USEFUL)

ndash computer running Windows Linux or Mac OS with internet access

ndash 37V Li-Ion Protected rechargeable battery switches recharge port speaker LEDs resistors chassis etc

ndash Smart Li-Ion CC-CV (Constant Current - Constant Voltage mode) battery charger for 37V (42V) cells

ndash patience

WIRING DIAGRAMS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 25

31

PROFFIEBOARD INSTRUCTIONS

Board pinout

Battery + ndash 26 to 45 volt input drives everything except the LEDs

Battery - ndash negative pad for LEDs needs to be at same level as GND when both are connected Both pads are internally connected

GND ndash ground for electronics except LEDs Note that there are two GND pads on the board that are internally connected

Speaker +- ndash hooks up to speaker

Activation (1) Aux (2) Aux2 button (3) ndash hook up to closing buttons or potentially touch buttons

Blade ID Neopixel Data 1 ndash normally used to measure the blade ID restor and if itrsquos a neopixel blade feed out neopixel data

Data 2 3 4 5 ndash additional neopixel data outputs or free for other purposes

LED 1 2 3 4 5 6 ndash hooks up to negative side of LED (positive side of LED hooks up directly to battery) These pads can handle

up to 30 volts

SDA SCL ndash these pins are used to wire OLED display or to communicate with the gyro and accelerometer chip

RX TX ndash these pins are used for wiring a bluetooth module for wireless control

SWDCLK SWDIO ndash can be hooked up to a ST-LINK device and lets you debug programs running on the ProffieBoard

+5V ndash generated by the ProffieBoard normally itrsquos only ON when sound is playing

+33V ndash generated by the ProffieBoard for powering OLED display Bluetooth module or some accent leds

BOOT RESET ndash buttons to put the ProffieBoard in bootloader mode if uploading doesnrsquot work

micro USB port ndash micro USB port used only for firmware upload and can be used for sound files upload to SD card (from firmware version

1291 and up) THIS PORT ISNrsquoT USED FOR CHARGING THE BATTERY

LED 4LED 3

LED 2

LED 1

LED 5

LED 6

RESETBOOT

Battery - Battery -

Speaker + (red dot or ldquo+rdquo mark on speaker)

Battery +

Aux button (2)Activation button (1)

Aux2 button (3)

Blade ID Neopixel Data 1

Data 5

Data 4Data 3Data 2

+33V

SWDIO

SWDCLK

+5V

TXRX

GND

GND

Reset

Speaker -

SCLSDA

micro USB port

WIRING DIAGRAMS

26 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Basic Tri-Cree wiring diagram(In-hilt LED)

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

+

+

-

-

26 AWG

26 A

WG

30-32 AWG

28-30 AWG

28-3

0 A

WG

30-32 AWG

Protected 36-37V (42V max at full charge) 10A 3500mAh battery recommended+18650 battery holder (optional)Keystone 1042P

AV switch with accent led(constantly ON no effects)

accent leds run mostly at10-15mA so resistors for them must be calculated accordingly

Main RGB led

additional RGB leds(optional)

In case no additional high power leds are needed LED channels 4 5 6 can be used for 3 controllable(programmable for different effects) accent leds So AV switch led can be wired to one of these channelsAccent leds also can be wired to Data pads 1-5 please see ldquoAccent LEDs wiring and setuprdquo page

LED Resistor Calculator

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 27

3WIRING DIAGRAMS1

Basic Tri-Cree wiring (In-hilt LED)ldquoconfighrdquo file setup

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

Use a given or build your wiring diagram on THIS PAGE then open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text

Editor (Notepad - to see code correctly in Notepad Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all

text) and Delete it then Copy-and-Paste (Ctrl+C Ctrl+V) your wiring diagram config code (example below) into empty _configh file and

Save it under new name Follow the instructions on page 22 to upload it to the board

ldquoproffieboard_v1_confighrdquoNUM_BLADES 2NUM_BUTTONS 2VOLUME 1000CLASH_THRESHOLD_G 10StyleNormalPtrltCYAN WHITE 300 800gt()StyleNormalPtrltCYAN WHITE 300 800gt()

CreeXPE2RedTemplatelt1000gtCreeXPE2GreenTemplatelt0gtCreeXPE2BlueTemplatelt240gtNoLED

ProffieBoard config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)Volume level (0-3000)Clash sensitivity (adjust lower or higher with 01 step)ldquoBlade 1rdquo styleldquoBlade 2rdquo style (in case only 1 blade is used you donrsquot need this line)LED configuration (use these XP-E2 LED templatesto define your LED If other LED resistors are used change these values to match Ohm1000=ltvaluegt)

where 1000 is 1 Ohm resistor 0 is no resistor240 is 024 Ohm resistorNoLED ndash no 4th led used

Preset 1

LED 1 configuration

LED 2 configuration

Preset 2 etc

PROFFIEBOARD INSTRUCTIONS

28 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Basic Neopixel wiring diagram

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

+

+

-

-

22 A

WG

22 AWG

x2 28 AWG

x2 26 AWG

22 A

WG

30-32 AWG30-32 AWG

Protected 36-37V (42V max at full charge) 10A 3500mAh or 15A 3120mAhbattery recommended+18650 battery holder (optional)Keystone 1042P

AV switch with accent led(constantly ON no effects)

accent leds run mostly at10-15mA so resistors for them must be calculated accordingly

Main Neopixel strip

additional Neopixelstrips(optional)

Neopixel bladeconnector

330 Ohm on the Blade pcb side

x3 28 AWGor x1 22 AWGfor Negative

330 Ohm on the Blade pcb side

arrows up

330 Ohm on the Blade pcb side

In case no additional Neopixel strips are needed LED channels 4 5 6 can be used for 3 controllable(programmable for different effects) accent leds So AV switch led can be wired to one of these channelsAccent leds also can be wired to Data pads 2-5 please see ldquoAccent LEDs wiring and setuprdquo page

Recommended power wire gauges (22 AWG) are given for 2-strip blade For 3-strip blade you gonna need at least 20 AWG wires

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 29

ldquoproffieboard_v1_confighrdquo

3WIRING DIAGRAMS1

Basic Neopixel wiringldquoconfighrdquo file setup

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

NUM_BLADES 3NUM_BUTTONS 2VOLUME 1000CLASH_THRESHOLD_G 10IgnitionDelaylt0 any blade stylegtIgnitionDelaylt800 any blade stylegtIgnitionDelaylt800 any blade stylegtWS2811BladePtrlt118 WS2811 800kHz | WS2811 GRBgt()WS2811BladePtrlt26 blade2Pin ltbladePowerPin4gtgt()WS2811BladePtrlt26 blade3Pin ltbladePowerPin5gtgt()

ProffieBoard config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)Volume level (0-3000)Clash sensitivity (adjust lower or higher with 01 step)ldquoBlade 1rdquo style (main blade with IgnitionDelay 0)ldquoBlade 2rdquo style (CG blade 1 with IgnitionDelay 800)ldquoBlade 3rdquo style (CG blade 2 with IgnitionDelay 800)

strip configuration (defines how many pixels it has and to which LED output and pin is wired)

Preset 1

any blade style

strip (blade) 1 configuration

adjust this number to match your strips leds count

strip (blade) 2 configuration

strip (blade) 3 configuration

Preset 2 etc

Use a given or build your wiring diagram on THIS PAGE then open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text

Editor (Notepad - to see code correctly in Notepad Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all

text) and Delete it then Copy-and-Paste (Ctrl+C Ctrl+V) your wiring diagram config code (example below) into empty _configh file and

Save it under new name Follow the instructions on page 22 to upload it to the board

PROFFIEBOARD INSTRUCTIONS

30 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Basic Segmented string wiring diagram

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

+

+

-

-

24 A

WG

28 AWG

30-32 AWG30-32 AWG

Protected 36-37V (42V max at full charge) 10A 3500mAh battery recommended+18650 battery holder (optional)Keystone 1042P

AV switch with accent led(constantly ON no effects)

accent leds run mostly at10-15mA so resistors for them must be calculated accordingly

6-segments string blade

FoC string

N-channel FET3A minimum

123456

Calculate resistors for each led segment of the blade string depending on which leds are used 5mm leds have max drive current around 25mA per led when 10mm leds can be 100mA and 200mA per ledSo pay attention to your led max current and Forward Voltage (Vf) when calculating a segment resistor resistence as well as its wattage Also choose wire gauges accordingly to meet segments and total blade max current draw level

LED Resistor Calculator

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 31

ldquoproffieboard_v1_confighrdquo

3WIRING DIAGRAMS1

Basic Segmented string wiringldquoconfighrdquo file setup

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

NUM_BLADES 1NUM_BUTTONS 2VOLUME 1000CLASH_THRESHOLD_G 10StyleNormalPtrltCYAN WHITE 300 800gt()ltBlue3mmLED BladePin White3mmLEDgt

ProffieBoard config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)Volume level (0-3000)Clash sensitivity (adjust lower or higher with 01 step)Blade styleLED string configuration(here you mention the color and type of leds usedin the main blade string segments and FoC stringBladePin is the FoC signal pin (Blade ID pin))

Preset

LED string configuration

Use a given or build your wiring diagram on THIS PAGE then open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text

Editor (Notepad - to see code correctly in Notepad Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all

text) and Delete it then Copy-and-Paste (Ctrl+C Ctrl+V) your wiring diagram config code (example below) into empty _configh file and

Save it under new name Follow the instructions on page 22 to upload it to the board

PROFFIEBOARD INSTRUCTIONS

32 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Accent LEDs wiring diagram(optional)

Accent LEDs work with ProffieBoard as additional ldquobladesrdquo when powered by LED outputs 4 5 6 or Data pads 1 2 3 5 as PWM So they can

have any effect that blade can have If no effects needed accent led can be powered just by a 33V output pad (power-on led indication)

30-32 AWG

with Neopixel blade setup these 4 outputsdonrsquot work for regular accent leds

Recommended resistors to use for accent leds at 33V power source and 15mA drive

ndash 100 Ohm for Red (lt100000gt value in the code)ndash 13 Ohm for Green (lt13000gt value in the code)ndash 13 Ohm for Blue (lt13000gt value in the code)ndash 100 Ohm for Yellow (lt100000gt value in the code)ndash 20 Ohm for White (lt20000gt value in the code)

RGB ledcommon-anode

8 ldquobladesrdquo1 main and 7 accent leds

main blade style (effects) main blade style (effects)

7 accent leds style (effects)accent led style (effects)

7 accent leds configurations

RGB accent led configuration

2 ldquobladesrdquo1 main and 1 RGB accent led

ldquoPower-onrdquo indicationaccent leds (no effects)

7 accent leds withindependent effects

RGB accent led

a) b)

b)

c)

c)

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 33

3WIRING DIAGRAMS1

Neopixel Accent LEDs wiring diagram(optional)

With Neopixel setup additional neopixel leds or arrays can be used as accent leds There are 2 ways to wire them using additional Data

pins 2 3 4 5 or ldquoSub-bladesrdquo wiring with just 1 Data output pin Same way Neopixel connectors with on-board leds ca be wired

Option 1 ndash with extra Data pins

Main Blade

some accent leds

D1

D2

crystal leds

330 Ohm

330 Ohm

330 Ohm

main blade style (effects)

main blade 144 leds Data pin 1

accent leds blade style (effects)

accent leds ldquobladerdquo 4 leds Data pin 2

crystal leds blade style (effects)

crystal leds ldquobladerdquo 2 leds Data pin 3

3 ldquobladesrdquo1 main 1 accent leds array and 1 crystal leds array

PROFFIEBOARD INSTRUCTIONS

D3

follow arrows direction

34 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Neopixel Accent LEDs wiring diagram(optional)

PROFFIEBOARD INSTRUCTIONS

Main Blade

some accent leds

1

3

5678

2

4

D1

crystal leds

follow arrows direction

330 Ohm

330 OhmData signal

With this setup a single array of neopixel leds is separated into a couple of sub-blades with their own style configuration and behaviour This

is really usefull when you want to use only one data pin More about ldquoSub-bladesrdquo on ProffieOS wiki page

Option 2 ndash with ldquoSub-bladesrdquo

main blade style (effects)

main blade sub-blade 140 leds (7-146) but from 6 to 145 in the code

accent leds blade style (effects)

accent leds sub-blade 4 leds (1-4) but from 0 to 3 in the code

crystal leds blade style (effects)

146 leds total used

crystal leds sub-blade 2 leds (5-6) but from 4 to 5 in the code

update default 144 to a higher total value if you get all accent leds +Main blade gt 144 Example update to 146 if you have 2 crystal leds +4 accent leds + 140 Main blade leds = 146

3 ldquobladesrdquo 1 main 1 accent leds array and 1 crystal leds array

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 35

3WIRING DIAGRAMS1

OLED display wiring diagram(optional)

SSD1306 128x32 pixels OLED display allows to show battery level current preset name play different animations and even simple games It

can be wired to any blade configuration and requires just one additional line in the code to work You can get monochrome display in white

or blue color

SSD1306128x32OLED

SSD1306 ndash with blue or white display color selectSSD1306 ndash cheaper priceSSD1306 just screen ndash blue or white select

30-32 AWG

30-32 AWG

add this line to enable OLED display

display shows a preset name written in these quotes ldquoldquo

PROFFIEBOARD INSTRUCTIONS

36 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Bluetooth module wiring diagram(optional)

SOON

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 37

3WIRING DIAGRAMS1

Blade ID resistor functions(optional)

SOON

PROFFIEBOARD INSTRUCTIONS

38 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

website ProffieBoard FULL wiring diagrams link

Scroll the page down till you see the interactive diagram Above the diagram there are components selection options Build your saber setup

with it and follow diagram to wire your board Then you need to copy the configuration code below and paste it into your _configh file

Choose components you want

3WIRING DIAGRAMS1

More wiring diagrams

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 39

3WIRING DIAGRAMS1

How to use it

PROFFIEBOARD INSTRUCTIONS

Blade ignitionretraction ndash assuming you have at least one button pressing it briefly should turn the saber on or off If you have an AUX button pressing it briefly should also turn the saber on and off If you have no buttons you can turn the saber on and off by twisting your wrist back and forth Note that the motion has to be done long enough to count so a very quick flick of the wrist will not workTurn On muted ndash double-click power buttonNext preset ndash while saber is off click the AUX buttonPrevious preset ndash hold AUX button and click the Activation buttonTrigger Clash ndash while saber is on hit the bladeTrigger Lockup ndash while saber is on hold Activation button then trigger a clash Lockup releases when you let go of the Acti-vation buttonTrigger Drag ndash like lockup but point saber mostly down before holding Activation buttonTrigger Force ndash long-click AUX buttonStart soundtrack ndash long-click the Activation buttonTrigger Blaster Block ndash while saber is on short-click AUX button

Serial Monitor commands

battery_voltage ndash gets current battery voltage valueget_volume ndash get current volume valuepow ndash power OnOff the saberon ndash power On the saberoff ndash power Off the saberset_volume lt0-3000gt ndash set volume value (example set_volume 500)play ndash play the default preset trackplay trackslttrack namegt ndash play a specific track from tracks folder (example play tracksvenuswav)stop ndash stop the playing trackforce ndash play ldquoforcerdquo sound effectsdrag ndash play ldquodragrdquo sound effectsblast ndash play ldquoblasterrdquo sound effectslock ndash play ldquolockuprdquo sound effectsclash ndash play ldquoclashrdquo sound effectsreset ndash reboot the boardn ndash switch to next presetp ndash switch to previous presetlist_presets ndash show all presetssdtest ndash test SD card speed

40 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3FIRMWARE UPLOAD AND UPDATE2

Software installation and setup

PROFFIEBOARD INSTRUCTIONS

To upload firmware to ProffieBoard Arduino IDE program is required Follow these steps to install it to your PC

1 Install latest Arduino IDE software (donrsquot use BETA)

Installing as Windows app also is not recommended

because it will be installed in a specific protected folder that

wonrsquot allow you to install any additional softwareplugin in it

If ProffieBoard wonrsquot show up in COM port use

Arduino IDE 186 version

2 Install the Proffieboard Arduino Plugin and Zadig software

Follow installation instructions

3 Select Proffieboard-STM32L433 in Tools -gt Board

USB Type ndash Serial CPU Speed ndash 80 MHz Optimize ndash Smallest Code DOSFS ndash SDCARD (SPI) Port ndash COM(the number your PC assigned) (Butterfly-L433CC)

Connect Proffieboard via USB cable to PC to be able to select

the Port

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 41

3FIRMWARE UPLOAD AND UPDATE2

Uploading firmware

PROFFIEBOARD INSTRUCTIONS

1 Download the ProffieBoard firmware and SD card content

Unzip lightsaber-1286zip to your Documents directory or to

Desktop but not to Arduino program folder or anywhere in

Programs directory where all programs are installed You will

see a lightsaber folder and files inside it Donrsquot move any of

these files to any other location outside the lightsaber folder

and donrsquot reorganize them Unzip ProffieOS_SD_Cardzip to the

folder where you keep lightsaber-1286 folder Copy all files

from ProffieOS_SD_Card folder to your SD card

2 Unhide file extensions in File Explorer settings to see h ending

of config files Donrsquot add ldquohrdquo to the config file name Go to config folder and create you own configh file (see page

42 for how-to)

Double-click the lightsaberino file

3 Add the name of your configh file as shown and Save this

lightsaberino file Make sure the other config files are

commented out there should be only one CONFIG_FILE

without You can have multiple config files

in lightsabergtconfig folder and just define the one you need

in lightsaberino file and upload it again to ProffieBoard

4 Connect battery to ProffieBoard and hook up to your PC

with a data transfer micro-USB-to-USB cable

Press arrow button it will compile and upload firmware to the

board Wait for red text progress bars to stop at 100

ProffieBoard will play boot sound if speaker is connected

Now you can unplug the USB cable Done

If it gives an error instead this means your configh file has

issues define CONFIG_FILE name has mistakes configh file

is out of config folder your PC user name is non-latin

42 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

33

configh file structure editing

PROFFIEBOARD INSTRUCTIONS

CHANGING PARAMETERS

All sound files (sound fonts music tracks) are stored on the micro SD card Add required sound fonts folders (Plecter NEC and Smoothswing

fonts are supported no need to change WAV files names just copy and paste) to SD card root directory as itrsquos done in the default

ProffieOS_SD_Card content folder and music tracks to the tracks folder

Make sure to name all music tracks and sound fonts folders with latin characters and only up to 8 characters long without using any special

characters (like |[- etc)

Make sure you have a configini file in each sound font folder if there is none - copy one from some default TeensySaberProffieBoard sound

font and paste into newly added sound font folder It has only one parameter that you can modify - humstart It helps to match hum sound

start with blade ignition 1000 usually works fine

All blade effects LED configuration volume level clash sensitivity etc are changed in the configh file located in lightsabergtconfig folder

To do that open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text Editor (Notepad - to see code correctly in Notepad

Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all text) and Delete it then Copy-and-Paste (Ctrl+C

Ctrl+V) your wiring diagram config code into empty _configh file and Save it under new name Follow the instructions on page 39 to

upload it to the board

Proffieboard config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)

volume level (0-3000)

clash sensitivity (adjust lower or higher with 01 step)

sound font folder nametrack name

Preset name

Blade style

LED configuration (use these XP-E2 LED templatesto define your LED)

for Red use 1 Ohm resistor for Green - no resistor for Blue use 024 Ohm

NoLED ndash no 4th led used

Preset 1

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 43

33

Blade Styles

StylePtrltInOutHelperltSimpleClashltLockupltBlastltOnSparkltAudioFlickerltRgblt02550gtRgblt501000gtgtRgblt2552550gt150gtRgblt255500gtgtAudioFlickerltRgblt1002550gtRgblt2550150gtgtgtRgblt255100150gt40gt200300Blackgtgt

ndash this is how the Blade Style code looks pasted in the configh file Preset (it sits inside a StylePtrltgt container)

ndash this is how the Blade Style code looks when editing it inside a Blade Style Editor

Each Blade Style is made of a variety of Effects each added effect goes instead of a base color in the previous effect

PROFFIEBOARD INSTRUCTIONS

CHANGING PARAMETERS

ProffieBoard and TeensySaber use Blade Styles for the main saber blade and any other accent leds to define all light effects (color changing

flashes flickering delays ignitionretraction timing etc)

Use Blade Style Editor to create and adjust Blade Styles Megtooth Sith Sabers did a great video tutorial where he shows and explains

how to use Blade Style Editor Also you can grab some pre-made Blade Styles or share yours here on TRA forums

A Blade Style example of simple flickering Green blade with Spark on start Clash Blaster Lockup and Drag IgnitionRetraction effects

InOutHelperltSimpleClashltLockupltBlastltOnSparkltAudioFlickerltRgblt02550gtRgblt501000gtgtRgblt2552550gt150gtRgblt255500gtgtAudioFlickerltRgblt1002550gtRgblt2550150gtgtgtRgblt255100150gt40gt200300Blackgt

InOutHelperltbase color200300Blackgt ndash base color can be defined by words (WHITE RED GREEN PURPLE etc) or by Rgblt0-2550-2550-255gt values for more

custom shades 200 is extension length in milliseconds 300 is retraction length in milliseconds Black is color when retracted (also can be any other color)

SimpleClashltbase colorclash color40gt ndash clash effect 40 is clash duration in milliseconds

Lockupltbase colorlockup colorgt ndash lockup effect

Blastltbase colorblast colorgt ndash blaster effect

OnSparkltbase colorspark color150gt ndash spark on ignition effect 150 is spark duration in milliseconds

AudioFlickerltrdquoArdquo colorrdquoBrdquo colorgt ndash flickering effect (blade flickers to the actual saber hum sound) the more difference between ldquoArdquo and ldquoBrdquo colors - the more

abrupt is flickering

Rgblt255500gt ndash actual color in RGB format (0 is no light 255 is the maximum brightness value for Red Green or Blue channel)

44 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

ndash SanDisk 4GB microSDHC Class 4 (Genuine) ndash SanDisk 4GB microSDHC Class 4 (Genuine)

130238 kbs = 1477 simultaneous audio streams 137812 kbs = 1562 simultaneous audio streams

ndash Patriot LX Series 16GB microSDHC UHS-IU1 Class 10 ndash Patriot LX Series 16GB microSDHC UHS-IU1 Class 10

133005 kbs = 1508 simultaneous audio streams

ndash GSkill 16GB microSDHC UHS-IU1 Class 10 ndash GSkill 16GB microSDHC UHS-IU1 Class 10

129534 kbs = 1469 simultaneous audio streams

ndash Kingston 16GB microSDHC UHS-IU1 Class 10 ndash Kingston 16GB microSDHC UHS-IU1 Class 10

128090 kbs = 1452 simultaneous audio streams

ndash SanDisk Ultra 16GB microSDHC UHS-IU1 A1 Class 10 ndash SanDisk Ultra 16GB microSDHC UHS-IU1 A1 Class 10

102663 kbs = 1164 simultaneous audio streams 11124 kbs = 1261 simultaneous audio streams

ndash SanDisk 8GB microSDHC Class 4 ndash SanDisk 8GB microSDHC Class 4

108506 kbs = 1230 simultaneous audio streams

ndash SanDisk 16GB microSDHC Class 4 ndash SanDisk 16GB microSDHC Class 4

102663 kbs = 1164 simultaneous audio streams 106957 kbs = 1213 simultaneous audio streams

ndash SanDisk Ultra 16GB microSDHC UHS-IU1 Class 10 ndash SanDisk Ultra 16GB microSDHC UHS-IU1 Class 10

102663 kbs = 1164 simultaneous audio streams 103909 kbs = 1178 simultaneous audio streams

ndash Smartbuy 4GB microSDHC Class 4 ndash Smartbuy 4GB microSDHC Class 4

75437 kbs = 855 simultaneous audio streams

ndash Kingston 8GB microSDHC Class 4 ndash Kingston 8GB microSDHC Class 4

75209 kbs = 822 simultaneous audio streams

ndash SanDisk 4GB microSDHC Class 4 (Fake) ndash SanDisk 4GB microSDHC Class 4 (Fake)

677 kbs = 769 simultaneous audio streams

Here is a list of tested micro SD cards speed with TeensySaber V3 and ProffieBoard Any card with speed over 900 kbs is recommended the

higher the speed is ndash the better Memory size of 4-16Gb is more than enough Cards were tested with a default firmware (1291) compiled

with ldquoSmallest Coderdquo under Optimize ldquodefault_proffieboard_confighrdquo file and default ProffieOS SD card sound files (7 folders)

To test your SD card speed simply hook up ProffieBoard to PC open Arduino IDE go to Tools and open Serial Monitor make sure you have

New Line and 9600 baud rate selected on the bottom of Serial Monitor window type and send sdtest command wait for the test result

4Recommended micro SD cards

BEST

TEENSYSABER PROFFIEBOARD

GOOD

BAD

PROFFIEBOARD INSTRUCTIONS

SD CARD RECOMMENDATIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 45

There are a lot of fake (chinese copies) microSD cards on the market from aliexpress ebay amazon etc They look very similar to genuine

cards but are a bit different though and have a twice lower writingreading speed Here is an example of a SanDisk 4Gb Class 4 card one is

genuine with 137812 kbs speed and the other one is fake with 677 kbs speed I got from ebay seller

Be carefull and pay attention to how the actual card looks if you are not sure ask seller for the real photo of SD card he sells

4Genuine and Fake SanDisk 4Gb Class 4 microSD

PROFFIEBOARD INSTRUCTIONS

SD CARD RECOMMENDATIONS

46 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

WIRE GAUGE GUIDE

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 47

RECHARGE PORTS AND KILL SWITCHES

48 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

NEOPIXEL STRIPS CURRENT DRAW

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 49

6TROUBLESHOOTING

For more help please check these linksProffieOSProffieBoardTeensySaber wiki on GitHubAsk your question on The Rebel Armory forumsAsk your question on FX-sabers forumsAsk your question in facebook group

How to solve most common issues

Quick troubleshooting tips

TeensySaber board or Proffieboard is not recognized by computer (nothing under Port selection in Arduino)

ndash Make sure a charged 37V battery is connected to the board micro-USB cable is a data transfer cable all plugins and drivers are installed ndash

check again pages 21 for TeensySaber or 40 for Proffieboard Try a different USB port on your computer

Sketch (code) compile error in Arduino IDE

ndash Check your define CONFIG_FILE ldquoconfig_confighrdquo line in opened lightsaberino file if itrsquos written correctly with config in it

Sketch (code) compile error in Arduino IDE

ndash Check if the _configh file you defined in the lightsaberino sketch file is same name as in the lightsaber-rdquofirmware versionrdquolightsaber

config folder and is located in this folder

Sketch (code) compile error in Arduino IDE

ndash Check your settings under Tools tab in Arduino IDE program Check again pages 21 for TeensySaber or 40 for Proffieboard

Sketch (code) compile error in Arduino IDE

ndash Check if your _configh file is correct Blade Styles Presets const unsigned int maxLedsPerStrip = 144 if BladeConfig blades[] = is correct

Sketch (code) compile error in Arduino IDE

ndash If nothing helps install Arduino IDE version 186 and try to compile and upload the firmware again

Sound doesnrsquot play

ndash Remove SD card and insert again check speaker wiring Make sure all sound files on SD card are correctly named (8 characters max long)

Re-format SD card in FAT32 load sound files and try again try another SD card

Board says ldquoLOW POWERrdquo

ndash Charge the battery

Serial Monitor shows info sent by the board but your commands donrsquot work

ndash In the bottom right corner of Serial Monitor window make sure the Line Ending drop down is set to New Line

Sound is weird and distorted

ndash Check your SD card speed (see page 44) Check speaker wiring try another good speaker

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 25

31

PROFFIEBOARD INSTRUCTIONS

Board pinout

Battery + ndash 26 to 45 volt input drives everything except the LEDs

Battery - ndash negative pad for LEDs needs to be at same level as GND when both are connected Both pads are internally connected

GND ndash ground for electronics except LEDs Note that there are two GND pads on the board that are internally connected

Speaker +- ndash hooks up to speaker

Activation (1) Aux (2) Aux2 button (3) ndash hook up to closing buttons or potentially touch buttons

Blade ID Neopixel Data 1 ndash normally used to measure the blade ID restor and if itrsquos a neopixel blade feed out neopixel data

Data 2 3 4 5 ndash additional neopixel data outputs or free for other purposes

LED 1 2 3 4 5 6 ndash hooks up to negative side of LED (positive side of LED hooks up directly to battery) These pads can handle

up to 30 volts

SDA SCL ndash these pins are used to wire OLED display or to communicate with the gyro and accelerometer chip

RX TX ndash these pins are used for wiring a bluetooth module for wireless control

SWDCLK SWDIO ndash can be hooked up to a ST-LINK device and lets you debug programs running on the ProffieBoard

+5V ndash generated by the ProffieBoard normally itrsquos only ON when sound is playing

+33V ndash generated by the ProffieBoard for powering OLED display Bluetooth module or some accent leds

BOOT RESET ndash buttons to put the ProffieBoard in bootloader mode if uploading doesnrsquot work

micro USB port ndash micro USB port used only for firmware upload and can be used for sound files upload to SD card (from firmware version

1291 and up) THIS PORT ISNrsquoT USED FOR CHARGING THE BATTERY

LED 4LED 3

LED 2

LED 1

LED 5

LED 6

RESETBOOT

Battery - Battery -

Speaker + (red dot or ldquo+rdquo mark on speaker)

Battery +

Aux button (2)Activation button (1)

Aux2 button (3)

Blade ID Neopixel Data 1

Data 5

Data 4Data 3Data 2

+33V

SWDIO

SWDCLK

+5V

TXRX

GND

GND

Reset

Speaker -

SCLSDA

micro USB port

WIRING DIAGRAMS

26 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Basic Tri-Cree wiring diagram(In-hilt LED)

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

+

+

-

-

26 AWG

26 A

WG

30-32 AWG

28-30 AWG

28-3

0 A

WG

30-32 AWG

Protected 36-37V (42V max at full charge) 10A 3500mAh battery recommended+18650 battery holder (optional)Keystone 1042P

AV switch with accent led(constantly ON no effects)

accent leds run mostly at10-15mA so resistors for them must be calculated accordingly

Main RGB led

additional RGB leds(optional)

In case no additional high power leds are needed LED channels 4 5 6 can be used for 3 controllable(programmable for different effects) accent leds So AV switch led can be wired to one of these channelsAccent leds also can be wired to Data pads 1-5 please see ldquoAccent LEDs wiring and setuprdquo page

LED Resistor Calculator

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 27

3WIRING DIAGRAMS1

Basic Tri-Cree wiring (In-hilt LED)ldquoconfighrdquo file setup

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

Use a given or build your wiring diagram on THIS PAGE then open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text

Editor (Notepad - to see code correctly in Notepad Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all

text) and Delete it then Copy-and-Paste (Ctrl+C Ctrl+V) your wiring diagram config code (example below) into empty _configh file and

Save it under new name Follow the instructions on page 22 to upload it to the board

ldquoproffieboard_v1_confighrdquoNUM_BLADES 2NUM_BUTTONS 2VOLUME 1000CLASH_THRESHOLD_G 10StyleNormalPtrltCYAN WHITE 300 800gt()StyleNormalPtrltCYAN WHITE 300 800gt()

CreeXPE2RedTemplatelt1000gtCreeXPE2GreenTemplatelt0gtCreeXPE2BlueTemplatelt240gtNoLED

ProffieBoard config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)Volume level (0-3000)Clash sensitivity (adjust lower or higher with 01 step)ldquoBlade 1rdquo styleldquoBlade 2rdquo style (in case only 1 blade is used you donrsquot need this line)LED configuration (use these XP-E2 LED templatesto define your LED If other LED resistors are used change these values to match Ohm1000=ltvaluegt)

where 1000 is 1 Ohm resistor 0 is no resistor240 is 024 Ohm resistorNoLED ndash no 4th led used

Preset 1

LED 1 configuration

LED 2 configuration

Preset 2 etc

PROFFIEBOARD INSTRUCTIONS

28 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Basic Neopixel wiring diagram

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

+

+

-

-

22 A

WG

22 AWG

x2 28 AWG

x2 26 AWG

22 A

WG

30-32 AWG30-32 AWG

Protected 36-37V (42V max at full charge) 10A 3500mAh or 15A 3120mAhbattery recommended+18650 battery holder (optional)Keystone 1042P

AV switch with accent led(constantly ON no effects)

accent leds run mostly at10-15mA so resistors for them must be calculated accordingly

Main Neopixel strip

additional Neopixelstrips(optional)

Neopixel bladeconnector

330 Ohm on the Blade pcb side

x3 28 AWGor x1 22 AWGfor Negative

330 Ohm on the Blade pcb side

arrows up

330 Ohm on the Blade pcb side

In case no additional Neopixel strips are needed LED channels 4 5 6 can be used for 3 controllable(programmable for different effects) accent leds So AV switch led can be wired to one of these channelsAccent leds also can be wired to Data pads 2-5 please see ldquoAccent LEDs wiring and setuprdquo page

Recommended power wire gauges (22 AWG) are given for 2-strip blade For 3-strip blade you gonna need at least 20 AWG wires

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 29

ldquoproffieboard_v1_confighrdquo

3WIRING DIAGRAMS1

Basic Neopixel wiringldquoconfighrdquo file setup

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

NUM_BLADES 3NUM_BUTTONS 2VOLUME 1000CLASH_THRESHOLD_G 10IgnitionDelaylt0 any blade stylegtIgnitionDelaylt800 any blade stylegtIgnitionDelaylt800 any blade stylegtWS2811BladePtrlt118 WS2811 800kHz | WS2811 GRBgt()WS2811BladePtrlt26 blade2Pin ltbladePowerPin4gtgt()WS2811BladePtrlt26 blade3Pin ltbladePowerPin5gtgt()

ProffieBoard config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)Volume level (0-3000)Clash sensitivity (adjust lower or higher with 01 step)ldquoBlade 1rdquo style (main blade with IgnitionDelay 0)ldquoBlade 2rdquo style (CG blade 1 with IgnitionDelay 800)ldquoBlade 3rdquo style (CG blade 2 with IgnitionDelay 800)

strip configuration (defines how many pixels it has and to which LED output and pin is wired)

Preset 1

any blade style

strip (blade) 1 configuration

adjust this number to match your strips leds count

strip (blade) 2 configuration

strip (blade) 3 configuration

Preset 2 etc

Use a given or build your wiring diagram on THIS PAGE then open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text

Editor (Notepad - to see code correctly in Notepad Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all

text) and Delete it then Copy-and-Paste (Ctrl+C Ctrl+V) your wiring diagram config code (example below) into empty _configh file and

Save it under new name Follow the instructions on page 22 to upload it to the board

PROFFIEBOARD INSTRUCTIONS

30 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Basic Segmented string wiring diagram

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

+

+

-

-

24 A

WG

28 AWG

30-32 AWG30-32 AWG

Protected 36-37V (42V max at full charge) 10A 3500mAh battery recommended+18650 battery holder (optional)Keystone 1042P

AV switch with accent led(constantly ON no effects)

accent leds run mostly at10-15mA so resistors for them must be calculated accordingly

6-segments string blade

FoC string

N-channel FET3A minimum

123456

Calculate resistors for each led segment of the blade string depending on which leds are used 5mm leds have max drive current around 25mA per led when 10mm leds can be 100mA and 200mA per ledSo pay attention to your led max current and Forward Voltage (Vf) when calculating a segment resistor resistence as well as its wattage Also choose wire gauges accordingly to meet segments and total blade max current draw level

LED Resistor Calculator

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 31

ldquoproffieboard_v1_confighrdquo

3WIRING DIAGRAMS1

Basic Segmented string wiringldquoconfighrdquo file setup

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

NUM_BLADES 1NUM_BUTTONS 2VOLUME 1000CLASH_THRESHOLD_G 10StyleNormalPtrltCYAN WHITE 300 800gt()ltBlue3mmLED BladePin White3mmLEDgt

ProffieBoard config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)Volume level (0-3000)Clash sensitivity (adjust lower or higher with 01 step)Blade styleLED string configuration(here you mention the color and type of leds usedin the main blade string segments and FoC stringBladePin is the FoC signal pin (Blade ID pin))

Preset

LED string configuration

Use a given or build your wiring diagram on THIS PAGE then open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text

Editor (Notepad - to see code correctly in Notepad Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all

text) and Delete it then Copy-and-Paste (Ctrl+C Ctrl+V) your wiring diagram config code (example below) into empty _configh file and

Save it under new name Follow the instructions on page 22 to upload it to the board

PROFFIEBOARD INSTRUCTIONS

32 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Accent LEDs wiring diagram(optional)

Accent LEDs work with ProffieBoard as additional ldquobladesrdquo when powered by LED outputs 4 5 6 or Data pads 1 2 3 5 as PWM So they can

have any effect that blade can have If no effects needed accent led can be powered just by a 33V output pad (power-on led indication)

30-32 AWG

with Neopixel blade setup these 4 outputsdonrsquot work for regular accent leds

Recommended resistors to use for accent leds at 33V power source and 15mA drive

ndash 100 Ohm for Red (lt100000gt value in the code)ndash 13 Ohm for Green (lt13000gt value in the code)ndash 13 Ohm for Blue (lt13000gt value in the code)ndash 100 Ohm for Yellow (lt100000gt value in the code)ndash 20 Ohm for White (lt20000gt value in the code)

RGB ledcommon-anode

8 ldquobladesrdquo1 main and 7 accent leds

main blade style (effects) main blade style (effects)

7 accent leds style (effects)accent led style (effects)

7 accent leds configurations

RGB accent led configuration

2 ldquobladesrdquo1 main and 1 RGB accent led

ldquoPower-onrdquo indicationaccent leds (no effects)

7 accent leds withindependent effects

RGB accent led

a) b)

b)

c)

c)

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 33

3WIRING DIAGRAMS1

Neopixel Accent LEDs wiring diagram(optional)

With Neopixel setup additional neopixel leds or arrays can be used as accent leds There are 2 ways to wire them using additional Data

pins 2 3 4 5 or ldquoSub-bladesrdquo wiring with just 1 Data output pin Same way Neopixel connectors with on-board leds ca be wired

Option 1 ndash with extra Data pins

Main Blade

some accent leds

D1

D2

crystal leds

330 Ohm

330 Ohm

330 Ohm

main blade style (effects)

main blade 144 leds Data pin 1

accent leds blade style (effects)

accent leds ldquobladerdquo 4 leds Data pin 2

crystal leds blade style (effects)

crystal leds ldquobladerdquo 2 leds Data pin 3

3 ldquobladesrdquo1 main 1 accent leds array and 1 crystal leds array

PROFFIEBOARD INSTRUCTIONS

D3

follow arrows direction

34 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Neopixel Accent LEDs wiring diagram(optional)

PROFFIEBOARD INSTRUCTIONS

Main Blade

some accent leds

1

3

5678

2

4

D1

crystal leds

follow arrows direction

330 Ohm

330 OhmData signal

With this setup a single array of neopixel leds is separated into a couple of sub-blades with their own style configuration and behaviour This

is really usefull when you want to use only one data pin More about ldquoSub-bladesrdquo on ProffieOS wiki page

Option 2 ndash with ldquoSub-bladesrdquo

main blade style (effects)

main blade sub-blade 140 leds (7-146) but from 6 to 145 in the code

accent leds blade style (effects)

accent leds sub-blade 4 leds (1-4) but from 0 to 3 in the code

crystal leds blade style (effects)

146 leds total used

crystal leds sub-blade 2 leds (5-6) but from 4 to 5 in the code

update default 144 to a higher total value if you get all accent leds +Main blade gt 144 Example update to 146 if you have 2 crystal leds +4 accent leds + 140 Main blade leds = 146

3 ldquobladesrdquo 1 main 1 accent leds array and 1 crystal leds array

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 35

3WIRING DIAGRAMS1

OLED display wiring diagram(optional)

SSD1306 128x32 pixels OLED display allows to show battery level current preset name play different animations and even simple games It

can be wired to any blade configuration and requires just one additional line in the code to work You can get monochrome display in white

or blue color

SSD1306128x32OLED

SSD1306 ndash with blue or white display color selectSSD1306 ndash cheaper priceSSD1306 just screen ndash blue or white select

30-32 AWG

30-32 AWG

add this line to enable OLED display

display shows a preset name written in these quotes ldquoldquo

PROFFIEBOARD INSTRUCTIONS

36 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Bluetooth module wiring diagram(optional)

SOON

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 37

3WIRING DIAGRAMS1

Blade ID resistor functions(optional)

SOON

PROFFIEBOARD INSTRUCTIONS

38 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

website ProffieBoard FULL wiring diagrams link

Scroll the page down till you see the interactive diagram Above the diagram there are components selection options Build your saber setup

with it and follow diagram to wire your board Then you need to copy the configuration code below and paste it into your _configh file

Choose components you want

3WIRING DIAGRAMS1

More wiring diagrams

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 39

3WIRING DIAGRAMS1

How to use it

PROFFIEBOARD INSTRUCTIONS

Blade ignitionretraction ndash assuming you have at least one button pressing it briefly should turn the saber on or off If you have an AUX button pressing it briefly should also turn the saber on and off If you have no buttons you can turn the saber on and off by twisting your wrist back and forth Note that the motion has to be done long enough to count so a very quick flick of the wrist will not workTurn On muted ndash double-click power buttonNext preset ndash while saber is off click the AUX buttonPrevious preset ndash hold AUX button and click the Activation buttonTrigger Clash ndash while saber is on hit the bladeTrigger Lockup ndash while saber is on hold Activation button then trigger a clash Lockup releases when you let go of the Acti-vation buttonTrigger Drag ndash like lockup but point saber mostly down before holding Activation buttonTrigger Force ndash long-click AUX buttonStart soundtrack ndash long-click the Activation buttonTrigger Blaster Block ndash while saber is on short-click AUX button

Serial Monitor commands

battery_voltage ndash gets current battery voltage valueget_volume ndash get current volume valuepow ndash power OnOff the saberon ndash power On the saberoff ndash power Off the saberset_volume lt0-3000gt ndash set volume value (example set_volume 500)play ndash play the default preset trackplay trackslttrack namegt ndash play a specific track from tracks folder (example play tracksvenuswav)stop ndash stop the playing trackforce ndash play ldquoforcerdquo sound effectsdrag ndash play ldquodragrdquo sound effectsblast ndash play ldquoblasterrdquo sound effectslock ndash play ldquolockuprdquo sound effectsclash ndash play ldquoclashrdquo sound effectsreset ndash reboot the boardn ndash switch to next presetp ndash switch to previous presetlist_presets ndash show all presetssdtest ndash test SD card speed

40 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3FIRMWARE UPLOAD AND UPDATE2

Software installation and setup

PROFFIEBOARD INSTRUCTIONS

To upload firmware to ProffieBoard Arduino IDE program is required Follow these steps to install it to your PC

1 Install latest Arduino IDE software (donrsquot use BETA)

Installing as Windows app also is not recommended

because it will be installed in a specific protected folder that

wonrsquot allow you to install any additional softwareplugin in it

If ProffieBoard wonrsquot show up in COM port use

Arduino IDE 186 version

2 Install the Proffieboard Arduino Plugin and Zadig software

Follow installation instructions

3 Select Proffieboard-STM32L433 in Tools -gt Board

USB Type ndash Serial CPU Speed ndash 80 MHz Optimize ndash Smallest Code DOSFS ndash SDCARD (SPI) Port ndash COM(the number your PC assigned) (Butterfly-L433CC)

Connect Proffieboard via USB cable to PC to be able to select

the Port

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 41

3FIRMWARE UPLOAD AND UPDATE2

Uploading firmware

PROFFIEBOARD INSTRUCTIONS

1 Download the ProffieBoard firmware and SD card content

Unzip lightsaber-1286zip to your Documents directory or to

Desktop but not to Arduino program folder or anywhere in

Programs directory where all programs are installed You will

see a lightsaber folder and files inside it Donrsquot move any of

these files to any other location outside the lightsaber folder

and donrsquot reorganize them Unzip ProffieOS_SD_Cardzip to the

folder where you keep lightsaber-1286 folder Copy all files

from ProffieOS_SD_Card folder to your SD card

2 Unhide file extensions in File Explorer settings to see h ending

of config files Donrsquot add ldquohrdquo to the config file name Go to config folder and create you own configh file (see page

42 for how-to)

Double-click the lightsaberino file

3 Add the name of your configh file as shown and Save this

lightsaberino file Make sure the other config files are

commented out there should be only one CONFIG_FILE

without You can have multiple config files

in lightsabergtconfig folder and just define the one you need

in lightsaberino file and upload it again to ProffieBoard

4 Connect battery to ProffieBoard and hook up to your PC

with a data transfer micro-USB-to-USB cable

Press arrow button it will compile and upload firmware to the

board Wait for red text progress bars to stop at 100

ProffieBoard will play boot sound if speaker is connected

Now you can unplug the USB cable Done

If it gives an error instead this means your configh file has

issues define CONFIG_FILE name has mistakes configh file

is out of config folder your PC user name is non-latin

42 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

33

configh file structure editing

PROFFIEBOARD INSTRUCTIONS

CHANGING PARAMETERS

All sound files (sound fonts music tracks) are stored on the micro SD card Add required sound fonts folders (Plecter NEC and Smoothswing

fonts are supported no need to change WAV files names just copy and paste) to SD card root directory as itrsquos done in the default

ProffieOS_SD_Card content folder and music tracks to the tracks folder

Make sure to name all music tracks and sound fonts folders with latin characters and only up to 8 characters long without using any special

characters (like |[- etc)

Make sure you have a configini file in each sound font folder if there is none - copy one from some default TeensySaberProffieBoard sound

font and paste into newly added sound font folder It has only one parameter that you can modify - humstart It helps to match hum sound

start with blade ignition 1000 usually works fine

All blade effects LED configuration volume level clash sensitivity etc are changed in the configh file located in lightsabergtconfig folder

To do that open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text Editor (Notepad - to see code correctly in Notepad

Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all text) and Delete it then Copy-and-Paste (Ctrl+C

Ctrl+V) your wiring diagram config code into empty _configh file and Save it under new name Follow the instructions on page 39 to

upload it to the board

Proffieboard config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)

volume level (0-3000)

clash sensitivity (adjust lower or higher with 01 step)

sound font folder nametrack name

Preset name

Blade style

LED configuration (use these XP-E2 LED templatesto define your LED)

for Red use 1 Ohm resistor for Green - no resistor for Blue use 024 Ohm

NoLED ndash no 4th led used

Preset 1

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 43

33

Blade Styles

StylePtrltInOutHelperltSimpleClashltLockupltBlastltOnSparkltAudioFlickerltRgblt02550gtRgblt501000gtgtRgblt2552550gt150gtRgblt255500gtgtAudioFlickerltRgblt1002550gtRgblt2550150gtgtgtRgblt255100150gt40gt200300Blackgtgt

ndash this is how the Blade Style code looks pasted in the configh file Preset (it sits inside a StylePtrltgt container)

ndash this is how the Blade Style code looks when editing it inside a Blade Style Editor

Each Blade Style is made of a variety of Effects each added effect goes instead of a base color in the previous effect

PROFFIEBOARD INSTRUCTIONS

CHANGING PARAMETERS

ProffieBoard and TeensySaber use Blade Styles for the main saber blade and any other accent leds to define all light effects (color changing

flashes flickering delays ignitionretraction timing etc)

Use Blade Style Editor to create and adjust Blade Styles Megtooth Sith Sabers did a great video tutorial where he shows and explains

how to use Blade Style Editor Also you can grab some pre-made Blade Styles or share yours here on TRA forums

A Blade Style example of simple flickering Green blade with Spark on start Clash Blaster Lockup and Drag IgnitionRetraction effects

InOutHelperltSimpleClashltLockupltBlastltOnSparkltAudioFlickerltRgblt02550gtRgblt501000gtgtRgblt2552550gt150gtRgblt255500gtgtAudioFlickerltRgblt1002550gtRgblt2550150gtgtgtRgblt255100150gt40gt200300Blackgt

InOutHelperltbase color200300Blackgt ndash base color can be defined by words (WHITE RED GREEN PURPLE etc) or by Rgblt0-2550-2550-255gt values for more

custom shades 200 is extension length in milliseconds 300 is retraction length in milliseconds Black is color when retracted (also can be any other color)

SimpleClashltbase colorclash color40gt ndash clash effect 40 is clash duration in milliseconds

Lockupltbase colorlockup colorgt ndash lockup effect

Blastltbase colorblast colorgt ndash blaster effect

OnSparkltbase colorspark color150gt ndash spark on ignition effect 150 is spark duration in milliseconds

AudioFlickerltrdquoArdquo colorrdquoBrdquo colorgt ndash flickering effect (blade flickers to the actual saber hum sound) the more difference between ldquoArdquo and ldquoBrdquo colors - the more

abrupt is flickering

Rgblt255500gt ndash actual color in RGB format (0 is no light 255 is the maximum brightness value for Red Green or Blue channel)

44 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

ndash SanDisk 4GB microSDHC Class 4 (Genuine) ndash SanDisk 4GB microSDHC Class 4 (Genuine)

130238 kbs = 1477 simultaneous audio streams 137812 kbs = 1562 simultaneous audio streams

ndash Patriot LX Series 16GB microSDHC UHS-IU1 Class 10 ndash Patriot LX Series 16GB microSDHC UHS-IU1 Class 10

133005 kbs = 1508 simultaneous audio streams

ndash GSkill 16GB microSDHC UHS-IU1 Class 10 ndash GSkill 16GB microSDHC UHS-IU1 Class 10

129534 kbs = 1469 simultaneous audio streams

ndash Kingston 16GB microSDHC UHS-IU1 Class 10 ndash Kingston 16GB microSDHC UHS-IU1 Class 10

128090 kbs = 1452 simultaneous audio streams

ndash SanDisk Ultra 16GB microSDHC UHS-IU1 A1 Class 10 ndash SanDisk Ultra 16GB microSDHC UHS-IU1 A1 Class 10

102663 kbs = 1164 simultaneous audio streams 11124 kbs = 1261 simultaneous audio streams

ndash SanDisk 8GB microSDHC Class 4 ndash SanDisk 8GB microSDHC Class 4

108506 kbs = 1230 simultaneous audio streams

ndash SanDisk 16GB microSDHC Class 4 ndash SanDisk 16GB microSDHC Class 4

102663 kbs = 1164 simultaneous audio streams 106957 kbs = 1213 simultaneous audio streams

ndash SanDisk Ultra 16GB microSDHC UHS-IU1 Class 10 ndash SanDisk Ultra 16GB microSDHC UHS-IU1 Class 10

102663 kbs = 1164 simultaneous audio streams 103909 kbs = 1178 simultaneous audio streams

ndash Smartbuy 4GB microSDHC Class 4 ndash Smartbuy 4GB microSDHC Class 4

75437 kbs = 855 simultaneous audio streams

ndash Kingston 8GB microSDHC Class 4 ndash Kingston 8GB microSDHC Class 4

75209 kbs = 822 simultaneous audio streams

ndash SanDisk 4GB microSDHC Class 4 (Fake) ndash SanDisk 4GB microSDHC Class 4 (Fake)

677 kbs = 769 simultaneous audio streams

Here is a list of tested micro SD cards speed with TeensySaber V3 and ProffieBoard Any card with speed over 900 kbs is recommended the

higher the speed is ndash the better Memory size of 4-16Gb is more than enough Cards were tested with a default firmware (1291) compiled

with ldquoSmallest Coderdquo under Optimize ldquodefault_proffieboard_confighrdquo file and default ProffieOS SD card sound files (7 folders)

To test your SD card speed simply hook up ProffieBoard to PC open Arduino IDE go to Tools and open Serial Monitor make sure you have

New Line and 9600 baud rate selected on the bottom of Serial Monitor window type and send sdtest command wait for the test result

4Recommended micro SD cards

BEST

TEENSYSABER PROFFIEBOARD

GOOD

BAD

PROFFIEBOARD INSTRUCTIONS

SD CARD RECOMMENDATIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 45

There are a lot of fake (chinese copies) microSD cards on the market from aliexpress ebay amazon etc They look very similar to genuine

cards but are a bit different though and have a twice lower writingreading speed Here is an example of a SanDisk 4Gb Class 4 card one is

genuine with 137812 kbs speed and the other one is fake with 677 kbs speed I got from ebay seller

Be carefull and pay attention to how the actual card looks if you are not sure ask seller for the real photo of SD card he sells

4Genuine and Fake SanDisk 4Gb Class 4 microSD

PROFFIEBOARD INSTRUCTIONS

SD CARD RECOMMENDATIONS

46 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

WIRE GAUGE GUIDE

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 47

RECHARGE PORTS AND KILL SWITCHES

48 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

NEOPIXEL STRIPS CURRENT DRAW

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 49

6TROUBLESHOOTING

For more help please check these linksProffieOSProffieBoardTeensySaber wiki on GitHubAsk your question on The Rebel Armory forumsAsk your question on FX-sabers forumsAsk your question in facebook group

How to solve most common issues

Quick troubleshooting tips

TeensySaber board or Proffieboard is not recognized by computer (nothing under Port selection in Arduino)

ndash Make sure a charged 37V battery is connected to the board micro-USB cable is a data transfer cable all plugins and drivers are installed ndash

check again pages 21 for TeensySaber or 40 for Proffieboard Try a different USB port on your computer

Sketch (code) compile error in Arduino IDE

ndash Check your define CONFIG_FILE ldquoconfig_confighrdquo line in opened lightsaberino file if itrsquos written correctly with config in it

Sketch (code) compile error in Arduino IDE

ndash Check if the _configh file you defined in the lightsaberino sketch file is same name as in the lightsaber-rdquofirmware versionrdquolightsaber

config folder and is located in this folder

Sketch (code) compile error in Arduino IDE

ndash Check your settings under Tools tab in Arduino IDE program Check again pages 21 for TeensySaber or 40 for Proffieboard

Sketch (code) compile error in Arduino IDE

ndash Check if your _configh file is correct Blade Styles Presets const unsigned int maxLedsPerStrip = 144 if BladeConfig blades[] = is correct

Sketch (code) compile error in Arduino IDE

ndash If nothing helps install Arduino IDE version 186 and try to compile and upload the firmware again

Sound doesnrsquot play

ndash Remove SD card and insert again check speaker wiring Make sure all sound files on SD card are correctly named (8 characters max long)

Re-format SD card in FAT32 load sound files and try again try another SD card

Board says ldquoLOW POWERrdquo

ndash Charge the battery

Serial Monitor shows info sent by the board but your commands donrsquot work

ndash In the bottom right corner of Serial Monitor window make sure the Line Ending drop down is set to New Line

Sound is weird and distorted

ndash Check your SD card speed (see page 44) Check speaker wiring try another good speaker

26 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Basic Tri-Cree wiring diagram(In-hilt LED)

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

+

+

-

-

26 AWG

26 A

WG

30-32 AWG

28-30 AWG

28-3

0 A

WG

30-32 AWG

Protected 36-37V (42V max at full charge) 10A 3500mAh battery recommended+18650 battery holder (optional)Keystone 1042P

AV switch with accent led(constantly ON no effects)

accent leds run mostly at10-15mA so resistors for them must be calculated accordingly

Main RGB led

additional RGB leds(optional)

In case no additional high power leds are needed LED channels 4 5 6 can be used for 3 controllable(programmable for different effects) accent leds So AV switch led can be wired to one of these channelsAccent leds also can be wired to Data pads 1-5 please see ldquoAccent LEDs wiring and setuprdquo page

LED Resistor Calculator

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 27

3WIRING DIAGRAMS1

Basic Tri-Cree wiring (In-hilt LED)ldquoconfighrdquo file setup

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

Use a given or build your wiring diagram on THIS PAGE then open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text

Editor (Notepad - to see code correctly in Notepad Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all

text) and Delete it then Copy-and-Paste (Ctrl+C Ctrl+V) your wiring diagram config code (example below) into empty _configh file and

Save it under new name Follow the instructions on page 22 to upload it to the board

ldquoproffieboard_v1_confighrdquoNUM_BLADES 2NUM_BUTTONS 2VOLUME 1000CLASH_THRESHOLD_G 10StyleNormalPtrltCYAN WHITE 300 800gt()StyleNormalPtrltCYAN WHITE 300 800gt()

CreeXPE2RedTemplatelt1000gtCreeXPE2GreenTemplatelt0gtCreeXPE2BlueTemplatelt240gtNoLED

ProffieBoard config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)Volume level (0-3000)Clash sensitivity (adjust lower or higher with 01 step)ldquoBlade 1rdquo styleldquoBlade 2rdquo style (in case only 1 blade is used you donrsquot need this line)LED configuration (use these XP-E2 LED templatesto define your LED If other LED resistors are used change these values to match Ohm1000=ltvaluegt)

where 1000 is 1 Ohm resistor 0 is no resistor240 is 024 Ohm resistorNoLED ndash no 4th led used

Preset 1

LED 1 configuration

LED 2 configuration

Preset 2 etc

PROFFIEBOARD INSTRUCTIONS

28 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Basic Neopixel wiring diagram

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

+

+

-

-

22 A

WG

22 AWG

x2 28 AWG

x2 26 AWG

22 A

WG

30-32 AWG30-32 AWG

Protected 36-37V (42V max at full charge) 10A 3500mAh or 15A 3120mAhbattery recommended+18650 battery holder (optional)Keystone 1042P

AV switch with accent led(constantly ON no effects)

accent leds run mostly at10-15mA so resistors for them must be calculated accordingly

Main Neopixel strip

additional Neopixelstrips(optional)

Neopixel bladeconnector

330 Ohm on the Blade pcb side

x3 28 AWGor x1 22 AWGfor Negative

330 Ohm on the Blade pcb side

arrows up

330 Ohm on the Blade pcb side

In case no additional Neopixel strips are needed LED channels 4 5 6 can be used for 3 controllable(programmable for different effects) accent leds So AV switch led can be wired to one of these channelsAccent leds also can be wired to Data pads 2-5 please see ldquoAccent LEDs wiring and setuprdquo page

Recommended power wire gauges (22 AWG) are given for 2-strip blade For 3-strip blade you gonna need at least 20 AWG wires

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 29

ldquoproffieboard_v1_confighrdquo

3WIRING DIAGRAMS1

Basic Neopixel wiringldquoconfighrdquo file setup

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

NUM_BLADES 3NUM_BUTTONS 2VOLUME 1000CLASH_THRESHOLD_G 10IgnitionDelaylt0 any blade stylegtIgnitionDelaylt800 any blade stylegtIgnitionDelaylt800 any blade stylegtWS2811BladePtrlt118 WS2811 800kHz | WS2811 GRBgt()WS2811BladePtrlt26 blade2Pin ltbladePowerPin4gtgt()WS2811BladePtrlt26 blade3Pin ltbladePowerPin5gtgt()

ProffieBoard config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)Volume level (0-3000)Clash sensitivity (adjust lower or higher with 01 step)ldquoBlade 1rdquo style (main blade with IgnitionDelay 0)ldquoBlade 2rdquo style (CG blade 1 with IgnitionDelay 800)ldquoBlade 3rdquo style (CG blade 2 with IgnitionDelay 800)

strip configuration (defines how many pixels it has and to which LED output and pin is wired)

Preset 1

any blade style

strip (blade) 1 configuration

adjust this number to match your strips leds count

strip (blade) 2 configuration

strip (blade) 3 configuration

Preset 2 etc

Use a given or build your wiring diagram on THIS PAGE then open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text

Editor (Notepad - to see code correctly in Notepad Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all

text) and Delete it then Copy-and-Paste (Ctrl+C Ctrl+V) your wiring diagram config code (example below) into empty _configh file and

Save it under new name Follow the instructions on page 22 to upload it to the board

PROFFIEBOARD INSTRUCTIONS

30 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Basic Segmented string wiring diagram

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

+

+

-

-

24 A

WG

28 AWG

30-32 AWG30-32 AWG

Protected 36-37V (42V max at full charge) 10A 3500mAh battery recommended+18650 battery holder (optional)Keystone 1042P

AV switch with accent led(constantly ON no effects)

accent leds run mostly at10-15mA so resistors for them must be calculated accordingly

6-segments string blade

FoC string

N-channel FET3A minimum

123456

Calculate resistors for each led segment of the blade string depending on which leds are used 5mm leds have max drive current around 25mA per led when 10mm leds can be 100mA and 200mA per ledSo pay attention to your led max current and Forward Voltage (Vf) when calculating a segment resistor resistence as well as its wattage Also choose wire gauges accordingly to meet segments and total blade max current draw level

LED Resistor Calculator

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 31

ldquoproffieboard_v1_confighrdquo

3WIRING DIAGRAMS1

Basic Segmented string wiringldquoconfighrdquo file setup

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

NUM_BLADES 1NUM_BUTTONS 2VOLUME 1000CLASH_THRESHOLD_G 10StyleNormalPtrltCYAN WHITE 300 800gt()ltBlue3mmLED BladePin White3mmLEDgt

ProffieBoard config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)Volume level (0-3000)Clash sensitivity (adjust lower or higher with 01 step)Blade styleLED string configuration(here you mention the color and type of leds usedin the main blade string segments and FoC stringBladePin is the FoC signal pin (Blade ID pin))

Preset

LED string configuration

Use a given or build your wiring diagram on THIS PAGE then open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text

Editor (Notepad - to see code correctly in Notepad Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all

text) and Delete it then Copy-and-Paste (Ctrl+C Ctrl+V) your wiring diagram config code (example below) into empty _configh file and

Save it under new name Follow the instructions on page 22 to upload it to the board

PROFFIEBOARD INSTRUCTIONS

32 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Accent LEDs wiring diagram(optional)

Accent LEDs work with ProffieBoard as additional ldquobladesrdquo when powered by LED outputs 4 5 6 or Data pads 1 2 3 5 as PWM So they can

have any effect that blade can have If no effects needed accent led can be powered just by a 33V output pad (power-on led indication)

30-32 AWG

with Neopixel blade setup these 4 outputsdonrsquot work for regular accent leds

Recommended resistors to use for accent leds at 33V power source and 15mA drive

ndash 100 Ohm for Red (lt100000gt value in the code)ndash 13 Ohm for Green (lt13000gt value in the code)ndash 13 Ohm for Blue (lt13000gt value in the code)ndash 100 Ohm for Yellow (lt100000gt value in the code)ndash 20 Ohm for White (lt20000gt value in the code)

RGB ledcommon-anode

8 ldquobladesrdquo1 main and 7 accent leds

main blade style (effects) main blade style (effects)

7 accent leds style (effects)accent led style (effects)

7 accent leds configurations

RGB accent led configuration

2 ldquobladesrdquo1 main and 1 RGB accent led

ldquoPower-onrdquo indicationaccent leds (no effects)

7 accent leds withindependent effects

RGB accent led

a) b)

b)

c)

c)

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 33

3WIRING DIAGRAMS1

Neopixel Accent LEDs wiring diagram(optional)

With Neopixel setup additional neopixel leds or arrays can be used as accent leds There are 2 ways to wire them using additional Data

pins 2 3 4 5 or ldquoSub-bladesrdquo wiring with just 1 Data output pin Same way Neopixel connectors with on-board leds ca be wired

Option 1 ndash with extra Data pins

Main Blade

some accent leds

D1

D2

crystal leds

330 Ohm

330 Ohm

330 Ohm

main blade style (effects)

main blade 144 leds Data pin 1

accent leds blade style (effects)

accent leds ldquobladerdquo 4 leds Data pin 2

crystal leds blade style (effects)

crystal leds ldquobladerdquo 2 leds Data pin 3

3 ldquobladesrdquo1 main 1 accent leds array and 1 crystal leds array

PROFFIEBOARD INSTRUCTIONS

D3

follow arrows direction

34 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Neopixel Accent LEDs wiring diagram(optional)

PROFFIEBOARD INSTRUCTIONS

Main Blade

some accent leds

1

3

5678

2

4

D1

crystal leds

follow arrows direction

330 Ohm

330 OhmData signal

With this setup a single array of neopixel leds is separated into a couple of sub-blades with their own style configuration and behaviour This

is really usefull when you want to use only one data pin More about ldquoSub-bladesrdquo on ProffieOS wiki page

Option 2 ndash with ldquoSub-bladesrdquo

main blade style (effects)

main blade sub-blade 140 leds (7-146) but from 6 to 145 in the code

accent leds blade style (effects)

accent leds sub-blade 4 leds (1-4) but from 0 to 3 in the code

crystal leds blade style (effects)

146 leds total used

crystal leds sub-blade 2 leds (5-6) but from 4 to 5 in the code

update default 144 to a higher total value if you get all accent leds +Main blade gt 144 Example update to 146 if you have 2 crystal leds +4 accent leds + 140 Main blade leds = 146

3 ldquobladesrdquo 1 main 1 accent leds array and 1 crystal leds array

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 35

3WIRING DIAGRAMS1

OLED display wiring diagram(optional)

SSD1306 128x32 pixels OLED display allows to show battery level current preset name play different animations and even simple games It

can be wired to any blade configuration and requires just one additional line in the code to work You can get monochrome display in white

or blue color

SSD1306128x32OLED

SSD1306 ndash with blue or white display color selectSSD1306 ndash cheaper priceSSD1306 just screen ndash blue or white select

30-32 AWG

30-32 AWG

add this line to enable OLED display

display shows a preset name written in these quotes ldquoldquo

PROFFIEBOARD INSTRUCTIONS

36 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Bluetooth module wiring diagram(optional)

SOON

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 37

3WIRING DIAGRAMS1

Blade ID resistor functions(optional)

SOON

PROFFIEBOARD INSTRUCTIONS

38 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

website ProffieBoard FULL wiring diagrams link

Scroll the page down till you see the interactive diagram Above the diagram there are components selection options Build your saber setup

with it and follow diagram to wire your board Then you need to copy the configuration code below and paste it into your _configh file

Choose components you want

3WIRING DIAGRAMS1

More wiring diagrams

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 39

3WIRING DIAGRAMS1

How to use it

PROFFIEBOARD INSTRUCTIONS

Blade ignitionretraction ndash assuming you have at least one button pressing it briefly should turn the saber on or off If you have an AUX button pressing it briefly should also turn the saber on and off If you have no buttons you can turn the saber on and off by twisting your wrist back and forth Note that the motion has to be done long enough to count so a very quick flick of the wrist will not workTurn On muted ndash double-click power buttonNext preset ndash while saber is off click the AUX buttonPrevious preset ndash hold AUX button and click the Activation buttonTrigger Clash ndash while saber is on hit the bladeTrigger Lockup ndash while saber is on hold Activation button then trigger a clash Lockup releases when you let go of the Acti-vation buttonTrigger Drag ndash like lockup but point saber mostly down before holding Activation buttonTrigger Force ndash long-click AUX buttonStart soundtrack ndash long-click the Activation buttonTrigger Blaster Block ndash while saber is on short-click AUX button

Serial Monitor commands

battery_voltage ndash gets current battery voltage valueget_volume ndash get current volume valuepow ndash power OnOff the saberon ndash power On the saberoff ndash power Off the saberset_volume lt0-3000gt ndash set volume value (example set_volume 500)play ndash play the default preset trackplay trackslttrack namegt ndash play a specific track from tracks folder (example play tracksvenuswav)stop ndash stop the playing trackforce ndash play ldquoforcerdquo sound effectsdrag ndash play ldquodragrdquo sound effectsblast ndash play ldquoblasterrdquo sound effectslock ndash play ldquolockuprdquo sound effectsclash ndash play ldquoclashrdquo sound effectsreset ndash reboot the boardn ndash switch to next presetp ndash switch to previous presetlist_presets ndash show all presetssdtest ndash test SD card speed

40 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3FIRMWARE UPLOAD AND UPDATE2

Software installation and setup

PROFFIEBOARD INSTRUCTIONS

To upload firmware to ProffieBoard Arduino IDE program is required Follow these steps to install it to your PC

1 Install latest Arduino IDE software (donrsquot use BETA)

Installing as Windows app also is not recommended

because it will be installed in a specific protected folder that

wonrsquot allow you to install any additional softwareplugin in it

If ProffieBoard wonrsquot show up in COM port use

Arduino IDE 186 version

2 Install the Proffieboard Arduino Plugin and Zadig software

Follow installation instructions

3 Select Proffieboard-STM32L433 in Tools -gt Board

USB Type ndash Serial CPU Speed ndash 80 MHz Optimize ndash Smallest Code DOSFS ndash SDCARD (SPI) Port ndash COM(the number your PC assigned) (Butterfly-L433CC)

Connect Proffieboard via USB cable to PC to be able to select

the Port

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 41

3FIRMWARE UPLOAD AND UPDATE2

Uploading firmware

PROFFIEBOARD INSTRUCTIONS

1 Download the ProffieBoard firmware and SD card content

Unzip lightsaber-1286zip to your Documents directory or to

Desktop but not to Arduino program folder or anywhere in

Programs directory where all programs are installed You will

see a lightsaber folder and files inside it Donrsquot move any of

these files to any other location outside the lightsaber folder

and donrsquot reorganize them Unzip ProffieOS_SD_Cardzip to the

folder where you keep lightsaber-1286 folder Copy all files

from ProffieOS_SD_Card folder to your SD card

2 Unhide file extensions in File Explorer settings to see h ending

of config files Donrsquot add ldquohrdquo to the config file name Go to config folder and create you own configh file (see page

42 for how-to)

Double-click the lightsaberino file

3 Add the name of your configh file as shown and Save this

lightsaberino file Make sure the other config files are

commented out there should be only one CONFIG_FILE

without You can have multiple config files

in lightsabergtconfig folder and just define the one you need

in lightsaberino file and upload it again to ProffieBoard

4 Connect battery to ProffieBoard and hook up to your PC

with a data transfer micro-USB-to-USB cable

Press arrow button it will compile and upload firmware to the

board Wait for red text progress bars to stop at 100

ProffieBoard will play boot sound if speaker is connected

Now you can unplug the USB cable Done

If it gives an error instead this means your configh file has

issues define CONFIG_FILE name has mistakes configh file

is out of config folder your PC user name is non-latin

42 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

33

configh file structure editing

PROFFIEBOARD INSTRUCTIONS

CHANGING PARAMETERS

All sound files (sound fonts music tracks) are stored on the micro SD card Add required sound fonts folders (Plecter NEC and Smoothswing

fonts are supported no need to change WAV files names just copy and paste) to SD card root directory as itrsquos done in the default

ProffieOS_SD_Card content folder and music tracks to the tracks folder

Make sure to name all music tracks and sound fonts folders with latin characters and only up to 8 characters long without using any special

characters (like |[- etc)

Make sure you have a configini file in each sound font folder if there is none - copy one from some default TeensySaberProffieBoard sound

font and paste into newly added sound font folder It has only one parameter that you can modify - humstart It helps to match hum sound

start with blade ignition 1000 usually works fine

All blade effects LED configuration volume level clash sensitivity etc are changed in the configh file located in lightsabergtconfig folder

To do that open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text Editor (Notepad - to see code correctly in Notepad

Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all text) and Delete it then Copy-and-Paste (Ctrl+C

Ctrl+V) your wiring diagram config code into empty _configh file and Save it under new name Follow the instructions on page 39 to

upload it to the board

Proffieboard config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)

volume level (0-3000)

clash sensitivity (adjust lower or higher with 01 step)

sound font folder nametrack name

Preset name

Blade style

LED configuration (use these XP-E2 LED templatesto define your LED)

for Red use 1 Ohm resistor for Green - no resistor for Blue use 024 Ohm

NoLED ndash no 4th led used

Preset 1

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 43

33

Blade Styles

StylePtrltInOutHelperltSimpleClashltLockupltBlastltOnSparkltAudioFlickerltRgblt02550gtRgblt501000gtgtRgblt2552550gt150gtRgblt255500gtgtAudioFlickerltRgblt1002550gtRgblt2550150gtgtgtRgblt255100150gt40gt200300Blackgtgt

ndash this is how the Blade Style code looks pasted in the configh file Preset (it sits inside a StylePtrltgt container)

ndash this is how the Blade Style code looks when editing it inside a Blade Style Editor

Each Blade Style is made of a variety of Effects each added effect goes instead of a base color in the previous effect

PROFFIEBOARD INSTRUCTIONS

CHANGING PARAMETERS

ProffieBoard and TeensySaber use Blade Styles for the main saber blade and any other accent leds to define all light effects (color changing

flashes flickering delays ignitionretraction timing etc)

Use Blade Style Editor to create and adjust Blade Styles Megtooth Sith Sabers did a great video tutorial where he shows and explains

how to use Blade Style Editor Also you can grab some pre-made Blade Styles or share yours here on TRA forums

A Blade Style example of simple flickering Green blade with Spark on start Clash Blaster Lockup and Drag IgnitionRetraction effects

InOutHelperltSimpleClashltLockupltBlastltOnSparkltAudioFlickerltRgblt02550gtRgblt501000gtgtRgblt2552550gt150gtRgblt255500gtgtAudioFlickerltRgblt1002550gtRgblt2550150gtgtgtRgblt255100150gt40gt200300Blackgt

InOutHelperltbase color200300Blackgt ndash base color can be defined by words (WHITE RED GREEN PURPLE etc) or by Rgblt0-2550-2550-255gt values for more

custom shades 200 is extension length in milliseconds 300 is retraction length in milliseconds Black is color when retracted (also can be any other color)

SimpleClashltbase colorclash color40gt ndash clash effect 40 is clash duration in milliseconds

Lockupltbase colorlockup colorgt ndash lockup effect

Blastltbase colorblast colorgt ndash blaster effect

OnSparkltbase colorspark color150gt ndash spark on ignition effect 150 is spark duration in milliseconds

AudioFlickerltrdquoArdquo colorrdquoBrdquo colorgt ndash flickering effect (blade flickers to the actual saber hum sound) the more difference between ldquoArdquo and ldquoBrdquo colors - the more

abrupt is flickering

Rgblt255500gt ndash actual color in RGB format (0 is no light 255 is the maximum brightness value for Red Green or Blue channel)

44 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

ndash SanDisk 4GB microSDHC Class 4 (Genuine) ndash SanDisk 4GB microSDHC Class 4 (Genuine)

130238 kbs = 1477 simultaneous audio streams 137812 kbs = 1562 simultaneous audio streams

ndash Patriot LX Series 16GB microSDHC UHS-IU1 Class 10 ndash Patriot LX Series 16GB microSDHC UHS-IU1 Class 10

133005 kbs = 1508 simultaneous audio streams

ndash GSkill 16GB microSDHC UHS-IU1 Class 10 ndash GSkill 16GB microSDHC UHS-IU1 Class 10

129534 kbs = 1469 simultaneous audio streams

ndash Kingston 16GB microSDHC UHS-IU1 Class 10 ndash Kingston 16GB microSDHC UHS-IU1 Class 10

128090 kbs = 1452 simultaneous audio streams

ndash SanDisk Ultra 16GB microSDHC UHS-IU1 A1 Class 10 ndash SanDisk Ultra 16GB microSDHC UHS-IU1 A1 Class 10

102663 kbs = 1164 simultaneous audio streams 11124 kbs = 1261 simultaneous audio streams

ndash SanDisk 8GB microSDHC Class 4 ndash SanDisk 8GB microSDHC Class 4

108506 kbs = 1230 simultaneous audio streams

ndash SanDisk 16GB microSDHC Class 4 ndash SanDisk 16GB microSDHC Class 4

102663 kbs = 1164 simultaneous audio streams 106957 kbs = 1213 simultaneous audio streams

ndash SanDisk Ultra 16GB microSDHC UHS-IU1 Class 10 ndash SanDisk Ultra 16GB microSDHC UHS-IU1 Class 10

102663 kbs = 1164 simultaneous audio streams 103909 kbs = 1178 simultaneous audio streams

ndash Smartbuy 4GB microSDHC Class 4 ndash Smartbuy 4GB microSDHC Class 4

75437 kbs = 855 simultaneous audio streams

ndash Kingston 8GB microSDHC Class 4 ndash Kingston 8GB microSDHC Class 4

75209 kbs = 822 simultaneous audio streams

ndash SanDisk 4GB microSDHC Class 4 (Fake) ndash SanDisk 4GB microSDHC Class 4 (Fake)

677 kbs = 769 simultaneous audio streams

Here is a list of tested micro SD cards speed with TeensySaber V3 and ProffieBoard Any card with speed over 900 kbs is recommended the

higher the speed is ndash the better Memory size of 4-16Gb is more than enough Cards were tested with a default firmware (1291) compiled

with ldquoSmallest Coderdquo under Optimize ldquodefault_proffieboard_confighrdquo file and default ProffieOS SD card sound files (7 folders)

To test your SD card speed simply hook up ProffieBoard to PC open Arduino IDE go to Tools and open Serial Monitor make sure you have

New Line and 9600 baud rate selected on the bottom of Serial Monitor window type and send sdtest command wait for the test result

4Recommended micro SD cards

BEST

TEENSYSABER PROFFIEBOARD

GOOD

BAD

PROFFIEBOARD INSTRUCTIONS

SD CARD RECOMMENDATIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 45

There are a lot of fake (chinese copies) microSD cards on the market from aliexpress ebay amazon etc They look very similar to genuine

cards but are a bit different though and have a twice lower writingreading speed Here is an example of a SanDisk 4Gb Class 4 card one is

genuine with 137812 kbs speed and the other one is fake with 677 kbs speed I got from ebay seller

Be carefull and pay attention to how the actual card looks if you are not sure ask seller for the real photo of SD card he sells

4Genuine and Fake SanDisk 4Gb Class 4 microSD

PROFFIEBOARD INSTRUCTIONS

SD CARD RECOMMENDATIONS

46 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

WIRE GAUGE GUIDE

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 47

RECHARGE PORTS AND KILL SWITCHES

48 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

NEOPIXEL STRIPS CURRENT DRAW

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 49

6TROUBLESHOOTING

For more help please check these linksProffieOSProffieBoardTeensySaber wiki on GitHubAsk your question on The Rebel Armory forumsAsk your question on FX-sabers forumsAsk your question in facebook group

How to solve most common issues

Quick troubleshooting tips

TeensySaber board or Proffieboard is not recognized by computer (nothing under Port selection in Arduino)

ndash Make sure a charged 37V battery is connected to the board micro-USB cable is a data transfer cable all plugins and drivers are installed ndash

check again pages 21 for TeensySaber or 40 for Proffieboard Try a different USB port on your computer

Sketch (code) compile error in Arduino IDE

ndash Check your define CONFIG_FILE ldquoconfig_confighrdquo line in opened lightsaberino file if itrsquos written correctly with config in it

Sketch (code) compile error in Arduino IDE

ndash Check if the _configh file you defined in the lightsaberino sketch file is same name as in the lightsaber-rdquofirmware versionrdquolightsaber

config folder and is located in this folder

Sketch (code) compile error in Arduino IDE

ndash Check your settings under Tools tab in Arduino IDE program Check again pages 21 for TeensySaber or 40 for Proffieboard

Sketch (code) compile error in Arduino IDE

ndash Check if your _configh file is correct Blade Styles Presets const unsigned int maxLedsPerStrip = 144 if BladeConfig blades[] = is correct

Sketch (code) compile error in Arduino IDE

ndash If nothing helps install Arduino IDE version 186 and try to compile and upload the firmware again

Sound doesnrsquot play

ndash Remove SD card and insert again check speaker wiring Make sure all sound files on SD card are correctly named (8 characters max long)

Re-format SD card in FAT32 load sound files and try again try another SD card

Board says ldquoLOW POWERrdquo

ndash Charge the battery

Serial Monitor shows info sent by the board but your commands donrsquot work

ndash In the bottom right corner of Serial Monitor window make sure the Line Ending drop down is set to New Line

Sound is weird and distorted

ndash Check your SD card speed (see page 44) Check speaker wiring try another good speaker

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 27

3WIRING DIAGRAMS1

Basic Tri-Cree wiring (In-hilt LED)ldquoconfighrdquo file setup

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

Use a given or build your wiring diagram on THIS PAGE then open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text

Editor (Notepad - to see code correctly in Notepad Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all

text) and Delete it then Copy-and-Paste (Ctrl+C Ctrl+V) your wiring diagram config code (example below) into empty _configh file and

Save it under new name Follow the instructions on page 22 to upload it to the board

ldquoproffieboard_v1_confighrdquoNUM_BLADES 2NUM_BUTTONS 2VOLUME 1000CLASH_THRESHOLD_G 10StyleNormalPtrltCYAN WHITE 300 800gt()StyleNormalPtrltCYAN WHITE 300 800gt()

CreeXPE2RedTemplatelt1000gtCreeXPE2GreenTemplatelt0gtCreeXPE2BlueTemplatelt240gtNoLED

ProffieBoard config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)Volume level (0-3000)Clash sensitivity (adjust lower or higher with 01 step)ldquoBlade 1rdquo styleldquoBlade 2rdquo style (in case only 1 blade is used you donrsquot need this line)LED configuration (use these XP-E2 LED templatesto define your LED If other LED resistors are used change these values to match Ohm1000=ltvaluegt)

where 1000 is 1 Ohm resistor 0 is no resistor240 is 024 Ohm resistorNoLED ndash no 4th led used

Preset 1

LED 1 configuration

LED 2 configuration

Preset 2 etc

PROFFIEBOARD INSTRUCTIONS

28 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Basic Neopixel wiring diagram

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

+

+

-

-

22 A

WG

22 AWG

x2 28 AWG

x2 26 AWG

22 A

WG

30-32 AWG30-32 AWG

Protected 36-37V (42V max at full charge) 10A 3500mAh or 15A 3120mAhbattery recommended+18650 battery holder (optional)Keystone 1042P

AV switch with accent led(constantly ON no effects)

accent leds run mostly at10-15mA so resistors for them must be calculated accordingly

Main Neopixel strip

additional Neopixelstrips(optional)

Neopixel bladeconnector

330 Ohm on the Blade pcb side

x3 28 AWGor x1 22 AWGfor Negative

330 Ohm on the Blade pcb side

arrows up

330 Ohm on the Blade pcb side

In case no additional Neopixel strips are needed LED channels 4 5 6 can be used for 3 controllable(programmable for different effects) accent leds So AV switch led can be wired to one of these channelsAccent leds also can be wired to Data pads 2-5 please see ldquoAccent LEDs wiring and setuprdquo page

Recommended power wire gauges (22 AWG) are given for 2-strip blade For 3-strip blade you gonna need at least 20 AWG wires

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 29

ldquoproffieboard_v1_confighrdquo

3WIRING DIAGRAMS1

Basic Neopixel wiringldquoconfighrdquo file setup

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

NUM_BLADES 3NUM_BUTTONS 2VOLUME 1000CLASH_THRESHOLD_G 10IgnitionDelaylt0 any blade stylegtIgnitionDelaylt800 any blade stylegtIgnitionDelaylt800 any blade stylegtWS2811BladePtrlt118 WS2811 800kHz | WS2811 GRBgt()WS2811BladePtrlt26 blade2Pin ltbladePowerPin4gtgt()WS2811BladePtrlt26 blade3Pin ltbladePowerPin5gtgt()

ProffieBoard config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)Volume level (0-3000)Clash sensitivity (adjust lower or higher with 01 step)ldquoBlade 1rdquo style (main blade with IgnitionDelay 0)ldquoBlade 2rdquo style (CG blade 1 with IgnitionDelay 800)ldquoBlade 3rdquo style (CG blade 2 with IgnitionDelay 800)

strip configuration (defines how many pixels it has and to which LED output and pin is wired)

Preset 1

any blade style

strip (blade) 1 configuration

adjust this number to match your strips leds count

strip (blade) 2 configuration

strip (blade) 3 configuration

Preset 2 etc

Use a given or build your wiring diagram on THIS PAGE then open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text

Editor (Notepad - to see code correctly in Notepad Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all

text) and Delete it then Copy-and-Paste (Ctrl+C Ctrl+V) your wiring diagram config code (example below) into empty _configh file and

Save it under new name Follow the instructions on page 22 to upload it to the board

PROFFIEBOARD INSTRUCTIONS

30 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Basic Segmented string wiring diagram

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

+

+

-

-

24 A

WG

28 AWG

30-32 AWG30-32 AWG

Protected 36-37V (42V max at full charge) 10A 3500mAh battery recommended+18650 battery holder (optional)Keystone 1042P

AV switch with accent led(constantly ON no effects)

accent leds run mostly at10-15mA so resistors for them must be calculated accordingly

6-segments string blade

FoC string

N-channel FET3A minimum

123456

Calculate resistors for each led segment of the blade string depending on which leds are used 5mm leds have max drive current around 25mA per led when 10mm leds can be 100mA and 200mA per ledSo pay attention to your led max current and Forward Voltage (Vf) when calculating a segment resistor resistence as well as its wattage Also choose wire gauges accordingly to meet segments and total blade max current draw level

LED Resistor Calculator

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 31

ldquoproffieboard_v1_confighrdquo

3WIRING DIAGRAMS1

Basic Segmented string wiringldquoconfighrdquo file setup

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

NUM_BLADES 1NUM_BUTTONS 2VOLUME 1000CLASH_THRESHOLD_G 10StyleNormalPtrltCYAN WHITE 300 800gt()ltBlue3mmLED BladePin White3mmLEDgt

ProffieBoard config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)Volume level (0-3000)Clash sensitivity (adjust lower or higher with 01 step)Blade styleLED string configuration(here you mention the color and type of leds usedin the main blade string segments and FoC stringBladePin is the FoC signal pin (Blade ID pin))

Preset

LED string configuration

Use a given or build your wiring diagram on THIS PAGE then open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text

Editor (Notepad - to see code correctly in Notepad Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all

text) and Delete it then Copy-and-Paste (Ctrl+C Ctrl+V) your wiring diagram config code (example below) into empty _configh file and

Save it under new name Follow the instructions on page 22 to upload it to the board

PROFFIEBOARD INSTRUCTIONS

32 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Accent LEDs wiring diagram(optional)

Accent LEDs work with ProffieBoard as additional ldquobladesrdquo when powered by LED outputs 4 5 6 or Data pads 1 2 3 5 as PWM So they can

have any effect that blade can have If no effects needed accent led can be powered just by a 33V output pad (power-on led indication)

30-32 AWG

with Neopixel blade setup these 4 outputsdonrsquot work for regular accent leds

Recommended resistors to use for accent leds at 33V power source and 15mA drive

ndash 100 Ohm for Red (lt100000gt value in the code)ndash 13 Ohm for Green (lt13000gt value in the code)ndash 13 Ohm for Blue (lt13000gt value in the code)ndash 100 Ohm for Yellow (lt100000gt value in the code)ndash 20 Ohm for White (lt20000gt value in the code)

RGB ledcommon-anode

8 ldquobladesrdquo1 main and 7 accent leds

main blade style (effects) main blade style (effects)

7 accent leds style (effects)accent led style (effects)

7 accent leds configurations

RGB accent led configuration

2 ldquobladesrdquo1 main and 1 RGB accent led

ldquoPower-onrdquo indicationaccent leds (no effects)

7 accent leds withindependent effects

RGB accent led

a) b)

b)

c)

c)

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 33

3WIRING DIAGRAMS1

Neopixel Accent LEDs wiring diagram(optional)

With Neopixel setup additional neopixel leds or arrays can be used as accent leds There are 2 ways to wire them using additional Data

pins 2 3 4 5 or ldquoSub-bladesrdquo wiring with just 1 Data output pin Same way Neopixel connectors with on-board leds ca be wired

Option 1 ndash with extra Data pins

Main Blade

some accent leds

D1

D2

crystal leds

330 Ohm

330 Ohm

330 Ohm

main blade style (effects)

main blade 144 leds Data pin 1

accent leds blade style (effects)

accent leds ldquobladerdquo 4 leds Data pin 2

crystal leds blade style (effects)

crystal leds ldquobladerdquo 2 leds Data pin 3

3 ldquobladesrdquo1 main 1 accent leds array and 1 crystal leds array

PROFFIEBOARD INSTRUCTIONS

D3

follow arrows direction

34 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Neopixel Accent LEDs wiring diagram(optional)

PROFFIEBOARD INSTRUCTIONS

Main Blade

some accent leds

1

3

5678

2

4

D1

crystal leds

follow arrows direction

330 Ohm

330 OhmData signal

With this setup a single array of neopixel leds is separated into a couple of sub-blades with their own style configuration and behaviour This

is really usefull when you want to use only one data pin More about ldquoSub-bladesrdquo on ProffieOS wiki page

Option 2 ndash with ldquoSub-bladesrdquo

main blade style (effects)

main blade sub-blade 140 leds (7-146) but from 6 to 145 in the code

accent leds blade style (effects)

accent leds sub-blade 4 leds (1-4) but from 0 to 3 in the code

crystal leds blade style (effects)

146 leds total used

crystal leds sub-blade 2 leds (5-6) but from 4 to 5 in the code

update default 144 to a higher total value if you get all accent leds +Main blade gt 144 Example update to 146 if you have 2 crystal leds +4 accent leds + 140 Main blade leds = 146

3 ldquobladesrdquo 1 main 1 accent leds array and 1 crystal leds array

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 35

3WIRING DIAGRAMS1

OLED display wiring diagram(optional)

SSD1306 128x32 pixels OLED display allows to show battery level current preset name play different animations and even simple games It

can be wired to any blade configuration and requires just one additional line in the code to work You can get monochrome display in white

or blue color

SSD1306128x32OLED

SSD1306 ndash with blue or white display color selectSSD1306 ndash cheaper priceSSD1306 just screen ndash blue or white select

30-32 AWG

30-32 AWG

add this line to enable OLED display

display shows a preset name written in these quotes ldquoldquo

PROFFIEBOARD INSTRUCTIONS

36 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Bluetooth module wiring diagram(optional)

SOON

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 37

3WIRING DIAGRAMS1

Blade ID resistor functions(optional)

SOON

PROFFIEBOARD INSTRUCTIONS

38 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

website ProffieBoard FULL wiring diagrams link

Scroll the page down till you see the interactive diagram Above the diagram there are components selection options Build your saber setup

with it and follow diagram to wire your board Then you need to copy the configuration code below and paste it into your _configh file

Choose components you want

3WIRING DIAGRAMS1

More wiring diagrams

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 39

3WIRING DIAGRAMS1

How to use it

PROFFIEBOARD INSTRUCTIONS

Blade ignitionretraction ndash assuming you have at least one button pressing it briefly should turn the saber on or off If you have an AUX button pressing it briefly should also turn the saber on and off If you have no buttons you can turn the saber on and off by twisting your wrist back and forth Note that the motion has to be done long enough to count so a very quick flick of the wrist will not workTurn On muted ndash double-click power buttonNext preset ndash while saber is off click the AUX buttonPrevious preset ndash hold AUX button and click the Activation buttonTrigger Clash ndash while saber is on hit the bladeTrigger Lockup ndash while saber is on hold Activation button then trigger a clash Lockup releases when you let go of the Acti-vation buttonTrigger Drag ndash like lockup but point saber mostly down before holding Activation buttonTrigger Force ndash long-click AUX buttonStart soundtrack ndash long-click the Activation buttonTrigger Blaster Block ndash while saber is on short-click AUX button

Serial Monitor commands

battery_voltage ndash gets current battery voltage valueget_volume ndash get current volume valuepow ndash power OnOff the saberon ndash power On the saberoff ndash power Off the saberset_volume lt0-3000gt ndash set volume value (example set_volume 500)play ndash play the default preset trackplay trackslttrack namegt ndash play a specific track from tracks folder (example play tracksvenuswav)stop ndash stop the playing trackforce ndash play ldquoforcerdquo sound effectsdrag ndash play ldquodragrdquo sound effectsblast ndash play ldquoblasterrdquo sound effectslock ndash play ldquolockuprdquo sound effectsclash ndash play ldquoclashrdquo sound effectsreset ndash reboot the boardn ndash switch to next presetp ndash switch to previous presetlist_presets ndash show all presetssdtest ndash test SD card speed

40 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3FIRMWARE UPLOAD AND UPDATE2

Software installation and setup

PROFFIEBOARD INSTRUCTIONS

To upload firmware to ProffieBoard Arduino IDE program is required Follow these steps to install it to your PC

1 Install latest Arduino IDE software (donrsquot use BETA)

Installing as Windows app also is not recommended

because it will be installed in a specific protected folder that

wonrsquot allow you to install any additional softwareplugin in it

If ProffieBoard wonrsquot show up in COM port use

Arduino IDE 186 version

2 Install the Proffieboard Arduino Plugin and Zadig software

Follow installation instructions

3 Select Proffieboard-STM32L433 in Tools -gt Board

USB Type ndash Serial CPU Speed ndash 80 MHz Optimize ndash Smallest Code DOSFS ndash SDCARD (SPI) Port ndash COM(the number your PC assigned) (Butterfly-L433CC)

Connect Proffieboard via USB cable to PC to be able to select

the Port

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 41

3FIRMWARE UPLOAD AND UPDATE2

Uploading firmware

PROFFIEBOARD INSTRUCTIONS

1 Download the ProffieBoard firmware and SD card content

Unzip lightsaber-1286zip to your Documents directory or to

Desktop but not to Arduino program folder or anywhere in

Programs directory where all programs are installed You will

see a lightsaber folder and files inside it Donrsquot move any of

these files to any other location outside the lightsaber folder

and donrsquot reorganize them Unzip ProffieOS_SD_Cardzip to the

folder where you keep lightsaber-1286 folder Copy all files

from ProffieOS_SD_Card folder to your SD card

2 Unhide file extensions in File Explorer settings to see h ending

of config files Donrsquot add ldquohrdquo to the config file name Go to config folder and create you own configh file (see page

42 for how-to)

Double-click the lightsaberino file

3 Add the name of your configh file as shown and Save this

lightsaberino file Make sure the other config files are

commented out there should be only one CONFIG_FILE

without You can have multiple config files

in lightsabergtconfig folder and just define the one you need

in lightsaberino file and upload it again to ProffieBoard

4 Connect battery to ProffieBoard and hook up to your PC

with a data transfer micro-USB-to-USB cable

Press arrow button it will compile and upload firmware to the

board Wait for red text progress bars to stop at 100

ProffieBoard will play boot sound if speaker is connected

Now you can unplug the USB cable Done

If it gives an error instead this means your configh file has

issues define CONFIG_FILE name has mistakes configh file

is out of config folder your PC user name is non-latin

42 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

33

configh file structure editing

PROFFIEBOARD INSTRUCTIONS

CHANGING PARAMETERS

All sound files (sound fonts music tracks) are stored on the micro SD card Add required sound fonts folders (Plecter NEC and Smoothswing

fonts are supported no need to change WAV files names just copy and paste) to SD card root directory as itrsquos done in the default

ProffieOS_SD_Card content folder and music tracks to the tracks folder

Make sure to name all music tracks and sound fonts folders with latin characters and only up to 8 characters long without using any special

characters (like |[- etc)

Make sure you have a configini file in each sound font folder if there is none - copy one from some default TeensySaberProffieBoard sound

font and paste into newly added sound font folder It has only one parameter that you can modify - humstart It helps to match hum sound

start with blade ignition 1000 usually works fine

All blade effects LED configuration volume level clash sensitivity etc are changed in the configh file located in lightsabergtconfig folder

To do that open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text Editor (Notepad - to see code correctly in Notepad

Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all text) and Delete it then Copy-and-Paste (Ctrl+C

Ctrl+V) your wiring diagram config code into empty _configh file and Save it under new name Follow the instructions on page 39 to

upload it to the board

Proffieboard config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)

volume level (0-3000)

clash sensitivity (adjust lower or higher with 01 step)

sound font folder nametrack name

Preset name

Blade style

LED configuration (use these XP-E2 LED templatesto define your LED)

for Red use 1 Ohm resistor for Green - no resistor for Blue use 024 Ohm

NoLED ndash no 4th led used

Preset 1

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 43

33

Blade Styles

StylePtrltInOutHelperltSimpleClashltLockupltBlastltOnSparkltAudioFlickerltRgblt02550gtRgblt501000gtgtRgblt2552550gt150gtRgblt255500gtgtAudioFlickerltRgblt1002550gtRgblt2550150gtgtgtRgblt255100150gt40gt200300Blackgtgt

ndash this is how the Blade Style code looks pasted in the configh file Preset (it sits inside a StylePtrltgt container)

ndash this is how the Blade Style code looks when editing it inside a Blade Style Editor

Each Blade Style is made of a variety of Effects each added effect goes instead of a base color in the previous effect

PROFFIEBOARD INSTRUCTIONS

CHANGING PARAMETERS

ProffieBoard and TeensySaber use Blade Styles for the main saber blade and any other accent leds to define all light effects (color changing

flashes flickering delays ignitionretraction timing etc)

Use Blade Style Editor to create and adjust Blade Styles Megtooth Sith Sabers did a great video tutorial where he shows and explains

how to use Blade Style Editor Also you can grab some pre-made Blade Styles or share yours here on TRA forums

A Blade Style example of simple flickering Green blade with Spark on start Clash Blaster Lockup and Drag IgnitionRetraction effects

InOutHelperltSimpleClashltLockupltBlastltOnSparkltAudioFlickerltRgblt02550gtRgblt501000gtgtRgblt2552550gt150gtRgblt255500gtgtAudioFlickerltRgblt1002550gtRgblt2550150gtgtgtRgblt255100150gt40gt200300Blackgt

InOutHelperltbase color200300Blackgt ndash base color can be defined by words (WHITE RED GREEN PURPLE etc) or by Rgblt0-2550-2550-255gt values for more

custom shades 200 is extension length in milliseconds 300 is retraction length in milliseconds Black is color when retracted (also can be any other color)

SimpleClashltbase colorclash color40gt ndash clash effect 40 is clash duration in milliseconds

Lockupltbase colorlockup colorgt ndash lockup effect

Blastltbase colorblast colorgt ndash blaster effect

OnSparkltbase colorspark color150gt ndash spark on ignition effect 150 is spark duration in milliseconds

AudioFlickerltrdquoArdquo colorrdquoBrdquo colorgt ndash flickering effect (blade flickers to the actual saber hum sound) the more difference between ldquoArdquo and ldquoBrdquo colors - the more

abrupt is flickering

Rgblt255500gt ndash actual color in RGB format (0 is no light 255 is the maximum brightness value for Red Green or Blue channel)

44 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

ndash SanDisk 4GB microSDHC Class 4 (Genuine) ndash SanDisk 4GB microSDHC Class 4 (Genuine)

130238 kbs = 1477 simultaneous audio streams 137812 kbs = 1562 simultaneous audio streams

ndash Patriot LX Series 16GB microSDHC UHS-IU1 Class 10 ndash Patriot LX Series 16GB microSDHC UHS-IU1 Class 10

133005 kbs = 1508 simultaneous audio streams

ndash GSkill 16GB microSDHC UHS-IU1 Class 10 ndash GSkill 16GB microSDHC UHS-IU1 Class 10

129534 kbs = 1469 simultaneous audio streams

ndash Kingston 16GB microSDHC UHS-IU1 Class 10 ndash Kingston 16GB microSDHC UHS-IU1 Class 10

128090 kbs = 1452 simultaneous audio streams

ndash SanDisk Ultra 16GB microSDHC UHS-IU1 A1 Class 10 ndash SanDisk Ultra 16GB microSDHC UHS-IU1 A1 Class 10

102663 kbs = 1164 simultaneous audio streams 11124 kbs = 1261 simultaneous audio streams

ndash SanDisk 8GB microSDHC Class 4 ndash SanDisk 8GB microSDHC Class 4

108506 kbs = 1230 simultaneous audio streams

ndash SanDisk 16GB microSDHC Class 4 ndash SanDisk 16GB microSDHC Class 4

102663 kbs = 1164 simultaneous audio streams 106957 kbs = 1213 simultaneous audio streams

ndash SanDisk Ultra 16GB microSDHC UHS-IU1 Class 10 ndash SanDisk Ultra 16GB microSDHC UHS-IU1 Class 10

102663 kbs = 1164 simultaneous audio streams 103909 kbs = 1178 simultaneous audio streams

ndash Smartbuy 4GB microSDHC Class 4 ndash Smartbuy 4GB microSDHC Class 4

75437 kbs = 855 simultaneous audio streams

ndash Kingston 8GB microSDHC Class 4 ndash Kingston 8GB microSDHC Class 4

75209 kbs = 822 simultaneous audio streams

ndash SanDisk 4GB microSDHC Class 4 (Fake) ndash SanDisk 4GB microSDHC Class 4 (Fake)

677 kbs = 769 simultaneous audio streams

Here is a list of tested micro SD cards speed with TeensySaber V3 and ProffieBoard Any card with speed over 900 kbs is recommended the

higher the speed is ndash the better Memory size of 4-16Gb is more than enough Cards were tested with a default firmware (1291) compiled

with ldquoSmallest Coderdquo under Optimize ldquodefault_proffieboard_confighrdquo file and default ProffieOS SD card sound files (7 folders)

To test your SD card speed simply hook up ProffieBoard to PC open Arduino IDE go to Tools and open Serial Monitor make sure you have

New Line and 9600 baud rate selected on the bottom of Serial Monitor window type and send sdtest command wait for the test result

4Recommended micro SD cards

BEST

TEENSYSABER PROFFIEBOARD

GOOD

BAD

PROFFIEBOARD INSTRUCTIONS

SD CARD RECOMMENDATIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 45

There are a lot of fake (chinese copies) microSD cards on the market from aliexpress ebay amazon etc They look very similar to genuine

cards but are a bit different though and have a twice lower writingreading speed Here is an example of a SanDisk 4Gb Class 4 card one is

genuine with 137812 kbs speed and the other one is fake with 677 kbs speed I got from ebay seller

Be carefull and pay attention to how the actual card looks if you are not sure ask seller for the real photo of SD card he sells

4Genuine and Fake SanDisk 4Gb Class 4 microSD

PROFFIEBOARD INSTRUCTIONS

SD CARD RECOMMENDATIONS

46 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

WIRE GAUGE GUIDE

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 47

RECHARGE PORTS AND KILL SWITCHES

48 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

NEOPIXEL STRIPS CURRENT DRAW

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 49

6TROUBLESHOOTING

For more help please check these linksProffieOSProffieBoardTeensySaber wiki on GitHubAsk your question on The Rebel Armory forumsAsk your question on FX-sabers forumsAsk your question in facebook group

How to solve most common issues

Quick troubleshooting tips

TeensySaber board or Proffieboard is not recognized by computer (nothing under Port selection in Arduino)

ndash Make sure a charged 37V battery is connected to the board micro-USB cable is a data transfer cable all plugins and drivers are installed ndash

check again pages 21 for TeensySaber or 40 for Proffieboard Try a different USB port on your computer

Sketch (code) compile error in Arduino IDE

ndash Check your define CONFIG_FILE ldquoconfig_confighrdquo line in opened lightsaberino file if itrsquos written correctly with config in it

Sketch (code) compile error in Arduino IDE

ndash Check if the _configh file you defined in the lightsaberino sketch file is same name as in the lightsaber-rdquofirmware versionrdquolightsaber

config folder and is located in this folder

Sketch (code) compile error in Arduino IDE

ndash Check your settings under Tools tab in Arduino IDE program Check again pages 21 for TeensySaber or 40 for Proffieboard

Sketch (code) compile error in Arduino IDE

ndash Check if your _configh file is correct Blade Styles Presets const unsigned int maxLedsPerStrip = 144 if BladeConfig blades[] = is correct

Sketch (code) compile error in Arduino IDE

ndash If nothing helps install Arduino IDE version 186 and try to compile and upload the firmware again

Sound doesnrsquot play

ndash Remove SD card and insert again check speaker wiring Make sure all sound files on SD card are correctly named (8 characters max long)

Re-format SD card in FAT32 load sound files and try again try another SD card

Board says ldquoLOW POWERrdquo

ndash Charge the battery

Serial Monitor shows info sent by the board but your commands donrsquot work

ndash In the bottom right corner of Serial Monitor window make sure the Line Ending drop down is set to New Line

Sound is weird and distorted

ndash Check your SD card speed (see page 44) Check speaker wiring try another good speaker

28 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Basic Neopixel wiring diagram

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

+

+

-

-

22 A

WG

22 AWG

x2 28 AWG

x2 26 AWG

22 A

WG

30-32 AWG30-32 AWG

Protected 36-37V (42V max at full charge) 10A 3500mAh or 15A 3120mAhbattery recommended+18650 battery holder (optional)Keystone 1042P

AV switch with accent led(constantly ON no effects)

accent leds run mostly at10-15mA so resistors for them must be calculated accordingly

Main Neopixel strip

additional Neopixelstrips(optional)

Neopixel bladeconnector

330 Ohm on the Blade pcb side

x3 28 AWGor x1 22 AWGfor Negative

330 Ohm on the Blade pcb side

arrows up

330 Ohm on the Blade pcb side

In case no additional Neopixel strips are needed LED channels 4 5 6 can be used for 3 controllable(programmable for different effects) accent leds So AV switch led can be wired to one of these channelsAccent leds also can be wired to Data pads 2-5 please see ldquoAccent LEDs wiring and setuprdquo page

Recommended power wire gauges (22 AWG) are given for 2-strip blade For 3-strip blade you gonna need at least 20 AWG wires

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 29

ldquoproffieboard_v1_confighrdquo

3WIRING DIAGRAMS1

Basic Neopixel wiringldquoconfighrdquo file setup

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

NUM_BLADES 3NUM_BUTTONS 2VOLUME 1000CLASH_THRESHOLD_G 10IgnitionDelaylt0 any blade stylegtIgnitionDelaylt800 any blade stylegtIgnitionDelaylt800 any blade stylegtWS2811BladePtrlt118 WS2811 800kHz | WS2811 GRBgt()WS2811BladePtrlt26 blade2Pin ltbladePowerPin4gtgt()WS2811BladePtrlt26 blade3Pin ltbladePowerPin5gtgt()

ProffieBoard config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)Volume level (0-3000)Clash sensitivity (adjust lower or higher with 01 step)ldquoBlade 1rdquo style (main blade with IgnitionDelay 0)ldquoBlade 2rdquo style (CG blade 1 with IgnitionDelay 800)ldquoBlade 3rdquo style (CG blade 2 with IgnitionDelay 800)

strip configuration (defines how many pixels it has and to which LED output and pin is wired)

Preset 1

any blade style

strip (blade) 1 configuration

adjust this number to match your strips leds count

strip (blade) 2 configuration

strip (blade) 3 configuration

Preset 2 etc

Use a given or build your wiring diagram on THIS PAGE then open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text

Editor (Notepad - to see code correctly in Notepad Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all

text) and Delete it then Copy-and-Paste (Ctrl+C Ctrl+V) your wiring diagram config code (example below) into empty _configh file and

Save it under new name Follow the instructions on page 22 to upload it to the board

PROFFIEBOARD INSTRUCTIONS

30 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Basic Segmented string wiring diagram

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

+

+

-

-

24 A

WG

28 AWG

30-32 AWG30-32 AWG

Protected 36-37V (42V max at full charge) 10A 3500mAh battery recommended+18650 battery holder (optional)Keystone 1042P

AV switch with accent led(constantly ON no effects)

accent leds run mostly at10-15mA so resistors for them must be calculated accordingly

6-segments string blade

FoC string

N-channel FET3A minimum

123456

Calculate resistors for each led segment of the blade string depending on which leds are used 5mm leds have max drive current around 25mA per led when 10mm leds can be 100mA and 200mA per ledSo pay attention to your led max current and Forward Voltage (Vf) when calculating a segment resistor resistence as well as its wattage Also choose wire gauges accordingly to meet segments and total blade max current draw level

LED Resistor Calculator

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 31

ldquoproffieboard_v1_confighrdquo

3WIRING DIAGRAMS1

Basic Segmented string wiringldquoconfighrdquo file setup

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

NUM_BLADES 1NUM_BUTTONS 2VOLUME 1000CLASH_THRESHOLD_G 10StyleNormalPtrltCYAN WHITE 300 800gt()ltBlue3mmLED BladePin White3mmLEDgt

ProffieBoard config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)Volume level (0-3000)Clash sensitivity (adjust lower or higher with 01 step)Blade styleLED string configuration(here you mention the color and type of leds usedin the main blade string segments and FoC stringBladePin is the FoC signal pin (Blade ID pin))

Preset

LED string configuration

Use a given or build your wiring diagram on THIS PAGE then open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text

Editor (Notepad - to see code correctly in Notepad Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all

text) and Delete it then Copy-and-Paste (Ctrl+C Ctrl+V) your wiring diagram config code (example below) into empty _configh file and

Save it under new name Follow the instructions on page 22 to upload it to the board

PROFFIEBOARD INSTRUCTIONS

32 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Accent LEDs wiring diagram(optional)

Accent LEDs work with ProffieBoard as additional ldquobladesrdquo when powered by LED outputs 4 5 6 or Data pads 1 2 3 5 as PWM So they can

have any effect that blade can have If no effects needed accent led can be powered just by a 33V output pad (power-on led indication)

30-32 AWG

with Neopixel blade setup these 4 outputsdonrsquot work for regular accent leds

Recommended resistors to use for accent leds at 33V power source and 15mA drive

ndash 100 Ohm for Red (lt100000gt value in the code)ndash 13 Ohm for Green (lt13000gt value in the code)ndash 13 Ohm for Blue (lt13000gt value in the code)ndash 100 Ohm for Yellow (lt100000gt value in the code)ndash 20 Ohm for White (lt20000gt value in the code)

RGB ledcommon-anode

8 ldquobladesrdquo1 main and 7 accent leds

main blade style (effects) main blade style (effects)

7 accent leds style (effects)accent led style (effects)

7 accent leds configurations

RGB accent led configuration

2 ldquobladesrdquo1 main and 1 RGB accent led

ldquoPower-onrdquo indicationaccent leds (no effects)

7 accent leds withindependent effects

RGB accent led

a) b)

b)

c)

c)

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 33

3WIRING DIAGRAMS1

Neopixel Accent LEDs wiring diagram(optional)

With Neopixel setup additional neopixel leds or arrays can be used as accent leds There are 2 ways to wire them using additional Data

pins 2 3 4 5 or ldquoSub-bladesrdquo wiring with just 1 Data output pin Same way Neopixel connectors with on-board leds ca be wired

Option 1 ndash with extra Data pins

Main Blade

some accent leds

D1

D2

crystal leds

330 Ohm

330 Ohm

330 Ohm

main blade style (effects)

main blade 144 leds Data pin 1

accent leds blade style (effects)

accent leds ldquobladerdquo 4 leds Data pin 2

crystal leds blade style (effects)

crystal leds ldquobladerdquo 2 leds Data pin 3

3 ldquobladesrdquo1 main 1 accent leds array and 1 crystal leds array

PROFFIEBOARD INSTRUCTIONS

D3

follow arrows direction

34 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Neopixel Accent LEDs wiring diagram(optional)

PROFFIEBOARD INSTRUCTIONS

Main Blade

some accent leds

1

3

5678

2

4

D1

crystal leds

follow arrows direction

330 Ohm

330 OhmData signal

With this setup a single array of neopixel leds is separated into a couple of sub-blades with their own style configuration and behaviour This

is really usefull when you want to use only one data pin More about ldquoSub-bladesrdquo on ProffieOS wiki page

Option 2 ndash with ldquoSub-bladesrdquo

main blade style (effects)

main blade sub-blade 140 leds (7-146) but from 6 to 145 in the code

accent leds blade style (effects)

accent leds sub-blade 4 leds (1-4) but from 0 to 3 in the code

crystal leds blade style (effects)

146 leds total used

crystal leds sub-blade 2 leds (5-6) but from 4 to 5 in the code

update default 144 to a higher total value if you get all accent leds +Main blade gt 144 Example update to 146 if you have 2 crystal leds +4 accent leds + 140 Main blade leds = 146

3 ldquobladesrdquo 1 main 1 accent leds array and 1 crystal leds array

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 35

3WIRING DIAGRAMS1

OLED display wiring diagram(optional)

SSD1306 128x32 pixels OLED display allows to show battery level current preset name play different animations and even simple games It

can be wired to any blade configuration and requires just one additional line in the code to work You can get monochrome display in white

or blue color

SSD1306128x32OLED

SSD1306 ndash with blue or white display color selectSSD1306 ndash cheaper priceSSD1306 just screen ndash blue or white select

30-32 AWG

30-32 AWG

add this line to enable OLED display

display shows a preset name written in these quotes ldquoldquo

PROFFIEBOARD INSTRUCTIONS

36 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Bluetooth module wiring diagram(optional)

SOON

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 37

3WIRING DIAGRAMS1

Blade ID resistor functions(optional)

SOON

PROFFIEBOARD INSTRUCTIONS

38 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

website ProffieBoard FULL wiring diagrams link

Scroll the page down till you see the interactive diagram Above the diagram there are components selection options Build your saber setup

with it and follow diagram to wire your board Then you need to copy the configuration code below and paste it into your _configh file

Choose components you want

3WIRING DIAGRAMS1

More wiring diagrams

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 39

3WIRING DIAGRAMS1

How to use it

PROFFIEBOARD INSTRUCTIONS

Blade ignitionretraction ndash assuming you have at least one button pressing it briefly should turn the saber on or off If you have an AUX button pressing it briefly should also turn the saber on and off If you have no buttons you can turn the saber on and off by twisting your wrist back and forth Note that the motion has to be done long enough to count so a very quick flick of the wrist will not workTurn On muted ndash double-click power buttonNext preset ndash while saber is off click the AUX buttonPrevious preset ndash hold AUX button and click the Activation buttonTrigger Clash ndash while saber is on hit the bladeTrigger Lockup ndash while saber is on hold Activation button then trigger a clash Lockup releases when you let go of the Acti-vation buttonTrigger Drag ndash like lockup but point saber mostly down before holding Activation buttonTrigger Force ndash long-click AUX buttonStart soundtrack ndash long-click the Activation buttonTrigger Blaster Block ndash while saber is on short-click AUX button

Serial Monitor commands

battery_voltage ndash gets current battery voltage valueget_volume ndash get current volume valuepow ndash power OnOff the saberon ndash power On the saberoff ndash power Off the saberset_volume lt0-3000gt ndash set volume value (example set_volume 500)play ndash play the default preset trackplay trackslttrack namegt ndash play a specific track from tracks folder (example play tracksvenuswav)stop ndash stop the playing trackforce ndash play ldquoforcerdquo sound effectsdrag ndash play ldquodragrdquo sound effectsblast ndash play ldquoblasterrdquo sound effectslock ndash play ldquolockuprdquo sound effectsclash ndash play ldquoclashrdquo sound effectsreset ndash reboot the boardn ndash switch to next presetp ndash switch to previous presetlist_presets ndash show all presetssdtest ndash test SD card speed

40 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3FIRMWARE UPLOAD AND UPDATE2

Software installation and setup

PROFFIEBOARD INSTRUCTIONS

To upload firmware to ProffieBoard Arduino IDE program is required Follow these steps to install it to your PC

1 Install latest Arduino IDE software (donrsquot use BETA)

Installing as Windows app also is not recommended

because it will be installed in a specific protected folder that

wonrsquot allow you to install any additional softwareplugin in it

If ProffieBoard wonrsquot show up in COM port use

Arduino IDE 186 version

2 Install the Proffieboard Arduino Plugin and Zadig software

Follow installation instructions

3 Select Proffieboard-STM32L433 in Tools -gt Board

USB Type ndash Serial CPU Speed ndash 80 MHz Optimize ndash Smallest Code DOSFS ndash SDCARD (SPI) Port ndash COM(the number your PC assigned) (Butterfly-L433CC)

Connect Proffieboard via USB cable to PC to be able to select

the Port

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 41

3FIRMWARE UPLOAD AND UPDATE2

Uploading firmware

PROFFIEBOARD INSTRUCTIONS

1 Download the ProffieBoard firmware and SD card content

Unzip lightsaber-1286zip to your Documents directory or to

Desktop but not to Arduino program folder or anywhere in

Programs directory where all programs are installed You will

see a lightsaber folder and files inside it Donrsquot move any of

these files to any other location outside the lightsaber folder

and donrsquot reorganize them Unzip ProffieOS_SD_Cardzip to the

folder where you keep lightsaber-1286 folder Copy all files

from ProffieOS_SD_Card folder to your SD card

2 Unhide file extensions in File Explorer settings to see h ending

of config files Donrsquot add ldquohrdquo to the config file name Go to config folder and create you own configh file (see page

42 for how-to)

Double-click the lightsaberino file

3 Add the name of your configh file as shown and Save this

lightsaberino file Make sure the other config files are

commented out there should be only one CONFIG_FILE

without You can have multiple config files

in lightsabergtconfig folder and just define the one you need

in lightsaberino file and upload it again to ProffieBoard

4 Connect battery to ProffieBoard and hook up to your PC

with a data transfer micro-USB-to-USB cable

Press arrow button it will compile and upload firmware to the

board Wait for red text progress bars to stop at 100

ProffieBoard will play boot sound if speaker is connected

Now you can unplug the USB cable Done

If it gives an error instead this means your configh file has

issues define CONFIG_FILE name has mistakes configh file

is out of config folder your PC user name is non-latin

42 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

33

configh file structure editing

PROFFIEBOARD INSTRUCTIONS

CHANGING PARAMETERS

All sound files (sound fonts music tracks) are stored on the micro SD card Add required sound fonts folders (Plecter NEC and Smoothswing

fonts are supported no need to change WAV files names just copy and paste) to SD card root directory as itrsquos done in the default

ProffieOS_SD_Card content folder and music tracks to the tracks folder

Make sure to name all music tracks and sound fonts folders with latin characters and only up to 8 characters long without using any special

characters (like |[- etc)

Make sure you have a configini file in each sound font folder if there is none - copy one from some default TeensySaberProffieBoard sound

font and paste into newly added sound font folder It has only one parameter that you can modify - humstart It helps to match hum sound

start with blade ignition 1000 usually works fine

All blade effects LED configuration volume level clash sensitivity etc are changed in the configh file located in lightsabergtconfig folder

To do that open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text Editor (Notepad - to see code correctly in Notepad

Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all text) and Delete it then Copy-and-Paste (Ctrl+C

Ctrl+V) your wiring diagram config code into empty _configh file and Save it under new name Follow the instructions on page 39 to

upload it to the board

Proffieboard config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)

volume level (0-3000)

clash sensitivity (adjust lower or higher with 01 step)

sound font folder nametrack name

Preset name

Blade style

LED configuration (use these XP-E2 LED templatesto define your LED)

for Red use 1 Ohm resistor for Green - no resistor for Blue use 024 Ohm

NoLED ndash no 4th led used

Preset 1

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 43

33

Blade Styles

StylePtrltInOutHelperltSimpleClashltLockupltBlastltOnSparkltAudioFlickerltRgblt02550gtRgblt501000gtgtRgblt2552550gt150gtRgblt255500gtgtAudioFlickerltRgblt1002550gtRgblt2550150gtgtgtRgblt255100150gt40gt200300Blackgtgt

ndash this is how the Blade Style code looks pasted in the configh file Preset (it sits inside a StylePtrltgt container)

ndash this is how the Blade Style code looks when editing it inside a Blade Style Editor

Each Blade Style is made of a variety of Effects each added effect goes instead of a base color in the previous effect

PROFFIEBOARD INSTRUCTIONS

CHANGING PARAMETERS

ProffieBoard and TeensySaber use Blade Styles for the main saber blade and any other accent leds to define all light effects (color changing

flashes flickering delays ignitionretraction timing etc)

Use Blade Style Editor to create and adjust Blade Styles Megtooth Sith Sabers did a great video tutorial where he shows and explains

how to use Blade Style Editor Also you can grab some pre-made Blade Styles or share yours here on TRA forums

A Blade Style example of simple flickering Green blade with Spark on start Clash Blaster Lockup and Drag IgnitionRetraction effects

InOutHelperltSimpleClashltLockupltBlastltOnSparkltAudioFlickerltRgblt02550gtRgblt501000gtgtRgblt2552550gt150gtRgblt255500gtgtAudioFlickerltRgblt1002550gtRgblt2550150gtgtgtRgblt255100150gt40gt200300Blackgt

InOutHelperltbase color200300Blackgt ndash base color can be defined by words (WHITE RED GREEN PURPLE etc) or by Rgblt0-2550-2550-255gt values for more

custom shades 200 is extension length in milliseconds 300 is retraction length in milliseconds Black is color when retracted (also can be any other color)

SimpleClashltbase colorclash color40gt ndash clash effect 40 is clash duration in milliseconds

Lockupltbase colorlockup colorgt ndash lockup effect

Blastltbase colorblast colorgt ndash blaster effect

OnSparkltbase colorspark color150gt ndash spark on ignition effect 150 is spark duration in milliseconds

AudioFlickerltrdquoArdquo colorrdquoBrdquo colorgt ndash flickering effect (blade flickers to the actual saber hum sound) the more difference between ldquoArdquo and ldquoBrdquo colors - the more

abrupt is flickering

Rgblt255500gt ndash actual color in RGB format (0 is no light 255 is the maximum brightness value for Red Green or Blue channel)

44 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

ndash SanDisk 4GB microSDHC Class 4 (Genuine) ndash SanDisk 4GB microSDHC Class 4 (Genuine)

130238 kbs = 1477 simultaneous audio streams 137812 kbs = 1562 simultaneous audio streams

ndash Patriot LX Series 16GB microSDHC UHS-IU1 Class 10 ndash Patriot LX Series 16GB microSDHC UHS-IU1 Class 10

133005 kbs = 1508 simultaneous audio streams

ndash GSkill 16GB microSDHC UHS-IU1 Class 10 ndash GSkill 16GB microSDHC UHS-IU1 Class 10

129534 kbs = 1469 simultaneous audio streams

ndash Kingston 16GB microSDHC UHS-IU1 Class 10 ndash Kingston 16GB microSDHC UHS-IU1 Class 10

128090 kbs = 1452 simultaneous audio streams

ndash SanDisk Ultra 16GB microSDHC UHS-IU1 A1 Class 10 ndash SanDisk Ultra 16GB microSDHC UHS-IU1 A1 Class 10

102663 kbs = 1164 simultaneous audio streams 11124 kbs = 1261 simultaneous audio streams

ndash SanDisk 8GB microSDHC Class 4 ndash SanDisk 8GB microSDHC Class 4

108506 kbs = 1230 simultaneous audio streams

ndash SanDisk 16GB microSDHC Class 4 ndash SanDisk 16GB microSDHC Class 4

102663 kbs = 1164 simultaneous audio streams 106957 kbs = 1213 simultaneous audio streams

ndash SanDisk Ultra 16GB microSDHC UHS-IU1 Class 10 ndash SanDisk Ultra 16GB microSDHC UHS-IU1 Class 10

102663 kbs = 1164 simultaneous audio streams 103909 kbs = 1178 simultaneous audio streams

ndash Smartbuy 4GB microSDHC Class 4 ndash Smartbuy 4GB microSDHC Class 4

75437 kbs = 855 simultaneous audio streams

ndash Kingston 8GB microSDHC Class 4 ndash Kingston 8GB microSDHC Class 4

75209 kbs = 822 simultaneous audio streams

ndash SanDisk 4GB microSDHC Class 4 (Fake) ndash SanDisk 4GB microSDHC Class 4 (Fake)

677 kbs = 769 simultaneous audio streams

Here is a list of tested micro SD cards speed with TeensySaber V3 and ProffieBoard Any card with speed over 900 kbs is recommended the

higher the speed is ndash the better Memory size of 4-16Gb is more than enough Cards were tested with a default firmware (1291) compiled

with ldquoSmallest Coderdquo under Optimize ldquodefault_proffieboard_confighrdquo file and default ProffieOS SD card sound files (7 folders)

To test your SD card speed simply hook up ProffieBoard to PC open Arduino IDE go to Tools and open Serial Monitor make sure you have

New Line and 9600 baud rate selected on the bottom of Serial Monitor window type and send sdtest command wait for the test result

4Recommended micro SD cards

BEST

TEENSYSABER PROFFIEBOARD

GOOD

BAD

PROFFIEBOARD INSTRUCTIONS

SD CARD RECOMMENDATIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 45

There are a lot of fake (chinese copies) microSD cards on the market from aliexpress ebay amazon etc They look very similar to genuine

cards but are a bit different though and have a twice lower writingreading speed Here is an example of a SanDisk 4Gb Class 4 card one is

genuine with 137812 kbs speed and the other one is fake with 677 kbs speed I got from ebay seller

Be carefull and pay attention to how the actual card looks if you are not sure ask seller for the real photo of SD card he sells

4Genuine and Fake SanDisk 4Gb Class 4 microSD

PROFFIEBOARD INSTRUCTIONS

SD CARD RECOMMENDATIONS

46 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

WIRE GAUGE GUIDE

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 47

RECHARGE PORTS AND KILL SWITCHES

48 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

NEOPIXEL STRIPS CURRENT DRAW

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 49

6TROUBLESHOOTING

For more help please check these linksProffieOSProffieBoardTeensySaber wiki on GitHubAsk your question on The Rebel Armory forumsAsk your question on FX-sabers forumsAsk your question in facebook group

How to solve most common issues

Quick troubleshooting tips

TeensySaber board or Proffieboard is not recognized by computer (nothing under Port selection in Arduino)

ndash Make sure a charged 37V battery is connected to the board micro-USB cable is a data transfer cable all plugins and drivers are installed ndash

check again pages 21 for TeensySaber or 40 for Proffieboard Try a different USB port on your computer

Sketch (code) compile error in Arduino IDE

ndash Check your define CONFIG_FILE ldquoconfig_confighrdquo line in opened lightsaberino file if itrsquos written correctly with config in it

Sketch (code) compile error in Arduino IDE

ndash Check if the _configh file you defined in the lightsaberino sketch file is same name as in the lightsaber-rdquofirmware versionrdquolightsaber

config folder and is located in this folder

Sketch (code) compile error in Arduino IDE

ndash Check your settings under Tools tab in Arduino IDE program Check again pages 21 for TeensySaber or 40 for Proffieboard

Sketch (code) compile error in Arduino IDE

ndash Check if your _configh file is correct Blade Styles Presets const unsigned int maxLedsPerStrip = 144 if BladeConfig blades[] = is correct

Sketch (code) compile error in Arduino IDE

ndash If nothing helps install Arduino IDE version 186 and try to compile and upload the firmware again

Sound doesnrsquot play

ndash Remove SD card and insert again check speaker wiring Make sure all sound files on SD card are correctly named (8 characters max long)

Re-format SD card in FAT32 load sound files and try again try another SD card

Board says ldquoLOW POWERrdquo

ndash Charge the battery

Serial Monitor shows info sent by the board but your commands donrsquot work

ndash In the bottom right corner of Serial Monitor window make sure the Line Ending drop down is set to New Line

Sound is weird and distorted

ndash Check your SD card speed (see page 44) Check speaker wiring try another good speaker

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 29

ldquoproffieboard_v1_confighrdquo

3WIRING DIAGRAMS1

Basic Neopixel wiringldquoconfighrdquo file setup

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

NUM_BLADES 3NUM_BUTTONS 2VOLUME 1000CLASH_THRESHOLD_G 10IgnitionDelaylt0 any blade stylegtIgnitionDelaylt800 any blade stylegtIgnitionDelaylt800 any blade stylegtWS2811BladePtrlt118 WS2811 800kHz | WS2811 GRBgt()WS2811BladePtrlt26 blade2Pin ltbladePowerPin4gtgt()WS2811BladePtrlt26 blade3Pin ltbladePowerPin5gtgt()

ProffieBoard config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)Volume level (0-3000)Clash sensitivity (adjust lower or higher with 01 step)ldquoBlade 1rdquo style (main blade with IgnitionDelay 0)ldquoBlade 2rdquo style (CG blade 1 with IgnitionDelay 800)ldquoBlade 3rdquo style (CG blade 2 with IgnitionDelay 800)

strip configuration (defines how many pixels it has and to which LED output and pin is wired)

Preset 1

any blade style

strip (blade) 1 configuration

adjust this number to match your strips leds count

strip (blade) 2 configuration

strip (blade) 3 configuration

Preset 2 etc

Use a given or build your wiring diagram on THIS PAGE then open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text

Editor (Notepad - to see code correctly in Notepad Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all

text) and Delete it then Copy-and-Paste (Ctrl+C Ctrl+V) your wiring diagram config code (example below) into empty _configh file and

Save it under new name Follow the instructions on page 22 to upload it to the board

PROFFIEBOARD INSTRUCTIONS

30 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Basic Segmented string wiring diagram

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

+

+

-

-

24 A

WG

28 AWG

30-32 AWG30-32 AWG

Protected 36-37V (42V max at full charge) 10A 3500mAh battery recommended+18650 battery holder (optional)Keystone 1042P

AV switch with accent led(constantly ON no effects)

accent leds run mostly at10-15mA so resistors for them must be calculated accordingly

6-segments string blade

FoC string

N-channel FET3A minimum

123456

Calculate resistors for each led segment of the blade string depending on which leds are used 5mm leds have max drive current around 25mA per led when 10mm leds can be 100mA and 200mA per ledSo pay attention to your led max current and Forward Voltage (Vf) when calculating a segment resistor resistence as well as its wattage Also choose wire gauges accordingly to meet segments and total blade max current draw level

LED Resistor Calculator

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 31

ldquoproffieboard_v1_confighrdquo

3WIRING DIAGRAMS1

Basic Segmented string wiringldquoconfighrdquo file setup

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

NUM_BLADES 1NUM_BUTTONS 2VOLUME 1000CLASH_THRESHOLD_G 10StyleNormalPtrltCYAN WHITE 300 800gt()ltBlue3mmLED BladePin White3mmLEDgt

ProffieBoard config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)Volume level (0-3000)Clash sensitivity (adjust lower or higher with 01 step)Blade styleLED string configuration(here you mention the color and type of leds usedin the main blade string segments and FoC stringBladePin is the FoC signal pin (Blade ID pin))

Preset

LED string configuration

Use a given or build your wiring diagram on THIS PAGE then open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text

Editor (Notepad - to see code correctly in Notepad Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all

text) and Delete it then Copy-and-Paste (Ctrl+C Ctrl+V) your wiring diagram config code (example below) into empty _configh file and

Save it under new name Follow the instructions on page 22 to upload it to the board

PROFFIEBOARD INSTRUCTIONS

32 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Accent LEDs wiring diagram(optional)

Accent LEDs work with ProffieBoard as additional ldquobladesrdquo when powered by LED outputs 4 5 6 or Data pads 1 2 3 5 as PWM So they can

have any effect that blade can have If no effects needed accent led can be powered just by a 33V output pad (power-on led indication)

30-32 AWG

with Neopixel blade setup these 4 outputsdonrsquot work for regular accent leds

Recommended resistors to use for accent leds at 33V power source and 15mA drive

ndash 100 Ohm for Red (lt100000gt value in the code)ndash 13 Ohm for Green (lt13000gt value in the code)ndash 13 Ohm for Blue (lt13000gt value in the code)ndash 100 Ohm for Yellow (lt100000gt value in the code)ndash 20 Ohm for White (lt20000gt value in the code)

RGB ledcommon-anode

8 ldquobladesrdquo1 main and 7 accent leds

main blade style (effects) main blade style (effects)

7 accent leds style (effects)accent led style (effects)

7 accent leds configurations

RGB accent led configuration

2 ldquobladesrdquo1 main and 1 RGB accent led

ldquoPower-onrdquo indicationaccent leds (no effects)

7 accent leds withindependent effects

RGB accent led

a) b)

b)

c)

c)

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 33

3WIRING DIAGRAMS1

Neopixel Accent LEDs wiring diagram(optional)

With Neopixel setup additional neopixel leds or arrays can be used as accent leds There are 2 ways to wire them using additional Data

pins 2 3 4 5 or ldquoSub-bladesrdquo wiring with just 1 Data output pin Same way Neopixel connectors with on-board leds ca be wired

Option 1 ndash with extra Data pins

Main Blade

some accent leds

D1

D2

crystal leds

330 Ohm

330 Ohm

330 Ohm

main blade style (effects)

main blade 144 leds Data pin 1

accent leds blade style (effects)

accent leds ldquobladerdquo 4 leds Data pin 2

crystal leds blade style (effects)

crystal leds ldquobladerdquo 2 leds Data pin 3

3 ldquobladesrdquo1 main 1 accent leds array and 1 crystal leds array

PROFFIEBOARD INSTRUCTIONS

D3

follow arrows direction

34 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Neopixel Accent LEDs wiring diagram(optional)

PROFFIEBOARD INSTRUCTIONS

Main Blade

some accent leds

1

3

5678

2

4

D1

crystal leds

follow arrows direction

330 Ohm

330 OhmData signal

With this setup a single array of neopixel leds is separated into a couple of sub-blades with their own style configuration and behaviour This

is really usefull when you want to use only one data pin More about ldquoSub-bladesrdquo on ProffieOS wiki page

Option 2 ndash with ldquoSub-bladesrdquo

main blade style (effects)

main blade sub-blade 140 leds (7-146) but from 6 to 145 in the code

accent leds blade style (effects)

accent leds sub-blade 4 leds (1-4) but from 0 to 3 in the code

crystal leds blade style (effects)

146 leds total used

crystal leds sub-blade 2 leds (5-6) but from 4 to 5 in the code

update default 144 to a higher total value if you get all accent leds +Main blade gt 144 Example update to 146 if you have 2 crystal leds +4 accent leds + 140 Main blade leds = 146

3 ldquobladesrdquo 1 main 1 accent leds array and 1 crystal leds array

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 35

3WIRING DIAGRAMS1

OLED display wiring diagram(optional)

SSD1306 128x32 pixels OLED display allows to show battery level current preset name play different animations and even simple games It

can be wired to any blade configuration and requires just one additional line in the code to work You can get monochrome display in white

or blue color

SSD1306128x32OLED

SSD1306 ndash with blue or white display color selectSSD1306 ndash cheaper priceSSD1306 just screen ndash blue or white select

30-32 AWG

30-32 AWG

add this line to enable OLED display

display shows a preset name written in these quotes ldquoldquo

PROFFIEBOARD INSTRUCTIONS

36 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Bluetooth module wiring diagram(optional)

SOON

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 37

3WIRING DIAGRAMS1

Blade ID resistor functions(optional)

SOON

PROFFIEBOARD INSTRUCTIONS

38 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

website ProffieBoard FULL wiring diagrams link

Scroll the page down till you see the interactive diagram Above the diagram there are components selection options Build your saber setup

with it and follow diagram to wire your board Then you need to copy the configuration code below and paste it into your _configh file

Choose components you want

3WIRING DIAGRAMS1

More wiring diagrams

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 39

3WIRING DIAGRAMS1

How to use it

PROFFIEBOARD INSTRUCTIONS

Blade ignitionretraction ndash assuming you have at least one button pressing it briefly should turn the saber on or off If you have an AUX button pressing it briefly should also turn the saber on and off If you have no buttons you can turn the saber on and off by twisting your wrist back and forth Note that the motion has to be done long enough to count so a very quick flick of the wrist will not workTurn On muted ndash double-click power buttonNext preset ndash while saber is off click the AUX buttonPrevious preset ndash hold AUX button and click the Activation buttonTrigger Clash ndash while saber is on hit the bladeTrigger Lockup ndash while saber is on hold Activation button then trigger a clash Lockup releases when you let go of the Acti-vation buttonTrigger Drag ndash like lockup but point saber mostly down before holding Activation buttonTrigger Force ndash long-click AUX buttonStart soundtrack ndash long-click the Activation buttonTrigger Blaster Block ndash while saber is on short-click AUX button

Serial Monitor commands

battery_voltage ndash gets current battery voltage valueget_volume ndash get current volume valuepow ndash power OnOff the saberon ndash power On the saberoff ndash power Off the saberset_volume lt0-3000gt ndash set volume value (example set_volume 500)play ndash play the default preset trackplay trackslttrack namegt ndash play a specific track from tracks folder (example play tracksvenuswav)stop ndash stop the playing trackforce ndash play ldquoforcerdquo sound effectsdrag ndash play ldquodragrdquo sound effectsblast ndash play ldquoblasterrdquo sound effectslock ndash play ldquolockuprdquo sound effectsclash ndash play ldquoclashrdquo sound effectsreset ndash reboot the boardn ndash switch to next presetp ndash switch to previous presetlist_presets ndash show all presetssdtest ndash test SD card speed

40 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3FIRMWARE UPLOAD AND UPDATE2

Software installation and setup

PROFFIEBOARD INSTRUCTIONS

To upload firmware to ProffieBoard Arduino IDE program is required Follow these steps to install it to your PC

1 Install latest Arduino IDE software (donrsquot use BETA)

Installing as Windows app also is not recommended

because it will be installed in a specific protected folder that

wonrsquot allow you to install any additional softwareplugin in it

If ProffieBoard wonrsquot show up in COM port use

Arduino IDE 186 version

2 Install the Proffieboard Arduino Plugin and Zadig software

Follow installation instructions

3 Select Proffieboard-STM32L433 in Tools -gt Board

USB Type ndash Serial CPU Speed ndash 80 MHz Optimize ndash Smallest Code DOSFS ndash SDCARD (SPI) Port ndash COM(the number your PC assigned) (Butterfly-L433CC)

Connect Proffieboard via USB cable to PC to be able to select

the Port

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 41

3FIRMWARE UPLOAD AND UPDATE2

Uploading firmware

PROFFIEBOARD INSTRUCTIONS

1 Download the ProffieBoard firmware and SD card content

Unzip lightsaber-1286zip to your Documents directory or to

Desktop but not to Arduino program folder or anywhere in

Programs directory where all programs are installed You will

see a lightsaber folder and files inside it Donrsquot move any of

these files to any other location outside the lightsaber folder

and donrsquot reorganize them Unzip ProffieOS_SD_Cardzip to the

folder where you keep lightsaber-1286 folder Copy all files

from ProffieOS_SD_Card folder to your SD card

2 Unhide file extensions in File Explorer settings to see h ending

of config files Donrsquot add ldquohrdquo to the config file name Go to config folder and create you own configh file (see page

42 for how-to)

Double-click the lightsaberino file

3 Add the name of your configh file as shown and Save this

lightsaberino file Make sure the other config files are

commented out there should be only one CONFIG_FILE

without You can have multiple config files

in lightsabergtconfig folder and just define the one you need

in lightsaberino file and upload it again to ProffieBoard

4 Connect battery to ProffieBoard and hook up to your PC

with a data transfer micro-USB-to-USB cable

Press arrow button it will compile and upload firmware to the

board Wait for red text progress bars to stop at 100

ProffieBoard will play boot sound if speaker is connected

Now you can unplug the USB cable Done

If it gives an error instead this means your configh file has

issues define CONFIG_FILE name has mistakes configh file

is out of config folder your PC user name is non-latin

42 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

33

configh file structure editing

PROFFIEBOARD INSTRUCTIONS

CHANGING PARAMETERS

All sound files (sound fonts music tracks) are stored on the micro SD card Add required sound fonts folders (Plecter NEC and Smoothswing

fonts are supported no need to change WAV files names just copy and paste) to SD card root directory as itrsquos done in the default

ProffieOS_SD_Card content folder and music tracks to the tracks folder

Make sure to name all music tracks and sound fonts folders with latin characters and only up to 8 characters long without using any special

characters (like |[- etc)

Make sure you have a configini file in each sound font folder if there is none - copy one from some default TeensySaberProffieBoard sound

font and paste into newly added sound font folder It has only one parameter that you can modify - humstart It helps to match hum sound

start with blade ignition 1000 usually works fine

All blade effects LED configuration volume level clash sensitivity etc are changed in the configh file located in lightsabergtconfig folder

To do that open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text Editor (Notepad - to see code correctly in Notepad

Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all text) and Delete it then Copy-and-Paste (Ctrl+C

Ctrl+V) your wiring diagram config code into empty _configh file and Save it under new name Follow the instructions on page 39 to

upload it to the board

Proffieboard config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)

volume level (0-3000)

clash sensitivity (adjust lower or higher with 01 step)

sound font folder nametrack name

Preset name

Blade style

LED configuration (use these XP-E2 LED templatesto define your LED)

for Red use 1 Ohm resistor for Green - no resistor for Blue use 024 Ohm

NoLED ndash no 4th led used

Preset 1

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 43

33

Blade Styles

StylePtrltInOutHelperltSimpleClashltLockupltBlastltOnSparkltAudioFlickerltRgblt02550gtRgblt501000gtgtRgblt2552550gt150gtRgblt255500gtgtAudioFlickerltRgblt1002550gtRgblt2550150gtgtgtRgblt255100150gt40gt200300Blackgtgt

ndash this is how the Blade Style code looks pasted in the configh file Preset (it sits inside a StylePtrltgt container)

ndash this is how the Blade Style code looks when editing it inside a Blade Style Editor

Each Blade Style is made of a variety of Effects each added effect goes instead of a base color in the previous effect

PROFFIEBOARD INSTRUCTIONS

CHANGING PARAMETERS

ProffieBoard and TeensySaber use Blade Styles for the main saber blade and any other accent leds to define all light effects (color changing

flashes flickering delays ignitionretraction timing etc)

Use Blade Style Editor to create and adjust Blade Styles Megtooth Sith Sabers did a great video tutorial where he shows and explains

how to use Blade Style Editor Also you can grab some pre-made Blade Styles or share yours here on TRA forums

A Blade Style example of simple flickering Green blade with Spark on start Clash Blaster Lockup and Drag IgnitionRetraction effects

InOutHelperltSimpleClashltLockupltBlastltOnSparkltAudioFlickerltRgblt02550gtRgblt501000gtgtRgblt2552550gt150gtRgblt255500gtgtAudioFlickerltRgblt1002550gtRgblt2550150gtgtgtRgblt255100150gt40gt200300Blackgt

InOutHelperltbase color200300Blackgt ndash base color can be defined by words (WHITE RED GREEN PURPLE etc) or by Rgblt0-2550-2550-255gt values for more

custom shades 200 is extension length in milliseconds 300 is retraction length in milliseconds Black is color when retracted (also can be any other color)

SimpleClashltbase colorclash color40gt ndash clash effect 40 is clash duration in milliseconds

Lockupltbase colorlockup colorgt ndash lockup effect

Blastltbase colorblast colorgt ndash blaster effect

OnSparkltbase colorspark color150gt ndash spark on ignition effect 150 is spark duration in milliseconds

AudioFlickerltrdquoArdquo colorrdquoBrdquo colorgt ndash flickering effect (blade flickers to the actual saber hum sound) the more difference between ldquoArdquo and ldquoBrdquo colors - the more

abrupt is flickering

Rgblt255500gt ndash actual color in RGB format (0 is no light 255 is the maximum brightness value for Red Green or Blue channel)

44 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

ndash SanDisk 4GB microSDHC Class 4 (Genuine) ndash SanDisk 4GB microSDHC Class 4 (Genuine)

130238 kbs = 1477 simultaneous audio streams 137812 kbs = 1562 simultaneous audio streams

ndash Patriot LX Series 16GB microSDHC UHS-IU1 Class 10 ndash Patriot LX Series 16GB microSDHC UHS-IU1 Class 10

133005 kbs = 1508 simultaneous audio streams

ndash GSkill 16GB microSDHC UHS-IU1 Class 10 ndash GSkill 16GB microSDHC UHS-IU1 Class 10

129534 kbs = 1469 simultaneous audio streams

ndash Kingston 16GB microSDHC UHS-IU1 Class 10 ndash Kingston 16GB microSDHC UHS-IU1 Class 10

128090 kbs = 1452 simultaneous audio streams

ndash SanDisk Ultra 16GB microSDHC UHS-IU1 A1 Class 10 ndash SanDisk Ultra 16GB microSDHC UHS-IU1 A1 Class 10

102663 kbs = 1164 simultaneous audio streams 11124 kbs = 1261 simultaneous audio streams

ndash SanDisk 8GB microSDHC Class 4 ndash SanDisk 8GB microSDHC Class 4

108506 kbs = 1230 simultaneous audio streams

ndash SanDisk 16GB microSDHC Class 4 ndash SanDisk 16GB microSDHC Class 4

102663 kbs = 1164 simultaneous audio streams 106957 kbs = 1213 simultaneous audio streams

ndash SanDisk Ultra 16GB microSDHC UHS-IU1 Class 10 ndash SanDisk Ultra 16GB microSDHC UHS-IU1 Class 10

102663 kbs = 1164 simultaneous audio streams 103909 kbs = 1178 simultaneous audio streams

ndash Smartbuy 4GB microSDHC Class 4 ndash Smartbuy 4GB microSDHC Class 4

75437 kbs = 855 simultaneous audio streams

ndash Kingston 8GB microSDHC Class 4 ndash Kingston 8GB microSDHC Class 4

75209 kbs = 822 simultaneous audio streams

ndash SanDisk 4GB microSDHC Class 4 (Fake) ndash SanDisk 4GB microSDHC Class 4 (Fake)

677 kbs = 769 simultaneous audio streams

Here is a list of tested micro SD cards speed with TeensySaber V3 and ProffieBoard Any card with speed over 900 kbs is recommended the

higher the speed is ndash the better Memory size of 4-16Gb is more than enough Cards were tested with a default firmware (1291) compiled

with ldquoSmallest Coderdquo under Optimize ldquodefault_proffieboard_confighrdquo file and default ProffieOS SD card sound files (7 folders)

To test your SD card speed simply hook up ProffieBoard to PC open Arduino IDE go to Tools and open Serial Monitor make sure you have

New Line and 9600 baud rate selected on the bottom of Serial Monitor window type and send sdtest command wait for the test result

4Recommended micro SD cards

BEST

TEENSYSABER PROFFIEBOARD

GOOD

BAD

PROFFIEBOARD INSTRUCTIONS

SD CARD RECOMMENDATIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 45

There are a lot of fake (chinese copies) microSD cards on the market from aliexpress ebay amazon etc They look very similar to genuine

cards but are a bit different though and have a twice lower writingreading speed Here is an example of a SanDisk 4Gb Class 4 card one is

genuine with 137812 kbs speed and the other one is fake with 677 kbs speed I got from ebay seller

Be carefull and pay attention to how the actual card looks if you are not sure ask seller for the real photo of SD card he sells

4Genuine and Fake SanDisk 4Gb Class 4 microSD

PROFFIEBOARD INSTRUCTIONS

SD CARD RECOMMENDATIONS

46 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

WIRE GAUGE GUIDE

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 47

RECHARGE PORTS AND KILL SWITCHES

48 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

NEOPIXEL STRIPS CURRENT DRAW

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 49

6TROUBLESHOOTING

For more help please check these linksProffieOSProffieBoardTeensySaber wiki on GitHubAsk your question on The Rebel Armory forumsAsk your question on FX-sabers forumsAsk your question in facebook group

How to solve most common issues

Quick troubleshooting tips

TeensySaber board or Proffieboard is not recognized by computer (nothing under Port selection in Arduino)

ndash Make sure a charged 37V battery is connected to the board micro-USB cable is a data transfer cable all plugins and drivers are installed ndash

check again pages 21 for TeensySaber or 40 for Proffieboard Try a different USB port on your computer

Sketch (code) compile error in Arduino IDE

ndash Check your define CONFIG_FILE ldquoconfig_confighrdquo line in opened lightsaberino file if itrsquos written correctly with config in it

Sketch (code) compile error in Arduino IDE

ndash Check if the _configh file you defined in the lightsaberino sketch file is same name as in the lightsaber-rdquofirmware versionrdquolightsaber

config folder and is located in this folder

Sketch (code) compile error in Arduino IDE

ndash Check your settings under Tools tab in Arduino IDE program Check again pages 21 for TeensySaber or 40 for Proffieboard

Sketch (code) compile error in Arduino IDE

ndash Check if your _configh file is correct Blade Styles Presets const unsigned int maxLedsPerStrip = 144 if BladeConfig blades[] = is correct

Sketch (code) compile error in Arduino IDE

ndash If nothing helps install Arduino IDE version 186 and try to compile and upload the firmware again

Sound doesnrsquot play

ndash Remove SD card and insert again check speaker wiring Make sure all sound files on SD card are correctly named (8 characters max long)

Re-format SD card in FAT32 load sound files and try again try another SD card

Board says ldquoLOW POWERrdquo

ndash Charge the battery

Serial Monitor shows info sent by the board but your commands donrsquot work

ndash In the bottom right corner of Serial Monitor window make sure the Line Ending drop down is set to New Line

Sound is weird and distorted

ndash Check your SD card speed (see page 44) Check speaker wiring try another good speaker

30 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Basic Segmented string wiring diagram

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

+

+

-

-

24 A

WG

28 AWG

30-32 AWG30-32 AWG

Protected 36-37V (42V max at full charge) 10A 3500mAh battery recommended+18650 battery holder (optional)Keystone 1042P

AV switch with accent led(constantly ON no effects)

accent leds run mostly at10-15mA so resistors for them must be calculated accordingly

6-segments string blade

FoC string

N-channel FET3A minimum

123456

Calculate resistors for each led segment of the blade string depending on which leds are used 5mm leds have max drive current around 25mA per led when 10mm leds can be 100mA and 200mA per ledSo pay attention to your led max current and Forward Voltage (Vf) when calculating a segment resistor resistence as well as its wattage Also choose wire gauges accordingly to meet segments and total blade max current draw level

LED Resistor Calculator

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 31

ldquoproffieboard_v1_confighrdquo

3WIRING DIAGRAMS1

Basic Segmented string wiringldquoconfighrdquo file setup

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

NUM_BLADES 1NUM_BUTTONS 2VOLUME 1000CLASH_THRESHOLD_G 10StyleNormalPtrltCYAN WHITE 300 800gt()ltBlue3mmLED BladePin White3mmLEDgt

ProffieBoard config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)Volume level (0-3000)Clash sensitivity (adjust lower or higher with 01 step)Blade styleLED string configuration(here you mention the color and type of leds usedin the main blade string segments and FoC stringBladePin is the FoC signal pin (Blade ID pin))

Preset

LED string configuration

Use a given or build your wiring diagram on THIS PAGE then open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text

Editor (Notepad - to see code correctly in Notepad Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all

text) and Delete it then Copy-and-Paste (Ctrl+C Ctrl+V) your wiring diagram config code (example below) into empty _configh file and

Save it under new name Follow the instructions on page 22 to upload it to the board

PROFFIEBOARD INSTRUCTIONS

32 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Accent LEDs wiring diagram(optional)

Accent LEDs work with ProffieBoard as additional ldquobladesrdquo when powered by LED outputs 4 5 6 or Data pads 1 2 3 5 as PWM So they can

have any effect that blade can have If no effects needed accent led can be powered just by a 33V output pad (power-on led indication)

30-32 AWG

with Neopixel blade setup these 4 outputsdonrsquot work for regular accent leds

Recommended resistors to use for accent leds at 33V power source and 15mA drive

ndash 100 Ohm for Red (lt100000gt value in the code)ndash 13 Ohm for Green (lt13000gt value in the code)ndash 13 Ohm for Blue (lt13000gt value in the code)ndash 100 Ohm for Yellow (lt100000gt value in the code)ndash 20 Ohm for White (lt20000gt value in the code)

RGB ledcommon-anode

8 ldquobladesrdquo1 main and 7 accent leds

main blade style (effects) main blade style (effects)

7 accent leds style (effects)accent led style (effects)

7 accent leds configurations

RGB accent led configuration

2 ldquobladesrdquo1 main and 1 RGB accent led

ldquoPower-onrdquo indicationaccent leds (no effects)

7 accent leds withindependent effects

RGB accent led

a) b)

b)

c)

c)

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 33

3WIRING DIAGRAMS1

Neopixel Accent LEDs wiring diagram(optional)

With Neopixel setup additional neopixel leds or arrays can be used as accent leds There are 2 ways to wire them using additional Data

pins 2 3 4 5 or ldquoSub-bladesrdquo wiring with just 1 Data output pin Same way Neopixel connectors with on-board leds ca be wired

Option 1 ndash with extra Data pins

Main Blade

some accent leds

D1

D2

crystal leds

330 Ohm

330 Ohm

330 Ohm

main blade style (effects)

main blade 144 leds Data pin 1

accent leds blade style (effects)

accent leds ldquobladerdquo 4 leds Data pin 2

crystal leds blade style (effects)

crystal leds ldquobladerdquo 2 leds Data pin 3

3 ldquobladesrdquo1 main 1 accent leds array and 1 crystal leds array

PROFFIEBOARD INSTRUCTIONS

D3

follow arrows direction

34 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Neopixel Accent LEDs wiring diagram(optional)

PROFFIEBOARD INSTRUCTIONS

Main Blade

some accent leds

1

3

5678

2

4

D1

crystal leds

follow arrows direction

330 Ohm

330 OhmData signal

With this setup a single array of neopixel leds is separated into a couple of sub-blades with their own style configuration and behaviour This

is really usefull when you want to use only one data pin More about ldquoSub-bladesrdquo on ProffieOS wiki page

Option 2 ndash with ldquoSub-bladesrdquo

main blade style (effects)

main blade sub-blade 140 leds (7-146) but from 6 to 145 in the code

accent leds blade style (effects)

accent leds sub-blade 4 leds (1-4) but from 0 to 3 in the code

crystal leds blade style (effects)

146 leds total used

crystal leds sub-blade 2 leds (5-6) but from 4 to 5 in the code

update default 144 to a higher total value if you get all accent leds +Main blade gt 144 Example update to 146 if you have 2 crystal leds +4 accent leds + 140 Main blade leds = 146

3 ldquobladesrdquo 1 main 1 accent leds array and 1 crystal leds array

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 35

3WIRING DIAGRAMS1

OLED display wiring diagram(optional)

SSD1306 128x32 pixels OLED display allows to show battery level current preset name play different animations and even simple games It

can be wired to any blade configuration and requires just one additional line in the code to work You can get monochrome display in white

or blue color

SSD1306128x32OLED

SSD1306 ndash with blue or white display color selectSSD1306 ndash cheaper priceSSD1306 just screen ndash blue or white select

30-32 AWG

30-32 AWG

add this line to enable OLED display

display shows a preset name written in these quotes ldquoldquo

PROFFIEBOARD INSTRUCTIONS

36 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Bluetooth module wiring diagram(optional)

SOON

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 37

3WIRING DIAGRAMS1

Blade ID resistor functions(optional)

SOON

PROFFIEBOARD INSTRUCTIONS

38 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

website ProffieBoard FULL wiring diagrams link

Scroll the page down till you see the interactive diagram Above the diagram there are components selection options Build your saber setup

with it and follow diagram to wire your board Then you need to copy the configuration code below and paste it into your _configh file

Choose components you want

3WIRING DIAGRAMS1

More wiring diagrams

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 39

3WIRING DIAGRAMS1

How to use it

PROFFIEBOARD INSTRUCTIONS

Blade ignitionretraction ndash assuming you have at least one button pressing it briefly should turn the saber on or off If you have an AUX button pressing it briefly should also turn the saber on and off If you have no buttons you can turn the saber on and off by twisting your wrist back and forth Note that the motion has to be done long enough to count so a very quick flick of the wrist will not workTurn On muted ndash double-click power buttonNext preset ndash while saber is off click the AUX buttonPrevious preset ndash hold AUX button and click the Activation buttonTrigger Clash ndash while saber is on hit the bladeTrigger Lockup ndash while saber is on hold Activation button then trigger a clash Lockup releases when you let go of the Acti-vation buttonTrigger Drag ndash like lockup but point saber mostly down before holding Activation buttonTrigger Force ndash long-click AUX buttonStart soundtrack ndash long-click the Activation buttonTrigger Blaster Block ndash while saber is on short-click AUX button

Serial Monitor commands

battery_voltage ndash gets current battery voltage valueget_volume ndash get current volume valuepow ndash power OnOff the saberon ndash power On the saberoff ndash power Off the saberset_volume lt0-3000gt ndash set volume value (example set_volume 500)play ndash play the default preset trackplay trackslttrack namegt ndash play a specific track from tracks folder (example play tracksvenuswav)stop ndash stop the playing trackforce ndash play ldquoforcerdquo sound effectsdrag ndash play ldquodragrdquo sound effectsblast ndash play ldquoblasterrdquo sound effectslock ndash play ldquolockuprdquo sound effectsclash ndash play ldquoclashrdquo sound effectsreset ndash reboot the boardn ndash switch to next presetp ndash switch to previous presetlist_presets ndash show all presetssdtest ndash test SD card speed

40 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3FIRMWARE UPLOAD AND UPDATE2

Software installation and setup

PROFFIEBOARD INSTRUCTIONS

To upload firmware to ProffieBoard Arduino IDE program is required Follow these steps to install it to your PC

1 Install latest Arduino IDE software (donrsquot use BETA)

Installing as Windows app also is not recommended

because it will be installed in a specific protected folder that

wonrsquot allow you to install any additional softwareplugin in it

If ProffieBoard wonrsquot show up in COM port use

Arduino IDE 186 version

2 Install the Proffieboard Arduino Plugin and Zadig software

Follow installation instructions

3 Select Proffieboard-STM32L433 in Tools -gt Board

USB Type ndash Serial CPU Speed ndash 80 MHz Optimize ndash Smallest Code DOSFS ndash SDCARD (SPI) Port ndash COM(the number your PC assigned) (Butterfly-L433CC)

Connect Proffieboard via USB cable to PC to be able to select

the Port

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 41

3FIRMWARE UPLOAD AND UPDATE2

Uploading firmware

PROFFIEBOARD INSTRUCTIONS

1 Download the ProffieBoard firmware and SD card content

Unzip lightsaber-1286zip to your Documents directory or to

Desktop but not to Arduino program folder or anywhere in

Programs directory where all programs are installed You will

see a lightsaber folder and files inside it Donrsquot move any of

these files to any other location outside the lightsaber folder

and donrsquot reorganize them Unzip ProffieOS_SD_Cardzip to the

folder where you keep lightsaber-1286 folder Copy all files

from ProffieOS_SD_Card folder to your SD card

2 Unhide file extensions in File Explorer settings to see h ending

of config files Donrsquot add ldquohrdquo to the config file name Go to config folder and create you own configh file (see page

42 for how-to)

Double-click the lightsaberino file

3 Add the name of your configh file as shown and Save this

lightsaberino file Make sure the other config files are

commented out there should be only one CONFIG_FILE

without You can have multiple config files

in lightsabergtconfig folder and just define the one you need

in lightsaberino file and upload it again to ProffieBoard

4 Connect battery to ProffieBoard and hook up to your PC

with a data transfer micro-USB-to-USB cable

Press arrow button it will compile and upload firmware to the

board Wait for red text progress bars to stop at 100

ProffieBoard will play boot sound if speaker is connected

Now you can unplug the USB cable Done

If it gives an error instead this means your configh file has

issues define CONFIG_FILE name has mistakes configh file

is out of config folder your PC user name is non-latin

42 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

33

configh file structure editing

PROFFIEBOARD INSTRUCTIONS

CHANGING PARAMETERS

All sound files (sound fonts music tracks) are stored on the micro SD card Add required sound fonts folders (Plecter NEC and Smoothswing

fonts are supported no need to change WAV files names just copy and paste) to SD card root directory as itrsquos done in the default

ProffieOS_SD_Card content folder and music tracks to the tracks folder

Make sure to name all music tracks and sound fonts folders with latin characters and only up to 8 characters long without using any special

characters (like |[- etc)

Make sure you have a configini file in each sound font folder if there is none - copy one from some default TeensySaberProffieBoard sound

font and paste into newly added sound font folder It has only one parameter that you can modify - humstart It helps to match hum sound

start with blade ignition 1000 usually works fine

All blade effects LED configuration volume level clash sensitivity etc are changed in the configh file located in lightsabergtconfig folder

To do that open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text Editor (Notepad - to see code correctly in Notepad

Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all text) and Delete it then Copy-and-Paste (Ctrl+C

Ctrl+V) your wiring diagram config code into empty _configh file and Save it under new name Follow the instructions on page 39 to

upload it to the board

Proffieboard config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)

volume level (0-3000)

clash sensitivity (adjust lower or higher with 01 step)

sound font folder nametrack name

Preset name

Blade style

LED configuration (use these XP-E2 LED templatesto define your LED)

for Red use 1 Ohm resistor for Green - no resistor for Blue use 024 Ohm

NoLED ndash no 4th led used

Preset 1

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 43

33

Blade Styles

StylePtrltInOutHelperltSimpleClashltLockupltBlastltOnSparkltAudioFlickerltRgblt02550gtRgblt501000gtgtRgblt2552550gt150gtRgblt255500gtgtAudioFlickerltRgblt1002550gtRgblt2550150gtgtgtRgblt255100150gt40gt200300Blackgtgt

ndash this is how the Blade Style code looks pasted in the configh file Preset (it sits inside a StylePtrltgt container)

ndash this is how the Blade Style code looks when editing it inside a Blade Style Editor

Each Blade Style is made of a variety of Effects each added effect goes instead of a base color in the previous effect

PROFFIEBOARD INSTRUCTIONS

CHANGING PARAMETERS

ProffieBoard and TeensySaber use Blade Styles for the main saber blade and any other accent leds to define all light effects (color changing

flashes flickering delays ignitionretraction timing etc)

Use Blade Style Editor to create and adjust Blade Styles Megtooth Sith Sabers did a great video tutorial where he shows and explains

how to use Blade Style Editor Also you can grab some pre-made Blade Styles or share yours here on TRA forums

A Blade Style example of simple flickering Green blade with Spark on start Clash Blaster Lockup and Drag IgnitionRetraction effects

InOutHelperltSimpleClashltLockupltBlastltOnSparkltAudioFlickerltRgblt02550gtRgblt501000gtgtRgblt2552550gt150gtRgblt255500gtgtAudioFlickerltRgblt1002550gtRgblt2550150gtgtgtRgblt255100150gt40gt200300Blackgt

InOutHelperltbase color200300Blackgt ndash base color can be defined by words (WHITE RED GREEN PURPLE etc) or by Rgblt0-2550-2550-255gt values for more

custom shades 200 is extension length in milliseconds 300 is retraction length in milliseconds Black is color when retracted (also can be any other color)

SimpleClashltbase colorclash color40gt ndash clash effect 40 is clash duration in milliseconds

Lockupltbase colorlockup colorgt ndash lockup effect

Blastltbase colorblast colorgt ndash blaster effect

OnSparkltbase colorspark color150gt ndash spark on ignition effect 150 is spark duration in milliseconds

AudioFlickerltrdquoArdquo colorrdquoBrdquo colorgt ndash flickering effect (blade flickers to the actual saber hum sound) the more difference between ldquoArdquo and ldquoBrdquo colors - the more

abrupt is flickering

Rgblt255500gt ndash actual color in RGB format (0 is no light 255 is the maximum brightness value for Red Green or Blue channel)

44 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

ndash SanDisk 4GB microSDHC Class 4 (Genuine) ndash SanDisk 4GB microSDHC Class 4 (Genuine)

130238 kbs = 1477 simultaneous audio streams 137812 kbs = 1562 simultaneous audio streams

ndash Patriot LX Series 16GB microSDHC UHS-IU1 Class 10 ndash Patriot LX Series 16GB microSDHC UHS-IU1 Class 10

133005 kbs = 1508 simultaneous audio streams

ndash GSkill 16GB microSDHC UHS-IU1 Class 10 ndash GSkill 16GB microSDHC UHS-IU1 Class 10

129534 kbs = 1469 simultaneous audio streams

ndash Kingston 16GB microSDHC UHS-IU1 Class 10 ndash Kingston 16GB microSDHC UHS-IU1 Class 10

128090 kbs = 1452 simultaneous audio streams

ndash SanDisk Ultra 16GB microSDHC UHS-IU1 A1 Class 10 ndash SanDisk Ultra 16GB microSDHC UHS-IU1 A1 Class 10

102663 kbs = 1164 simultaneous audio streams 11124 kbs = 1261 simultaneous audio streams

ndash SanDisk 8GB microSDHC Class 4 ndash SanDisk 8GB microSDHC Class 4

108506 kbs = 1230 simultaneous audio streams

ndash SanDisk 16GB microSDHC Class 4 ndash SanDisk 16GB microSDHC Class 4

102663 kbs = 1164 simultaneous audio streams 106957 kbs = 1213 simultaneous audio streams

ndash SanDisk Ultra 16GB microSDHC UHS-IU1 Class 10 ndash SanDisk Ultra 16GB microSDHC UHS-IU1 Class 10

102663 kbs = 1164 simultaneous audio streams 103909 kbs = 1178 simultaneous audio streams

ndash Smartbuy 4GB microSDHC Class 4 ndash Smartbuy 4GB microSDHC Class 4

75437 kbs = 855 simultaneous audio streams

ndash Kingston 8GB microSDHC Class 4 ndash Kingston 8GB microSDHC Class 4

75209 kbs = 822 simultaneous audio streams

ndash SanDisk 4GB microSDHC Class 4 (Fake) ndash SanDisk 4GB microSDHC Class 4 (Fake)

677 kbs = 769 simultaneous audio streams

Here is a list of tested micro SD cards speed with TeensySaber V3 and ProffieBoard Any card with speed over 900 kbs is recommended the

higher the speed is ndash the better Memory size of 4-16Gb is more than enough Cards were tested with a default firmware (1291) compiled

with ldquoSmallest Coderdquo under Optimize ldquodefault_proffieboard_confighrdquo file and default ProffieOS SD card sound files (7 folders)

To test your SD card speed simply hook up ProffieBoard to PC open Arduino IDE go to Tools and open Serial Monitor make sure you have

New Line and 9600 baud rate selected on the bottom of Serial Monitor window type and send sdtest command wait for the test result

4Recommended micro SD cards

BEST

TEENSYSABER PROFFIEBOARD

GOOD

BAD

PROFFIEBOARD INSTRUCTIONS

SD CARD RECOMMENDATIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 45

There are a lot of fake (chinese copies) microSD cards on the market from aliexpress ebay amazon etc They look very similar to genuine

cards but are a bit different though and have a twice lower writingreading speed Here is an example of a SanDisk 4Gb Class 4 card one is

genuine with 137812 kbs speed and the other one is fake with 677 kbs speed I got from ebay seller

Be carefull and pay attention to how the actual card looks if you are not sure ask seller for the real photo of SD card he sells

4Genuine and Fake SanDisk 4Gb Class 4 microSD

PROFFIEBOARD INSTRUCTIONS

SD CARD RECOMMENDATIONS

46 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

WIRE GAUGE GUIDE

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 47

RECHARGE PORTS AND KILL SWITCHES

48 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

NEOPIXEL STRIPS CURRENT DRAW

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 49

6TROUBLESHOOTING

For more help please check these linksProffieOSProffieBoardTeensySaber wiki on GitHubAsk your question on The Rebel Armory forumsAsk your question on FX-sabers forumsAsk your question in facebook group

How to solve most common issues

Quick troubleshooting tips

TeensySaber board or Proffieboard is not recognized by computer (nothing under Port selection in Arduino)

ndash Make sure a charged 37V battery is connected to the board micro-USB cable is a data transfer cable all plugins and drivers are installed ndash

check again pages 21 for TeensySaber or 40 for Proffieboard Try a different USB port on your computer

Sketch (code) compile error in Arduino IDE

ndash Check your define CONFIG_FILE ldquoconfig_confighrdquo line in opened lightsaberino file if itrsquos written correctly with config in it

Sketch (code) compile error in Arduino IDE

ndash Check if the _configh file you defined in the lightsaberino sketch file is same name as in the lightsaber-rdquofirmware versionrdquolightsaber

config folder and is located in this folder

Sketch (code) compile error in Arduino IDE

ndash Check your settings under Tools tab in Arduino IDE program Check again pages 21 for TeensySaber or 40 for Proffieboard

Sketch (code) compile error in Arduino IDE

ndash Check if your _configh file is correct Blade Styles Presets const unsigned int maxLedsPerStrip = 144 if BladeConfig blades[] = is correct

Sketch (code) compile error in Arduino IDE

ndash If nothing helps install Arduino IDE version 186 and try to compile and upload the firmware again

Sound doesnrsquot play

ndash Remove SD card and insert again check speaker wiring Make sure all sound files on SD card are correctly named (8 characters max long)

Re-format SD card in FAT32 load sound files and try again try another SD card

Board says ldquoLOW POWERrdquo

ndash Charge the battery

Serial Monitor shows info sent by the board but your commands donrsquot work

ndash In the bottom right corner of Serial Monitor window make sure the Line Ending drop down is set to New Line

Sound is weird and distorted

ndash Check your SD card speed (see page 44) Check speaker wiring try another good speaker

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 31

ldquoproffieboard_v1_confighrdquo

3WIRING DIAGRAMS1

Basic Segmented string wiringldquoconfighrdquo file setup

2-5W 4-8 ohmspeaker(positive pad has red dot or ldquo+rdquo mark)

NUM_BLADES 1NUM_BUTTONS 2VOLUME 1000CLASH_THRESHOLD_G 10StyleNormalPtrltCYAN WHITE 300 800gt()ltBlue3mmLED BladePin White3mmLEDgt

ProffieBoard config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)Volume level (0-3000)Clash sensitivity (adjust lower or higher with 01 step)Blade styleLED string configuration(here you mention the color and type of leds usedin the main blade string segments and FoC stringBladePin is the FoC signal pin (Blade ID pin))

Preset

LED string configuration

Use a given or build your wiring diagram on THIS PAGE then open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text

Editor (Notepad - to see code correctly in Notepad Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all

text) and Delete it then Copy-and-Paste (Ctrl+C Ctrl+V) your wiring diagram config code (example below) into empty _configh file and

Save it under new name Follow the instructions on page 22 to upload it to the board

PROFFIEBOARD INSTRUCTIONS

32 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Accent LEDs wiring diagram(optional)

Accent LEDs work with ProffieBoard as additional ldquobladesrdquo when powered by LED outputs 4 5 6 or Data pads 1 2 3 5 as PWM So they can

have any effect that blade can have If no effects needed accent led can be powered just by a 33V output pad (power-on led indication)

30-32 AWG

with Neopixel blade setup these 4 outputsdonrsquot work for regular accent leds

Recommended resistors to use for accent leds at 33V power source and 15mA drive

ndash 100 Ohm for Red (lt100000gt value in the code)ndash 13 Ohm for Green (lt13000gt value in the code)ndash 13 Ohm for Blue (lt13000gt value in the code)ndash 100 Ohm for Yellow (lt100000gt value in the code)ndash 20 Ohm for White (lt20000gt value in the code)

RGB ledcommon-anode

8 ldquobladesrdquo1 main and 7 accent leds

main blade style (effects) main blade style (effects)

7 accent leds style (effects)accent led style (effects)

7 accent leds configurations

RGB accent led configuration

2 ldquobladesrdquo1 main and 1 RGB accent led

ldquoPower-onrdquo indicationaccent leds (no effects)

7 accent leds withindependent effects

RGB accent led

a) b)

b)

c)

c)

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 33

3WIRING DIAGRAMS1

Neopixel Accent LEDs wiring diagram(optional)

With Neopixel setup additional neopixel leds or arrays can be used as accent leds There are 2 ways to wire them using additional Data

pins 2 3 4 5 or ldquoSub-bladesrdquo wiring with just 1 Data output pin Same way Neopixel connectors with on-board leds ca be wired

Option 1 ndash with extra Data pins

Main Blade

some accent leds

D1

D2

crystal leds

330 Ohm

330 Ohm

330 Ohm

main blade style (effects)

main blade 144 leds Data pin 1

accent leds blade style (effects)

accent leds ldquobladerdquo 4 leds Data pin 2

crystal leds blade style (effects)

crystal leds ldquobladerdquo 2 leds Data pin 3

3 ldquobladesrdquo1 main 1 accent leds array and 1 crystal leds array

PROFFIEBOARD INSTRUCTIONS

D3

follow arrows direction

34 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Neopixel Accent LEDs wiring diagram(optional)

PROFFIEBOARD INSTRUCTIONS

Main Blade

some accent leds

1

3

5678

2

4

D1

crystal leds

follow arrows direction

330 Ohm

330 OhmData signal

With this setup a single array of neopixel leds is separated into a couple of sub-blades with their own style configuration and behaviour This

is really usefull when you want to use only one data pin More about ldquoSub-bladesrdquo on ProffieOS wiki page

Option 2 ndash with ldquoSub-bladesrdquo

main blade style (effects)

main blade sub-blade 140 leds (7-146) but from 6 to 145 in the code

accent leds blade style (effects)

accent leds sub-blade 4 leds (1-4) but from 0 to 3 in the code

crystal leds blade style (effects)

146 leds total used

crystal leds sub-blade 2 leds (5-6) but from 4 to 5 in the code

update default 144 to a higher total value if you get all accent leds +Main blade gt 144 Example update to 146 if you have 2 crystal leds +4 accent leds + 140 Main blade leds = 146

3 ldquobladesrdquo 1 main 1 accent leds array and 1 crystal leds array

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 35

3WIRING DIAGRAMS1

OLED display wiring diagram(optional)

SSD1306 128x32 pixels OLED display allows to show battery level current preset name play different animations and even simple games It

can be wired to any blade configuration and requires just one additional line in the code to work You can get monochrome display in white

or blue color

SSD1306128x32OLED

SSD1306 ndash with blue or white display color selectSSD1306 ndash cheaper priceSSD1306 just screen ndash blue or white select

30-32 AWG

30-32 AWG

add this line to enable OLED display

display shows a preset name written in these quotes ldquoldquo

PROFFIEBOARD INSTRUCTIONS

36 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Bluetooth module wiring diagram(optional)

SOON

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 37

3WIRING DIAGRAMS1

Blade ID resistor functions(optional)

SOON

PROFFIEBOARD INSTRUCTIONS

38 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

website ProffieBoard FULL wiring diagrams link

Scroll the page down till you see the interactive diagram Above the diagram there are components selection options Build your saber setup

with it and follow diagram to wire your board Then you need to copy the configuration code below and paste it into your _configh file

Choose components you want

3WIRING DIAGRAMS1

More wiring diagrams

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 39

3WIRING DIAGRAMS1

How to use it

PROFFIEBOARD INSTRUCTIONS

Blade ignitionretraction ndash assuming you have at least one button pressing it briefly should turn the saber on or off If you have an AUX button pressing it briefly should also turn the saber on and off If you have no buttons you can turn the saber on and off by twisting your wrist back and forth Note that the motion has to be done long enough to count so a very quick flick of the wrist will not workTurn On muted ndash double-click power buttonNext preset ndash while saber is off click the AUX buttonPrevious preset ndash hold AUX button and click the Activation buttonTrigger Clash ndash while saber is on hit the bladeTrigger Lockup ndash while saber is on hold Activation button then trigger a clash Lockup releases when you let go of the Acti-vation buttonTrigger Drag ndash like lockup but point saber mostly down before holding Activation buttonTrigger Force ndash long-click AUX buttonStart soundtrack ndash long-click the Activation buttonTrigger Blaster Block ndash while saber is on short-click AUX button

Serial Monitor commands

battery_voltage ndash gets current battery voltage valueget_volume ndash get current volume valuepow ndash power OnOff the saberon ndash power On the saberoff ndash power Off the saberset_volume lt0-3000gt ndash set volume value (example set_volume 500)play ndash play the default preset trackplay trackslttrack namegt ndash play a specific track from tracks folder (example play tracksvenuswav)stop ndash stop the playing trackforce ndash play ldquoforcerdquo sound effectsdrag ndash play ldquodragrdquo sound effectsblast ndash play ldquoblasterrdquo sound effectslock ndash play ldquolockuprdquo sound effectsclash ndash play ldquoclashrdquo sound effectsreset ndash reboot the boardn ndash switch to next presetp ndash switch to previous presetlist_presets ndash show all presetssdtest ndash test SD card speed

40 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3FIRMWARE UPLOAD AND UPDATE2

Software installation and setup

PROFFIEBOARD INSTRUCTIONS

To upload firmware to ProffieBoard Arduino IDE program is required Follow these steps to install it to your PC

1 Install latest Arduino IDE software (donrsquot use BETA)

Installing as Windows app also is not recommended

because it will be installed in a specific protected folder that

wonrsquot allow you to install any additional softwareplugin in it

If ProffieBoard wonrsquot show up in COM port use

Arduino IDE 186 version

2 Install the Proffieboard Arduino Plugin and Zadig software

Follow installation instructions

3 Select Proffieboard-STM32L433 in Tools -gt Board

USB Type ndash Serial CPU Speed ndash 80 MHz Optimize ndash Smallest Code DOSFS ndash SDCARD (SPI) Port ndash COM(the number your PC assigned) (Butterfly-L433CC)

Connect Proffieboard via USB cable to PC to be able to select

the Port

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 41

3FIRMWARE UPLOAD AND UPDATE2

Uploading firmware

PROFFIEBOARD INSTRUCTIONS

1 Download the ProffieBoard firmware and SD card content

Unzip lightsaber-1286zip to your Documents directory or to

Desktop but not to Arduino program folder or anywhere in

Programs directory where all programs are installed You will

see a lightsaber folder and files inside it Donrsquot move any of

these files to any other location outside the lightsaber folder

and donrsquot reorganize them Unzip ProffieOS_SD_Cardzip to the

folder where you keep lightsaber-1286 folder Copy all files

from ProffieOS_SD_Card folder to your SD card

2 Unhide file extensions in File Explorer settings to see h ending

of config files Donrsquot add ldquohrdquo to the config file name Go to config folder and create you own configh file (see page

42 for how-to)

Double-click the lightsaberino file

3 Add the name of your configh file as shown and Save this

lightsaberino file Make sure the other config files are

commented out there should be only one CONFIG_FILE

without You can have multiple config files

in lightsabergtconfig folder and just define the one you need

in lightsaberino file and upload it again to ProffieBoard

4 Connect battery to ProffieBoard and hook up to your PC

with a data transfer micro-USB-to-USB cable

Press arrow button it will compile and upload firmware to the

board Wait for red text progress bars to stop at 100

ProffieBoard will play boot sound if speaker is connected

Now you can unplug the USB cable Done

If it gives an error instead this means your configh file has

issues define CONFIG_FILE name has mistakes configh file

is out of config folder your PC user name is non-latin

42 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

33

configh file structure editing

PROFFIEBOARD INSTRUCTIONS

CHANGING PARAMETERS

All sound files (sound fonts music tracks) are stored on the micro SD card Add required sound fonts folders (Plecter NEC and Smoothswing

fonts are supported no need to change WAV files names just copy and paste) to SD card root directory as itrsquos done in the default

ProffieOS_SD_Card content folder and music tracks to the tracks folder

Make sure to name all music tracks and sound fonts folders with latin characters and only up to 8 characters long without using any special

characters (like |[- etc)

Make sure you have a configini file in each sound font folder if there is none - copy one from some default TeensySaberProffieBoard sound

font and paste into newly added sound font folder It has only one parameter that you can modify - humstart It helps to match hum sound

start with blade ignition 1000 usually works fine

All blade effects LED configuration volume level clash sensitivity etc are changed in the configh file located in lightsabergtconfig folder

To do that open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text Editor (Notepad - to see code correctly in Notepad

Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all text) and Delete it then Copy-and-Paste (Ctrl+C

Ctrl+V) your wiring diagram config code into empty _configh file and Save it under new name Follow the instructions on page 39 to

upload it to the board

Proffieboard config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)

volume level (0-3000)

clash sensitivity (adjust lower or higher with 01 step)

sound font folder nametrack name

Preset name

Blade style

LED configuration (use these XP-E2 LED templatesto define your LED)

for Red use 1 Ohm resistor for Green - no resistor for Blue use 024 Ohm

NoLED ndash no 4th led used

Preset 1

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 43

33

Blade Styles

StylePtrltInOutHelperltSimpleClashltLockupltBlastltOnSparkltAudioFlickerltRgblt02550gtRgblt501000gtgtRgblt2552550gt150gtRgblt255500gtgtAudioFlickerltRgblt1002550gtRgblt2550150gtgtgtRgblt255100150gt40gt200300Blackgtgt

ndash this is how the Blade Style code looks pasted in the configh file Preset (it sits inside a StylePtrltgt container)

ndash this is how the Blade Style code looks when editing it inside a Blade Style Editor

Each Blade Style is made of a variety of Effects each added effect goes instead of a base color in the previous effect

PROFFIEBOARD INSTRUCTIONS

CHANGING PARAMETERS

ProffieBoard and TeensySaber use Blade Styles for the main saber blade and any other accent leds to define all light effects (color changing

flashes flickering delays ignitionretraction timing etc)

Use Blade Style Editor to create and adjust Blade Styles Megtooth Sith Sabers did a great video tutorial where he shows and explains

how to use Blade Style Editor Also you can grab some pre-made Blade Styles or share yours here on TRA forums

A Blade Style example of simple flickering Green blade with Spark on start Clash Blaster Lockup and Drag IgnitionRetraction effects

InOutHelperltSimpleClashltLockupltBlastltOnSparkltAudioFlickerltRgblt02550gtRgblt501000gtgtRgblt2552550gt150gtRgblt255500gtgtAudioFlickerltRgblt1002550gtRgblt2550150gtgtgtRgblt255100150gt40gt200300Blackgt

InOutHelperltbase color200300Blackgt ndash base color can be defined by words (WHITE RED GREEN PURPLE etc) or by Rgblt0-2550-2550-255gt values for more

custom shades 200 is extension length in milliseconds 300 is retraction length in milliseconds Black is color when retracted (also can be any other color)

SimpleClashltbase colorclash color40gt ndash clash effect 40 is clash duration in milliseconds

Lockupltbase colorlockup colorgt ndash lockup effect

Blastltbase colorblast colorgt ndash blaster effect

OnSparkltbase colorspark color150gt ndash spark on ignition effect 150 is spark duration in milliseconds

AudioFlickerltrdquoArdquo colorrdquoBrdquo colorgt ndash flickering effect (blade flickers to the actual saber hum sound) the more difference between ldquoArdquo and ldquoBrdquo colors - the more

abrupt is flickering

Rgblt255500gt ndash actual color in RGB format (0 is no light 255 is the maximum brightness value for Red Green or Blue channel)

44 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

ndash SanDisk 4GB microSDHC Class 4 (Genuine) ndash SanDisk 4GB microSDHC Class 4 (Genuine)

130238 kbs = 1477 simultaneous audio streams 137812 kbs = 1562 simultaneous audio streams

ndash Patriot LX Series 16GB microSDHC UHS-IU1 Class 10 ndash Patriot LX Series 16GB microSDHC UHS-IU1 Class 10

133005 kbs = 1508 simultaneous audio streams

ndash GSkill 16GB microSDHC UHS-IU1 Class 10 ndash GSkill 16GB microSDHC UHS-IU1 Class 10

129534 kbs = 1469 simultaneous audio streams

ndash Kingston 16GB microSDHC UHS-IU1 Class 10 ndash Kingston 16GB microSDHC UHS-IU1 Class 10

128090 kbs = 1452 simultaneous audio streams

ndash SanDisk Ultra 16GB microSDHC UHS-IU1 A1 Class 10 ndash SanDisk Ultra 16GB microSDHC UHS-IU1 A1 Class 10

102663 kbs = 1164 simultaneous audio streams 11124 kbs = 1261 simultaneous audio streams

ndash SanDisk 8GB microSDHC Class 4 ndash SanDisk 8GB microSDHC Class 4

108506 kbs = 1230 simultaneous audio streams

ndash SanDisk 16GB microSDHC Class 4 ndash SanDisk 16GB microSDHC Class 4

102663 kbs = 1164 simultaneous audio streams 106957 kbs = 1213 simultaneous audio streams

ndash SanDisk Ultra 16GB microSDHC UHS-IU1 Class 10 ndash SanDisk Ultra 16GB microSDHC UHS-IU1 Class 10

102663 kbs = 1164 simultaneous audio streams 103909 kbs = 1178 simultaneous audio streams

ndash Smartbuy 4GB microSDHC Class 4 ndash Smartbuy 4GB microSDHC Class 4

75437 kbs = 855 simultaneous audio streams

ndash Kingston 8GB microSDHC Class 4 ndash Kingston 8GB microSDHC Class 4

75209 kbs = 822 simultaneous audio streams

ndash SanDisk 4GB microSDHC Class 4 (Fake) ndash SanDisk 4GB microSDHC Class 4 (Fake)

677 kbs = 769 simultaneous audio streams

Here is a list of tested micro SD cards speed with TeensySaber V3 and ProffieBoard Any card with speed over 900 kbs is recommended the

higher the speed is ndash the better Memory size of 4-16Gb is more than enough Cards were tested with a default firmware (1291) compiled

with ldquoSmallest Coderdquo under Optimize ldquodefault_proffieboard_confighrdquo file and default ProffieOS SD card sound files (7 folders)

To test your SD card speed simply hook up ProffieBoard to PC open Arduino IDE go to Tools and open Serial Monitor make sure you have

New Line and 9600 baud rate selected on the bottom of Serial Monitor window type and send sdtest command wait for the test result

4Recommended micro SD cards

BEST

TEENSYSABER PROFFIEBOARD

GOOD

BAD

PROFFIEBOARD INSTRUCTIONS

SD CARD RECOMMENDATIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 45

There are a lot of fake (chinese copies) microSD cards on the market from aliexpress ebay amazon etc They look very similar to genuine

cards but are a bit different though and have a twice lower writingreading speed Here is an example of a SanDisk 4Gb Class 4 card one is

genuine with 137812 kbs speed and the other one is fake with 677 kbs speed I got from ebay seller

Be carefull and pay attention to how the actual card looks if you are not sure ask seller for the real photo of SD card he sells

4Genuine and Fake SanDisk 4Gb Class 4 microSD

PROFFIEBOARD INSTRUCTIONS

SD CARD RECOMMENDATIONS

46 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

WIRE GAUGE GUIDE

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 47

RECHARGE PORTS AND KILL SWITCHES

48 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

NEOPIXEL STRIPS CURRENT DRAW

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 49

6TROUBLESHOOTING

For more help please check these linksProffieOSProffieBoardTeensySaber wiki on GitHubAsk your question on The Rebel Armory forumsAsk your question on FX-sabers forumsAsk your question in facebook group

How to solve most common issues

Quick troubleshooting tips

TeensySaber board or Proffieboard is not recognized by computer (nothing under Port selection in Arduino)

ndash Make sure a charged 37V battery is connected to the board micro-USB cable is a data transfer cable all plugins and drivers are installed ndash

check again pages 21 for TeensySaber or 40 for Proffieboard Try a different USB port on your computer

Sketch (code) compile error in Arduino IDE

ndash Check your define CONFIG_FILE ldquoconfig_confighrdquo line in opened lightsaberino file if itrsquos written correctly with config in it

Sketch (code) compile error in Arduino IDE

ndash Check if the _configh file you defined in the lightsaberino sketch file is same name as in the lightsaber-rdquofirmware versionrdquolightsaber

config folder and is located in this folder

Sketch (code) compile error in Arduino IDE

ndash Check your settings under Tools tab in Arduino IDE program Check again pages 21 for TeensySaber or 40 for Proffieboard

Sketch (code) compile error in Arduino IDE

ndash Check if your _configh file is correct Blade Styles Presets const unsigned int maxLedsPerStrip = 144 if BladeConfig blades[] = is correct

Sketch (code) compile error in Arduino IDE

ndash If nothing helps install Arduino IDE version 186 and try to compile and upload the firmware again

Sound doesnrsquot play

ndash Remove SD card and insert again check speaker wiring Make sure all sound files on SD card are correctly named (8 characters max long)

Re-format SD card in FAT32 load sound files and try again try another SD card

Board says ldquoLOW POWERrdquo

ndash Charge the battery

Serial Monitor shows info sent by the board but your commands donrsquot work

ndash In the bottom right corner of Serial Monitor window make sure the Line Ending drop down is set to New Line

Sound is weird and distorted

ndash Check your SD card speed (see page 44) Check speaker wiring try another good speaker

32 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Accent LEDs wiring diagram(optional)

Accent LEDs work with ProffieBoard as additional ldquobladesrdquo when powered by LED outputs 4 5 6 or Data pads 1 2 3 5 as PWM So they can

have any effect that blade can have If no effects needed accent led can be powered just by a 33V output pad (power-on led indication)

30-32 AWG

with Neopixel blade setup these 4 outputsdonrsquot work for regular accent leds

Recommended resistors to use for accent leds at 33V power source and 15mA drive

ndash 100 Ohm for Red (lt100000gt value in the code)ndash 13 Ohm for Green (lt13000gt value in the code)ndash 13 Ohm for Blue (lt13000gt value in the code)ndash 100 Ohm for Yellow (lt100000gt value in the code)ndash 20 Ohm for White (lt20000gt value in the code)

RGB ledcommon-anode

8 ldquobladesrdquo1 main and 7 accent leds

main blade style (effects) main blade style (effects)

7 accent leds style (effects)accent led style (effects)

7 accent leds configurations

RGB accent led configuration

2 ldquobladesrdquo1 main and 1 RGB accent led

ldquoPower-onrdquo indicationaccent leds (no effects)

7 accent leds withindependent effects

RGB accent led

a) b)

b)

c)

c)

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 33

3WIRING DIAGRAMS1

Neopixel Accent LEDs wiring diagram(optional)

With Neopixel setup additional neopixel leds or arrays can be used as accent leds There are 2 ways to wire them using additional Data

pins 2 3 4 5 or ldquoSub-bladesrdquo wiring with just 1 Data output pin Same way Neopixel connectors with on-board leds ca be wired

Option 1 ndash with extra Data pins

Main Blade

some accent leds

D1

D2

crystal leds

330 Ohm

330 Ohm

330 Ohm

main blade style (effects)

main blade 144 leds Data pin 1

accent leds blade style (effects)

accent leds ldquobladerdquo 4 leds Data pin 2

crystal leds blade style (effects)

crystal leds ldquobladerdquo 2 leds Data pin 3

3 ldquobladesrdquo1 main 1 accent leds array and 1 crystal leds array

PROFFIEBOARD INSTRUCTIONS

D3

follow arrows direction

34 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Neopixel Accent LEDs wiring diagram(optional)

PROFFIEBOARD INSTRUCTIONS

Main Blade

some accent leds

1

3

5678

2

4

D1

crystal leds

follow arrows direction

330 Ohm

330 OhmData signal

With this setup a single array of neopixel leds is separated into a couple of sub-blades with their own style configuration and behaviour This

is really usefull when you want to use only one data pin More about ldquoSub-bladesrdquo on ProffieOS wiki page

Option 2 ndash with ldquoSub-bladesrdquo

main blade style (effects)

main blade sub-blade 140 leds (7-146) but from 6 to 145 in the code

accent leds blade style (effects)

accent leds sub-blade 4 leds (1-4) but from 0 to 3 in the code

crystal leds blade style (effects)

146 leds total used

crystal leds sub-blade 2 leds (5-6) but from 4 to 5 in the code

update default 144 to a higher total value if you get all accent leds +Main blade gt 144 Example update to 146 if you have 2 crystal leds +4 accent leds + 140 Main blade leds = 146

3 ldquobladesrdquo 1 main 1 accent leds array and 1 crystal leds array

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 35

3WIRING DIAGRAMS1

OLED display wiring diagram(optional)

SSD1306 128x32 pixels OLED display allows to show battery level current preset name play different animations and even simple games It

can be wired to any blade configuration and requires just one additional line in the code to work You can get monochrome display in white

or blue color

SSD1306128x32OLED

SSD1306 ndash with blue or white display color selectSSD1306 ndash cheaper priceSSD1306 just screen ndash blue or white select

30-32 AWG

30-32 AWG

add this line to enable OLED display

display shows a preset name written in these quotes ldquoldquo

PROFFIEBOARD INSTRUCTIONS

36 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Bluetooth module wiring diagram(optional)

SOON

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 37

3WIRING DIAGRAMS1

Blade ID resistor functions(optional)

SOON

PROFFIEBOARD INSTRUCTIONS

38 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

website ProffieBoard FULL wiring diagrams link

Scroll the page down till you see the interactive diagram Above the diagram there are components selection options Build your saber setup

with it and follow diagram to wire your board Then you need to copy the configuration code below and paste it into your _configh file

Choose components you want

3WIRING DIAGRAMS1

More wiring diagrams

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 39

3WIRING DIAGRAMS1

How to use it

PROFFIEBOARD INSTRUCTIONS

Blade ignitionretraction ndash assuming you have at least one button pressing it briefly should turn the saber on or off If you have an AUX button pressing it briefly should also turn the saber on and off If you have no buttons you can turn the saber on and off by twisting your wrist back and forth Note that the motion has to be done long enough to count so a very quick flick of the wrist will not workTurn On muted ndash double-click power buttonNext preset ndash while saber is off click the AUX buttonPrevious preset ndash hold AUX button and click the Activation buttonTrigger Clash ndash while saber is on hit the bladeTrigger Lockup ndash while saber is on hold Activation button then trigger a clash Lockup releases when you let go of the Acti-vation buttonTrigger Drag ndash like lockup but point saber mostly down before holding Activation buttonTrigger Force ndash long-click AUX buttonStart soundtrack ndash long-click the Activation buttonTrigger Blaster Block ndash while saber is on short-click AUX button

Serial Monitor commands

battery_voltage ndash gets current battery voltage valueget_volume ndash get current volume valuepow ndash power OnOff the saberon ndash power On the saberoff ndash power Off the saberset_volume lt0-3000gt ndash set volume value (example set_volume 500)play ndash play the default preset trackplay trackslttrack namegt ndash play a specific track from tracks folder (example play tracksvenuswav)stop ndash stop the playing trackforce ndash play ldquoforcerdquo sound effectsdrag ndash play ldquodragrdquo sound effectsblast ndash play ldquoblasterrdquo sound effectslock ndash play ldquolockuprdquo sound effectsclash ndash play ldquoclashrdquo sound effectsreset ndash reboot the boardn ndash switch to next presetp ndash switch to previous presetlist_presets ndash show all presetssdtest ndash test SD card speed

40 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3FIRMWARE UPLOAD AND UPDATE2

Software installation and setup

PROFFIEBOARD INSTRUCTIONS

To upload firmware to ProffieBoard Arduino IDE program is required Follow these steps to install it to your PC

1 Install latest Arduino IDE software (donrsquot use BETA)

Installing as Windows app also is not recommended

because it will be installed in a specific protected folder that

wonrsquot allow you to install any additional softwareplugin in it

If ProffieBoard wonrsquot show up in COM port use

Arduino IDE 186 version

2 Install the Proffieboard Arduino Plugin and Zadig software

Follow installation instructions

3 Select Proffieboard-STM32L433 in Tools -gt Board

USB Type ndash Serial CPU Speed ndash 80 MHz Optimize ndash Smallest Code DOSFS ndash SDCARD (SPI) Port ndash COM(the number your PC assigned) (Butterfly-L433CC)

Connect Proffieboard via USB cable to PC to be able to select

the Port

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 41

3FIRMWARE UPLOAD AND UPDATE2

Uploading firmware

PROFFIEBOARD INSTRUCTIONS

1 Download the ProffieBoard firmware and SD card content

Unzip lightsaber-1286zip to your Documents directory or to

Desktop but not to Arduino program folder or anywhere in

Programs directory where all programs are installed You will

see a lightsaber folder and files inside it Donrsquot move any of

these files to any other location outside the lightsaber folder

and donrsquot reorganize them Unzip ProffieOS_SD_Cardzip to the

folder where you keep lightsaber-1286 folder Copy all files

from ProffieOS_SD_Card folder to your SD card

2 Unhide file extensions in File Explorer settings to see h ending

of config files Donrsquot add ldquohrdquo to the config file name Go to config folder and create you own configh file (see page

42 for how-to)

Double-click the lightsaberino file

3 Add the name of your configh file as shown and Save this

lightsaberino file Make sure the other config files are

commented out there should be only one CONFIG_FILE

without You can have multiple config files

in lightsabergtconfig folder and just define the one you need

in lightsaberino file and upload it again to ProffieBoard

4 Connect battery to ProffieBoard and hook up to your PC

with a data transfer micro-USB-to-USB cable

Press arrow button it will compile and upload firmware to the

board Wait for red text progress bars to stop at 100

ProffieBoard will play boot sound if speaker is connected

Now you can unplug the USB cable Done

If it gives an error instead this means your configh file has

issues define CONFIG_FILE name has mistakes configh file

is out of config folder your PC user name is non-latin

42 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

33

configh file structure editing

PROFFIEBOARD INSTRUCTIONS

CHANGING PARAMETERS

All sound files (sound fonts music tracks) are stored on the micro SD card Add required sound fonts folders (Plecter NEC and Smoothswing

fonts are supported no need to change WAV files names just copy and paste) to SD card root directory as itrsquos done in the default

ProffieOS_SD_Card content folder and music tracks to the tracks folder

Make sure to name all music tracks and sound fonts folders with latin characters and only up to 8 characters long without using any special

characters (like |[- etc)

Make sure you have a configini file in each sound font folder if there is none - copy one from some default TeensySaberProffieBoard sound

font and paste into newly added sound font folder It has only one parameter that you can modify - humstart It helps to match hum sound

start with blade ignition 1000 usually works fine

All blade effects LED configuration volume level clash sensitivity etc are changed in the configh file located in lightsabergtconfig folder

To do that open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text Editor (Notepad - to see code correctly in Notepad

Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all text) and Delete it then Copy-and-Paste (Ctrl+C

Ctrl+V) your wiring diagram config code into empty _configh file and Save it under new name Follow the instructions on page 39 to

upload it to the board

Proffieboard config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)

volume level (0-3000)

clash sensitivity (adjust lower or higher with 01 step)

sound font folder nametrack name

Preset name

Blade style

LED configuration (use these XP-E2 LED templatesto define your LED)

for Red use 1 Ohm resistor for Green - no resistor for Blue use 024 Ohm

NoLED ndash no 4th led used

Preset 1

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 43

33

Blade Styles

StylePtrltInOutHelperltSimpleClashltLockupltBlastltOnSparkltAudioFlickerltRgblt02550gtRgblt501000gtgtRgblt2552550gt150gtRgblt255500gtgtAudioFlickerltRgblt1002550gtRgblt2550150gtgtgtRgblt255100150gt40gt200300Blackgtgt

ndash this is how the Blade Style code looks pasted in the configh file Preset (it sits inside a StylePtrltgt container)

ndash this is how the Blade Style code looks when editing it inside a Blade Style Editor

Each Blade Style is made of a variety of Effects each added effect goes instead of a base color in the previous effect

PROFFIEBOARD INSTRUCTIONS

CHANGING PARAMETERS

ProffieBoard and TeensySaber use Blade Styles for the main saber blade and any other accent leds to define all light effects (color changing

flashes flickering delays ignitionretraction timing etc)

Use Blade Style Editor to create and adjust Blade Styles Megtooth Sith Sabers did a great video tutorial where he shows and explains

how to use Blade Style Editor Also you can grab some pre-made Blade Styles or share yours here on TRA forums

A Blade Style example of simple flickering Green blade with Spark on start Clash Blaster Lockup and Drag IgnitionRetraction effects

InOutHelperltSimpleClashltLockupltBlastltOnSparkltAudioFlickerltRgblt02550gtRgblt501000gtgtRgblt2552550gt150gtRgblt255500gtgtAudioFlickerltRgblt1002550gtRgblt2550150gtgtgtRgblt255100150gt40gt200300Blackgt

InOutHelperltbase color200300Blackgt ndash base color can be defined by words (WHITE RED GREEN PURPLE etc) or by Rgblt0-2550-2550-255gt values for more

custom shades 200 is extension length in milliseconds 300 is retraction length in milliseconds Black is color when retracted (also can be any other color)

SimpleClashltbase colorclash color40gt ndash clash effect 40 is clash duration in milliseconds

Lockupltbase colorlockup colorgt ndash lockup effect

Blastltbase colorblast colorgt ndash blaster effect

OnSparkltbase colorspark color150gt ndash spark on ignition effect 150 is spark duration in milliseconds

AudioFlickerltrdquoArdquo colorrdquoBrdquo colorgt ndash flickering effect (blade flickers to the actual saber hum sound) the more difference between ldquoArdquo and ldquoBrdquo colors - the more

abrupt is flickering

Rgblt255500gt ndash actual color in RGB format (0 is no light 255 is the maximum brightness value for Red Green or Blue channel)

44 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

ndash SanDisk 4GB microSDHC Class 4 (Genuine) ndash SanDisk 4GB microSDHC Class 4 (Genuine)

130238 kbs = 1477 simultaneous audio streams 137812 kbs = 1562 simultaneous audio streams

ndash Patriot LX Series 16GB microSDHC UHS-IU1 Class 10 ndash Patriot LX Series 16GB microSDHC UHS-IU1 Class 10

133005 kbs = 1508 simultaneous audio streams

ndash GSkill 16GB microSDHC UHS-IU1 Class 10 ndash GSkill 16GB microSDHC UHS-IU1 Class 10

129534 kbs = 1469 simultaneous audio streams

ndash Kingston 16GB microSDHC UHS-IU1 Class 10 ndash Kingston 16GB microSDHC UHS-IU1 Class 10

128090 kbs = 1452 simultaneous audio streams

ndash SanDisk Ultra 16GB microSDHC UHS-IU1 A1 Class 10 ndash SanDisk Ultra 16GB microSDHC UHS-IU1 A1 Class 10

102663 kbs = 1164 simultaneous audio streams 11124 kbs = 1261 simultaneous audio streams

ndash SanDisk 8GB microSDHC Class 4 ndash SanDisk 8GB microSDHC Class 4

108506 kbs = 1230 simultaneous audio streams

ndash SanDisk 16GB microSDHC Class 4 ndash SanDisk 16GB microSDHC Class 4

102663 kbs = 1164 simultaneous audio streams 106957 kbs = 1213 simultaneous audio streams

ndash SanDisk Ultra 16GB microSDHC UHS-IU1 Class 10 ndash SanDisk Ultra 16GB microSDHC UHS-IU1 Class 10

102663 kbs = 1164 simultaneous audio streams 103909 kbs = 1178 simultaneous audio streams

ndash Smartbuy 4GB microSDHC Class 4 ndash Smartbuy 4GB microSDHC Class 4

75437 kbs = 855 simultaneous audio streams

ndash Kingston 8GB microSDHC Class 4 ndash Kingston 8GB microSDHC Class 4

75209 kbs = 822 simultaneous audio streams

ndash SanDisk 4GB microSDHC Class 4 (Fake) ndash SanDisk 4GB microSDHC Class 4 (Fake)

677 kbs = 769 simultaneous audio streams

Here is a list of tested micro SD cards speed with TeensySaber V3 and ProffieBoard Any card with speed over 900 kbs is recommended the

higher the speed is ndash the better Memory size of 4-16Gb is more than enough Cards were tested with a default firmware (1291) compiled

with ldquoSmallest Coderdquo under Optimize ldquodefault_proffieboard_confighrdquo file and default ProffieOS SD card sound files (7 folders)

To test your SD card speed simply hook up ProffieBoard to PC open Arduino IDE go to Tools and open Serial Monitor make sure you have

New Line and 9600 baud rate selected on the bottom of Serial Monitor window type and send sdtest command wait for the test result

4Recommended micro SD cards

BEST

TEENSYSABER PROFFIEBOARD

GOOD

BAD

PROFFIEBOARD INSTRUCTIONS

SD CARD RECOMMENDATIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 45

There are a lot of fake (chinese copies) microSD cards on the market from aliexpress ebay amazon etc They look very similar to genuine

cards but are a bit different though and have a twice lower writingreading speed Here is an example of a SanDisk 4Gb Class 4 card one is

genuine with 137812 kbs speed and the other one is fake with 677 kbs speed I got from ebay seller

Be carefull and pay attention to how the actual card looks if you are not sure ask seller for the real photo of SD card he sells

4Genuine and Fake SanDisk 4Gb Class 4 microSD

PROFFIEBOARD INSTRUCTIONS

SD CARD RECOMMENDATIONS

46 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

WIRE GAUGE GUIDE

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 47

RECHARGE PORTS AND KILL SWITCHES

48 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

NEOPIXEL STRIPS CURRENT DRAW

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 49

6TROUBLESHOOTING

For more help please check these linksProffieOSProffieBoardTeensySaber wiki on GitHubAsk your question on The Rebel Armory forumsAsk your question on FX-sabers forumsAsk your question in facebook group

How to solve most common issues

Quick troubleshooting tips

TeensySaber board or Proffieboard is not recognized by computer (nothing under Port selection in Arduino)

ndash Make sure a charged 37V battery is connected to the board micro-USB cable is a data transfer cable all plugins and drivers are installed ndash

check again pages 21 for TeensySaber or 40 for Proffieboard Try a different USB port on your computer

Sketch (code) compile error in Arduino IDE

ndash Check your define CONFIG_FILE ldquoconfig_confighrdquo line in opened lightsaberino file if itrsquos written correctly with config in it

Sketch (code) compile error in Arduino IDE

ndash Check if the _configh file you defined in the lightsaberino sketch file is same name as in the lightsaber-rdquofirmware versionrdquolightsaber

config folder and is located in this folder

Sketch (code) compile error in Arduino IDE

ndash Check your settings under Tools tab in Arduino IDE program Check again pages 21 for TeensySaber or 40 for Proffieboard

Sketch (code) compile error in Arduino IDE

ndash Check if your _configh file is correct Blade Styles Presets const unsigned int maxLedsPerStrip = 144 if BladeConfig blades[] = is correct

Sketch (code) compile error in Arduino IDE

ndash If nothing helps install Arduino IDE version 186 and try to compile and upload the firmware again

Sound doesnrsquot play

ndash Remove SD card and insert again check speaker wiring Make sure all sound files on SD card are correctly named (8 characters max long)

Re-format SD card in FAT32 load sound files and try again try another SD card

Board says ldquoLOW POWERrdquo

ndash Charge the battery

Serial Monitor shows info sent by the board but your commands donrsquot work

ndash In the bottom right corner of Serial Monitor window make sure the Line Ending drop down is set to New Line

Sound is weird and distorted

ndash Check your SD card speed (see page 44) Check speaker wiring try another good speaker

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 33

3WIRING DIAGRAMS1

Neopixel Accent LEDs wiring diagram(optional)

With Neopixel setup additional neopixel leds or arrays can be used as accent leds There are 2 ways to wire them using additional Data

pins 2 3 4 5 or ldquoSub-bladesrdquo wiring with just 1 Data output pin Same way Neopixel connectors with on-board leds ca be wired

Option 1 ndash with extra Data pins

Main Blade

some accent leds

D1

D2

crystal leds

330 Ohm

330 Ohm

330 Ohm

main blade style (effects)

main blade 144 leds Data pin 1

accent leds blade style (effects)

accent leds ldquobladerdquo 4 leds Data pin 2

crystal leds blade style (effects)

crystal leds ldquobladerdquo 2 leds Data pin 3

3 ldquobladesrdquo1 main 1 accent leds array and 1 crystal leds array

PROFFIEBOARD INSTRUCTIONS

D3

follow arrows direction

34 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Neopixel Accent LEDs wiring diagram(optional)

PROFFIEBOARD INSTRUCTIONS

Main Blade

some accent leds

1

3

5678

2

4

D1

crystal leds

follow arrows direction

330 Ohm

330 OhmData signal

With this setup a single array of neopixel leds is separated into a couple of sub-blades with their own style configuration and behaviour This

is really usefull when you want to use only one data pin More about ldquoSub-bladesrdquo on ProffieOS wiki page

Option 2 ndash with ldquoSub-bladesrdquo

main blade style (effects)

main blade sub-blade 140 leds (7-146) but from 6 to 145 in the code

accent leds blade style (effects)

accent leds sub-blade 4 leds (1-4) but from 0 to 3 in the code

crystal leds blade style (effects)

146 leds total used

crystal leds sub-blade 2 leds (5-6) but from 4 to 5 in the code

update default 144 to a higher total value if you get all accent leds +Main blade gt 144 Example update to 146 if you have 2 crystal leds +4 accent leds + 140 Main blade leds = 146

3 ldquobladesrdquo 1 main 1 accent leds array and 1 crystal leds array

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 35

3WIRING DIAGRAMS1

OLED display wiring diagram(optional)

SSD1306 128x32 pixels OLED display allows to show battery level current preset name play different animations and even simple games It

can be wired to any blade configuration and requires just one additional line in the code to work You can get monochrome display in white

or blue color

SSD1306128x32OLED

SSD1306 ndash with blue or white display color selectSSD1306 ndash cheaper priceSSD1306 just screen ndash blue or white select

30-32 AWG

30-32 AWG

add this line to enable OLED display

display shows a preset name written in these quotes ldquoldquo

PROFFIEBOARD INSTRUCTIONS

36 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Bluetooth module wiring diagram(optional)

SOON

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 37

3WIRING DIAGRAMS1

Blade ID resistor functions(optional)

SOON

PROFFIEBOARD INSTRUCTIONS

38 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

website ProffieBoard FULL wiring diagrams link

Scroll the page down till you see the interactive diagram Above the diagram there are components selection options Build your saber setup

with it and follow diagram to wire your board Then you need to copy the configuration code below and paste it into your _configh file

Choose components you want

3WIRING DIAGRAMS1

More wiring diagrams

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 39

3WIRING DIAGRAMS1

How to use it

PROFFIEBOARD INSTRUCTIONS

Blade ignitionretraction ndash assuming you have at least one button pressing it briefly should turn the saber on or off If you have an AUX button pressing it briefly should also turn the saber on and off If you have no buttons you can turn the saber on and off by twisting your wrist back and forth Note that the motion has to be done long enough to count so a very quick flick of the wrist will not workTurn On muted ndash double-click power buttonNext preset ndash while saber is off click the AUX buttonPrevious preset ndash hold AUX button and click the Activation buttonTrigger Clash ndash while saber is on hit the bladeTrigger Lockup ndash while saber is on hold Activation button then trigger a clash Lockup releases when you let go of the Acti-vation buttonTrigger Drag ndash like lockup but point saber mostly down before holding Activation buttonTrigger Force ndash long-click AUX buttonStart soundtrack ndash long-click the Activation buttonTrigger Blaster Block ndash while saber is on short-click AUX button

Serial Monitor commands

battery_voltage ndash gets current battery voltage valueget_volume ndash get current volume valuepow ndash power OnOff the saberon ndash power On the saberoff ndash power Off the saberset_volume lt0-3000gt ndash set volume value (example set_volume 500)play ndash play the default preset trackplay trackslttrack namegt ndash play a specific track from tracks folder (example play tracksvenuswav)stop ndash stop the playing trackforce ndash play ldquoforcerdquo sound effectsdrag ndash play ldquodragrdquo sound effectsblast ndash play ldquoblasterrdquo sound effectslock ndash play ldquolockuprdquo sound effectsclash ndash play ldquoclashrdquo sound effectsreset ndash reboot the boardn ndash switch to next presetp ndash switch to previous presetlist_presets ndash show all presetssdtest ndash test SD card speed

40 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3FIRMWARE UPLOAD AND UPDATE2

Software installation and setup

PROFFIEBOARD INSTRUCTIONS

To upload firmware to ProffieBoard Arduino IDE program is required Follow these steps to install it to your PC

1 Install latest Arduino IDE software (donrsquot use BETA)

Installing as Windows app also is not recommended

because it will be installed in a specific protected folder that

wonrsquot allow you to install any additional softwareplugin in it

If ProffieBoard wonrsquot show up in COM port use

Arduino IDE 186 version

2 Install the Proffieboard Arduino Plugin and Zadig software

Follow installation instructions

3 Select Proffieboard-STM32L433 in Tools -gt Board

USB Type ndash Serial CPU Speed ndash 80 MHz Optimize ndash Smallest Code DOSFS ndash SDCARD (SPI) Port ndash COM(the number your PC assigned) (Butterfly-L433CC)

Connect Proffieboard via USB cable to PC to be able to select

the Port

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 41

3FIRMWARE UPLOAD AND UPDATE2

Uploading firmware

PROFFIEBOARD INSTRUCTIONS

1 Download the ProffieBoard firmware and SD card content

Unzip lightsaber-1286zip to your Documents directory or to

Desktop but not to Arduino program folder or anywhere in

Programs directory where all programs are installed You will

see a lightsaber folder and files inside it Donrsquot move any of

these files to any other location outside the lightsaber folder

and donrsquot reorganize them Unzip ProffieOS_SD_Cardzip to the

folder where you keep lightsaber-1286 folder Copy all files

from ProffieOS_SD_Card folder to your SD card

2 Unhide file extensions in File Explorer settings to see h ending

of config files Donrsquot add ldquohrdquo to the config file name Go to config folder and create you own configh file (see page

42 for how-to)

Double-click the lightsaberino file

3 Add the name of your configh file as shown and Save this

lightsaberino file Make sure the other config files are

commented out there should be only one CONFIG_FILE

without You can have multiple config files

in lightsabergtconfig folder and just define the one you need

in lightsaberino file and upload it again to ProffieBoard

4 Connect battery to ProffieBoard and hook up to your PC

with a data transfer micro-USB-to-USB cable

Press arrow button it will compile and upload firmware to the

board Wait for red text progress bars to stop at 100

ProffieBoard will play boot sound if speaker is connected

Now you can unplug the USB cable Done

If it gives an error instead this means your configh file has

issues define CONFIG_FILE name has mistakes configh file

is out of config folder your PC user name is non-latin

42 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

33

configh file structure editing

PROFFIEBOARD INSTRUCTIONS

CHANGING PARAMETERS

All sound files (sound fonts music tracks) are stored on the micro SD card Add required sound fonts folders (Plecter NEC and Smoothswing

fonts are supported no need to change WAV files names just copy and paste) to SD card root directory as itrsquos done in the default

ProffieOS_SD_Card content folder and music tracks to the tracks folder

Make sure to name all music tracks and sound fonts folders with latin characters and only up to 8 characters long without using any special

characters (like |[- etc)

Make sure you have a configini file in each sound font folder if there is none - copy one from some default TeensySaberProffieBoard sound

font and paste into newly added sound font folder It has only one parameter that you can modify - humstart It helps to match hum sound

start with blade ignition 1000 usually works fine

All blade effects LED configuration volume level clash sensitivity etc are changed in the configh file located in lightsabergtconfig folder

To do that open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text Editor (Notepad - to see code correctly in Notepad

Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all text) and Delete it then Copy-and-Paste (Ctrl+C

Ctrl+V) your wiring diagram config code into empty _configh file and Save it under new name Follow the instructions on page 39 to

upload it to the board

Proffieboard config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)

volume level (0-3000)

clash sensitivity (adjust lower or higher with 01 step)

sound font folder nametrack name

Preset name

Blade style

LED configuration (use these XP-E2 LED templatesto define your LED)

for Red use 1 Ohm resistor for Green - no resistor for Blue use 024 Ohm

NoLED ndash no 4th led used

Preset 1

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 43

33

Blade Styles

StylePtrltInOutHelperltSimpleClashltLockupltBlastltOnSparkltAudioFlickerltRgblt02550gtRgblt501000gtgtRgblt2552550gt150gtRgblt255500gtgtAudioFlickerltRgblt1002550gtRgblt2550150gtgtgtRgblt255100150gt40gt200300Blackgtgt

ndash this is how the Blade Style code looks pasted in the configh file Preset (it sits inside a StylePtrltgt container)

ndash this is how the Blade Style code looks when editing it inside a Blade Style Editor

Each Blade Style is made of a variety of Effects each added effect goes instead of a base color in the previous effect

PROFFIEBOARD INSTRUCTIONS

CHANGING PARAMETERS

ProffieBoard and TeensySaber use Blade Styles for the main saber blade and any other accent leds to define all light effects (color changing

flashes flickering delays ignitionretraction timing etc)

Use Blade Style Editor to create and adjust Blade Styles Megtooth Sith Sabers did a great video tutorial where he shows and explains

how to use Blade Style Editor Also you can grab some pre-made Blade Styles or share yours here on TRA forums

A Blade Style example of simple flickering Green blade with Spark on start Clash Blaster Lockup and Drag IgnitionRetraction effects

InOutHelperltSimpleClashltLockupltBlastltOnSparkltAudioFlickerltRgblt02550gtRgblt501000gtgtRgblt2552550gt150gtRgblt255500gtgtAudioFlickerltRgblt1002550gtRgblt2550150gtgtgtRgblt255100150gt40gt200300Blackgt

InOutHelperltbase color200300Blackgt ndash base color can be defined by words (WHITE RED GREEN PURPLE etc) or by Rgblt0-2550-2550-255gt values for more

custom shades 200 is extension length in milliseconds 300 is retraction length in milliseconds Black is color when retracted (also can be any other color)

SimpleClashltbase colorclash color40gt ndash clash effect 40 is clash duration in milliseconds

Lockupltbase colorlockup colorgt ndash lockup effect

Blastltbase colorblast colorgt ndash blaster effect

OnSparkltbase colorspark color150gt ndash spark on ignition effect 150 is spark duration in milliseconds

AudioFlickerltrdquoArdquo colorrdquoBrdquo colorgt ndash flickering effect (blade flickers to the actual saber hum sound) the more difference between ldquoArdquo and ldquoBrdquo colors - the more

abrupt is flickering

Rgblt255500gt ndash actual color in RGB format (0 is no light 255 is the maximum brightness value for Red Green or Blue channel)

44 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

ndash SanDisk 4GB microSDHC Class 4 (Genuine) ndash SanDisk 4GB microSDHC Class 4 (Genuine)

130238 kbs = 1477 simultaneous audio streams 137812 kbs = 1562 simultaneous audio streams

ndash Patriot LX Series 16GB microSDHC UHS-IU1 Class 10 ndash Patriot LX Series 16GB microSDHC UHS-IU1 Class 10

133005 kbs = 1508 simultaneous audio streams

ndash GSkill 16GB microSDHC UHS-IU1 Class 10 ndash GSkill 16GB microSDHC UHS-IU1 Class 10

129534 kbs = 1469 simultaneous audio streams

ndash Kingston 16GB microSDHC UHS-IU1 Class 10 ndash Kingston 16GB microSDHC UHS-IU1 Class 10

128090 kbs = 1452 simultaneous audio streams

ndash SanDisk Ultra 16GB microSDHC UHS-IU1 A1 Class 10 ndash SanDisk Ultra 16GB microSDHC UHS-IU1 A1 Class 10

102663 kbs = 1164 simultaneous audio streams 11124 kbs = 1261 simultaneous audio streams

ndash SanDisk 8GB microSDHC Class 4 ndash SanDisk 8GB microSDHC Class 4

108506 kbs = 1230 simultaneous audio streams

ndash SanDisk 16GB microSDHC Class 4 ndash SanDisk 16GB microSDHC Class 4

102663 kbs = 1164 simultaneous audio streams 106957 kbs = 1213 simultaneous audio streams

ndash SanDisk Ultra 16GB microSDHC UHS-IU1 Class 10 ndash SanDisk Ultra 16GB microSDHC UHS-IU1 Class 10

102663 kbs = 1164 simultaneous audio streams 103909 kbs = 1178 simultaneous audio streams

ndash Smartbuy 4GB microSDHC Class 4 ndash Smartbuy 4GB microSDHC Class 4

75437 kbs = 855 simultaneous audio streams

ndash Kingston 8GB microSDHC Class 4 ndash Kingston 8GB microSDHC Class 4

75209 kbs = 822 simultaneous audio streams

ndash SanDisk 4GB microSDHC Class 4 (Fake) ndash SanDisk 4GB microSDHC Class 4 (Fake)

677 kbs = 769 simultaneous audio streams

Here is a list of tested micro SD cards speed with TeensySaber V3 and ProffieBoard Any card with speed over 900 kbs is recommended the

higher the speed is ndash the better Memory size of 4-16Gb is more than enough Cards were tested with a default firmware (1291) compiled

with ldquoSmallest Coderdquo under Optimize ldquodefault_proffieboard_confighrdquo file and default ProffieOS SD card sound files (7 folders)

To test your SD card speed simply hook up ProffieBoard to PC open Arduino IDE go to Tools and open Serial Monitor make sure you have

New Line and 9600 baud rate selected on the bottom of Serial Monitor window type and send sdtest command wait for the test result

4Recommended micro SD cards

BEST

TEENSYSABER PROFFIEBOARD

GOOD

BAD

PROFFIEBOARD INSTRUCTIONS

SD CARD RECOMMENDATIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 45

There are a lot of fake (chinese copies) microSD cards on the market from aliexpress ebay amazon etc They look very similar to genuine

cards but are a bit different though and have a twice lower writingreading speed Here is an example of a SanDisk 4Gb Class 4 card one is

genuine with 137812 kbs speed and the other one is fake with 677 kbs speed I got from ebay seller

Be carefull and pay attention to how the actual card looks if you are not sure ask seller for the real photo of SD card he sells

4Genuine and Fake SanDisk 4Gb Class 4 microSD

PROFFIEBOARD INSTRUCTIONS

SD CARD RECOMMENDATIONS

46 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

WIRE GAUGE GUIDE

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 47

RECHARGE PORTS AND KILL SWITCHES

48 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

NEOPIXEL STRIPS CURRENT DRAW

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 49

6TROUBLESHOOTING

For more help please check these linksProffieOSProffieBoardTeensySaber wiki on GitHubAsk your question on The Rebel Armory forumsAsk your question on FX-sabers forumsAsk your question in facebook group

How to solve most common issues

Quick troubleshooting tips

TeensySaber board or Proffieboard is not recognized by computer (nothing under Port selection in Arduino)

ndash Make sure a charged 37V battery is connected to the board micro-USB cable is a data transfer cable all plugins and drivers are installed ndash

check again pages 21 for TeensySaber or 40 for Proffieboard Try a different USB port on your computer

Sketch (code) compile error in Arduino IDE

ndash Check your define CONFIG_FILE ldquoconfig_confighrdquo line in opened lightsaberino file if itrsquos written correctly with config in it

Sketch (code) compile error in Arduino IDE

ndash Check if the _configh file you defined in the lightsaberino sketch file is same name as in the lightsaber-rdquofirmware versionrdquolightsaber

config folder and is located in this folder

Sketch (code) compile error in Arduino IDE

ndash Check your settings under Tools tab in Arduino IDE program Check again pages 21 for TeensySaber or 40 for Proffieboard

Sketch (code) compile error in Arduino IDE

ndash Check if your _configh file is correct Blade Styles Presets const unsigned int maxLedsPerStrip = 144 if BladeConfig blades[] = is correct

Sketch (code) compile error in Arduino IDE

ndash If nothing helps install Arduino IDE version 186 and try to compile and upload the firmware again

Sound doesnrsquot play

ndash Remove SD card and insert again check speaker wiring Make sure all sound files on SD card are correctly named (8 characters max long)

Re-format SD card in FAT32 load sound files and try again try another SD card

Board says ldquoLOW POWERrdquo

ndash Charge the battery

Serial Monitor shows info sent by the board but your commands donrsquot work

ndash In the bottom right corner of Serial Monitor window make sure the Line Ending drop down is set to New Line

Sound is weird and distorted

ndash Check your SD card speed (see page 44) Check speaker wiring try another good speaker

34 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Neopixel Accent LEDs wiring diagram(optional)

PROFFIEBOARD INSTRUCTIONS

Main Blade

some accent leds

1

3

5678

2

4

D1

crystal leds

follow arrows direction

330 Ohm

330 OhmData signal

With this setup a single array of neopixel leds is separated into a couple of sub-blades with their own style configuration and behaviour This

is really usefull when you want to use only one data pin More about ldquoSub-bladesrdquo on ProffieOS wiki page

Option 2 ndash with ldquoSub-bladesrdquo

main blade style (effects)

main blade sub-blade 140 leds (7-146) but from 6 to 145 in the code

accent leds blade style (effects)

accent leds sub-blade 4 leds (1-4) but from 0 to 3 in the code

crystal leds blade style (effects)

146 leds total used

crystal leds sub-blade 2 leds (5-6) but from 4 to 5 in the code

update default 144 to a higher total value if you get all accent leds +Main blade gt 144 Example update to 146 if you have 2 crystal leds +4 accent leds + 140 Main blade leds = 146

3 ldquobladesrdquo 1 main 1 accent leds array and 1 crystal leds array

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 35

3WIRING DIAGRAMS1

OLED display wiring diagram(optional)

SSD1306 128x32 pixels OLED display allows to show battery level current preset name play different animations and even simple games It

can be wired to any blade configuration and requires just one additional line in the code to work You can get monochrome display in white

or blue color

SSD1306128x32OLED

SSD1306 ndash with blue or white display color selectSSD1306 ndash cheaper priceSSD1306 just screen ndash blue or white select

30-32 AWG

30-32 AWG

add this line to enable OLED display

display shows a preset name written in these quotes ldquoldquo

PROFFIEBOARD INSTRUCTIONS

36 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Bluetooth module wiring diagram(optional)

SOON

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 37

3WIRING DIAGRAMS1

Blade ID resistor functions(optional)

SOON

PROFFIEBOARD INSTRUCTIONS

38 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

website ProffieBoard FULL wiring diagrams link

Scroll the page down till you see the interactive diagram Above the diagram there are components selection options Build your saber setup

with it and follow diagram to wire your board Then you need to copy the configuration code below and paste it into your _configh file

Choose components you want

3WIRING DIAGRAMS1

More wiring diagrams

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 39

3WIRING DIAGRAMS1

How to use it

PROFFIEBOARD INSTRUCTIONS

Blade ignitionretraction ndash assuming you have at least one button pressing it briefly should turn the saber on or off If you have an AUX button pressing it briefly should also turn the saber on and off If you have no buttons you can turn the saber on and off by twisting your wrist back and forth Note that the motion has to be done long enough to count so a very quick flick of the wrist will not workTurn On muted ndash double-click power buttonNext preset ndash while saber is off click the AUX buttonPrevious preset ndash hold AUX button and click the Activation buttonTrigger Clash ndash while saber is on hit the bladeTrigger Lockup ndash while saber is on hold Activation button then trigger a clash Lockup releases when you let go of the Acti-vation buttonTrigger Drag ndash like lockup but point saber mostly down before holding Activation buttonTrigger Force ndash long-click AUX buttonStart soundtrack ndash long-click the Activation buttonTrigger Blaster Block ndash while saber is on short-click AUX button

Serial Monitor commands

battery_voltage ndash gets current battery voltage valueget_volume ndash get current volume valuepow ndash power OnOff the saberon ndash power On the saberoff ndash power Off the saberset_volume lt0-3000gt ndash set volume value (example set_volume 500)play ndash play the default preset trackplay trackslttrack namegt ndash play a specific track from tracks folder (example play tracksvenuswav)stop ndash stop the playing trackforce ndash play ldquoforcerdquo sound effectsdrag ndash play ldquodragrdquo sound effectsblast ndash play ldquoblasterrdquo sound effectslock ndash play ldquolockuprdquo sound effectsclash ndash play ldquoclashrdquo sound effectsreset ndash reboot the boardn ndash switch to next presetp ndash switch to previous presetlist_presets ndash show all presetssdtest ndash test SD card speed

40 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3FIRMWARE UPLOAD AND UPDATE2

Software installation and setup

PROFFIEBOARD INSTRUCTIONS

To upload firmware to ProffieBoard Arduino IDE program is required Follow these steps to install it to your PC

1 Install latest Arduino IDE software (donrsquot use BETA)

Installing as Windows app also is not recommended

because it will be installed in a specific protected folder that

wonrsquot allow you to install any additional softwareplugin in it

If ProffieBoard wonrsquot show up in COM port use

Arduino IDE 186 version

2 Install the Proffieboard Arduino Plugin and Zadig software

Follow installation instructions

3 Select Proffieboard-STM32L433 in Tools -gt Board

USB Type ndash Serial CPU Speed ndash 80 MHz Optimize ndash Smallest Code DOSFS ndash SDCARD (SPI) Port ndash COM(the number your PC assigned) (Butterfly-L433CC)

Connect Proffieboard via USB cable to PC to be able to select

the Port

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 41

3FIRMWARE UPLOAD AND UPDATE2

Uploading firmware

PROFFIEBOARD INSTRUCTIONS

1 Download the ProffieBoard firmware and SD card content

Unzip lightsaber-1286zip to your Documents directory or to

Desktop but not to Arduino program folder or anywhere in

Programs directory where all programs are installed You will

see a lightsaber folder and files inside it Donrsquot move any of

these files to any other location outside the lightsaber folder

and donrsquot reorganize them Unzip ProffieOS_SD_Cardzip to the

folder where you keep lightsaber-1286 folder Copy all files

from ProffieOS_SD_Card folder to your SD card

2 Unhide file extensions in File Explorer settings to see h ending

of config files Donrsquot add ldquohrdquo to the config file name Go to config folder and create you own configh file (see page

42 for how-to)

Double-click the lightsaberino file

3 Add the name of your configh file as shown and Save this

lightsaberino file Make sure the other config files are

commented out there should be only one CONFIG_FILE

without You can have multiple config files

in lightsabergtconfig folder and just define the one you need

in lightsaberino file and upload it again to ProffieBoard

4 Connect battery to ProffieBoard and hook up to your PC

with a data transfer micro-USB-to-USB cable

Press arrow button it will compile and upload firmware to the

board Wait for red text progress bars to stop at 100

ProffieBoard will play boot sound if speaker is connected

Now you can unplug the USB cable Done

If it gives an error instead this means your configh file has

issues define CONFIG_FILE name has mistakes configh file

is out of config folder your PC user name is non-latin

42 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

33

configh file structure editing

PROFFIEBOARD INSTRUCTIONS

CHANGING PARAMETERS

All sound files (sound fonts music tracks) are stored on the micro SD card Add required sound fonts folders (Plecter NEC and Smoothswing

fonts are supported no need to change WAV files names just copy and paste) to SD card root directory as itrsquos done in the default

ProffieOS_SD_Card content folder and music tracks to the tracks folder

Make sure to name all music tracks and sound fonts folders with latin characters and only up to 8 characters long without using any special

characters (like |[- etc)

Make sure you have a configini file in each sound font folder if there is none - copy one from some default TeensySaberProffieBoard sound

font and paste into newly added sound font folder It has only one parameter that you can modify - humstart It helps to match hum sound

start with blade ignition 1000 usually works fine

All blade effects LED configuration volume level clash sensitivity etc are changed in the configh file located in lightsabergtconfig folder

To do that open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text Editor (Notepad - to see code correctly in Notepad

Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all text) and Delete it then Copy-and-Paste (Ctrl+C

Ctrl+V) your wiring diagram config code into empty _configh file and Save it under new name Follow the instructions on page 39 to

upload it to the board

Proffieboard config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)

volume level (0-3000)

clash sensitivity (adjust lower or higher with 01 step)

sound font folder nametrack name

Preset name

Blade style

LED configuration (use these XP-E2 LED templatesto define your LED)

for Red use 1 Ohm resistor for Green - no resistor for Blue use 024 Ohm

NoLED ndash no 4th led used

Preset 1

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 43

33

Blade Styles

StylePtrltInOutHelperltSimpleClashltLockupltBlastltOnSparkltAudioFlickerltRgblt02550gtRgblt501000gtgtRgblt2552550gt150gtRgblt255500gtgtAudioFlickerltRgblt1002550gtRgblt2550150gtgtgtRgblt255100150gt40gt200300Blackgtgt

ndash this is how the Blade Style code looks pasted in the configh file Preset (it sits inside a StylePtrltgt container)

ndash this is how the Blade Style code looks when editing it inside a Blade Style Editor

Each Blade Style is made of a variety of Effects each added effect goes instead of a base color in the previous effect

PROFFIEBOARD INSTRUCTIONS

CHANGING PARAMETERS

ProffieBoard and TeensySaber use Blade Styles for the main saber blade and any other accent leds to define all light effects (color changing

flashes flickering delays ignitionretraction timing etc)

Use Blade Style Editor to create and adjust Blade Styles Megtooth Sith Sabers did a great video tutorial where he shows and explains

how to use Blade Style Editor Also you can grab some pre-made Blade Styles or share yours here on TRA forums

A Blade Style example of simple flickering Green blade with Spark on start Clash Blaster Lockup and Drag IgnitionRetraction effects

InOutHelperltSimpleClashltLockupltBlastltOnSparkltAudioFlickerltRgblt02550gtRgblt501000gtgtRgblt2552550gt150gtRgblt255500gtgtAudioFlickerltRgblt1002550gtRgblt2550150gtgtgtRgblt255100150gt40gt200300Blackgt

InOutHelperltbase color200300Blackgt ndash base color can be defined by words (WHITE RED GREEN PURPLE etc) or by Rgblt0-2550-2550-255gt values for more

custom shades 200 is extension length in milliseconds 300 is retraction length in milliseconds Black is color when retracted (also can be any other color)

SimpleClashltbase colorclash color40gt ndash clash effect 40 is clash duration in milliseconds

Lockupltbase colorlockup colorgt ndash lockup effect

Blastltbase colorblast colorgt ndash blaster effect

OnSparkltbase colorspark color150gt ndash spark on ignition effect 150 is spark duration in milliseconds

AudioFlickerltrdquoArdquo colorrdquoBrdquo colorgt ndash flickering effect (blade flickers to the actual saber hum sound) the more difference between ldquoArdquo and ldquoBrdquo colors - the more

abrupt is flickering

Rgblt255500gt ndash actual color in RGB format (0 is no light 255 is the maximum brightness value for Red Green or Blue channel)

44 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

ndash SanDisk 4GB microSDHC Class 4 (Genuine) ndash SanDisk 4GB microSDHC Class 4 (Genuine)

130238 kbs = 1477 simultaneous audio streams 137812 kbs = 1562 simultaneous audio streams

ndash Patriot LX Series 16GB microSDHC UHS-IU1 Class 10 ndash Patriot LX Series 16GB microSDHC UHS-IU1 Class 10

133005 kbs = 1508 simultaneous audio streams

ndash GSkill 16GB microSDHC UHS-IU1 Class 10 ndash GSkill 16GB microSDHC UHS-IU1 Class 10

129534 kbs = 1469 simultaneous audio streams

ndash Kingston 16GB microSDHC UHS-IU1 Class 10 ndash Kingston 16GB microSDHC UHS-IU1 Class 10

128090 kbs = 1452 simultaneous audio streams

ndash SanDisk Ultra 16GB microSDHC UHS-IU1 A1 Class 10 ndash SanDisk Ultra 16GB microSDHC UHS-IU1 A1 Class 10

102663 kbs = 1164 simultaneous audio streams 11124 kbs = 1261 simultaneous audio streams

ndash SanDisk 8GB microSDHC Class 4 ndash SanDisk 8GB microSDHC Class 4

108506 kbs = 1230 simultaneous audio streams

ndash SanDisk 16GB microSDHC Class 4 ndash SanDisk 16GB microSDHC Class 4

102663 kbs = 1164 simultaneous audio streams 106957 kbs = 1213 simultaneous audio streams

ndash SanDisk Ultra 16GB microSDHC UHS-IU1 Class 10 ndash SanDisk Ultra 16GB microSDHC UHS-IU1 Class 10

102663 kbs = 1164 simultaneous audio streams 103909 kbs = 1178 simultaneous audio streams

ndash Smartbuy 4GB microSDHC Class 4 ndash Smartbuy 4GB microSDHC Class 4

75437 kbs = 855 simultaneous audio streams

ndash Kingston 8GB microSDHC Class 4 ndash Kingston 8GB microSDHC Class 4

75209 kbs = 822 simultaneous audio streams

ndash SanDisk 4GB microSDHC Class 4 (Fake) ndash SanDisk 4GB microSDHC Class 4 (Fake)

677 kbs = 769 simultaneous audio streams

Here is a list of tested micro SD cards speed with TeensySaber V3 and ProffieBoard Any card with speed over 900 kbs is recommended the

higher the speed is ndash the better Memory size of 4-16Gb is more than enough Cards were tested with a default firmware (1291) compiled

with ldquoSmallest Coderdquo under Optimize ldquodefault_proffieboard_confighrdquo file and default ProffieOS SD card sound files (7 folders)

To test your SD card speed simply hook up ProffieBoard to PC open Arduino IDE go to Tools and open Serial Monitor make sure you have

New Line and 9600 baud rate selected on the bottom of Serial Monitor window type and send sdtest command wait for the test result

4Recommended micro SD cards

BEST

TEENSYSABER PROFFIEBOARD

GOOD

BAD

PROFFIEBOARD INSTRUCTIONS

SD CARD RECOMMENDATIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 45

There are a lot of fake (chinese copies) microSD cards on the market from aliexpress ebay amazon etc They look very similar to genuine

cards but are a bit different though and have a twice lower writingreading speed Here is an example of a SanDisk 4Gb Class 4 card one is

genuine with 137812 kbs speed and the other one is fake with 677 kbs speed I got from ebay seller

Be carefull and pay attention to how the actual card looks if you are not sure ask seller for the real photo of SD card he sells

4Genuine and Fake SanDisk 4Gb Class 4 microSD

PROFFIEBOARD INSTRUCTIONS

SD CARD RECOMMENDATIONS

46 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

WIRE GAUGE GUIDE

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 47

RECHARGE PORTS AND KILL SWITCHES

48 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

NEOPIXEL STRIPS CURRENT DRAW

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 49

6TROUBLESHOOTING

For more help please check these linksProffieOSProffieBoardTeensySaber wiki on GitHubAsk your question on The Rebel Armory forumsAsk your question on FX-sabers forumsAsk your question in facebook group

How to solve most common issues

Quick troubleshooting tips

TeensySaber board or Proffieboard is not recognized by computer (nothing under Port selection in Arduino)

ndash Make sure a charged 37V battery is connected to the board micro-USB cable is a data transfer cable all plugins and drivers are installed ndash

check again pages 21 for TeensySaber or 40 for Proffieboard Try a different USB port on your computer

Sketch (code) compile error in Arduino IDE

ndash Check your define CONFIG_FILE ldquoconfig_confighrdquo line in opened lightsaberino file if itrsquos written correctly with config in it

Sketch (code) compile error in Arduino IDE

ndash Check if the _configh file you defined in the lightsaberino sketch file is same name as in the lightsaber-rdquofirmware versionrdquolightsaber

config folder and is located in this folder

Sketch (code) compile error in Arduino IDE

ndash Check your settings under Tools tab in Arduino IDE program Check again pages 21 for TeensySaber or 40 for Proffieboard

Sketch (code) compile error in Arduino IDE

ndash Check if your _configh file is correct Blade Styles Presets const unsigned int maxLedsPerStrip = 144 if BladeConfig blades[] = is correct

Sketch (code) compile error in Arduino IDE

ndash If nothing helps install Arduino IDE version 186 and try to compile and upload the firmware again

Sound doesnrsquot play

ndash Remove SD card and insert again check speaker wiring Make sure all sound files on SD card are correctly named (8 characters max long)

Re-format SD card in FAT32 load sound files and try again try another SD card

Board says ldquoLOW POWERrdquo

ndash Charge the battery

Serial Monitor shows info sent by the board but your commands donrsquot work

ndash In the bottom right corner of Serial Monitor window make sure the Line Ending drop down is set to New Line

Sound is weird and distorted

ndash Check your SD card speed (see page 44) Check speaker wiring try another good speaker

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 35

3WIRING DIAGRAMS1

OLED display wiring diagram(optional)

SSD1306 128x32 pixels OLED display allows to show battery level current preset name play different animations and even simple games It

can be wired to any blade configuration and requires just one additional line in the code to work You can get monochrome display in white

or blue color

SSD1306128x32OLED

SSD1306 ndash with blue or white display color selectSSD1306 ndash cheaper priceSSD1306 just screen ndash blue or white select

30-32 AWG

30-32 AWG

add this line to enable OLED display

display shows a preset name written in these quotes ldquoldquo

PROFFIEBOARD INSTRUCTIONS

36 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Bluetooth module wiring diagram(optional)

SOON

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 37

3WIRING DIAGRAMS1

Blade ID resistor functions(optional)

SOON

PROFFIEBOARD INSTRUCTIONS

38 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

website ProffieBoard FULL wiring diagrams link

Scroll the page down till you see the interactive diagram Above the diagram there are components selection options Build your saber setup

with it and follow diagram to wire your board Then you need to copy the configuration code below and paste it into your _configh file

Choose components you want

3WIRING DIAGRAMS1

More wiring diagrams

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 39

3WIRING DIAGRAMS1

How to use it

PROFFIEBOARD INSTRUCTIONS

Blade ignitionretraction ndash assuming you have at least one button pressing it briefly should turn the saber on or off If you have an AUX button pressing it briefly should also turn the saber on and off If you have no buttons you can turn the saber on and off by twisting your wrist back and forth Note that the motion has to be done long enough to count so a very quick flick of the wrist will not workTurn On muted ndash double-click power buttonNext preset ndash while saber is off click the AUX buttonPrevious preset ndash hold AUX button and click the Activation buttonTrigger Clash ndash while saber is on hit the bladeTrigger Lockup ndash while saber is on hold Activation button then trigger a clash Lockup releases when you let go of the Acti-vation buttonTrigger Drag ndash like lockup but point saber mostly down before holding Activation buttonTrigger Force ndash long-click AUX buttonStart soundtrack ndash long-click the Activation buttonTrigger Blaster Block ndash while saber is on short-click AUX button

Serial Monitor commands

battery_voltage ndash gets current battery voltage valueget_volume ndash get current volume valuepow ndash power OnOff the saberon ndash power On the saberoff ndash power Off the saberset_volume lt0-3000gt ndash set volume value (example set_volume 500)play ndash play the default preset trackplay trackslttrack namegt ndash play a specific track from tracks folder (example play tracksvenuswav)stop ndash stop the playing trackforce ndash play ldquoforcerdquo sound effectsdrag ndash play ldquodragrdquo sound effectsblast ndash play ldquoblasterrdquo sound effectslock ndash play ldquolockuprdquo sound effectsclash ndash play ldquoclashrdquo sound effectsreset ndash reboot the boardn ndash switch to next presetp ndash switch to previous presetlist_presets ndash show all presetssdtest ndash test SD card speed

40 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3FIRMWARE UPLOAD AND UPDATE2

Software installation and setup

PROFFIEBOARD INSTRUCTIONS

To upload firmware to ProffieBoard Arduino IDE program is required Follow these steps to install it to your PC

1 Install latest Arduino IDE software (donrsquot use BETA)

Installing as Windows app also is not recommended

because it will be installed in a specific protected folder that

wonrsquot allow you to install any additional softwareplugin in it

If ProffieBoard wonrsquot show up in COM port use

Arduino IDE 186 version

2 Install the Proffieboard Arduino Plugin and Zadig software

Follow installation instructions

3 Select Proffieboard-STM32L433 in Tools -gt Board

USB Type ndash Serial CPU Speed ndash 80 MHz Optimize ndash Smallest Code DOSFS ndash SDCARD (SPI) Port ndash COM(the number your PC assigned) (Butterfly-L433CC)

Connect Proffieboard via USB cable to PC to be able to select

the Port

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 41

3FIRMWARE UPLOAD AND UPDATE2

Uploading firmware

PROFFIEBOARD INSTRUCTIONS

1 Download the ProffieBoard firmware and SD card content

Unzip lightsaber-1286zip to your Documents directory or to

Desktop but not to Arduino program folder or anywhere in

Programs directory where all programs are installed You will

see a lightsaber folder and files inside it Donrsquot move any of

these files to any other location outside the lightsaber folder

and donrsquot reorganize them Unzip ProffieOS_SD_Cardzip to the

folder where you keep lightsaber-1286 folder Copy all files

from ProffieOS_SD_Card folder to your SD card

2 Unhide file extensions in File Explorer settings to see h ending

of config files Donrsquot add ldquohrdquo to the config file name Go to config folder and create you own configh file (see page

42 for how-to)

Double-click the lightsaberino file

3 Add the name of your configh file as shown and Save this

lightsaberino file Make sure the other config files are

commented out there should be only one CONFIG_FILE

without You can have multiple config files

in lightsabergtconfig folder and just define the one you need

in lightsaberino file and upload it again to ProffieBoard

4 Connect battery to ProffieBoard and hook up to your PC

with a data transfer micro-USB-to-USB cable

Press arrow button it will compile and upload firmware to the

board Wait for red text progress bars to stop at 100

ProffieBoard will play boot sound if speaker is connected

Now you can unplug the USB cable Done

If it gives an error instead this means your configh file has

issues define CONFIG_FILE name has mistakes configh file

is out of config folder your PC user name is non-latin

42 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

33

configh file structure editing

PROFFIEBOARD INSTRUCTIONS

CHANGING PARAMETERS

All sound files (sound fonts music tracks) are stored on the micro SD card Add required sound fonts folders (Plecter NEC and Smoothswing

fonts are supported no need to change WAV files names just copy and paste) to SD card root directory as itrsquos done in the default

ProffieOS_SD_Card content folder and music tracks to the tracks folder

Make sure to name all music tracks and sound fonts folders with latin characters and only up to 8 characters long without using any special

characters (like |[- etc)

Make sure you have a configini file in each sound font folder if there is none - copy one from some default TeensySaberProffieBoard sound

font and paste into newly added sound font folder It has only one parameter that you can modify - humstart It helps to match hum sound

start with blade ignition 1000 usually works fine

All blade effects LED configuration volume level clash sensitivity etc are changed in the configh file located in lightsabergtconfig folder

To do that open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text Editor (Notepad - to see code correctly in Notepad

Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all text) and Delete it then Copy-and-Paste (Ctrl+C

Ctrl+V) your wiring diagram config code into empty _configh file and Save it under new name Follow the instructions on page 39 to

upload it to the board

Proffieboard config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)

volume level (0-3000)

clash sensitivity (adjust lower or higher with 01 step)

sound font folder nametrack name

Preset name

Blade style

LED configuration (use these XP-E2 LED templatesto define your LED)

for Red use 1 Ohm resistor for Green - no resistor for Blue use 024 Ohm

NoLED ndash no 4th led used

Preset 1

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 43

33

Blade Styles

StylePtrltInOutHelperltSimpleClashltLockupltBlastltOnSparkltAudioFlickerltRgblt02550gtRgblt501000gtgtRgblt2552550gt150gtRgblt255500gtgtAudioFlickerltRgblt1002550gtRgblt2550150gtgtgtRgblt255100150gt40gt200300Blackgtgt

ndash this is how the Blade Style code looks pasted in the configh file Preset (it sits inside a StylePtrltgt container)

ndash this is how the Blade Style code looks when editing it inside a Blade Style Editor

Each Blade Style is made of a variety of Effects each added effect goes instead of a base color in the previous effect

PROFFIEBOARD INSTRUCTIONS

CHANGING PARAMETERS

ProffieBoard and TeensySaber use Blade Styles for the main saber blade and any other accent leds to define all light effects (color changing

flashes flickering delays ignitionretraction timing etc)

Use Blade Style Editor to create and adjust Blade Styles Megtooth Sith Sabers did a great video tutorial where he shows and explains

how to use Blade Style Editor Also you can grab some pre-made Blade Styles or share yours here on TRA forums

A Blade Style example of simple flickering Green blade with Spark on start Clash Blaster Lockup and Drag IgnitionRetraction effects

InOutHelperltSimpleClashltLockupltBlastltOnSparkltAudioFlickerltRgblt02550gtRgblt501000gtgtRgblt2552550gt150gtRgblt255500gtgtAudioFlickerltRgblt1002550gtRgblt2550150gtgtgtRgblt255100150gt40gt200300Blackgt

InOutHelperltbase color200300Blackgt ndash base color can be defined by words (WHITE RED GREEN PURPLE etc) or by Rgblt0-2550-2550-255gt values for more

custom shades 200 is extension length in milliseconds 300 is retraction length in milliseconds Black is color when retracted (also can be any other color)

SimpleClashltbase colorclash color40gt ndash clash effect 40 is clash duration in milliseconds

Lockupltbase colorlockup colorgt ndash lockup effect

Blastltbase colorblast colorgt ndash blaster effect

OnSparkltbase colorspark color150gt ndash spark on ignition effect 150 is spark duration in milliseconds

AudioFlickerltrdquoArdquo colorrdquoBrdquo colorgt ndash flickering effect (blade flickers to the actual saber hum sound) the more difference between ldquoArdquo and ldquoBrdquo colors - the more

abrupt is flickering

Rgblt255500gt ndash actual color in RGB format (0 is no light 255 is the maximum brightness value for Red Green or Blue channel)

44 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

ndash SanDisk 4GB microSDHC Class 4 (Genuine) ndash SanDisk 4GB microSDHC Class 4 (Genuine)

130238 kbs = 1477 simultaneous audio streams 137812 kbs = 1562 simultaneous audio streams

ndash Patriot LX Series 16GB microSDHC UHS-IU1 Class 10 ndash Patriot LX Series 16GB microSDHC UHS-IU1 Class 10

133005 kbs = 1508 simultaneous audio streams

ndash GSkill 16GB microSDHC UHS-IU1 Class 10 ndash GSkill 16GB microSDHC UHS-IU1 Class 10

129534 kbs = 1469 simultaneous audio streams

ndash Kingston 16GB microSDHC UHS-IU1 Class 10 ndash Kingston 16GB microSDHC UHS-IU1 Class 10

128090 kbs = 1452 simultaneous audio streams

ndash SanDisk Ultra 16GB microSDHC UHS-IU1 A1 Class 10 ndash SanDisk Ultra 16GB microSDHC UHS-IU1 A1 Class 10

102663 kbs = 1164 simultaneous audio streams 11124 kbs = 1261 simultaneous audio streams

ndash SanDisk 8GB microSDHC Class 4 ndash SanDisk 8GB microSDHC Class 4

108506 kbs = 1230 simultaneous audio streams

ndash SanDisk 16GB microSDHC Class 4 ndash SanDisk 16GB microSDHC Class 4

102663 kbs = 1164 simultaneous audio streams 106957 kbs = 1213 simultaneous audio streams

ndash SanDisk Ultra 16GB microSDHC UHS-IU1 Class 10 ndash SanDisk Ultra 16GB microSDHC UHS-IU1 Class 10

102663 kbs = 1164 simultaneous audio streams 103909 kbs = 1178 simultaneous audio streams

ndash Smartbuy 4GB microSDHC Class 4 ndash Smartbuy 4GB microSDHC Class 4

75437 kbs = 855 simultaneous audio streams

ndash Kingston 8GB microSDHC Class 4 ndash Kingston 8GB microSDHC Class 4

75209 kbs = 822 simultaneous audio streams

ndash SanDisk 4GB microSDHC Class 4 (Fake) ndash SanDisk 4GB microSDHC Class 4 (Fake)

677 kbs = 769 simultaneous audio streams

Here is a list of tested micro SD cards speed with TeensySaber V3 and ProffieBoard Any card with speed over 900 kbs is recommended the

higher the speed is ndash the better Memory size of 4-16Gb is more than enough Cards were tested with a default firmware (1291) compiled

with ldquoSmallest Coderdquo under Optimize ldquodefault_proffieboard_confighrdquo file and default ProffieOS SD card sound files (7 folders)

To test your SD card speed simply hook up ProffieBoard to PC open Arduino IDE go to Tools and open Serial Monitor make sure you have

New Line and 9600 baud rate selected on the bottom of Serial Monitor window type and send sdtest command wait for the test result

4Recommended micro SD cards

BEST

TEENSYSABER PROFFIEBOARD

GOOD

BAD

PROFFIEBOARD INSTRUCTIONS

SD CARD RECOMMENDATIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 45

There are a lot of fake (chinese copies) microSD cards on the market from aliexpress ebay amazon etc They look very similar to genuine

cards but are a bit different though and have a twice lower writingreading speed Here is an example of a SanDisk 4Gb Class 4 card one is

genuine with 137812 kbs speed and the other one is fake with 677 kbs speed I got from ebay seller

Be carefull and pay attention to how the actual card looks if you are not sure ask seller for the real photo of SD card he sells

4Genuine and Fake SanDisk 4Gb Class 4 microSD

PROFFIEBOARD INSTRUCTIONS

SD CARD RECOMMENDATIONS

46 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

WIRE GAUGE GUIDE

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 47

RECHARGE PORTS AND KILL SWITCHES

48 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

NEOPIXEL STRIPS CURRENT DRAW

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 49

6TROUBLESHOOTING

For more help please check these linksProffieOSProffieBoardTeensySaber wiki on GitHubAsk your question on The Rebel Armory forumsAsk your question on FX-sabers forumsAsk your question in facebook group

How to solve most common issues

Quick troubleshooting tips

TeensySaber board or Proffieboard is not recognized by computer (nothing under Port selection in Arduino)

ndash Make sure a charged 37V battery is connected to the board micro-USB cable is a data transfer cable all plugins and drivers are installed ndash

check again pages 21 for TeensySaber or 40 for Proffieboard Try a different USB port on your computer

Sketch (code) compile error in Arduino IDE

ndash Check your define CONFIG_FILE ldquoconfig_confighrdquo line in opened lightsaberino file if itrsquos written correctly with config in it

Sketch (code) compile error in Arduino IDE

ndash Check if the _configh file you defined in the lightsaberino sketch file is same name as in the lightsaber-rdquofirmware versionrdquolightsaber

config folder and is located in this folder

Sketch (code) compile error in Arduino IDE

ndash Check your settings under Tools tab in Arduino IDE program Check again pages 21 for TeensySaber or 40 for Proffieboard

Sketch (code) compile error in Arduino IDE

ndash Check if your _configh file is correct Blade Styles Presets const unsigned int maxLedsPerStrip = 144 if BladeConfig blades[] = is correct

Sketch (code) compile error in Arduino IDE

ndash If nothing helps install Arduino IDE version 186 and try to compile and upload the firmware again

Sound doesnrsquot play

ndash Remove SD card and insert again check speaker wiring Make sure all sound files on SD card are correctly named (8 characters max long)

Re-format SD card in FAT32 load sound files and try again try another SD card

Board says ldquoLOW POWERrdquo

ndash Charge the battery

Serial Monitor shows info sent by the board but your commands donrsquot work

ndash In the bottom right corner of Serial Monitor window make sure the Line Ending drop down is set to New Line

Sound is weird and distorted

ndash Check your SD card speed (see page 44) Check speaker wiring try another good speaker

36 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3WIRING DIAGRAMS1

Bluetooth module wiring diagram(optional)

SOON

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 37

3WIRING DIAGRAMS1

Blade ID resistor functions(optional)

SOON

PROFFIEBOARD INSTRUCTIONS

38 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

website ProffieBoard FULL wiring diagrams link

Scroll the page down till you see the interactive diagram Above the diagram there are components selection options Build your saber setup

with it and follow diagram to wire your board Then you need to copy the configuration code below and paste it into your _configh file

Choose components you want

3WIRING DIAGRAMS1

More wiring diagrams

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 39

3WIRING DIAGRAMS1

How to use it

PROFFIEBOARD INSTRUCTIONS

Blade ignitionretraction ndash assuming you have at least one button pressing it briefly should turn the saber on or off If you have an AUX button pressing it briefly should also turn the saber on and off If you have no buttons you can turn the saber on and off by twisting your wrist back and forth Note that the motion has to be done long enough to count so a very quick flick of the wrist will not workTurn On muted ndash double-click power buttonNext preset ndash while saber is off click the AUX buttonPrevious preset ndash hold AUX button and click the Activation buttonTrigger Clash ndash while saber is on hit the bladeTrigger Lockup ndash while saber is on hold Activation button then trigger a clash Lockup releases when you let go of the Acti-vation buttonTrigger Drag ndash like lockup but point saber mostly down before holding Activation buttonTrigger Force ndash long-click AUX buttonStart soundtrack ndash long-click the Activation buttonTrigger Blaster Block ndash while saber is on short-click AUX button

Serial Monitor commands

battery_voltage ndash gets current battery voltage valueget_volume ndash get current volume valuepow ndash power OnOff the saberon ndash power On the saberoff ndash power Off the saberset_volume lt0-3000gt ndash set volume value (example set_volume 500)play ndash play the default preset trackplay trackslttrack namegt ndash play a specific track from tracks folder (example play tracksvenuswav)stop ndash stop the playing trackforce ndash play ldquoforcerdquo sound effectsdrag ndash play ldquodragrdquo sound effectsblast ndash play ldquoblasterrdquo sound effectslock ndash play ldquolockuprdquo sound effectsclash ndash play ldquoclashrdquo sound effectsreset ndash reboot the boardn ndash switch to next presetp ndash switch to previous presetlist_presets ndash show all presetssdtest ndash test SD card speed

40 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3FIRMWARE UPLOAD AND UPDATE2

Software installation and setup

PROFFIEBOARD INSTRUCTIONS

To upload firmware to ProffieBoard Arduino IDE program is required Follow these steps to install it to your PC

1 Install latest Arduino IDE software (donrsquot use BETA)

Installing as Windows app also is not recommended

because it will be installed in a specific protected folder that

wonrsquot allow you to install any additional softwareplugin in it

If ProffieBoard wonrsquot show up in COM port use

Arduino IDE 186 version

2 Install the Proffieboard Arduino Plugin and Zadig software

Follow installation instructions

3 Select Proffieboard-STM32L433 in Tools -gt Board

USB Type ndash Serial CPU Speed ndash 80 MHz Optimize ndash Smallest Code DOSFS ndash SDCARD (SPI) Port ndash COM(the number your PC assigned) (Butterfly-L433CC)

Connect Proffieboard via USB cable to PC to be able to select

the Port

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 41

3FIRMWARE UPLOAD AND UPDATE2

Uploading firmware

PROFFIEBOARD INSTRUCTIONS

1 Download the ProffieBoard firmware and SD card content

Unzip lightsaber-1286zip to your Documents directory or to

Desktop but not to Arduino program folder or anywhere in

Programs directory where all programs are installed You will

see a lightsaber folder and files inside it Donrsquot move any of

these files to any other location outside the lightsaber folder

and donrsquot reorganize them Unzip ProffieOS_SD_Cardzip to the

folder where you keep lightsaber-1286 folder Copy all files

from ProffieOS_SD_Card folder to your SD card

2 Unhide file extensions in File Explorer settings to see h ending

of config files Donrsquot add ldquohrdquo to the config file name Go to config folder and create you own configh file (see page

42 for how-to)

Double-click the lightsaberino file

3 Add the name of your configh file as shown and Save this

lightsaberino file Make sure the other config files are

commented out there should be only one CONFIG_FILE

without You can have multiple config files

in lightsabergtconfig folder and just define the one you need

in lightsaberino file and upload it again to ProffieBoard

4 Connect battery to ProffieBoard and hook up to your PC

with a data transfer micro-USB-to-USB cable

Press arrow button it will compile and upload firmware to the

board Wait for red text progress bars to stop at 100

ProffieBoard will play boot sound if speaker is connected

Now you can unplug the USB cable Done

If it gives an error instead this means your configh file has

issues define CONFIG_FILE name has mistakes configh file

is out of config folder your PC user name is non-latin

42 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

33

configh file structure editing

PROFFIEBOARD INSTRUCTIONS

CHANGING PARAMETERS

All sound files (sound fonts music tracks) are stored on the micro SD card Add required sound fonts folders (Plecter NEC and Smoothswing

fonts are supported no need to change WAV files names just copy and paste) to SD card root directory as itrsquos done in the default

ProffieOS_SD_Card content folder and music tracks to the tracks folder

Make sure to name all music tracks and sound fonts folders with latin characters and only up to 8 characters long without using any special

characters (like |[- etc)

Make sure you have a configini file in each sound font folder if there is none - copy one from some default TeensySaberProffieBoard sound

font and paste into newly added sound font folder It has only one parameter that you can modify - humstart It helps to match hum sound

start with blade ignition 1000 usually works fine

All blade effects LED configuration volume level clash sensitivity etc are changed in the configh file located in lightsabergtconfig folder

To do that open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text Editor (Notepad - to see code correctly in Notepad

Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all text) and Delete it then Copy-and-Paste (Ctrl+C

Ctrl+V) your wiring diagram config code into empty _configh file and Save it under new name Follow the instructions on page 39 to

upload it to the board

Proffieboard config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)

volume level (0-3000)

clash sensitivity (adjust lower or higher with 01 step)

sound font folder nametrack name

Preset name

Blade style

LED configuration (use these XP-E2 LED templatesto define your LED)

for Red use 1 Ohm resistor for Green - no resistor for Blue use 024 Ohm

NoLED ndash no 4th led used

Preset 1

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 43

33

Blade Styles

StylePtrltInOutHelperltSimpleClashltLockupltBlastltOnSparkltAudioFlickerltRgblt02550gtRgblt501000gtgtRgblt2552550gt150gtRgblt255500gtgtAudioFlickerltRgblt1002550gtRgblt2550150gtgtgtRgblt255100150gt40gt200300Blackgtgt

ndash this is how the Blade Style code looks pasted in the configh file Preset (it sits inside a StylePtrltgt container)

ndash this is how the Blade Style code looks when editing it inside a Blade Style Editor

Each Blade Style is made of a variety of Effects each added effect goes instead of a base color in the previous effect

PROFFIEBOARD INSTRUCTIONS

CHANGING PARAMETERS

ProffieBoard and TeensySaber use Blade Styles for the main saber blade and any other accent leds to define all light effects (color changing

flashes flickering delays ignitionretraction timing etc)

Use Blade Style Editor to create and adjust Blade Styles Megtooth Sith Sabers did a great video tutorial where he shows and explains

how to use Blade Style Editor Also you can grab some pre-made Blade Styles or share yours here on TRA forums

A Blade Style example of simple flickering Green blade with Spark on start Clash Blaster Lockup and Drag IgnitionRetraction effects

InOutHelperltSimpleClashltLockupltBlastltOnSparkltAudioFlickerltRgblt02550gtRgblt501000gtgtRgblt2552550gt150gtRgblt255500gtgtAudioFlickerltRgblt1002550gtRgblt2550150gtgtgtRgblt255100150gt40gt200300Blackgt

InOutHelperltbase color200300Blackgt ndash base color can be defined by words (WHITE RED GREEN PURPLE etc) or by Rgblt0-2550-2550-255gt values for more

custom shades 200 is extension length in milliseconds 300 is retraction length in milliseconds Black is color when retracted (also can be any other color)

SimpleClashltbase colorclash color40gt ndash clash effect 40 is clash duration in milliseconds

Lockupltbase colorlockup colorgt ndash lockup effect

Blastltbase colorblast colorgt ndash blaster effect

OnSparkltbase colorspark color150gt ndash spark on ignition effect 150 is spark duration in milliseconds

AudioFlickerltrdquoArdquo colorrdquoBrdquo colorgt ndash flickering effect (blade flickers to the actual saber hum sound) the more difference between ldquoArdquo and ldquoBrdquo colors - the more

abrupt is flickering

Rgblt255500gt ndash actual color in RGB format (0 is no light 255 is the maximum brightness value for Red Green or Blue channel)

44 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

ndash SanDisk 4GB microSDHC Class 4 (Genuine) ndash SanDisk 4GB microSDHC Class 4 (Genuine)

130238 kbs = 1477 simultaneous audio streams 137812 kbs = 1562 simultaneous audio streams

ndash Patriot LX Series 16GB microSDHC UHS-IU1 Class 10 ndash Patriot LX Series 16GB microSDHC UHS-IU1 Class 10

133005 kbs = 1508 simultaneous audio streams

ndash GSkill 16GB microSDHC UHS-IU1 Class 10 ndash GSkill 16GB microSDHC UHS-IU1 Class 10

129534 kbs = 1469 simultaneous audio streams

ndash Kingston 16GB microSDHC UHS-IU1 Class 10 ndash Kingston 16GB microSDHC UHS-IU1 Class 10

128090 kbs = 1452 simultaneous audio streams

ndash SanDisk Ultra 16GB microSDHC UHS-IU1 A1 Class 10 ndash SanDisk Ultra 16GB microSDHC UHS-IU1 A1 Class 10

102663 kbs = 1164 simultaneous audio streams 11124 kbs = 1261 simultaneous audio streams

ndash SanDisk 8GB microSDHC Class 4 ndash SanDisk 8GB microSDHC Class 4

108506 kbs = 1230 simultaneous audio streams

ndash SanDisk 16GB microSDHC Class 4 ndash SanDisk 16GB microSDHC Class 4

102663 kbs = 1164 simultaneous audio streams 106957 kbs = 1213 simultaneous audio streams

ndash SanDisk Ultra 16GB microSDHC UHS-IU1 Class 10 ndash SanDisk Ultra 16GB microSDHC UHS-IU1 Class 10

102663 kbs = 1164 simultaneous audio streams 103909 kbs = 1178 simultaneous audio streams

ndash Smartbuy 4GB microSDHC Class 4 ndash Smartbuy 4GB microSDHC Class 4

75437 kbs = 855 simultaneous audio streams

ndash Kingston 8GB microSDHC Class 4 ndash Kingston 8GB microSDHC Class 4

75209 kbs = 822 simultaneous audio streams

ndash SanDisk 4GB microSDHC Class 4 (Fake) ndash SanDisk 4GB microSDHC Class 4 (Fake)

677 kbs = 769 simultaneous audio streams

Here is a list of tested micro SD cards speed with TeensySaber V3 and ProffieBoard Any card with speed over 900 kbs is recommended the

higher the speed is ndash the better Memory size of 4-16Gb is more than enough Cards were tested with a default firmware (1291) compiled

with ldquoSmallest Coderdquo under Optimize ldquodefault_proffieboard_confighrdquo file and default ProffieOS SD card sound files (7 folders)

To test your SD card speed simply hook up ProffieBoard to PC open Arduino IDE go to Tools and open Serial Monitor make sure you have

New Line and 9600 baud rate selected on the bottom of Serial Monitor window type and send sdtest command wait for the test result

4Recommended micro SD cards

BEST

TEENSYSABER PROFFIEBOARD

GOOD

BAD

PROFFIEBOARD INSTRUCTIONS

SD CARD RECOMMENDATIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 45

There are a lot of fake (chinese copies) microSD cards on the market from aliexpress ebay amazon etc They look very similar to genuine

cards but are a bit different though and have a twice lower writingreading speed Here is an example of a SanDisk 4Gb Class 4 card one is

genuine with 137812 kbs speed and the other one is fake with 677 kbs speed I got from ebay seller

Be carefull and pay attention to how the actual card looks if you are not sure ask seller for the real photo of SD card he sells

4Genuine and Fake SanDisk 4Gb Class 4 microSD

PROFFIEBOARD INSTRUCTIONS

SD CARD RECOMMENDATIONS

46 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

WIRE GAUGE GUIDE

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 47

RECHARGE PORTS AND KILL SWITCHES

48 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

NEOPIXEL STRIPS CURRENT DRAW

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 49

6TROUBLESHOOTING

For more help please check these linksProffieOSProffieBoardTeensySaber wiki on GitHubAsk your question on The Rebel Armory forumsAsk your question on FX-sabers forumsAsk your question in facebook group

How to solve most common issues

Quick troubleshooting tips

TeensySaber board or Proffieboard is not recognized by computer (nothing under Port selection in Arduino)

ndash Make sure a charged 37V battery is connected to the board micro-USB cable is a data transfer cable all plugins and drivers are installed ndash

check again pages 21 for TeensySaber or 40 for Proffieboard Try a different USB port on your computer

Sketch (code) compile error in Arduino IDE

ndash Check your define CONFIG_FILE ldquoconfig_confighrdquo line in opened lightsaberino file if itrsquos written correctly with config in it

Sketch (code) compile error in Arduino IDE

ndash Check if the _configh file you defined in the lightsaberino sketch file is same name as in the lightsaber-rdquofirmware versionrdquolightsaber

config folder and is located in this folder

Sketch (code) compile error in Arduino IDE

ndash Check your settings under Tools tab in Arduino IDE program Check again pages 21 for TeensySaber or 40 for Proffieboard

Sketch (code) compile error in Arduino IDE

ndash Check if your _configh file is correct Blade Styles Presets const unsigned int maxLedsPerStrip = 144 if BladeConfig blades[] = is correct

Sketch (code) compile error in Arduino IDE

ndash If nothing helps install Arduino IDE version 186 and try to compile and upload the firmware again

Sound doesnrsquot play

ndash Remove SD card and insert again check speaker wiring Make sure all sound files on SD card are correctly named (8 characters max long)

Re-format SD card in FAT32 load sound files and try again try another SD card

Board says ldquoLOW POWERrdquo

ndash Charge the battery

Serial Monitor shows info sent by the board but your commands donrsquot work

ndash In the bottom right corner of Serial Monitor window make sure the Line Ending drop down is set to New Line

Sound is weird and distorted

ndash Check your SD card speed (see page 44) Check speaker wiring try another good speaker

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 37

3WIRING DIAGRAMS1

Blade ID resistor functions(optional)

SOON

PROFFIEBOARD INSTRUCTIONS

38 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

website ProffieBoard FULL wiring diagrams link

Scroll the page down till you see the interactive diagram Above the diagram there are components selection options Build your saber setup

with it and follow diagram to wire your board Then you need to copy the configuration code below and paste it into your _configh file

Choose components you want

3WIRING DIAGRAMS1

More wiring diagrams

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 39

3WIRING DIAGRAMS1

How to use it

PROFFIEBOARD INSTRUCTIONS

Blade ignitionretraction ndash assuming you have at least one button pressing it briefly should turn the saber on or off If you have an AUX button pressing it briefly should also turn the saber on and off If you have no buttons you can turn the saber on and off by twisting your wrist back and forth Note that the motion has to be done long enough to count so a very quick flick of the wrist will not workTurn On muted ndash double-click power buttonNext preset ndash while saber is off click the AUX buttonPrevious preset ndash hold AUX button and click the Activation buttonTrigger Clash ndash while saber is on hit the bladeTrigger Lockup ndash while saber is on hold Activation button then trigger a clash Lockup releases when you let go of the Acti-vation buttonTrigger Drag ndash like lockup but point saber mostly down before holding Activation buttonTrigger Force ndash long-click AUX buttonStart soundtrack ndash long-click the Activation buttonTrigger Blaster Block ndash while saber is on short-click AUX button

Serial Monitor commands

battery_voltage ndash gets current battery voltage valueget_volume ndash get current volume valuepow ndash power OnOff the saberon ndash power On the saberoff ndash power Off the saberset_volume lt0-3000gt ndash set volume value (example set_volume 500)play ndash play the default preset trackplay trackslttrack namegt ndash play a specific track from tracks folder (example play tracksvenuswav)stop ndash stop the playing trackforce ndash play ldquoforcerdquo sound effectsdrag ndash play ldquodragrdquo sound effectsblast ndash play ldquoblasterrdquo sound effectslock ndash play ldquolockuprdquo sound effectsclash ndash play ldquoclashrdquo sound effectsreset ndash reboot the boardn ndash switch to next presetp ndash switch to previous presetlist_presets ndash show all presetssdtest ndash test SD card speed

40 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3FIRMWARE UPLOAD AND UPDATE2

Software installation and setup

PROFFIEBOARD INSTRUCTIONS

To upload firmware to ProffieBoard Arduino IDE program is required Follow these steps to install it to your PC

1 Install latest Arduino IDE software (donrsquot use BETA)

Installing as Windows app also is not recommended

because it will be installed in a specific protected folder that

wonrsquot allow you to install any additional softwareplugin in it

If ProffieBoard wonrsquot show up in COM port use

Arduino IDE 186 version

2 Install the Proffieboard Arduino Plugin and Zadig software

Follow installation instructions

3 Select Proffieboard-STM32L433 in Tools -gt Board

USB Type ndash Serial CPU Speed ndash 80 MHz Optimize ndash Smallest Code DOSFS ndash SDCARD (SPI) Port ndash COM(the number your PC assigned) (Butterfly-L433CC)

Connect Proffieboard via USB cable to PC to be able to select

the Port

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 41

3FIRMWARE UPLOAD AND UPDATE2

Uploading firmware

PROFFIEBOARD INSTRUCTIONS

1 Download the ProffieBoard firmware and SD card content

Unzip lightsaber-1286zip to your Documents directory or to

Desktop but not to Arduino program folder or anywhere in

Programs directory where all programs are installed You will

see a lightsaber folder and files inside it Donrsquot move any of

these files to any other location outside the lightsaber folder

and donrsquot reorganize them Unzip ProffieOS_SD_Cardzip to the

folder where you keep lightsaber-1286 folder Copy all files

from ProffieOS_SD_Card folder to your SD card

2 Unhide file extensions in File Explorer settings to see h ending

of config files Donrsquot add ldquohrdquo to the config file name Go to config folder and create you own configh file (see page

42 for how-to)

Double-click the lightsaberino file

3 Add the name of your configh file as shown and Save this

lightsaberino file Make sure the other config files are

commented out there should be only one CONFIG_FILE

without You can have multiple config files

in lightsabergtconfig folder and just define the one you need

in lightsaberino file and upload it again to ProffieBoard

4 Connect battery to ProffieBoard and hook up to your PC

with a data transfer micro-USB-to-USB cable

Press arrow button it will compile and upload firmware to the

board Wait for red text progress bars to stop at 100

ProffieBoard will play boot sound if speaker is connected

Now you can unplug the USB cable Done

If it gives an error instead this means your configh file has

issues define CONFIG_FILE name has mistakes configh file

is out of config folder your PC user name is non-latin

42 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

33

configh file structure editing

PROFFIEBOARD INSTRUCTIONS

CHANGING PARAMETERS

All sound files (sound fonts music tracks) are stored on the micro SD card Add required sound fonts folders (Plecter NEC and Smoothswing

fonts are supported no need to change WAV files names just copy and paste) to SD card root directory as itrsquos done in the default

ProffieOS_SD_Card content folder and music tracks to the tracks folder

Make sure to name all music tracks and sound fonts folders with latin characters and only up to 8 characters long without using any special

characters (like |[- etc)

Make sure you have a configini file in each sound font folder if there is none - copy one from some default TeensySaberProffieBoard sound

font and paste into newly added sound font folder It has only one parameter that you can modify - humstart It helps to match hum sound

start with blade ignition 1000 usually works fine

All blade effects LED configuration volume level clash sensitivity etc are changed in the configh file located in lightsabergtconfig folder

To do that open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text Editor (Notepad - to see code correctly in Notepad

Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all text) and Delete it then Copy-and-Paste (Ctrl+C

Ctrl+V) your wiring diagram config code into empty _configh file and Save it under new name Follow the instructions on page 39 to

upload it to the board

Proffieboard config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)

volume level (0-3000)

clash sensitivity (adjust lower or higher with 01 step)

sound font folder nametrack name

Preset name

Blade style

LED configuration (use these XP-E2 LED templatesto define your LED)

for Red use 1 Ohm resistor for Green - no resistor for Blue use 024 Ohm

NoLED ndash no 4th led used

Preset 1

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 43

33

Blade Styles

StylePtrltInOutHelperltSimpleClashltLockupltBlastltOnSparkltAudioFlickerltRgblt02550gtRgblt501000gtgtRgblt2552550gt150gtRgblt255500gtgtAudioFlickerltRgblt1002550gtRgblt2550150gtgtgtRgblt255100150gt40gt200300Blackgtgt

ndash this is how the Blade Style code looks pasted in the configh file Preset (it sits inside a StylePtrltgt container)

ndash this is how the Blade Style code looks when editing it inside a Blade Style Editor

Each Blade Style is made of a variety of Effects each added effect goes instead of a base color in the previous effect

PROFFIEBOARD INSTRUCTIONS

CHANGING PARAMETERS

ProffieBoard and TeensySaber use Blade Styles for the main saber blade and any other accent leds to define all light effects (color changing

flashes flickering delays ignitionretraction timing etc)

Use Blade Style Editor to create and adjust Blade Styles Megtooth Sith Sabers did a great video tutorial where he shows and explains

how to use Blade Style Editor Also you can grab some pre-made Blade Styles or share yours here on TRA forums

A Blade Style example of simple flickering Green blade with Spark on start Clash Blaster Lockup and Drag IgnitionRetraction effects

InOutHelperltSimpleClashltLockupltBlastltOnSparkltAudioFlickerltRgblt02550gtRgblt501000gtgtRgblt2552550gt150gtRgblt255500gtgtAudioFlickerltRgblt1002550gtRgblt2550150gtgtgtRgblt255100150gt40gt200300Blackgt

InOutHelperltbase color200300Blackgt ndash base color can be defined by words (WHITE RED GREEN PURPLE etc) or by Rgblt0-2550-2550-255gt values for more

custom shades 200 is extension length in milliseconds 300 is retraction length in milliseconds Black is color when retracted (also can be any other color)

SimpleClashltbase colorclash color40gt ndash clash effect 40 is clash duration in milliseconds

Lockupltbase colorlockup colorgt ndash lockup effect

Blastltbase colorblast colorgt ndash blaster effect

OnSparkltbase colorspark color150gt ndash spark on ignition effect 150 is spark duration in milliseconds

AudioFlickerltrdquoArdquo colorrdquoBrdquo colorgt ndash flickering effect (blade flickers to the actual saber hum sound) the more difference between ldquoArdquo and ldquoBrdquo colors - the more

abrupt is flickering

Rgblt255500gt ndash actual color in RGB format (0 is no light 255 is the maximum brightness value for Red Green or Blue channel)

44 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

ndash SanDisk 4GB microSDHC Class 4 (Genuine) ndash SanDisk 4GB microSDHC Class 4 (Genuine)

130238 kbs = 1477 simultaneous audio streams 137812 kbs = 1562 simultaneous audio streams

ndash Patriot LX Series 16GB microSDHC UHS-IU1 Class 10 ndash Patriot LX Series 16GB microSDHC UHS-IU1 Class 10

133005 kbs = 1508 simultaneous audio streams

ndash GSkill 16GB microSDHC UHS-IU1 Class 10 ndash GSkill 16GB microSDHC UHS-IU1 Class 10

129534 kbs = 1469 simultaneous audio streams

ndash Kingston 16GB microSDHC UHS-IU1 Class 10 ndash Kingston 16GB microSDHC UHS-IU1 Class 10

128090 kbs = 1452 simultaneous audio streams

ndash SanDisk Ultra 16GB microSDHC UHS-IU1 A1 Class 10 ndash SanDisk Ultra 16GB microSDHC UHS-IU1 A1 Class 10

102663 kbs = 1164 simultaneous audio streams 11124 kbs = 1261 simultaneous audio streams

ndash SanDisk 8GB microSDHC Class 4 ndash SanDisk 8GB microSDHC Class 4

108506 kbs = 1230 simultaneous audio streams

ndash SanDisk 16GB microSDHC Class 4 ndash SanDisk 16GB microSDHC Class 4

102663 kbs = 1164 simultaneous audio streams 106957 kbs = 1213 simultaneous audio streams

ndash SanDisk Ultra 16GB microSDHC UHS-IU1 Class 10 ndash SanDisk Ultra 16GB microSDHC UHS-IU1 Class 10

102663 kbs = 1164 simultaneous audio streams 103909 kbs = 1178 simultaneous audio streams

ndash Smartbuy 4GB microSDHC Class 4 ndash Smartbuy 4GB microSDHC Class 4

75437 kbs = 855 simultaneous audio streams

ndash Kingston 8GB microSDHC Class 4 ndash Kingston 8GB microSDHC Class 4

75209 kbs = 822 simultaneous audio streams

ndash SanDisk 4GB microSDHC Class 4 (Fake) ndash SanDisk 4GB microSDHC Class 4 (Fake)

677 kbs = 769 simultaneous audio streams

Here is a list of tested micro SD cards speed with TeensySaber V3 and ProffieBoard Any card with speed over 900 kbs is recommended the

higher the speed is ndash the better Memory size of 4-16Gb is more than enough Cards were tested with a default firmware (1291) compiled

with ldquoSmallest Coderdquo under Optimize ldquodefault_proffieboard_confighrdquo file and default ProffieOS SD card sound files (7 folders)

To test your SD card speed simply hook up ProffieBoard to PC open Arduino IDE go to Tools and open Serial Monitor make sure you have

New Line and 9600 baud rate selected on the bottom of Serial Monitor window type and send sdtest command wait for the test result

4Recommended micro SD cards

BEST

TEENSYSABER PROFFIEBOARD

GOOD

BAD

PROFFIEBOARD INSTRUCTIONS

SD CARD RECOMMENDATIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 45

There are a lot of fake (chinese copies) microSD cards on the market from aliexpress ebay amazon etc They look very similar to genuine

cards but are a bit different though and have a twice lower writingreading speed Here is an example of a SanDisk 4Gb Class 4 card one is

genuine with 137812 kbs speed and the other one is fake with 677 kbs speed I got from ebay seller

Be carefull and pay attention to how the actual card looks if you are not sure ask seller for the real photo of SD card he sells

4Genuine and Fake SanDisk 4Gb Class 4 microSD

PROFFIEBOARD INSTRUCTIONS

SD CARD RECOMMENDATIONS

46 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

WIRE GAUGE GUIDE

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 47

RECHARGE PORTS AND KILL SWITCHES

48 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

NEOPIXEL STRIPS CURRENT DRAW

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 49

6TROUBLESHOOTING

For more help please check these linksProffieOSProffieBoardTeensySaber wiki on GitHubAsk your question on The Rebel Armory forumsAsk your question on FX-sabers forumsAsk your question in facebook group

How to solve most common issues

Quick troubleshooting tips

TeensySaber board or Proffieboard is not recognized by computer (nothing under Port selection in Arduino)

ndash Make sure a charged 37V battery is connected to the board micro-USB cable is a data transfer cable all plugins and drivers are installed ndash

check again pages 21 for TeensySaber or 40 for Proffieboard Try a different USB port on your computer

Sketch (code) compile error in Arduino IDE

ndash Check your define CONFIG_FILE ldquoconfig_confighrdquo line in opened lightsaberino file if itrsquos written correctly with config in it

Sketch (code) compile error in Arduino IDE

ndash Check if the _configh file you defined in the lightsaberino sketch file is same name as in the lightsaber-rdquofirmware versionrdquolightsaber

config folder and is located in this folder

Sketch (code) compile error in Arduino IDE

ndash Check your settings under Tools tab in Arduino IDE program Check again pages 21 for TeensySaber or 40 for Proffieboard

Sketch (code) compile error in Arduino IDE

ndash Check if your _configh file is correct Blade Styles Presets const unsigned int maxLedsPerStrip = 144 if BladeConfig blades[] = is correct

Sketch (code) compile error in Arduino IDE

ndash If nothing helps install Arduino IDE version 186 and try to compile and upload the firmware again

Sound doesnrsquot play

ndash Remove SD card and insert again check speaker wiring Make sure all sound files on SD card are correctly named (8 characters max long)

Re-format SD card in FAT32 load sound files and try again try another SD card

Board says ldquoLOW POWERrdquo

ndash Charge the battery

Serial Monitor shows info sent by the board but your commands donrsquot work

ndash In the bottom right corner of Serial Monitor window make sure the Line Ending drop down is set to New Line

Sound is weird and distorted

ndash Check your SD card speed (see page 44) Check speaker wiring try another good speaker

38 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

website ProffieBoard FULL wiring diagrams link

Scroll the page down till you see the interactive diagram Above the diagram there are components selection options Build your saber setup

with it and follow diagram to wire your board Then you need to copy the configuration code below and paste it into your _configh file

Choose components you want

3WIRING DIAGRAMS1

More wiring diagrams

PROFFIEBOARD INSTRUCTIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 39

3WIRING DIAGRAMS1

How to use it

PROFFIEBOARD INSTRUCTIONS

Blade ignitionretraction ndash assuming you have at least one button pressing it briefly should turn the saber on or off If you have an AUX button pressing it briefly should also turn the saber on and off If you have no buttons you can turn the saber on and off by twisting your wrist back and forth Note that the motion has to be done long enough to count so a very quick flick of the wrist will not workTurn On muted ndash double-click power buttonNext preset ndash while saber is off click the AUX buttonPrevious preset ndash hold AUX button and click the Activation buttonTrigger Clash ndash while saber is on hit the bladeTrigger Lockup ndash while saber is on hold Activation button then trigger a clash Lockup releases when you let go of the Acti-vation buttonTrigger Drag ndash like lockup but point saber mostly down before holding Activation buttonTrigger Force ndash long-click AUX buttonStart soundtrack ndash long-click the Activation buttonTrigger Blaster Block ndash while saber is on short-click AUX button

Serial Monitor commands

battery_voltage ndash gets current battery voltage valueget_volume ndash get current volume valuepow ndash power OnOff the saberon ndash power On the saberoff ndash power Off the saberset_volume lt0-3000gt ndash set volume value (example set_volume 500)play ndash play the default preset trackplay trackslttrack namegt ndash play a specific track from tracks folder (example play tracksvenuswav)stop ndash stop the playing trackforce ndash play ldquoforcerdquo sound effectsdrag ndash play ldquodragrdquo sound effectsblast ndash play ldquoblasterrdquo sound effectslock ndash play ldquolockuprdquo sound effectsclash ndash play ldquoclashrdquo sound effectsreset ndash reboot the boardn ndash switch to next presetp ndash switch to previous presetlist_presets ndash show all presetssdtest ndash test SD card speed

40 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3FIRMWARE UPLOAD AND UPDATE2

Software installation and setup

PROFFIEBOARD INSTRUCTIONS

To upload firmware to ProffieBoard Arduino IDE program is required Follow these steps to install it to your PC

1 Install latest Arduino IDE software (donrsquot use BETA)

Installing as Windows app also is not recommended

because it will be installed in a specific protected folder that

wonrsquot allow you to install any additional softwareplugin in it

If ProffieBoard wonrsquot show up in COM port use

Arduino IDE 186 version

2 Install the Proffieboard Arduino Plugin and Zadig software

Follow installation instructions

3 Select Proffieboard-STM32L433 in Tools -gt Board

USB Type ndash Serial CPU Speed ndash 80 MHz Optimize ndash Smallest Code DOSFS ndash SDCARD (SPI) Port ndash COM(the number your PC assigned) (Butterfly-L433CC)

Connect Proffieboard via USB cable to PC to be able to select

the Port

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 41

3FIRMWARE UPLOAD AND UPDATE2

Uploading firmware

PROFFIEBOARD INSTRUCTIONS

1 Download the ProffieBoard firmware and SD card content

Unzip lightsaber-1286zip to your Documents directory or to

Desktop but not to Arduino program folder or anywhere in

Programs directory where all programs are installed You will

see a lightsaber folder and files inside it Donrsquot move any of

these files to any other location outside the lightsaber folder

and donrsquot reorganize them Unzip ProffieOS_SD_Cardzip to the

folder where you keep lightsaber-1286 folder Copy all files

from ProffieOS_SD_Card folder to your SD card

2 Unhide file extensions in File Explorer settings to see h ending

of config files Donrsquot add ldquohrdquo to the config file name Go to config folder and create you own configh file (see page

42 for how-to)

Double-click the lightsaberino file

3 Add the name of your configh file as shown and Save this

lightsaberino file Make sure the other config files are

commented out there should be only one CONFIG_FILE

without You can have multiple config files

in lightsabergtconfig folder and just define the one you need

in lightsaberino file and upload it again to ProffieBoard

4 Connect battery to ProffieBoard and hook up to your PC

with a data transfer micro-USB-to-USB cable

Press arrow button it will compile and upload firmware to the

board Wait for red text progress bars to stop at 100

ProffieBoard will play boot sound if speaker is connected

Now you can unplug the USB cable Done

If it gives an error instead this means your configh file has

issues define CONFIG_FILE name has mistakes configh file

is out of config folder your PC user name is non-latin

42 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

33

configh file structure editing

PROFFIEBOARD INSTRUCTIONS

CHANGING PARAMETERS

All sound files (sound fonts music tracks) are stored on the micro SD card Add required sound fonts folders (Plecter NEC and Smoothswing

fonts are supported no need to change WAV files names just copy and paste) to SD card root directory as itrsquos done in the default

ProffieOS_SD_Card content folder and music tracks to the tracks folder

Make sure to name all music tracks and sound fonts folders with latin characters and only up to 8 characters long without using any special

characters (like |[- etc)

Make sure you have a configini file in each sound font folder if there is none - copy one from some default TeensySaberProffieBoard sound

font and paste into newly added sound font folder It has only one parameter that you can modify - humstart It helps to match hum sound

start with blade ignition 1000 usually works fine

All blade effects LED configuration volume level clash sensitivity etc are changed in the configh file located in lightsabergtconfig folder

To do that open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text Editor (Notepad - to see code correctly in Notepad

Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all text) and Delete it then Copy-and-Paste (Ctrl+C

Ctrl+V) your wiring diagram config code into empty _configh file and Save it under new name Follow the instructions on page 39 to

upload it to the board

Proffieboard config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)

volume level (0-3000)

clash sensitivity (adjust lower or higher with 01 step)

sound font folder nametrack name

Preset name

Blade style

LED configuration (use these XP-E2 LED templatesto define your LED)

for Red use 1 Ohm resistor for Green - no resistor for Blue use 024 Ohm

NoLED ndash no 4th led used

Preset 1

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 43

33

Blade Styles

StylePtrltInOutHelperltSimpleClashltLockupltBlastltOnSparkltAudioFlickerltRgblt02550gtRgblt501000gtgtRgblt2552550gt150gtRgblt255500gtgtAudioFlickerltRgblt1002550gtRgblt2550150gtgtgtRgblt255100150gt40gt200300Blackgtgt

ndash this is how the Blade Style code looks pasted in the configh file Preset (it sits inside a StylePtrltgt container)

ndash this is how the Blade Style code looks when editing it inside a Blade Style Editor

Each Blade Style is made of a variety of Effects each added effect goes instead of a base color in the previous effect

PROFFIEBOARD INSTRUCTIONS

CHANGING PARAMETERS

ProffieBoard and TeensySaber use Blade Styles for the main saber blade and any other accent leds to define all light effects (color changing

flashes flickering delays ignitionretraction timing etc)

Use Blade Style Editor to create and adjust Blade Styles Megtooth Sith Sabers did a great video tutorial where he shows and explains

how to use Blade Style Editor Also you can grab some pre-made Blade Styles or share yours here on TRA forums

A Blade Style example of simple flickering Green blade with Spark on start Clash Blaster Lockup and Drag IgnitionRetraction effects

InOutHelperltSimpleClashltLockupltBlastltOnSparkltAudioFlickerltRgblt02550gtRgblt501000gtgtRgblt2552550gt150gtRgblt255500gtgtAudioFlickerltRgblt1002550gtRgblt2550150gtgtgtRgblt255100150gt40gt200300Blackgt

InOutHelperltbase color200300Blackgt ndash base color can be defined by words (WHITE RED GREEN PURPLE etc) or by Rgblt0-2550-2550-255gt values for more

custom shades 200 is extension length in milliseconds 300 is retraction length in milliseconds Black is color when retracted (also can be any other color)

SimpleClashltbase colorclash color40gt ndash clash effect 40 is clash duration in milliseconds

Lockupltbase colorlockup colorgt ndash lockup effect

Blastltbase colorblast colorgt ndash blaster effect

OnSparkltbase colorspark color150gt ndash spark on ignition effect 150 is spark duration in milliseconds

AudioFlickerltrdquoArdquo colorrdquoBrdquo colorgt ndash flickering effect (blade flickers to the actual saber hum sound) the more difference between ldquoArdquo and ldquoBrdquo colors - the more

abrupt is flickering

Rgblt255500gt ndash actual color in RGB format (0 is no light 255 is the maximum brightness value for Red Green or Blue channel)

44 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

ndash SanDisk 4GB microSDHC Class 4 (Genuine) ndash SanDisk 4GB microSDHC Class 4 (Genuine)

130238 kbs = 1477 simultaneous audio streams 137812 kbs = 1562 simultaneous audio streams

ndash Patriot LX Series 16GB microSDHC UHS-IU1 Class 10 ndash Patriot LX Series 16GB microSDHC UHS-IU1 Class 10

133005 kbs = 1508 simultaneous audio streams

ndash GSkill 16GB microSDHC UHS-IU1 Class 10 ndash GSkill 16GB microSDHC UHS-IU1 Class 10

129534 kbs = 1469 simultaneous audio streams

ndash Kingston 16GB microSDHC UHS-IU1 Class 10 ndash Kingston 16GB microSDHC UHS-IU1 Class 10

128090 kbs = 1452 simultaneous audio streams

ndash SanDisk Ultra 16GB microSDHC UHS-IU1 A1 Class 10 ndash SanDisk Ultra 16GB microSDHC UHS-IU1 A1 Class 10

102663 kbs = 1164 simultaneous audio streams 11124 kbs = 1261 simultaneous audio streams

ndash SanDisk 8GB microSDHC Class 4 ndash SanDisk 8GB microSDHC Class 4

108506 kbs = 1230 simultaneous audio streams

ndash SanDisk 16GB microSDHC Class 4 ndash SanDisk 16GB microSDHC Class 4

102663 kbs = 1164 simultaneous audio streams 106957 kbs = 1213 simultaneous audio streams

ndash SanDisk Ultra 16GB microSDHC UHS-IU1 Class 10 ndash SanDisk Ultra 16GB microSDHC UHS-IU1 Class 10

102663 kbs = 1164 simultaneous audio streams 103909 kbs = 1178 simultaneous audio streams

ndash Smartbuy 4GB microSDHC Class 4 ndash Smartbuy 4GB microSDHC Class 4

75437 kbs = 855 simultaneous audio streams

ndash Kingston 8GB microSDHC Class 4 ndash Kingston 8GB microSDHC Class 4

75209 kbs = 822 simultaneous audio streams

ndash SanDisk 4GB microSDHC Class 4 (Fake) ndash SanDisk 4GB microSDHC Class 4 (Fake)

677 kbs = 769 simultaneous audio streams

Here is a list of tested micro SD cards speed with TeensySaber V3 and ProffieBoard Any card with speed over 900 kbs is recommended the

higher the speed is ndash the better Memory size of 4-16Gb is more than enough Cards were tested with a default firmware (1291) compiled

with ldquoSmallest Coderdquo under Optimize ldquodefault_proffieboard_confighrdquo file and default ProffieOS SD card sound files (7 folders)

To test your SD card speed simply hook up ProffieBoard to PC open Arduino IDE go to Tools and open Serial Monitor make sure you have

New Line and 9600 baud rate selected on the bottom of Serial Monitor window type and send sdtest command wait for the test result

4Recommended micro SD cards

BEST

TEENSYSABER PROFFIEBOARD

GOOD

BAD

PROFFIEBOARD INSTRUCTIONS

SD CARD RECOMMENDATIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 45

There are a lot of fake (chinese copies) microSD cards on the market from aliexpress ebay amazon etc They look very similar to genuine

cards but are a bit different though and have a twice lower writingreading speed Here is an example of a SanDisk 4Gb Class 4 card one is

genuine with 137812 kbs speed and the other one is fake with 677 kbs speed I got from ebay seller

Be carefull and pay attention to how the actual card looks if you are not sure ask seller for the real photo of SD card he sells

4Genuine and Fake SanDisk 4Gb Class 4 microSD

PROFFIEBOARD INSTRUCTIONS

SD CARD RECOMMENDATIONS

46 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

WIRE GAUGE GUIDE

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 47

RECHARGE PORTS AND KILL SWITCHES

48 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

NEOPIXEL STRIPS CURRENT DRAW

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 49

6TROUBLESHOOTING

For more help please check these linksProffieOSProffieBoardTeensySaber wiki on GitHubAsk your question on The Rebel Armory forumsAsk your question on FX-sabers forumsAsk your question in facebook group

How to solve most common issues

Quick troubleshooting tips

TeensySaber board or Proffieboard is not recognized by computer (nothing under Port selection in Arduino)

ndash Make sure a charged 37V battery is connected to the board micro-USB cable is a data transfer cable all plugins and drivers are installed ndash

check again pages 21 for TeensySaber or 40 for Proffieboard Try a different USB port on your computer

Sketch (code) compile error in Arduino IDE

ndash Check your define CONFIG_FILE ldquoconfig_confighrdquo line in opened lightsaberino file if itrsquos written correctly with config in it

Sketch (code) compile error in Arduino IDE

ndash Check if the _configh file you defined in the lightsaberino sketch file is same name as in the lightsaber-rdquofirmware versionrdquolightsaber

config folder and is located in this folder

Sketch (code) compile error in Arduino IDE

ndash Check your settings under Tools tab in Arduino IDE program Check again pages 21 for TeensySaber or 40 for Proffieboard

Sketch (code) compile error in Arduino IDE

ndash Check if your _configh file is correct Blade Styles Presets const unsigned int maxLedsPerStrip = 144 if BladeConfig blades[] = is correct

Sketch (code) compile error in Arduino IDE

ndash If nothing helps install Arduino IDE version 186 and try to compile and upload the firmware again

Sound doesnrsquot play

ndash Remove SD card and insert again check speaker wiring Make sure all sound files on SD card are correctly named (8 characters max long)

Re-format SD card in FAT32 load sound files and try again try another SD card

Board says ldquoLOW POWERrdquo

ndash Charge the battery

Serial Monitor shows info sent by the board but your commands donrsquot work

ndash In the bottom right corner of Serial Monitor window make sure the Line Ending drop down is set to New Line

Sound is weird and distorted

ndash Check your SD card speed (see page 44) Check speaker wiring try another good speaker

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 39

3WIRING DIAGRAMS1

How to use it

PROFFIEBOARD INSTRUCTIONS

Blade ignitionretraction ndash assuming you have at least one button pressing it briefly should turn the saber on or off If you have an AUX button pressing it briefly should also turn the saber on and off If you have no buttons you can turn the saber on and off by twisting your wrist back and forth Note that the motion has to be done long enough to count so a very quick flick of the wrist will not workTurn On muted ndash double-click power buttonNext preset ndash while saber is off click the AUX buttonPrevious preset ndash hold AUX button and click the Activation buttonTrigger Clash ndash while saber is on hit the bladeTrigger Lockup ndash while saber is on hold Activation button then trigger a clash Lockup releases when you let go of the Acti-vation buttonTrigger Drag ndash like lockup but point saber mostly down before holding Activation buttonTrigger Force ndash long-click AUX buttonStart soundtrack ndash long-click the Activation buttonTrigger Blaster Block ndash while saber is on short-click AUX button

Serial Monitor commands

battery_voltage ndash gets current battery voltage valueget_volume ndash get current volume valuepow ndash power OnOff the saberon ndash power On the saberoff ndash power Off the saberset_volume lt0-3000gt ndash set volume value (example set_volume 500)play ndash play the default preset trackplay trackslttrack namegt ndash play a specific track from tracks folder (example play tracksvenuswav)stop ndash stop the playing trackforce ndash play ldquoforcerdquo sound effectsdrag ndash play ldquodragrdquo sound effectsblast ndash play ldquoblasterrdquo sound effectslock ndash play ldquolockuprdquo sound effectsclash ndash play ldquoclashrdquo sound effectsreset ndash reboot the boardn ndash switch to next presetp ndash switch to previous presetlist_presets ndash show all presetssdtest ndash test SD card speed

40 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3FIRMWARE UPLOAD AND UPDATE2

Software installation and setup

PROFFIEBOARD INSTRUCTIONS

To upload firmware to ProffieBoard Arduino IDE program is required Follow these steps to install it to your PC

1 Install latest Arduino IDE software (donrsquot use BETA)

Installing as Windows app also is not recommended

because it will be installed in a specific protected folder that

wonrsquot allow you to install any additional softwareplugin in it

If ProffieBoard wonrsquot show up in COM port use

Arduino IDE 186 version

2 Install the Proffieboard Arduino Plugin and Zadig software

Follow installation instructions

3 Select Proffieboard-STM32L433 in Tools -gt Board

USB Type ndash Serial CPU Speed ndash 80 MHz Optimize ndash Smallest Code DOSFS ndash SDCARD (SPI) Port ndash COM(the number your PC assigned) (Butterfly-L433CC)

Connect Proffieboard via USB cable to PC to be able to select

the Port

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 41

3FIRMWARE UPLOAD AND UPDATE2

Uploading firmware

PROFFIEBOARD INSTRUCTIONS

1 Download the ProffieBoard firmware and SD card content

Unzip lightsaber-1286zip to your Documents directory or to

Desktop but not to Arduino program folder or anywhere in

Programs directory where all programs are installed You will

see a lightsaber folder and files inside it Donrsquot move any of

these files to any other location outside the lightsaber folder

and donrsquot reorganize them Unzip ProffieOS_SD_Cardzip to the

folder where you keep lightsaber-1286 folder Copy all files

from ProffieOS_SD_Card folder to your SD card

2 Unhide file extensions in File Explorer settings to see h ending

of config files Donrsquot add ldquohrdquo to the config file name Go to config folder and create you own configh file (see page

42 for how-to)

Double-click the lightsaberino file

3 Add the name of your configh file as shown and Save this

lightsaberino file Make sure the other config files are

commented out there should be only one CONFIG_FILE

without You can have multiple config files

in lightsabergtconfig folder and just define the one you need

in lightsaberino file and upload it again to ProffieBoard

4 Connect battery to ProffieBoard and hook up to your PC

with a data transfer micro-USB-to-USB cable

Press arrow button it will compile and upload firmware to the

board Wait for red text progress bars to stop at 100

ProffieBoard will play boot sound if speaker is connected

Now you can unplug the USB cable Done

If it gives an error instead this means your configh file has

issues define CONFIG_FILE name has mistakes configh file

is out of config folder your PC user name is non-latin

42 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

33

configh file structure editing

PROFFIEBOARD INSTRUCTIONS

CHANGING PARAMETERS

All sound files (sound fonts music tracks) are stored on the micro SD card Add required sound fonts folders (Plecter NEC and Smoothswing

fonts are supported no need to change WAV files names just copy and paste) to SD card root directory as itrsquos done in the default

ProffieOS_SD_Card content folder and music tracks to the tracks folder

Make sure to name all music tracks and sound fonts folders with latin characters and only up to 8 characters long without using any special

characters (like |[- etc)

Make sure you have a configini file in each sound font folder if there is none - copy one from some default TeensySaberProffieBoard sound

font and paste into newly added sound font folder It has only one parameter that you can modify - humstart It helps to match hum sound

start with blade ignition 1000 usually works fine

All blade effects LED configuration volume level clash sensitivity etc are changed in the configh file located in lightsabergtconfig folder

To do that open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text Editor (Notepad - to see code correctly in Notepad

Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all text) and Delete it then Copy-and-Paste (Ctrl+C

Ctrl+V) your wiring diagram config code into empty _configh file and Save it under new name Follow the instructions on page 39 to

upload it to the board

Proffieboard config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)

volume level (0-3000)

clash sensitivity (adjust lower or higher with 01 step)

sound font folder nametrack name

Preset name

Blade style

LED configuration (use these XP-E2 LED templatesto define your LED)

for Red use 1 Ohm resistor for Green - no resistor for Blue use 024 Ohm

NoLED ndash no 4th led used

Preset 1

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 43

33

Blade Styles

StylePtrltInOutHelperltSimpleClashltLockupltBlastltOnSparkltAudioFlickerltRgblt02550gtRgblt501000gtgtRgblt2552550gt150gtRgblt255500gtgtAudioFlickerltRgblt1002550gtRgblt2550150gtgtgtRgblt255100150gt40gt200300Blackgtgt

ndash this is how the Blade Style code looks pasted in the configh file Preset (it sits inside a StylePtrltgt container)

ndash this is how the Blade Style code looks when editing it inside a Blade Style Editor

Each Blade Style is made of a variety of Effects each added effect goes instead of a base color in the previous effect

PROFFIEBOARD INSTRUCTIONS

CHANGING PARAMETERS

ProffieBoard and TeensySaber use Blade Styles for the main saber blade and any other accent leds to define all light effects (color changing

flashes flickering delays ignitionretraction timing etc)

Use Blade Style Editor to create and adjust Blade Styles Megtooth Sith Sabers did a great video tutorial where he shows and explains

how to use Blade Style Editor Also you can grab some pre-made Blade Styles or share yours here on TRA forums

A Blade Style example of simple flickering Green blade with Spark on start Clash Blaster Lockup and Drag IgnitionRetraction effects

InOutHelperltSimpleClashltLockupltBlastltOnSparkltAudioFlickerltRgblt02550gtRgblt501000gtgtRgblt2552550gt150gtRgblt255500gtgtAudioFlickerltRgblt1002550gtRgblt2550150gtgtgtRgblt255100150gt40gt200300Blackgt

InOutHelperltbase color200300Blackgt ndash base color can be defined by words (WHITE RED GREEN PURPLE etc) or by Rgblt0-2550-2550-255gt values for more

custom shades 200 is extension length in milliseconds 300 is retraction length in milliseconds Black is color when retracted (also can be any other color)

SimpleClashltbase colorclash color40gt ndash clash effect 40 is clash duration in milliseconds

Lockupltbase colorlockup colorgt ndash lockup effect

Blastltbase colorblast colorgt ndash blaster effect

OnSparkltbase colorspark color150gt ndash spark on ignition effect 150 is spark duration in milliseconds

AudioFlickerltrdquoArdquo colorrdquoBrdquo colorgt ndash flickering effect (blade flickers to the actual saber hum sound) the more difference between ldquoArdquo and ldquoBrdquo colors - the more

abrupt is flickering

Rgblt255500gt ndash actual color in RGB format (0 is no light 255 is the maximum brightness value for Red Green or Blue channel)

44 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

ndash SanDisk 4GB microSDHC Class 4 (Genuine) ndash SanDisk 4GB microSDHC Class 4 (Genuine)

130238 kbs = 1477 simultaneous audio streams 137812 kbs = 1562 simultaneous audio streams

ndash Patriot LX Series 16GB microSDHC UHS-IU1 Class 10 ndash Patriot LX Series 16GB microSDHC UHS-IU1 Class 10

133005 kbs = 1508 simultaneous audio streams

ndash GSkill 16GB microSDHC UHS-IU1 Class 10 ndash GSkill 16GB microSDHC UHS-IU1 Class 10

129534 kbs = 1469 simultaneous audio streams

ndash Kingston 16GB microSDHC UHS-IU1 Class 10 ndash Kingston 16GB microSDHC UHS-IU1 Class 10

128090 kbs = 1452 simultaneous audio streams

ndash SanDisk Ultra 16GB microSDHC UHS-IU1 A1 Class 10 ndash SanDisk Ultra 16GB microSDHC UHS-IU1 A1 Class 10

102663 kbs = 1164 simultaneous audio streams 11124 kbs = 1261 simultaneous audio streams

ndash SanDisk 8GB microSDHC Class 4 ndash SanDisk 8GB microSDHC Class 4

108506 kbs = 1230 simultaneous audio streams

ndash SanDisk 16GB microSDHC Class 4 ndash SanDisk 16GB microSDHC Class 4

102663 kbs = 1164 simultaneous audio streams 106957 kbs = 1213 simultaneous audio streams

ndash SanDisk Ultra 16GB microSDHC UHS-IU1 Class 10 ndash SanDisk Ultra 16GB microSDHC UHS-IU1 Class 10

102663 kbs = 1164 simultaneous audio streams 103909 kbs = 1178 simultaneous audio streams

ndash Smartbuy 4GB microSDHC Class 4 ndash Smartbuy 4GB microSDHC Class 4

75437 kbs = 855 simultaneous audio streams

ndash Kingston 8GB microSDHC Class 4 ndash Kingston 8GB microSDHC Class 4

75209 kbs = 822 simultaneous audio streams

ndash SanDisk 4GB microSDHC Class 4 (Fake) ndash SanDisk 4GB microSDHC Class 4 (Fake)

677 kbs = 769 simultaneous audio streams

Here is a list of tested micro SD cards speed with TeensySaber V3 and ProffieBoard Any card with speed over 900 kbs is recommended the

higher the speed is ndash the better Memory size of 4-16Gb is more than enough Cards were tested with a default firmware (1291) compiled

with ldquoSmallest Coderdquo under Optimize ldquodefault_proffieboard_confighrdquo file and default ProffieOS SD card sound files (7 folders)

To test your SD card speed simply hook up ProffieBoard to PC open Arduino IDE go to Tools and open Serial Monitor make sure you have

New Line and 9600 baud rate selected on the bottom of Serial Monitor window type and send sdtest command wait for the test result

4Recommended micro SD cards

BEST

TEENSYSABER PROFFIEBOARD

GOOD

BAD

PROFFIEBOARD INSTRUCTIONS

SD CARD RECOMMENDATIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 45

There are a lot of fake (chinese copies) microSD cards on the market from aliexpress ebay amazon etc They look very similar to genuine

cards but are a bit different though and have a twice lower writingreading speed Here is an example of a SanDisk 4Gb Class 4 card one is

genuine with 137812 kbs speed and the other one is fake with 677 kbs speed I got from ebay seller

Be carefull and pay attention to how the actual card looks if you are not sure ask seller for the real photo of SD card he sells

4Genuine and Fake SanDisk 4Gb Class 4 microSD

PROFFIEBOARD INSTRUCTIONS

SD CARD RECOMMENDATIONS

46 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

WIRE GAUGE GUIDE

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 47

RECHARGE PORTS AND KILL SWITCHES

48 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

NEOPIXEL STRIPS CURRENT DRAW

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 49

6TROUBLESHOOTING

For more help please check these linksProffieOSProffieBoardTeensySaber wiki on GitHubAsk your question on The Rebel Armory forumsAsk your question on FX-sabers forumsAsk your question in facebook group

How to solve most common issues

Quick troubleshooting tips

TeensySaber board or Proffieboard is not recognized by computer (nothing under Port selection in Arduino)

ndash Make sure a charged 37V battery is connected to the board micro-USB cable is a data transfer cable all plugins and drivers are installed ndash

check again pages 21 for TeensySaber or 40 for Proffieboard Try a different USB port on your computer

Sketch (code) compile error in Arduino IDE

ndash Check your define CONFIG_FILE ldquoconfig_confighrdquo line in opened lightsaberino file if itrsquos written correctly with config in it

Sketch (code) compile error in Arduino IDE

ndash Check if the _configh file you defined in the lightsaberino sketch file is same name as in the lightsaber-rdquofirmware versionrdquolightsaber

config folder and is located in this folder

Sketch (code) compile error in Arduino IDE

ndash Check your settings under Tools tab in Arduino IDE program Check again pages 21 for TeensySaber or 40 for Proffieboard

Sketch (code) compile error in Arduino IDE

ndash Check if your _configh file is correct Blade Styles Presets const unsigned int maxLedsPerStrip = 144 if BladeConfig blades[] = is correct

Sketch (code) compile error in Arduino IDE

ndash If nothing helps install Arduino IDE version 186 and try to compile and upload the firmware again

Sound doesnrsquot play

ndash Remove SD card and insert again check speaker wiring Make sure all sound files on SD card are correctly named (8 characters max long)

Re-format SD card in FAT32 load sound files and try again try another SD card

Board says ldquoLOW POWERrdquo

ndash Charge the battery

Serial Monitor shows info sent by the board but your commands donrsquot work

ndash In the bottom right corner of Serial Monitor window make sure the Line Ending drop down is set to New Line

Sound is weird and distorted

ndash Check your SD card speed (see page 44) Check speaker wiring try another good speaker

40 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

3FIRMWARE UPLOAD AND UPDATE2

Software installation and setup

PROFFIEBOARD INSTRUCTIONS

To upload firmware to ProffieBoard Arduino IDE program is required Follow these steps to install it to your PC

1 Install latest Arduino IDE software (donrsquot use BETA)

Installing as Windows app also is not recommended

because it will be installed in a specific protected folder that

wonrsquot allow you to install any additional softwareplugin in it

If ProffieBoard wonrsquot show up in COM port use

Arduino IDE 186 version

2 Install the Proffieboard Arduino Plugin and Zadig software

Follow installation instructions

3 Select Proffieboard-STM32L433 in Tools -gt Board

USB Type ndash Serial CPU Speed ndash 80 MHz Optimize ndash Smallest Code DOSFS ndash SDCARD (SPI) Port ndash COM(the number your PC assigned) (Butterfly-L433CC)

Connect Proffieboard via USB cable to PC to be able to select

the Port

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 41

3FIRMWARE UPLOAD AND UPDATE2

Uploading firmware

PROFFIEBOARD INSTRUCTIONS

1 Download the ProffieBoard firmware and SD card content

Unzip lightsaber-1286zip to your Documents directory or to

Desktop but not to Arduino program folder or anywhere in

Programs directory where all programs are installed You will

see a lightsaber folder and files inside it Donrsquot move any of

these files to any other location outside the lightsaber folder

and donrsquot reorganize them Unzip ProffieOS_SD_Cardzip to the

folder where you keep lightsaber-1286 folder Copy all files

from ProffieOS_SD_Card folder to your SD card

2 Unhide file extensions in File Explorer settings to see h ending

of config files Donrsquot add ldquohrdquo to the config file name Go to config folder and create you own configh file (see page

42 for how-to)

Double-click the lightsaberino file

3 Add the name of your configh file as shown and Save this

lightsaberino file Make sure the other config files are

commented out there should be only one CONFIG_FILE

without You can have multiple config files

in lightsabergtconfig folder and just define the one you need

in lightsaberino file and upload it again to ProffieBoard

4 Connect battery to ProffieBoard and hook up to your PC

with a data transfer micro-USB-to-USB cable

Press arrow button it will compile and upload firmware to the

board Wait for red text progress bars to stop at 100

ProffieBoard will play boot sound if speaker is connected

Now you can unplug the USB cable Done

If it gives an error instead this means your configh file has

issues define CONFIG_FILE name has mistakes configh file

is out of config folder your PC user name is non-latin

42 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

33

configh file structure editing

PROFFIEBOARD INSTRUCTIONS

CHANGING PARAMETERS

All sound files (sound fonts music tracks) are stored on the micro SD card Add required sound fonts folders (Plecter NEC and Smoothswing

fonts are supported no need to change WAV files names just copy and paste) to SD card root directory as itrsquos done in the default

ProffieOS_SD_Card content folder and music tracks to the tracks folder

Make sure to name all music tracks and sound fonts folders with latin characters and only up to 8 characters long without using any special

characters (like |[- etc)

Make sure you have a configini file in each sound font folder if there is none - copy one from some default TeensySaberProffieBoard sound

font and paste into newly added sound font folder It has only one parameter that you can modify - humstart It helps to match hum sound

start with blade ignition 1000 usually works fine

All blade effects LED configuration volume level clash sensitivity etc are changed in the configh file located in lightsabergtconfig folder

To do that open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text Editor (Notepad - to see code correctly in Notepad

Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all text) and Delete it then Copy-and-Paste (Ctrl+C

Ctrl+V) your wiring diagram config code into empty _configh file and Save it under new name Follow the instructions on page 39 to

upload it to the board

Proffieboard config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)

volume level (0-3000)

clash sensitivity (adjust lower or higher with 01 step)

sound font folder nametrack name

Preset name

Blade style

LED configuration (use these XP-E2 LED templatesto define your LED)

for Red use 1 Ohm resistor for Green - no resistor for Blue use 024 Ohm

NoLED ndash no 4th led used

Preset 1

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 43

33

Blade Styles

StylePtrltInOutHelperltSimpleClashltLockupltBlastltOnSparkltAudioFlickerltRgblt02550gtRgblt501000gtgtRgblt2552550gt150gtRgblt255500gtgtAudioFlickerltRgblt1002550gtRgblt2550150gtgtgtRgblt255100150gt40gt200300Blackgtgt

ndash this is how the Blade Style code looks pasted in the configh file Preset (it sits inside a StylePtrltgt container)

ndash this is how the Blade Style code looks when editing it inside a Blade Style Editor

Each Blade Style is made of a variety of Effects each added effect goes instead of a base color in the previous effect

PROFFIEBOARD INSTRUCTIONS

CHANGING PARAMETERS

ProffieBoard and TeensySaber use Blade Styles for the main saber blade and any other accent leds to define all light effects (color changing

flashes flickering delays ignitionretraction timing etc)

Use Blade Style Editor to create and adjust Blade Styles Megtooth Sith Sabers did a great video tutorial where he shows and explains

how to use Blade Style Editor Also you can grab some pre-made Blade Styles or share yours here on TRA forums

A Blade Style example of simple flickering Green blade with Spark on start Clash Blaster Lockup and Drag IgnitionRetraction effects

InOutHelperltSimpleClashltLockupltBlastltOnSparkltAudioFlickerltRgblt02550gtRgblt501000gtgtRgblt2552550gt150gtRgblt255500gtgtAudioFlickerltRgblt1002550gtRgblt2550150gtgtgtRgblt255100150gt40gt200300Blackgt

InOutHelperltbase color200300Blackgt ndash base color can be defined by words (WHITE RED GREEN PURPLE etc) or by Rgblt0-2550-2550-255gt values for more

custom shades 200 is extension length in milliseconds 300 is retraction length in milliseconds Black is color when retracted (also can be any other color)

SimpleClashltbase colorclash color40gt ndash clash effect 40 is clash duration in milliseconds

Lockupltbase colorlockup colorgt ndash lockup effect

Blastltbase colorblast colorgt ndash blaster effect

OnSparkltbase colorspark color150gt ndash spark on ignition effect 150 is spark duration in milliseconds

AudioFlickerltrdquoArdquo colorrdquoBrdquo colorgt ndash flickering effect (blade flickers to the actual saber hum sound) the more difference between ldquoArdquo and ldquoBrdquo colors - the more

abrupt is flickering

Rgblt255500gt ndash actual color in RGB format (0 is no light 255 is the maximum brightness value for Red Green or Blue channel)

44 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

ndash SanDisk 4GB microSDHC Class 4 (Genuine) ndash SanDisk 4GB microSDHC Class 4 (Genuine)

130238 kbs = 1477 simultaneous audio streams 137812 kbs = 1562 simultaneous audio streams

ndash Patriot LX Series 16GB microSDHC UHS-IU1 Class 10 ndash Patriot LX Series 16GB microSDHC UHS-IU1 Class 10

133005 kbs = 1508 simultaneous audio streams

ndash GSkill 16GB microSDHC UHS-IU1 Class 10 ndash GSkill 16GB microSDHC UHS-IU1 Class 10

129534 kbs = 1469 simultaneous audio streams

ndash Kingston 16GB microSDHC UHS-IU1 Class 10 ndash Kingston 16GB microSDHC UHS-IU1 Class 10

128090 kbs = 1452 simultaneous audio streams

ndash SanDisk Ultra 16GB microSDHC UHS-IU1 A1 Class 10 ndash SanDisk Ultra 16GB microSDHC UHS-IU1 A1 Class 10

102663 kbs = 1164 simultaneous audio streams 11124 kbs = 1261 simultaneous audio streams

ndash SanDisk 8GB microSDHC Class 4 ndash SanDisk 8GB microSDHC Class 4

108506 kbs = 1230 simultaneous audio streams

ndash SanDisk 16GB microSDHC Class 4 ndash SanDisk 16GB microSDHC Class 4

102663 kbs = 1164 simultaneous audio streams 106957 kbs = 1213 simultaneous audio streams

ndash SanDisk Ultra 16GB microSDHC UHS-IU1 Class 10 ndash SanDisk Ultra 16GB microSDHC UHS-IU1 Class 10

102663 kbs = 1164 simultaneous audio streams 103909 kbs = 1178 simultaneous audio streams

ndash Smartbuy 4GB microSDHC Class 4 ndash Smartbuy 4GB microSDHC Class 4

75437 kbs = 855 simultaneous audio streams

ndash Kingston 8GB microSDHC Class 4 ndash Kingston 8GB microSDHC Class 4

75209 kbs = 822 simultaneous audio streams

ndash SanDisk 4GB microSDHC Class 4 (Fake) ndash SanDisk 4GB microSDHC Class 4 (Fake)

677 kbs = 769 simultaneous audio streams

Here is a list of tested micro SD cards speed with TeensySaber V3 and ProffieBoard Any card with speed over 900 kbs is recommended the

higher the speed is ndash the better Memory size of 4-16Gb is more than enough Cards were tested with a default firmware (1291) compiled

with ldquoSmallest Coderdquo under Optimize ldquodefault_proffieboard_confighrdquo file and default ProffieOS SD card sound files (7 folders)

To test your SD card speed simply hook up ProffieBoard to PC open Arduino IDE go to Tools and open Serial Monitor make sure you have

New Line and 9600 baud rate selected on the bottom of Serial Monitor window type and send sdtest command wait for the test result

4Recommended micro SD cards

BEST

TEENSYSABER PROFFIEBOARD

GOOD

BAD

PROFFIEBOARD INSTRUCTIONS

SD CARD RECOMMENDATIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 45

There are a lot of fake (chinese copies) microSD cards on the market from aliexpress ebay amazon etc They look very similar to genuine

cards but are a bit different though and have a twice lower writingreading speed Here is an example of a SanDisk 4Gb Class 4 card one is

genuine with 137812 kbs speed and the other one is fake with 677 kbs speed I got from ebay seller

Be carefull and pay attention to how the actual card looks if you are not sure ask seller for the real photo of SD card he sells

4Genuine and Fake SanDisk 4Gb Class 4 microSD

PROFFIEBOARD INSTRUCTIONS

SD CARD RECOMMENDATIONS

46 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

WIRE GAUGE GUIDE

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 47

RECHARGE PORTS AND KILL SWITCHES

48 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

NEOPIXEL STRIPS CURRENT DRAW

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 49

6TROUBLESHOOTING

For more help please check these linksProffieOSProffieBoardTeensySaber wiki on GitHubAsk your question on The Rebel Armory forumsAsk your question on FX-sabers forumsAsk your question in facebook group

How to solve most common issues

Quick troubleshooting tips

TeensySaber board or Proffieboard is not recognized by computer (nothing under Port selection in Arduino)

ndash Make sure a charged 37V battery is connected to the board micro-USB cable is a data transfer cable all plugins and drivers are installed ndash

check again pages 21 for TeensySaber or 40 for Proffieboard Try a different USB port on your computer

Sketch (code) compile error in Arduino IDE

ndash Check your define CONFIG_FILE ldquoconfig_confighrdquo line in opened lightsaberino file if itrsquos written correctly with config in it

Sketch (code) compile error in Arduino IDE

ndash Check if the _configh file you defined in the lightsaberino sketch file is same name as in the lightsaber-rdquofirmware versionrdquolightsaber

config folder and is located in this folder

Sketch (code) compile error in Arduino IDE

ndash Check your settings under Tools tab in Arduino IDE program Check again pages 21 for TeensySaber or 40 for Proffieboard

Sketch (code) compile error in Arduino IDE

ndash Check if your _configh file is correct Blade Styles Presets const unsigned int maxLedsPerStrip = 144 if BladeConfig blades[] = is correct

Sketch (code) compile error in Arduino IDE

ndash If nothing helps install Arduino IDE version 186 and try to compile and upload the firmware again

Sound doesnrsquot play

ndash Remove SD card and insert again check speaker wiring Make sure all sound files on SD card are correctly named (8 characters max long)

Re-format SD card in FAT32 load sound files and try again try another SD card

Board says ldquoLOW POWERrdquo

ndash Charge the battery

Serial Monitor shows info sent by the board but your commands donrsquot work

ndash In the bottom right corner of Serial Monitor window make sure the Line Ending drop down is set to New Line

Sound is weird and distorted

ndash Check your SD card speed (see page 44) Check speaker wiring try another good speaker

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 41

3FIRMWARE UPLOAD AND UPDATE2

Uploading firmware

PROFFIEBOARD INSTRUCTIONS

1 Download the ProffieBoard firmware and SD card content

Unzip lightsaber-1286zip to your Documents directory or to

Desktop but not to Arduino program folder or anywhere in

Programs directory where all programs are installed You will

see a lightsaber folder and files inside it Donrsquot move any of

these files to any other location outside the lightsaber folder

and donrsquot reorganize them Unzip ProffieOS_SD_Cardzip to the

folder where you keep lightsaber-1286 folder Copy all files

from ProffieOS_SD_Card folder to your SD card

2 Unhide file extensions in File Explorer settings to see h ending

of config files Donrsquot add ldquohrdquo to the config file name Go to config folder and create you own configh file (see page

42 for how-to)

Double-click the lightsaberino file

3 Add the name of your configh file as shown and Save this

lightsaberino file Make sure the other config files are

commented out there should be only one CONFIG_FILE

without You can have multiple config files

in lightsabergtconfig folder and just define the one you need

in lightsaberino file and upload it again to ProffieBoard

4 Connect battery to ProffieBoard and hook up to your PC

with a data transfer micro-USB-to-USB cable

Press arrow button it will compile and upload firmware to the

board Wait for red text progress bars to stop at 100

ProffieBoard will play boot sound if speaker is connected

Now you can unplug the USB cable Done

If it gives an error instead this means your configh file has

issues define CONFIG_FILE name has mistakes configh file

is out of config folder your PC user name is non-latin

42 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

33

configh file structure editing

PROFFIEBOARD INSTRUCTIONS

CHANGING PARAMETERS

All sound files (sound fonts music tracks) are stored on the micro SD card Add required sound fonts folders (Plecter NEC and Smoothswing

fonts are supported no need to change WAV files names just copy and paste) to SD card root directory as itrsquos done in the default

ProffieOS_SD_Card content folder and music tracks to the tracks folder

Make sure to name all music tracks and sound fonts folders with latin characters and only up to 8 characters long without using any special

characters (like |[- etc)

Make sure you have a configini file in each sound font folder if there is none - copy one from some default TeensySaberProffieBoard sound

font and paste into newly added sound font folder It has only one parameter that you can modify - humstart It helps to match hum sound

start with blade ignition 1000 usually works fine

All blade effects LED configuration volume level clash sensitivity etc are changed in the configh file located in lightsabergtconfig folder

To do that open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text Editor (Notepad - to see code correctly in Notepad

Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all text) and Delete it then Copy-and-Paste (Ctrl+C

Ctrl+V) your wiring diagram config code into empty _configh file and Save it under new name Follow the instructions on page 39 to

upload it to the board

Proffieboard config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)

volume level (0-3000)

clash sensitivity (adjust lower or higher with 01 step)

sound font folder nametrack name

Preset name

Blade style

LED configuration (use these XP-E2 LED templatesto define your LED)

for Red use 1 Ohm resistor for Green - no resistor for Blue use 024 Ohm

NoLED ndash no 4th led used

Preset 1

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 43

33

Blade Styles

StylePtrltInOutHelperltSimpleClashltLockupltBlastltOnSparkltAudioFlickerltRgblt02550gtRgblt501000gtgtRgblt2552550gt150gtRgblt255500gtgtAudioFlickerltRgblt1002550gtRgblt2550150gtgtgtRgblt255100150gt40gt200300Blackgtgt

ndash this is how the Blade Style code looks pasted in the configh file Preset (it sits inside a StylePtrltgt container)

ndash this is how the Blade Style code looks when editing it inside a Blade Style Editor

Each Blade Style is made of a variety of Effects each added effect goes instead of a base color in the previous effect

PROFFIEBOARD INSTRUCTIONS

CHANGING PARAMETERS

ProffieBoard and TeensySaber use Blade Styles for the main saber blade and any other accent leds to define all light effects (color changing

flashes flickering delays ignitionretraction timing etc)

Use Blade Style Editor to create and adjust Blade Styles Megtooth Sith Sabers did a great video tutorial where he shows and explains

how to use Blade Style Editor Also you can grab some pre-made Blade Styles or share yours here on TRA forums

A Blade Style example of simple flickering Green blade with Spark on start Clash Blaster Lockup and Drag IgnitionRetraction effects

InOutHelperltSimpleClashltLockupltBlastltOnSparkltAudioFlickerltRgblt02550gtRgblt501000gtgtRgblt2552550gt150gtRgblt255500gtgtAudioFlickerltRgblt1002550gtRgblt2550150gtgtgtRgblt255100150gt40gt200300Blackgt

InOutHelperltbase color200300Blackgt ndash base color can be defined by words (WHITE RED GREEN PURPLE etc) or by Rgblt0-2550-2550-255gt values for more

custom shades 200 is extension length in milliseconds 300 is retraction length in milliseconds Black is color when retracted (also can be any other color)

SimpleClashltbase colorclash color40gt ndash clash effect 40 is clash duration in milliseconds

Lockupltbase colorlockup colorgt ndash lockup effect

Blastltbase colorblast colorgt ndash blaster effect

OnSparkltbase colorspark color150gt ndash spark on ignition effect 150 is spark duration in milliseconds

AudioFlickerltrdquoArdquo colorrdquoBrdquo colorgt ndash flickering effect (blade flickers to the actual saber hum sound) the more difference between ldquoArdquo and ldquoBrdquo colors - the more

abrupt is flickering

Rgblt255500gt ndash actual color in RGB format (0 is no light 255 is the maximum brightness value for Red Green or Blue channel)

44 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

ndash SanDisk 4GB microSDHC Class 4 (Genuine) ndash SanDisk 4GB microSDHC Class 4 (Genuine)

130238 kbs = 1477 simultaneous audio streams 137812 kbs = 1562 simultaneous audio streams

ndash Patriot LX Series 16GB microSDHC UHS-IU1 Class 10 ndash Patriot LX Series 16GB microSDHC UHS-IU1 Class 10

133005 kbs = 1508 simultaneous audio streams

ndash GSkill 16GB microSDHC UHS-IU1 Class 10 ndash GSkill 16GB microSDHC UHS-IU1 Class 10

129534 kbs = 1469 simultaneous audio streams

ndash Kingston 16GB microSDHC UHS-IU1 Class 10 ndash Kingston 16GB microSDHC UHS-IU1 Class 10

128090 kbs = 1452 simultaneous audio streams

ndash SanDisk Ultra 16GB microSDHC UHS-IU1 A1 Class 10 ndash SanDisk Ultra 16GB microSDHC UHS-IU1 A1 Class 10

102663 kbs = 1164 simultaneous audio streams 11124 kbs = 1261 simultaneous audio streams

ndash SanDisk 8GB microSDHC Class 4 ndash SanDisk 8GB microSDHC Class 4

108506 kbs = 1230 simultaneous audio streams

ndash SanDisk 16GB microSDHC Class 4 ndash SanDisk 16GB microSDHC Class 4

102663 kbs = 1164 simultaneous audio streams 106957 kbs = 1213 simultaneous audio streams

ndash SanDisk Ultra 16GB microSDHC UHS-IU1 Class 10 ndash SanDisk Ultra 16GB microSDHC UHS-IU1 Class 10

102663 kbs = 1164 simultaneous audio streams 103909 kbs = 1178 simultaneous audio streams

ndash Smartbuy 4GB microSDHC Class 4 ndash Smartbuy 4GB microSDHC Class 4

75437 kbs = 855 simultaneous audio streams

ndash Kingston 8GB microSDHC Class 4 ndash Kingston 8GB microSDHC Class 4

75209 kbs = 822 simultaneous audio streams

ndash SanDisk 4GB microSDHC Class 4 (Fake) ndash SanDisk 4GB microSDHC Class 4 (Fake)

677 kbs = 769 simultaneous audio streams

Here is a list of tested micro SD cards speed with TeensySaber V3 and ProffieBoard Any card with speed over 900 kbs is recommended the

higher the speed is ndash the better Memory size of 4-16Gb is more than enough Cards were tested with a default firmware (1291) compiled

with ldquoSmallest Coderdquo under Optimize ldquodefault_proffieboard_confighrdquo file and default ProffieOS SD card sound files (7 folders)

To test your SD card speed simply hook up ProffieBoard to PC open Arduino IDE go to Tools and open Serial Monitor make sure you have

New Line and 9600 baud rate selected on the bottom of Serial Monitor window type and send sdtest command wait for the test result

4Recommended micro SD cards

BEST

TEENSYSABER PROFFIEBOARD

GOOD

BAD

PROFFIEBOARD INSTRUCTIONS

SD CARD RECOMMENDATIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 45

There are a lot of fake (chinese copies) microSD cards on the market from aliexpress ebay amazon etc They look very similar to genuine

cards but are a bit different though and have a twice lower writingreading speed Here is an example of a SanDisk 4Gb Class 4 card one is

genuine with 137812 kbs speed and the other one is fake with 677 kbs speed I got from ebay seller

Be carefull and pay attention to how the actual card looks if you are not sure ask seller for the real photo of SD card he sells

4Genuine and Fake SanDisk 4Gb Class 4 microSD

PROFFIEBOARD INSTRUCTIONS

SD CARD RECOMMENDATIONS

46 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

WIRE GAUGE GUIDE

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 47

RECHARGE PORTS AND KILL SWITCHES

48 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

NEOPIXEL STRIPS CURRENT DRAW

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 49

6TROUBLESHOOTING

For more help please check these linksProffieOSProffieBoardTeensySaber wiki on GitHubAsk your question on The Rebel Armory forumsAsk your question on FX-sabers forumsAsk your question in facebook group

How to solve most common issues

Quick troubleshooting tips

TeensySaber board or Proffieboard is not recognized by computer (nothing under Port selection in Arduino)

ndash Make sure a charged 37V battery is connected to the board micro-USB cable is a data transfer cable all plugins and drivers are installed ndash

check again pages 21 for TeensySaber or 40 for Proffieboard Try a different USB port on your computer

Sketch (code) compile error in Arduino IDE

ndash Check your define CONFIG_FILE ldquoconfig_confighrdquo line in opened lightsaberino file if itrsquos written correctly with config in it

Sketch (code) compile error in Arduino IDE

ndash Check if the _configh file you defined in the lightsaberino sketch file is same name as in the lightsaber-rdquofirmware versionrdquolightsaber

config folder and is located in this folder

Sketch (code) compile error in Arduino IDE

ndash Check your settings under Tools tab in Arduino IDE program Check again pages 21 for TeensySaber or 40 for Proffieboard

Sketch (code) compile error in Arduino IDE

ndash Check if your _configh file is correct Blade Styles Presets const unsigned int maxLedsPerStrip = 144 if BladeConfig blades[] = is correct

Sketch (code) compile error in Arduino IDE

ndash If nothing helps install Arduino IDE version 186 and try to compile and upload the firmware again

Sound doesnrsquot play

ndash Remove SD card and insert again check speaker wiring Make sure all sound files on SD card are correctly named (8 characters max long)

Re-format SD card in FAT32 load sound files and try again try another SD card

Board says ldquoLOW POWERrdquo

ndash Charge the battery

Serial Monitor shows info sent by the board but your commands donrsquot work

ndash In the bottom right corner of Serial Monitor window make sure the Line Ending drop down is set to New Line

Sound is weird and distorted

ndash Check your SD card speed (see page 44) Check speaker wiring try another good speaker

42 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

33

configh file structure editing

PROFFIEBOARD INSTRUCTIONS

CHANGING PARAMETERS

All sound files (sound fonts music tracks) are stored on the micro SD card Add required sound fonts folders (Plecter NEC and Smoothswing

fonts are supported no need to change WAV files names just copy and paste) to SD card root directory as itrsquos done in the default

ProffieOS_SD_Card content folder and music tracks to the tracks folder

Make sure to name all music tracks and sound fonts folders with latin characters and only up to 8 characters long without using any special

characters (like |[- etc)

Make sure you have a configini file in each sound font folder if there is none - copy one from some default TeensySaberProffieBoard sound

font and paste into newly added sound font folder It has only one parameter that you can modify - humstart It helps to match hum sound

start with blade ignition 1000 usually works fine

All blade effects LED configuration volume level clash sensitivity etc are changed in the configh file located in lightsabergtconfig folder

To do that open any _configh file in the ldquolightsabergtconfigrdquo folder directory in any Text Editor (Notepad - to see code correctly in Notepad

Cut-and-Paste it to WordPad then Cut-and-Paste it back to Notepad Save) Ctrl+A (select all text) and Delete it then Copy-and-Paste (Ctrl+C

Ctrl+V) your wiring diagram config code into empty _configh file and Save it under new name Follow the instructions on page 39 to

upload it to the board

Proffieboard config setupnumber of ldquobladesrdquo usednumber of buttons used (1-3)

volume level (0-3000)

clash sensitivity (adjust lower or higher with 01 step)

sound font folder nametrack name

Preset name

Blade style

LED configuration (use these XP-E2 LED templatesto define your LED)

for Red use 1 Ohm resistor for Green - no resistor for Blue use 024 Ohm

NoLED ndash no 4th led used

Preset 1

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 43

33

Blade Styles

StylePtrltInOutHelperltSimpleClashltLockupltBlastltOnSparkltAudioFlickerltRgblt02550gtRgblt501000gtgtRgblt2552550gt150gtRgblt255500gtgtAudioFlickerltRgblt1002550gtRgblt2550150gtgtgtRgblt255100150gt40gt200300Blackgtgt

ndash this is how the Blade Style code looks pasted in the configh file Preset (it sits inside a StylePtrltgt container)

ndash this is how the Blade Style code looks when editing it inside a Blade Style Editor

Each Blade Style is made of a variety of Effects each added effect goes instead of a base color in the previous effect

PROFFIEBOARD INSTRUCTIONS

CHANGING PARAMETERS

ProffieBoard and TeensySaber use Blade Styles for the main saber blade and any other accent leds to define all light effects (color changing

flashes flickering delays ignitionretraction timing etc)

Use Blade Style Editor to create and adjust Blade Styles Megtooth Sith Sabers did a great video tutorial where he shows and explains

how to use Blade Style Editor Also you can grab some pre-made Blade Styles or share yours here on TRA forums

A Blade Style example of simple flickering Green blade with Spark on start Clash Blaster Lockup and Drag IgnitionRetraction effects

InOutHelperltSimpleClashltLockupltBlastltOnSparkltAudioFlickerltRgblt02550gtRgblt501000gtgtRgblt2552550gt150gtRgblt255500gtgtAudioFlickerltRgblt1002550gtRgblt2550150gtgtgtRgblt255100150gt40gt200300Blackgt

InOutHelperltbase color200300Blackgt ndash base color can be defined by words (WHITE RED GREEN PURPLE etc) or by Rgblt0-2550-2550-255gt values for more

custom shades 200 is extension length in milliseconds 300 is retraction length in milliseconds Black is color when retracted (also can be any other color)

SimpleClashltbase colorclash color40gt ndash clash effect 40 is clash duration in milliseconds

Lockupltbase colorlockup colorgt ndash lockup effect

Blastltbase colorblast colorgt ndash blaster effect

OnSparkltbase colorspark color150gt ndash spark on ignition effect 150 is spark duration in milliseconds

AudioFlickerltrdquoArdquo colorrdquoBrdquo colorgt ndash flickering effect (blade flickers to the actual saber hum sound) the more difference between ldquoArdquo and ldquoBrdquo colors - the more

abrupt is flickering

Rgblt255500gt ndash actual color in RGB format (0 is no light 255 is the maximum brightness value for Red Green or Blue channel)

44 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

ndash SanDisk 4GB microSDHC Class 4 (Genuine) ndash SanDisk 4GB microSDHC Class 4 (Genuine)

130238 kbs = 1477 simultaneous audio streams 137812 kbs = 1562 simultaneous audio streams

ndash Patriot LX Series 16GB microSDHC UHS-IU1 Class 10 ndash Patriot LX Series 16GB microSDHC UHS-IU1 Class 10

133005 kbs = 1508 simultaneous audio streams

ndash GSkill 16GB microSDHC UHS-IU1 Class 10 ndash GSkill 16GB microSDHC UHS-IU1 Class 10

129534 kbs = 1469 simultaneous audio streams

ndash Kingston 16GB microSDHC UHS-IU1 Class 10 ndash Kingston 16GB microSDHC UHS-IU1 Class 10

128090 kbs = 1452 simultaneous audio streams

ndash SanDisk Ultra 16GB microSDHC UHS-IU1 A1 Class 10 ndash SanDisk Ultra 16GB microSDHC UHS-IU1 A1 Class 10

102663 kbs = 1164 simultaneous audio streams 11124 kbs = 1261 simultaneous audio streams

ndash SanDisk 8GB microSDHC Class 4 ndash SanDisk 8GB microSDHC Class 4

108506 kbs = 1230 simultaneous audio streams

ndash SanDisk 16GB microSDHC Class 4 ndash SanDisk 16GB microSDHC Class 4

102663 kbs = 1164 simultaneous audio streams 106957 kbs = 1213 simultaneous audio streams

ndash SanDisk Ultra 16GB microSDHC UHS-IU1 Class 10 ndash SanDisk Ultra 16GB microSDHC UHS-IU1 Class 10

102663 kbs = 1164 simultaneous audio streams 103909 kbs = 1178 simultaneous audio streams

ndash Smartbuy 4GB microSDHC Class 4 ndash Smartbuy 4GB microSDHC Class 4

75437 kbs = 855 simultaneous audio streams

ndash Kingston 8GB microSDHC Class 4 ndash Kingston 8GB microSDHC Class 4

75209 kbs = 822 simultaneous audio streams

ndash SanDisk 4GB microSDHC Class 4 (Fake) ndash SanDisk 4GB microSDHC Class 4 (Fake)

677 kbs = 769 simultaneous audio streams

Here is a list of tested micro SD cards speed with TeensySaber V3 and ProffieBoard Any card with speed over 900 kbs is recommended the

higher the speed is ndash the better Memory size of 4-16Gb is more than enough Cards were tested with a default firmware (1291) compiled

with ldquoSmallest Coderdquo under Optimize ldquodefault_proffieboard_confighrdquo file and default ProffieOS SD card sound files (7 folders)

To test your SD card speed simply hook up ProffieBoard to PC open Arduino IDE go to Tools and open Serial Monitor make sure you have

New Line and 9600 baud rate selected on the bottom of Serial Monitor window type and send sdtest command wait for the test result

4Recommended micro SD cards

BEST

TEENSYSABER PROFFIEBOARD

GOOD

BAD

PROFFIEBOARD INSTRUCTIONS

SD CARD RECOMMENDATIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 45

There are a lot of fake (chinese copies) microSD cards on the market from aliexpress ebay amazon etc They look very similar to genuine

cards but are a bit different though and have a twice lower writingreading speed Here is an example of a SanDisk 4Gb Class 4 card one is

genuine with 137812 kbs speed and the other one is fake with 677 kbs speed I got from ebay seller

Be carefull and pay attention to how the actual card looks if you are not sure ask seller for the real photo of SD card he sells

4Genuine and Fake SanDisk 4Gb Class 4 microSD

PROFFIEBOARD INSTRUCTIONS

SD CARD RECOMMENDATIONS

46 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

WIRE GAUGE GUIDE

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 47

RECHARGE PORTS AND KILL SWITCHES

48 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

NEOPIXEL STRIPS CURRENT DRAW

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 49

6TROUBLESHOOTING

For more help please check these linksProffieOSProffieBoardTeensySaber wiki on GitHubAsk your question on The Rebel Armory forumsAsk your question on FX-sabers forumsAsk your question in facebook group

How to solve most common issues

Quick troubleshooting tips

TeensySaber board or Proffieboard is not recognized by computer (nothing under Port selection in Arduino)

ndash Make sure a charged 37V battery is connected to the board micro-USB cable is a data transfer cable all plugins and drivers are installed ndash

check again pages 21 for TeensySaber or 40 for Proffieboard Try a different USB port on your computer

Sketch (code) compile error in Arduino IDE

ndash Check your define CONFIG_FILE ldquoconfig_confighrdquo line in opened lightsaberino file if itrsquos written correctly with config in it

Sketch (code) compile error in Arduino IDE

ndash Check if the _configh file you defined in the lightsaberino sketch file is same name as in the lightsaber-rdquofirmware versionrdquolightsaber

config folder and is located in this folder

Sketch (code) compile error in Arduino IDE

ndash Check your settings under Tools tab in Arduino IDE program Check again pages 21 for TeensySaber or 40 for Proffieboard

Sketch (code) compile error in Arduino IDE

ndash Check if your _configh file is correct Blade Styles Presets const unsigned int maxLedsPerStrip = 144 if BladeConfig blades[] = is correct

Sketch (code) compile error in Arduino IDE

ndash If nothing helps install Arduino IDE version 186 and try to compile and upload the firmware again

Sound doesnrsquot play

ndash Remove SD card and insert again check speaker wiring Make sure all sound files on SD card are correctly named (8 characters max long)

Re-format SD card in FAT32 load sound files and try again try another SD card

Board says ldquoLOW POWERrdquo

ndash Charge the battery

Serial Monitor shows info sent by the board but your commands donrsquot work

ndash In the bottom right corner of Serial Monitor window make sure the Line Ending drop down is set to New Line

Sound is weird and distorted

ndash Check your SD card speed (see page 44) Check speaker wiring try another good speaker

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 43

33

Blade Styles

StylePtrltInOutHelperltSimpleClashltLockupltBlastltOnSparkltAudioFlickerltRgblt02550gtRgblt501000gtgtRgblt2552550gt150gtRgblt255500gtgtAudioFlickerltRgblt1002550gtRgblt2550150gtgtgtRgblt255100150gt40gt200300Blackgtgt

ndash this is how the Blade Style code looks pasted in the configh file Preset (it sits inside a StylePtrltgt container)

ndash this is how the Blade Style code looks when editing it inside a Blade Style Editor

Each Blade Style is made of a variety of Effects each added effect goes instead of a base color in the previous effect

PROFFIEBOARD INSTRUCTIONS

CHANGING PARAMETERS

ProffieBoard and TeensySaber use Blade Styles for the main saber blade and any other accent leds to define all light effects (color changing

flashes flickering delays ignitionretraction timing etc)

Use Blade Style Editor to create and adjust Blade Styles Megtooth Sith Sabers did a great video tutorial where he shows and explains

how to use Blade Style Editor Also you can grab some pre-made Blade Styles or share yours here on TRA forums

A Blade Style example of simple flickering Green blade with Spark on start Clash Blaster Lockup and Drag IgnitionRetraction effects

InOutHelperltSimpleClashltLockupltBlastltOnSparkltAudioFlickerltRgblt02550gtRgblt501000gtgtRgblt2552550gt150gtRgblt255500gtgtAudioFlickerltRgblt1002550gtRgblt2550150gtgtgtRgblt255100150gt40gt200300Blackgt

InOutHelperltbase color200300Blackgt ndash base color can be defined by words (WHITE RED GREEN PURPLE etc) or by Rgblt0-2550-2550-255gt values for more

custom shades 200 is extension length in milliseconds 300 is retraction length in milliseconds Black is color when retracted (also can be any other color)

SimpleClashltbase colorclash color40gt ndash clash effect 40 is clash duration in milliseconds

Lockupltbase colorlockup colorgt ndash lockup effect

Blastltbase colorblast colorgt ndash blaster effect

OnSparkltbase colorspark color150gt ndash spark on ignition effect 150 is spark duration in milliseconds

AudioFlickerltrdquoArdquo colorrdquoBrdquo colorgt ndash flickering effect (blade flickers to the actual saber hum sound) the more difference between ldquoArdquo and ldquoBrdquo colors - the more

abrupt is flickering

Rgblt255500gt ndash actual color in RGB format (0 is no light 255 is the maximum brightness value for Red Green or Blue channel)

44 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

ndash SanDisk 4GB microSDHC Class 4 (Genuine) ndash SanDisk 4GB microSDHC Class 4 (Genuine)

130238 kbs = 1477 simultaneous audio streams 137812 kbs = 1562 simultaneous audio streams

ndash Patriot LX Series 16GB microSDHC UHS-IU1 Class 10 ndash Patriot LX Series 16GB microSDHC UHS-IU1 Class 10

133005 kbs = 1508 simultaneous audio streams

ndash GSkill 16GB microSDHC UHS-IU1 Class 10 ndash GSkill 16GB microSDHC UHS-IU1 Class 10

129534 kbs = 1469 simultaneous audio streams

ndash Kingston 16GB microSDHC UHS-IU1 Class 10 ndash Kingston 16GB microSDHC UHS-IU1 Class 10

128090 kbs = 1452 simultaneous audio streams

ndash SanDisk Ultra 16GB microSDHC UHS-IU1 A1 Class 10 ndash SanDisk Ultra 16GB microSDHC UHS-IU1 A1 Class 10

102663 kbs = 1164 simultaneous audio streams 11124 kbs = 1261 simultaneous audio streams

ndash SanDisk 8GB microSDHC Class 4 ndash SanDisk 8GB microSDHC Class 4

108506 kbs = 1230 simultaneous audio streams

ndash SanDisk 16GB microSDHC Class 4 ndash SanDisk 16GB microSDHC Class 4

102663 kbs = 1164 simultaneous audio streams 106957 kbs = 1213 simultaneous audio streams

ndash SanDisk Ultra 16GB microSDHC UHS-IU1 Class 10 ndash SanDisk Ultra 16GB microSDHC UHS-IU1 Class 10

102663 kbs = 1164 simultaneous audio streams 103909 kbs = 1178 simultaneous audio streams

ndash Smartbuy 4GB microSDHC Class 4 ndash Smartbuy 4GB microSDHC Class 4

75437 kbs = 855 simultaneous audio streams

ndash Kingston 8GB microSDHC Class 4 ndash Kingston 8GB microSDHC Class 4

75209 kbs = 822 simultaneous audio streams

ndash SanDisk 4GB microSDHC Class 4 (Fake) ndash SanDisk 4GB microSDHC Class 4 (Fake)

677 kbs = 769 simultaneous audio streams

Here is a list of tested micro SD cards speed with TeensySaber V3 and ProffieBoard Any card with speed over 900 kbs is recommended the

higher the speed is ndash the better Memory size of 4-16Gb is more than enough Cards were tested with a default firmware (1291) compiled

with ldquoSmallest Coderdquo under Optimize ldquodefault_proffieboard_confighrdquo file and default ProffieOS SD card sound files (7 folders)

To test your SD card speed simply hook up ProffieBoard to PC open Arduino IDE go to Tools and open Serial Monitor make sure you have

New Line and 9600 baud rate selected on the bottom of Serial Monitor window type and send sdtest command wait for the test result

4Recommended micro SD cards

BEST

TEENSYSABER PROFFIEBOARD

GOOD

BAD

PROFFIEBOARD INSTRUCTIONS

SD CARD RECOMMENDATIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 45

There are a lot of fake (chinese copies) microSD cards on the market from aliexpress ebay amazon etc They look very similar to genuine

cards but are a bit different though and have a twice lower writingreading speed Here is an example of a SanDisk 4Gb Class 4 card one is

genuine with 137812 kbs speed and the other one is fake with 677 kbs speed I got from ebay seller

Be carefull and pay attention to how the actual card looks if you are not sure ask seller for the real photo of SD card he sells

4Genuine and Fake SanDisk 4Gb Class 4 microSD

PROFFIEBOARD INSTRUCTIONS

SD CARD RECOMMENDATIONS

46 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

WIRE GAUGE GUIDE

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 47

RECHARGE PORTS AND KILL SWITCHES

48 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

NEOPIXEL STRIPS CURRENT DRAW

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 49

6TROUBLESHOOTING

For more help please check these linksProffieOSProffieBoardTeensySaber wiki on GitHubAsk your question on The Rebel Armory forumsAsk your question on FX-sabers forumsAsk your question in facebook group

How to solve most common issues

Quick troubleshooting tips

TeensySaber board or Proffieboard is not recognized by computer (nothing under Port selection in Arduino)

ndash Make sure a charged 37V battery is connected to the board micro-USB cable is a data transfer cable all plugins and drivers are installed ndash

check again pages 21 for TeensySaber or 40 for Proffieboard Try a different USB port on your computer

Sketch (code) compile error in Arduino IDE

ndash Check your define CONFIG_FILE ldquoconfig_confighrdquo line in opened lightsaberino file if itrsquos written correctly with config in it

Sketch (code) compile error in Arduino IDE

ndash Check if the _configh file you defined in the lightsaberino sketch file is same name as in the lightsaber-rdquofirmware versionrdquolightsaber

config folder and is located in this folder

Sketch (code) compile error in Arduino IDE

ndash Check your settings under Tools tab in Arduino IDE program Check again pages 21 for TeensySaber or 40 for Proffieboard

Sketch (code) compile error in Arduino IDE

ndash Check if your _configh file is correct Blade Styles Presets const unsigned int maxLedsPerStrip = 144 if BladeConfig blades[] = is correct

Sketch (code) compile error in Arduino IDE

ndash If nothing helps install Arduino IDE version 186 and try to compile and upload the firmware again

Sound doesnrsquot play

ndash Remove SD card and insert again check speaker wiring Make sure all sound files on SD card are correctly named (8 characters max long)

Re-format SD card in FAT32 load sound files and try again try another SD card

Board says ldquoLOW POWERrdquo

ndash Charge the battery

Serial Monitor shows info sent by the board but your commands donrsquot work

ndash In the bottom right corner of Serial Monitor window make sure the Line Ending drop down is set to New Line

Sound is weird and distorted

ndash Check your SD card speed (see page 44) Check speaker wiring try another good speaker

44 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

ndash SanDisk 4GB microSDHC Class 4 (Genuine) ndash SanDisk 4GB microSDHC Class 4 (Genuine)

130238 kbs = 1477 simultaneous audio streams 137812 kbs = 1562 simultaneous audio streams

ndash Patriot LX Series 16GB microSDHC UHS-IU1 Class 10 ndash Patriot LX Series 16GB microSDHC UHS-IU1 Class 10

133005 kbs = 1508 simultaneous audio streams

ndash GSkill 16GB microSDHC UHS-IU1 Class 10 ndash GSkill 16GB microSDHC UHS-IU1 Class 10

129534 kbs = 1469 simultaneous audio streams

ndash Kingston 16GB microSDHC UHS-IU1 Class 10 ndash Kingston 16GB microSDHC UHS-IU1 Class 10

128090 kbs = 1452 simultaneous audio streams

ndash SanDisk Ultra 16GB microSDHC UHS-IU1 A1 Class 10 ndash SanDisk Ultra 16GB microSDHC UHS-IU1 A1 Class 10

102663 kbs = 1164 simultaneous audio streams 11124 kbs = 1261 simultaneous audio streams

ndash SanDisk 8GB microSDHC Class 4 ndash SanDisk 8GB microSDHC Class 4

108506 kbs = 1230 simultaneous audio streams

ndash SanDisk 16GB microSDHC Class 4 ndash SanDisk 16GB microSDHC Class 4

102663 kbs = 1164 simultaneous audio streams 106957 kbs = 1213 simultaneous audio streams

ndash SanDisk Ultra 16GB microSDHC UHS-IU1 Class 10 ndash SanDisk Ultra 16GB microSDHC UHS-IU1 Class 10

102663 kbs = 1164 simultaneous audio streams 103909 kbs = 1178 simultaneous audio streams

ndash Smartbuy 4GB microSDHC Class 4 ndash Smartbuy 4GB microSDHC Class 4

75437 kbs = 855 simultaneous audio streams

ndash Kingston 8GB microSDHC Class 4 ndash Kingston 8GB microSDHC Class 4

75209 kbs = 822 simultaneous audio streams

ndash SanDisk 4GB microSDHC Class 4 (Fake) ndash SanDisk 4GB microSDHC Class 4 (Fake)

677 kbs = 769 simultaneous audio streams

Here is a list of tested micro SD cards speed with TeensySaber V3 and ProffieBoard Any card with speed over 900 kbs is recommended the

higher the speed is ndash the better Memory size of 4-16Gb is more than enough Cards were tested with a default firmware (1291) compiled

with ldquoSmallest Coderdquo under Optimize ldquodefault_proffieboard_confighrdquo file and default ProffieOS SD card sound files (7 folders)

To test your SD card speed simply hook up ProffieBoard to PC open Arduino IDE go to Tools and open Serial Monitor make sure you have

New Line and 9600 baud rate selected on the bottom of Serial Monitor window type and send sdtest command wait for the test result

4Recommended micro SD cards

BEST

TEENSYSABER PROFFIEBOARD

GOOD

BAD

PROFFIEBOARD INSTRUCTIONS

SD CARD RECOMMENDATIONS

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 45

There are a lot of fake (chinese copies) microSD cards on the market from aliexpress ebay amazon etc They look very similar to genuine

cards but are a bit different though and have a twice lower writingreading speed Here is an example of a SanDisk 4Gb Class 4 card one is

genuine with 137812 kbs speed and the other one is fake with 677 kbs speed I got from ebay seller

Be carefull and pay attention to how the actual card looks if you are not sure ask seller for the real photo of SD card he sells

4Genuine and Fake SanDisk 4Gb Class 4 microSD

PROFFIEBOARD INSTRUCTIONS

SD CARD RECOMMENDATIONS

46 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

WIRE GAUGE GUIDE

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 47

RECHARGE PORTS AND KILL SWITCHES

48 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

NEOPIXEL STRIPS CURRENT DRAW

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 49

6TROUBLESHOOTING

For more help please check these linksProffieOSProffieBoardTeensySaber wiki on GitHubAsk your question on The Rebel Armory forumsAsk your question on FX-sabers forumsAsk your question in facebook group

How to solve most common issues

Quick troubleshooting tips

TeensySaber board or Proffieboard is not recognized by computer (nothing under Port selection in Arduino)

ndash Make sure a charged 37V battery is connected to the board micro-USB cable is a data transfer cable all plugins and drivers are installed ndash

check again pages 21 for TeensySaber or 40 for Proffieboard Try a different USB port on your computer

Sketch (code) compile error in Arduino IDE

ndash Check your define CONFIG_FILE ldquoconfig_confighrdquo line in opened lightsaberino file if itrsquos written correctly with config in it

Sketch (code) compile error in Arduino IDE

ndash Check if the _configh file you defined in the lightsaberino sketch file is same name as in the lightsaber-rdquofirmware versionrdquolightsaber

config folder and is located in this folder

Sketch (code) compile error in Arduino IDE

ndash Check your settings under Tools tab in Arduino IDE program Check again pages 21 for TeensySaber or 40 for Proffieboard

Sketch (code) compile error in Arduino IDE

ndash Check if your _configh file is correct Blade Styles Presets const unsigned int maxLedsPerStrip = 144 if BladeConfig blades[] = is correct

Sketch (code) compile error in Arduino IDE

ndash If nothing helps install Arduino IDE version 186 and try to compile and upload the firmware again

Sound doesnrsquot play

ndash Remove SD card and insert again check speaker wiring Make sure all sound files on SD card are correctly named (8 characters max long)

Re-format SD card in FAT32 load sound files and try again try another SD card

Board says ldquoLOW POWERrdquo

ndash Charge the battery

Serial Monitor shows info sent by the board but your commands donrsquot work

ndash In the bottom right corner of Serial Monitor window make sure the Line Ending drop down is set to New Line

Sound is weird and distorted

ndash Check your SD card speed (see page 44) Check speaker wiring try another good speaker

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 45

There are a lot of fake (chinese copies) microSD cards on the market from aliexpress ebay amazon etc They look very similar to genuine

cards but are a bit different though and have a twice lower writingreading speed Here is an example of a SanDisk 4Gb Class 4 card one is

genuine with 137812 kbs speed and the other one is fake with 677 kbs speed I got from ebay seller

Be carefull and pay attention to how the actual card looks if you are not sure ask seller for the real photo of SD card he sells

4Genuine and Fake SanDisk 4Gb Class 4 microSD

PROFFIEBOARD INSTRUCTIONS

SD CARD RECOMMENDATIONS

46 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

WIRE GAUGE GUIDE

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 47

RECHARGE PORTS AND KILL SWITCHES

48 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

NEOPIXEL STRIPS CURRENT DRAW

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 49

6TROUBLESHOOTING

For more help please check these linksProffieOSProffieBoardTeensySaber wiki on GitHubAsk your question on The Rebel Armory forumsAsk your question on FX-sabers forumsAsk your question in facebook group

How to solve most common issues

Quick troubleshooting tips

TeensySaber board or Proffieboard is not recognized by computer (nothing under Port selection in Arduino)

ndash Make sure a charged 37V battery is connected to the board micro-USB cable is a data transfer cable all plugins and drivers are installed ndash

check again pages 21 for TeensySaber or 40 for Proffieboard Try a different USB port on your computer

Sketch (code) compile error in Arduino IDE

ndash Check your define CONFIG_FILE ldquoconfig_confighrdquo line in opened lightsaberino file if itrsquos written correctly with config in it

Sketch (code) compile error in Arduino IDE

ndash Check if the _configh file you defined in the lightsaberino sketch file is same name as in the lightsaber-rdquofirmware versionrdquolightsaber

config folder and is located in this folder

Sketch (code) compile error in Arduino IDE

ndash Check your settings under Tools tab in Arduino IDE program Check again pages 21 for TeensySaber or 40 for Proffieboard

Sketch (code) compile error in Arduino IDE

ndash Check if your _configh file is correct Blade Styles Presets const unsigned int maxLedsPerStrip = 144 if BladeConfig blades[] = is correct

Sketch (code) compile error in Arduino IDE

ndash If nothing helps install Arduino IDE version 186 and try to compile and upload the firmware again

Sound doesnrsquot play

ndash Remove SD card and insert again check speaker wiring Make sure all sound files on SD card are correctly named (8 characters max long)

Re-format SD card in FAT32 load sound files and try again try another SD card

Board says ldquoLOW POWERrdquo

ndash Charge the battery

Serial Monitor shows info sent by the board but your commands donrsquot work

ndash In the bottom right corner of Serial Monitor window make sure the Line Ending drop down is set to New Line

Sound is weird and distorted

ndash Check your SD card speed (see page 44) Check speaker wiring try another good speaker

46 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

WIRE GAUGE GUIDE

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 47

RECHARGE PORTS AND KILL SWITCHES

48 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

NEOPIXEL STRIPS CURRENT DRAW

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 49

6TROUBLESHOOTING

For more help please check these linksProffieOSProffieBoardTeensySaber wiki on GitHubAsk your question on The Rebel Armory forumsAsk your question on FX-sabers forumsAsk your question in facebook group

How to solve most common issues

Quick troubleshooting tips

TeensySaber board or Proffieboard is not recognized by computer (nothing under Port selection in Arduino)

ndash Make sure a charged 37V battery is connected to the board micro-USB cable is a data transfer cable all plugins and drivers are installed ndash

check again pages 21 for TeensySaber or 40 for Proffieboard Try a different USB port on your computer

Sketch (code) compile error in Arduino IDE

ndash Check your define CONFIG_FILE ldquoconfig_confighrdquo line in opened lightsaberino file if itrsquos written correctly with config in it

Sketch (code) compile error in Arduino IDE

ndash Check if the _configh file you defined in the lightsaberino sketch file is same name as in the lightsaber-rdquofirmware versionrdquolightsaber

config folder and is located in this folder

Sketch (code) compile error in Arduino IDE

ndash Check your settings under Tools tab in Arduino IDE program Check again pages 21 for TeensySaber or 40 for Proffieboard

Sketch (code) compile error in Arduino IDE

ndash Check if your _configh file is correct Blade Styles Presets const unsigned int maxLedsPerStrip = 144 if BladeConfig blades[] = is correct

Sketch (code) compile error in Arduino IDE

ndash If nothing helps install Arduino IDE version 186 and try to compile and upload the firmware again

Sound doesnrsquot play

ndash Remove SD card and insert again check speaker wiring Make sure all sound files on SD card are correctly named (8 characters max long)

Re-format SD card in FAT32 load sound files and try again try another SD card

Board says ldquoLOW POWERrdquo

ndash Charge the battery

Serial Monitor shows info sent by the board but your commands donrsquot work

ndash In the bottom right corner of Serial Monitor window make sure the Line Ending drop down is set to New Line

Sound is weird and distorted

ndash Check your SD card speed (see page 44) Check speaker wiring try another good speaker

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 47

RECHARGE PORTS AND KILL SWITCHES

48 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

NEOPIXEL STRIPS CURRENT DRAW

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 49

6TROUBLESHOOTING

For more help please check these linksProffieOSProffieBoardTeensySaber wiki on GitHubAsk your question on The Rebel Armory forumsAsk your question on FX-sabers forumsAsk your question in facebook group

How to solve most common issues

Quick troubleshooting tips

TeensySaber board or Proffieboard is not recognized by computer (nothing under Port selection in Arduino)

ndash Make sure a charged 37V battery is connected to the board micro-USB cable is a data transfer cable all plugins and drivers are installed ndash

check again pages 21 for TeensySaber or 40 for Proffieboard Try a different USB port on your computer

Sketch (code) compile error in Arduino IDE

ndash Check your define CONFIG_FILE ldquoconfig_confighrdquo line in opened lightsaberino file if itrsquos written correctly with config in it

Sketch (code) compile error in Arduino IDE

ndash Check if the _configh file you defined in the lightsaberino sketch file is same name as in the lightsaber-rdquofirmware versionrdquolightsaber

config folder and is located in this folder

Sketch (code) compile error in Arduino IDE

ndash Check your settings under Tools tab in Arduino IDE program Check again pages 21 for TeensySaber or 40 for Proffieboard

Sketch (code) compile error in Arduino IDE

ndash Check if your _configh file is correct Blade Styles Presets const unsigned int maxLedsPerStrip = 144 if BladeConfig blades[] = is correct

Sketch (code) compile error in Arduino IDE

ndash If nothing helps install Arduino IDE version 186 and try to compile and upload the firmware again

Sound doesnrsquot play

ndash Remove SD card and insert again check speaker wiring Make sure all sound files on SD card are correctly named (8 characters max long)

Re-format SD card in FAT32 load sound files and try again try another SD card

Board says ldquoLOW POWERrdquo

ndash Charge the battery

Serial Monitor shows info sent by the board but your commands donrsquot work

ndash In the bottom right corner of Serial Monitor window make sure the Line Ending drop down is set to New Line

Sound is weird and distorted

ndash Check your SD card speed (see page 44) Check speaker wiring try another good speaker

48 | ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok

NEOPIXEL STRIPS CURRENT DRAW

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 49

6TROUBLESHOOTING

For more help please check these linksProffieOSProffieBoardTeensySaber wiki on GitHubAsk your question on The Rebel Armory forumsAsk your question on FX-sabers forumsAsk your question in facebook group

How to solve most common issues

Quick troubleshooting tips

TeensySaber board or Proffieboard is not recognized by computer (nothing under Port selection in Arduino)

ndash Make sure a charged 37V battery is connected to the board micro-USB cable is a data transfer cable all plugins and drivers are installed ndash

check again pages 21 for TeensySaber or 40 for Proffieboard Try a different USB port on your computer

Sketch (code) compile error in Arduino IDE

ndash Check your define CONFIG_FILE ldquoconfig_confighrdquo line in opened lightsaberino file if itrsquos written correctly with config in it

Sketch (code) compile error in Arduino IDE

ndash Check if the _configh file you defined in the lightsaberino sketch file is same name as in the lightsaber-rdquofirmware versionrdquolightsaber

config folder and is located in this folder

Sketch (code) compile error in Arduino IDE

ndash Check your settings under Tools tab in Arduino IDE program Check again pages 21 for TeensySaber or 40 for Proffieboard

Sketch (code) compile error in Arduino IDE

ndash Check if your _configh file is correct Blade Styles Presets const unsigned int maxLedsPerStrip = 144 if BladeConfig blades[] = is correct

Sketch (code) compile error in Arduino IDE

ndash If nothing helps install Arduino IDE version 186 and try to compile and upload the firmware again

Sound doesnrsquot play

ndash Remove SD card and insert again check speaker wiring Make sure all sound files on SD card are correctly named (8 characters max long)

Re-format SD card in FAT32 load sound files and try again try another SD card

Board says ldquoLOW POWERrdquo

ndash Charge the battery

Serial Monitor shows info sent by the board but your commands donrsquot work

ndash In the bottom right corner of Serial Monitor window make sure the Line Ending drop down is set to New Line

Sound is weird and distorted

ndash Check your SD card speed (see page 44) Check speaker wiring try another good speaker

ProffieBoardTeensySaber user manual by Fredrik Hubinette and Dmitry Shtok | 49

6TROUBLESHOOTING

For more help please check these linksProffieOSProffieBoardTeensySaber wiki on GitHubAsk your question on The Rebel Armory forumsAsk your question on FX-sabers forumsAsk your question in facebook group

How to solve most common issues

Quick troubleshooting tips

TeensySaber board or Proffieboard is not recognized by computer (nothing under Port selection in Arduino)

ndash Make sure a charged 37V battery is connected to the board micro-USB cable is a data transfer cable all plugins and drivers are installed ndash

check again pages 21 for TeensySaber or 40 for Proffieboard Try a different USB port on your computer

Sketch (code) compile error in Arduino IDE

ndash Check your define CONFIG_FILE ldquoconfig_confighrdquo line in opened lightsaberino file if itrsquos written correctly with config in it

Sketch (code) compile error in Arduino IDE

ndash Check if the _configh file you defined in the lightsaberino sketch file is same name as in the lightsaber-rdquofirmware versionrdquolightsaber

config folder and is located in this folder

Sketch (code) compile error in Arduino IDE

ndash Check your settings under Tools tab in Arduino IDE program Check again pages 21 for TeensySaber or 40 for Proffieboard

Sketch (code) compile error in Arduino IDE

ndash Check if your _configh file is correct Blade Styles Presets const unsigned int maxLedsPerStrip = 144 if BladeConfig blades[] = is correct

Sketch (code) compile error in Arduino IDE

ndash If nothing helps install Arduino IDE version 186 and try to compile and upload the firmware again

Sound doesnrsquot play

ndash Remove SD card and insert again check speaker wiring Make sure all sound files on SD card are correctly named (8 characters max long)

Re-format SD card in FAT32 load sound files and try again try another SD card

Board says ldquoLOW POWERrdquo

ndash Charge the battery

Serial Monitor shows info sent by the board but your commands donrsquot work

ndash In the bottom right corner of Serial Monitor window make sure the Line Ending drop down is set to New Line

Sound is weird and distorted

ndash Check your SD card speed (see page 44) Check speaker wiring try another good speaker