SaberTec Golden Harvest v3 Manual
Hide thumbs Also See for Golden Harvest v3:
Table of Contents

Advertisement

Quick Links

SaberTec
Contact: info@sabertec.net
Owner: Frederic Folz
Website: https://sabertec.net
Brentanoweg 3
66802 Überherrn
GERMANY

Advertisement

Table of Contents
loading

Summary of Contents for SaberTec Golden Harvest v3

  • Page 1 SaberTec Contact: info@sabertec.net Owner: Frederic Folz Website: https://sabertec.net Brentanoweg 3 66802 Überherrn GERMANY...
  • Page 2 SaberTec with the goal to develop a soundboard that can provide the most impressive and realistic saber experience imaginable – four years of hard work later the Golden Harvest v3 was born. Our company’s fundamental philosophy is to closely include you, the community, into everything we do –...
  • Page 3 We cannot be held responsible for any damage that arises from a faulty install or use of the board. Furthermore, be cautious when using the Golden Harvest v3 if you have photosensitive epilepsy or if you are photosensitive in general because the light effects can contain a series of flashing lights.
  • Page 4: Table Of Contents

    Content Features of the Golden Harvest v3 ......................7 Technical Specifications........................7 Installation and Use ..........................7 Audio Engine ............................7 Motion Detection ..........................9 Light Effects ............................9 Firmware Updates ..........................11 USB Charging and File Transfer ......................11 Evolution of the Board ..........................
  • Page 5 Gradient ............................61 Focus Deflection ..........................62 Thunder Storm ..........................65 Kylo Blade ............................69 Unstable Blade ..........................70 Magnetic Flare ..........................72 Shockwave ............................. 73 Responsive Lockup ........................77 Responsive Drag ..........................77 Responsive swing effects for Neopixel ..................78 Preon and postoff light effects for Neopixel .................
  • Page 6 Sound Fonts ............................98 Sound Font Settings File ........................99 Default Sound Font Package ......................102 Sound File Requirements ........................ 103 Background Music ........................... 104 Common Folder ..........................104 Sound menu ............................ 104 Two momentary buttons ......................104 One momentary button ......................105 Pairing of sound fonts with blade profiles, color profiles, on top effects and accent profiles ..
  • Page 7: Features Of The Golden Harvest V3

    Features of the Golden Harvest v3 Technical Specifications ➢ tiny dimensions of 28.5 mm x 18.5 mm x 3.7 mm / 1.12 ” x 0.73 ” x 0.15 ” ➢ powered by 3.7 V (single 18650 Li-ion cell for example) ➢...
  • Page 8 o unlimited lockup sounds o unlimited end lockup sounds o unlimited begin melt sounds o unlimited melt sounds o unlimited end melt sounds o unlimited begin drag sounds o unlimited drag sounds o unlimited end drag sounds o unlimited blaster sounds o unlimited force sounds o unlimited boot sounds o unlimited pre-on sounds...
  • Page 9: Motion Detection

    Golden Harvest board remembers with which blade style a sound font was lastly used default blade styles and manual available on https://sabertec.net/downloads ➢ in-hilt LED effects: o overwhelming light effect engine...
  • Page 10 o configurable effect duration o independent basic effects o independent clash effects o independent stab effects o independent swing effects o independent spin effects o independent lockup effects o independent melt effects o independent blaster effects o independent force effects o as there are more than 600 parameters, you can literally invent your own light effects o assuming there are 1000 possible values for each parameter (which is a hard under-...
  • Page 11: Firmware Updates

    ▪ Shockwave o configurable fade out o configurable effect transition: ▪ configurable transition time ▪ configurable transition type: • Basic • Window • Unstable Blade • Flame Blade o configurable effect duration o localized clash o localized lockup o localized drag o localized melt o localized blaster block o independent basic effects...
  • Page 12: Evolution Of The Board

    ➢ smaller than 11 mm x 19 mm / 0.433" x 0.748" Evolution of the Board Since its first release, several minor hardware changes of the Golden Harvest v3 have been implemented. The different hardware iterations of the board are labelled as phase 1, 2, 3 and 4. Each of these boards is capable of using the very same firmware.
  • Page 13: Wiring Of The Board

    Phase 3 Phase 4 Changes introduced by phase 2: - Decreased wait time when disconnecting and connecting the battery. - Batt. + pad on the top side instead of on the back side. Changes introduced by phase 3: - Wait time when disconnecting and connecting the battery completely removed. - Part in the upper left corner of the top side of the board replaced by a protected one to make it more robust against mistakes during install.
  • Page 14 If you decide to use only two LED channels for the blade for example, you can use the remaining LED channels to drive a switch LED or crystal chamber LEDs for example. As each LED channel provides up to 9 A, you could even connect up to 450 accent LEDs in parallel to each LED channel (assuming they need 20 mA each).
  • Page 15: Power Rating And Polarity Of Led Channels

    Soldering Advice The pads of the Golden Harvest v3 were designed to be as big as possible in order to make the soldering process as easy as possible. Compared to the other pads, the pad "Batt. -" has an even higher electrical and thermal conductivity.
  • Page 16: Handling Advice

    When soldering the board, make sure to do so while the board is not powered. That means solder the battery only in the very last step or use a kill key to keep it disconnected while soldering. Also, it is recommended to use the rectangular pads on the top side of the board instead of the circular ones on the back side because those on the top side are stronger.
  • Page 17 In the following, the wiring diagrams for different LED setups are shown. For in-hilt setups, the resistors can be added either to the positive or the negative of the LEDs. Single color blade with separate clash color The wiring of an in-hilt LED as single color blade with separate clash color is shown below. The wiring of an in-hilt RGB LED is shown below.
  • Page 18 RGBW The wiring of an in-hilt RGBW LED is shown below. Pixel strips without Pixel accents The wiring of a Pixel strip is shown below (commonly known as Neopixel™ which is a trademark of Adafruit™ with whom we are not affiliated). There is already a 470 Ohm data line resistor on the board so that you don’t need to add one.
  • Page 19 Pixel strips with Pixel accents The wiring of a Pixel strip with Pixel accents is shown below. There is already a 470 Ohm data line resistor on the board so that you don’t need to add one. If your blade is pre-resistored, this will not affect the functionality.
  • Page 20: Battery Recommendation

    There are even more customizable parameters in the "general.txt" of course, but to configure your Golden Harvest v3 for your hardware setup, only these three parameters need to be adjusted. You can also adjust the parameter "number_of_leds" on the fly using the Saber Editor.
  • Page 21: Choosing Your Light Effects

    Folder Structure on microSD Card The Golden Harvest v3 comes with a microSD card containing the default package. In the picture below, you can see the folder structure of the microSD card. Let’s go through it from top to bottom. The first folder is the "EffectFonts"...
  • Page 22: Hibernation Mode

    General Settings The general settings of your Golden Harvest v3 board can be found in the "general.txt" file on your microSD card. When the board boots, it loads all the parameters that are contained in this file. The parameters define the behavior of your board.
  • Page 25 PARAMETER DESCRIPTION volume Defines the maximum possible volume of your saber. Ranges from 0 (mute) to 400 (maximum loudness). Recommended value of 100. Please check if your speaker can handle such a high volume when increasing the volume to higher values than 100. We cannot be held responsible for any speaker damage that results from overpowering them.
  • Page 26 that also allows to customize the twist retraction. Otherwise the twist retraction will be customized in the "settings.txt". twist_protection The twist retraction is blocked if the movement of the saber is stronger than this parameter. This avoids that the saber accidentally turns off during movement. preon Defines how preon sounds and light effects are triggered.
  • Page 27 volume_control_twist_speed Defines the sensitivity of the volume control to twisting the saber. color_profile_edit_mode See section "Saber Editor". color_profile_tilt_speed See section "Saber Editor". color_profile_twist_speed See section "Saber Editor". pixel_number_edit_mode See section "Saber Editor". pixel_number_twist_speed See section "Saber Editor". ignition_speed_edit_mode See section "Saber Editor". ignition_speed_twist_speed See section "Saber Editor".
  • Page 28 motion. The twist motion is used by some button layouts described in the section "Menu navigation" instead of a double tap. The lower this value, the more sensitive your twist detection is. swing_cooldown Defines how long no other swing can be triggered after a swing has been detected.
  • Page 29: Blade Styles

    – due to the great variety of our settings, you can realize almost every effect you can imagine and literally even invent own ones. On the Golden Harvest v3, you can use more than 600 parameters for in-hilt setups and several thousands for Neopixel setups which are customizable by using our online configurator.
  • Page 30 Each blade style defines particular light effects and colors of your saber. As there are some differences between blade styles for in-hilt and blade styles for Neopixel, we will discuss their structure separately in the following. The structure of the blade styles for in-hilt is shown in the picture below. Each blade style comprises an "effect1.txt"...
  • Page 31: In-Hilt

    It shows an animation of how your saber would look like using these parameter values. A more detailed description of our configurator you can find on https://sabertec.net/downloads. The support of Neopixel is currently on the way. Our configurator will be accessible on our website soon.
  • Page 32 are driven and thus the color of the blade. Its values range from 0 to 1023 for each channel. A value of 0 means that the respective LED channel provides no power, whereas a value of 1023 means that the respective LED channel provides the maximum power.
  • Page 33 In the "effect1.txt" file, you can define whether an LED channel drives a blade LED or an accent LED and whether one of the LED channels should display a delayed ignition (the latter is not active yet). One of the fascinating features of our board is that the accent channels are not different from the blade channels with respect to the customizability of the light effects.
  • Page 34 example, you should choose "accent=0,0,0,1". The only difference between blade channels and accent channels is that the latter are already powered when the kill key is pulled, but the saber is not ignited yet. flicker_min_intensity, Define the minimum and maximum flicker intensity (see description above). flicker_max_intensity The actual flicker intensity varies randomly over time within the interval between these two values.
  • Page 35 the minimum and maximum flicker duration are 1. This means that every power drop has duration 1. The other channels are treated analogously. The picture above is a screenshot from our online configurator and illustrates meaning both "flicker_min_duration" "flicker_max_duration" parameter. It shows the change of the LED power over time using a flicker effect with the same duration parameters as in channel 1 in the previous example.
  • Page 36 The picture above is a screenshot from our online configurator and illustrates the meaning of both the "flicker_min_delay" and the "flicker_max_delay" parameter. It shows the change of the LED power over time using a flicker effect with the same delay parameters as in channel 1 in the previous example. As you can see, the delay between two successive drops in the LED power varies randomly within the interval between the minimum and maximum flicker delay, i.e.
  • Page 37 The picture above is a screenshot from our online configurator and illustrates the meaning of the "flicker_period" parameter. It shows the change of the LED power over time using a flicker effect with the same "flicker period" parameter value as in channel 1 in the previous example. As you can see, the depth of each drop in the LED power varies randomly within the interval between the flicker minimum and maximum intensity, whereby the latter changes periodically between the parameter values "flicker_min_intensity"...
  • Page 38 subtractive type (0) additive type (1) mixed type (2) The pictures above are screenshots from our online configurator and illustrate the meaning of the "flicker type" parameter. It shows the change of the LED power over time using a subtractive, additive or mixed flicker effect, respectively.
  • Page 39 In the following, we give a list of all the parameters of the pulse part and a short description. Similarly to the flicker part, the parameters are marked by different colors. These indicate whether they’re for users who only want to change a few parameters (black) or for more advanced users who want to unleash the full-blown effect engine (green).
  • Page 40 picture below). You can change this behavior by adjusting the parameter "pulse_intensity_phase_shift". By changing its value, you can shift the transition such that the pulse begins with its minimum intensity instead of its maximum intensity for example. Each LED channel has its own value. Example: pulse_intensity_change_period=600,0,1000,0 pulse_intensity_phase_shift=0,0,180,0...
  • Page 41 value. LED channel 2 shows a pulse with a period that changes back and forth within the interval between 100 and 1000. Thus, you get a pulse that periodically decreases and increases its speed. This can create an amazing look as it simulates a blade that undergoes a transition between a calm and an aggressive phase.
  • Page 42 Example: pulse_shape=0,1,0,0 In this case, the pulse effect in LED channel 1 creates sine shaped periodic, smooth drops in the LED power. LED channel 2 shows a pulse effect that creates impulse shaped periodic, smooth drops in the LED power. The other LED channels are treated analogously. sine shape (0) rectangular shape (5) impulse shape (1)
  • Page 43 there are two more parameters each in comparison to the basic state: effect duration and fade out. Let’s have a look at the clash state for example. All the clash parameters are shown below. As you can see, you have the same degree of customizability just as in the basic state, whereby the parameters here have the additional prefix "cl_"...
  • Page 44: Neopixel

    maintain very long which could simulate a blade that is strongly affected by the clash and takes a long time to stabilize again. Here, you have again the full freedom in designing your very own, unique light effects as you could also choose values of 70 % for example or any other value within the respective range.
  • Page 45 In this file, you can find the parameters that describe the background effect. Comments are indicated by hashtags and are ignored by the board when reading out the parameters contained in the file. Below the headline "Background Effect" there is a headline describing which background effect was chosen in the respective state.
  • Page 46 comparison to the basic state. These parameters customize the fading of the light effects of these states back to the light effects of the basic state. Let’s have a look at the clash state for example. All the clash parameters are shown below.
  • Page 47 As you can see, you have the same degree of customizability just as in the basic state, whereby the parameters here have the additional prefix "cl_" which indicates that they belong to the clash state. In addition to these settings you also have the parameters "cl_duration" and "cl_fade_out" among other parameters.
  • Page 48 and lets the basic light effects shine through more and more. This section customized parameters "cl_size", "cl_min_position", "cl_max_position" and "cl_smooth". Hereby, the parameter "cl_size" defines the size of the section of the blade that displays the clash light effects. The value are given as number of LEDs. The position of the section of the blade that displays the clash light effects varies...
  • Page 49 - cl_fade_out_type=11: During the fading, the section of the blade that displays the clash light effects moves up and down the blade and lets the basic light effects shine through more and more. There is also the parameter "cl_speed" which needs to be used together with "cl_fade_out_type=0" and a localized impact.
  • Page 50 PARAMETER DESCRIPTION ig_stuttering Defines whether or not the stuttering ignition effect should be used. A value of 0 disables this ignition effect and a value of 1 enables it. If it is enabled, additional ignition effects that may be set in the "Fading" section are ignored.
  • Page 51 parameter defines the aggressivity of the flash at the bottom of the blade when it is ignited. Example: ig_base_flash_rand=70 In this case, the aggressivity of the flash at the bottom of the blade is 70. ig_base_flash_duration the bottom of the blade is 70.ig_base_flash_duration The base factivated, it creates a white flash at the bottom of the blade when it is ignited that simulates an explosive ignition.
  • Page 52: Classic

    In the following, we will describe all the different background effects and on top effects. Let’s first consider the background effects. There are 6 different effect categories: Classic, Color Flow, Frozen Pulse, Wave, Flame Blade and Gradient. All of them will be described in detail in the next sections. Classic The background effect Classic basically extends the light effects of the In-Hilt RGB setup to Neopixel.
  • Page 53 color_flow_color2 Defines the second color of the color sequence in RGB code. When your saber is ignited and a Color Flow effect is active, this is the second color that will emerge from the lower end of your blade and move to its tip. Example: color_flow_color2=0,255,0 In this case, the first color of the color sequence is green which is given by...
  • Page 54: Frozen Pulse

    color_flow_fading Defines how smooth the transition between two successive color sections of the color sequence is. This parameter takes six different values. The first value describes the smoothness of the transition from the first to the second color section of the color sequence, the second value describes the smoothness of the transition from the second to the third color section of the color sequence and so on.
  • Page 55 frzn_pls_color=0,1,2 In this case, the first effect channel is assigned to red, the second is assigned to blue and the third is assigned to green. frzn_pls_shape Defines the spatial structure of the pattern on your blade. A value of 0 creates a sine pattern, a value of 1 creates an impulse pattern, a value of 2 creates an inverted impulse pattern, a value of 3 creates a rising sawtooth pattern, a value of 4 creates a falling sawtooth pattern, a value of 5 creates a triangle pattern and a...
  • Page 56: Wave

    defines the minimum density of the spatial pattern of each effect channel. Example: frzn_pls_min_dens=20,20,100 In this case, the first effect channel has a minimum density of 20, the second has a minimum density of 20 and the third has a minimum density of 100.
  • Page 57 PARAMETER DESCRIPTION wave_led Defines the background intensity of each effect channel. This is the intensity that would be displayed when no wave would propagate along the blade. The wave pattern digs into this background intensity. Example: wave_led=255,0,0 In this case, the background intensity of the first effect channel is 255, the background intensity of the second effect channel is 0 and the background intensity of the third effect channel is 0.
  • Page 58 wave_max_intensity Defines the maximum depth of each effect channel by which the wave digs into the background intensity. Example: wave_max_intensity=255,0,0 In this case, the maximum depth of the first effect channel by which the wave digs into the background intensity is 255, the maximum depth of the second effect channel by which the wave digs into the background intensity is 0 and the maximum depth of the third effect channel by which the wave digs into the...
  • Page 59 wave_modulation_period The period of each effect channel at which the waves are generated at the lower end of your blade alternates between "wave_min_period" and "wave_max_period" over time. This parameter defines the time needed for a transition between "wave_min_period " and "wave_max_period" to take place. Example: wave_modulation_period=1000,2000,2000 In this case, the modulation period of the first effect channel is...
  • Page 60: Flame Blade

    In this case, the speed at which the waves are generated can be changed by tilting the saber. wave_sauron See the section "Sauron mode". wave_sauron_size See the section "Sauron mode". wave_sauron_spark See the section "Sauron mode". Flame Blade The background effect Flame Blade lets your blade look like a flame that evolves over time as new sparks of the fire ignite at the lower end of your blade.
  • Page 61: Gradient

    Example: flame_blade_cooling=40 In this case, the cooling of the flame is 40. flame_blade_fueling Defines how strongly the flame is fueled. Higher values lead to more roaring flames. Example: flame_blade_fueling=50 In this case, the fueling of the flame is 50. flame_responsive Defines if the effect reacts to gestures in real-time by changing the aggressivity of the flame.
  • Page 62: Focus Deflection

    RGB value (0, 0, 255). Now, let’s have a look at the on top effects of the Golden Harvest v3 for Neopixel setup. There are 6 different categories: Focus Deflection, Thunderstorm, Kylo Blade, Unstable Blade, Magnetic Flare and Shockwave.
  • Page 63 creates an impulse movement, a value of 2 creates an inverted impulse movement, a value of 3 creates a rising sawtooth movement, a value of 4 creates a falling sawtooth movement, a value of 5 creates a triangle movement and a value of 6 creates a rectangle movement.
  • Page 64 focus_defl_spark_int Defines the intensity of the sparkling of the focus point. This parameter takes values between 0 and 255. Example: focus_defl_spark_int=255,100,100 In this case, the first effect channel displays a focus point with sparkling intensity of 255, the second displays a focus point with sparkling intensity of 100 and the third displays a focus point with sparkling intensity of 100.
  • Page 65: Thunder Storm

    Example: focus_defl_range_change_period=1000,5000,10000 In this case, the first effect channel displays a focus point whose range of movement changes with a period of 1000, the second displays a focus point whose range of movement changes with a period of 5000 and the third displays a focus point whose range of movement changes with a period of 10000.
  • Page 66 PARAMETER DESCRIPTION thnd_strm_color1 All the parameters of the Thunder Storm effect take three values. The first values of all parameters belong to the same effect channel as do the second and third values. This parameter defines the color of the first effect channel. The effect channels can be customized independently from each other.
  • Page 67 Example: thnd_strm_max_intensity=100,50,50 In this case, the first effect channel displays lightnings with a maximum intensity of 100, the second effect channel displays lightnings with a maximum intensity of 50 and the third effect channel displays lightnings with a maximum intensity of 50. thnd_strm_swarm_min_dur Defines the minimum duration of the lightnings within a swarm of each effect channel.
  • Page 68 swarm and the third effect channel displays lightnings with a maximum delay of 50 between successive lightnings within a swarm. thnd_strm_swarm_min_number Defines the minimum number of lightnings within a swarm of each effect channel. Example: thnd_strm_swarm_min_number=1,10,10 In this case, the first effect channel displays lightnings with a minimum number of 1 lightning within a swarm, the second effect channel displays lightnings with a minimum number of 10 lightnings within a swarm and the third effect channel...
  • Page 69: Kylo Blade

    lightnings with a maximum delay of 50 between successive swarms. Kylo Blade The on top effect Kylo Blade gives your blade a grained structure that alters the underlying background effect. PARAMETER DESCRIPTION kylo_blade_strength Defines how strong the structure of the background effect is altered.
  • Page 70: Unstable Blade

    Unstable Blade The on top effect Unstable Blade gives your blade an unstable structure that alters the underlying background effect by a spatially distributed, random intensity drops. PARAMETER DESCRIPTION unst_blade_color All the parameters of the Unstable Blade effect take three values. The first values of all parameters belong to the same effect channel as do the second and third values.
  • Page 71 unst_blade_type There are three different variations of the effect. This parameter defines which type of each effect channel is active. This parameter takes values between 0 and 2. Example: unst_blade_type=0,0,2 In this case, the first effect channel is of type 0, the second effect channel is of type 0 and the third effect channel is of type 2.
  • Page 72: Magnetic Flare

    unst_blade_cooling=100, 100, 100 In this case, the cooling of the first effect channel is 100, the cooling of the second effect channel is 100 and the cooling of the third effect channel is 100. Magnetic Flare The on top effect Magnetic Flare gives your blade a regular, pulsating spatial pattern that alters the underlying background effect.
  • Page 73: Shockwave

    Shockwave The on top effect Shockwave gives your blade a fluid structure by creating spatial waves on the underlying background effect. PARAMETER DESCRIPTION shockwave_color All the parameters of the Shockwave effect take three values. The first values of all parameters belong to the same effect channel as do the second and third values.
  • Page 74 shockwave_sync The three different effect channels can be synchronized with respect to which color component of the background effect they affect. This parameter defines if an effect channel should affect the same color component of the background effect as the first effect channel. Example: shockwave_sync=1,1,1 In this case, the three different effect channels affect the...
  • Page 75 parameter takes values between 0 and 100. The values are given as percentage of the whole blade length. Example: shockwave_min_pos=0,0,0 In this case, the minimum position of the intensity drops that generate the spatial waves of the first effect channel is 0, the minimum position of the intensity drops that generate the spatial waves of the second effect channel is 0 and the minimum position of the intensity drops that generate the...
  • Page 76 shockwave_min_del=100,200,500 In this case, the minimum delay between successive intensity drops that generate the spatial waves of the first effect channel is 100, the minimum delay between successive intensity drops that generate the spatial waves of the second effect channel is 200 and the minimum delay between successive intensity drops that generate the spatial waves of the third effect channel is 500.
  • Page 77: Responsive Lockup

    twisting the saber and a value of 6 corresponds to moving the dark spot both by tilting and twisting the saber. The same parameters are available for the Wave effect and the Color Flow effect. Responsive Lockup For the lockup effect, you can decide on your own if the lockup location is chosen randomly or affected by gestures in real time.
  • Page 78: Responsive Swing Effects For Neopixel

    - me_responsive=1: The area of the tip that simulates the melting and its color are changed by tilting the saber. - me_responsive=2: The area of the tip that simulates the melting and its color are changed by twisting the saber. - me_responsive=3: The area of the tip that simulates the melting and its color are changed both by tilting the saber and by twisting it.
  • Page 79: Preon And Postoff Light Effects For Neopixel

    - sw_max_threshold=15000: Swing speed at which the blending of the basic blade color and the basic blade light effects with the swing color and the swing light effects ends. Above this swing speed, the blade only displays the swing color and the swing light effects.
  • Page 80: Color Menu

    light effects will use the same effects as when the saber is in the basic state, i.e. after the ignition. - postoff_effect_intensity=10: Defines the intensity of the postoff light effects. Color menu The color menu can be trigerred by holding the power button and then tapping it. In the color menu, you can cycle through all preset color profiles by slowly twisting the saber.
  • Page 81: Two Momentary Buttons

    Two momentary buttons Let’s first come to the two momentary buttons setup. The effect menu can be trigerred by holding the power button and then holding it again. Point the saber upwards while doing this. In the effect menu, you can cycle through the blade profiles and the on top effects.
  • Page 82: Accent Profiles

    - effect_menu=0: The effect menu is disabled. - effect_menu=1: When in the effect menu, you can cycle through the different blade profiles by slowly twisting the saber. Hereby, twisting clockwise goes to the next blade profile and twisting counter clockwise goes to the previous blade profile.
  • Page 83 4 in the accent fonts are mapped to the pads LED5, LED6, LED7 and LED8 and the accent LED 5 in the accent profiles is mapped to the pad LED9 of the Golden Harvest v3. Let’s first have a look at the section for the accent LEDs 1 - 4 which is shown in the picture below.
  • Page 84 PARAMETER DESCRIPTION a1_color1 This parameter is only active for Neopixel accent LEDs. It defines the color of the first of the up to 8 Neopixel accent LEDs. Example: a1_color1=255,0,0 In this case, the color of the first of the up to 8 Neopixel accent LEDs is red.
  • Page 85 In this case, the color of the second of the up to 8 Neopixel accent LEDs is green. a1_color3 This parameter is only active for Neopixel accent LEDs. It defines the color of the third of the up to 8 Neopixel accent LEDs.
  • Page 86 PARAMETER DESCRIPTION a2_color1 This parameter is only active for Neopixel accent LEDs. It defines the color of the fifth of the up to 8 Neopixel accent LEDs. Example: a2_color1=255,0,0 In this case, the color of the fifth of the up to 8 Neopixel accent LEDs is red.
  • Page 87 a2_color3 This parameter is only active for Neopixel accent LEDs. It defines the color of the seventh of the up to 8 Neopixel accent LEDs. Example: a2_color3=0,0,255 In this case, the color of the seventh of the up to 8 Neopixel accent LEDs is blue.
  • Page 88 PARAMETER DESCRIPTION ac_mirror_blade Defines if the Neopixel accents mirror the blade. The parameter takes 8 values corresponding to the different Neopixel accents. A value of 1 enables the blade mirror feature and a value of 0 disables it. ac_sequence1 - ac_sequence16 These parameters define the actual sequence in which the accent LEDs 1 - 8 are turned on and off.
  • Page 89 ac_on_time1 - ac_on_time4 These parameters define the duration of each of the steps defined parameters "ac_sequence1" "ac_sequence16". The duration of the steps 1 - 4 of the sequence is given by the four values the parameter "ac_on_time1" takes, the duration of the steps 5 - 8 of the sequence is given by the four values the parameter "ac_on_time2"...
  • Page 90: Blade Matching Rgb Switch Led For Neopixel

    - accent_menu=1: The accent menu is enabled. Battery Indicator The Golden Harvest v3 features a battery indicator that can be triggered before the saber is ignited. This feature performs a measurement of the battery voltage and tells you acoustically how much charge is left.
  • Page 91: Volume Control

    - accent_battery_indicator=1: The charging indicator feature is enabled. Volume Control The Golden Harvest v3 features a volume control on the fly. After entering the volume control mode, this feature allows to change the volume of the saber by gestures. You can customize the volume control to change volume by tilting the saber, by twisting it or by both tilting and twisting it.
  • Page 92: Color Profile Edit Mode

    The parameters that you change in the saber editor are saved in the new "override-general.txt" file or the new "override-settings.txt" file. The parameters in these files will override the parameters in the "general.txt" and the "settings.txt". Thus, you can go back to default by deleting the override files.
  • Page 93: Pixel Number Edit Mode

    Pixel number edit mode The pixel number edit mode allows to adjust the number of pixels the board uses to match the number of pixels in your blade. After you entered the pixel number edit mode, a white spot on the blade indicates the number of pixels.
  • Page 94: Retraction Speed Edit Mode

    Retraction speed edit mode The retraction speed edit mode allows to adjust the retraction speed individually for each sound font. After you entered the retraction speed edit mode, you need to choose the sound font for which you want to adjust the retraction speed by slowly twisting your saber. If you twist it clockwise, you will go to the next sound font and if you twist it counter clockwise, you will go to the previous sound font.
  • Page 95: Effect Font Slot Edit Mode

    mode. The gesture controls edit mode is controlled by two parameters in the "general.txt". In the following, these parameters are described: - gesture_controls_edit_mode=0: A value of 1 enables the gesture controls edit mode and a value of 0 disables it. - gesture_controls_twist_speed=100: Defines the sensitvity of twisting the saber.
  • Page 96: Blaster Block For Two Momentary Buttons Setups

    Blaster block for two momentary buttons setups For two momentary buttons setups, there are two different options to trigger a blaster block available. It is possible to trigger a blaster block by tapping the auxiliary button or by swinging the saber after entering the MultiBlast mode by tapping the auxiliary button.
  • Page 97: Lockup For One Momentary Button Setups

    force_push=0: A force push is triggered by tapping the power button. force_push=1: A force push is triggered by swinging the saber while holding the auxiliary button. force_push_threshold=1: This parameter defines how strong you have to swing the saber to trigger a force push if you have chosen to trigger a force push by swinging the saber while holding the auxiliary button.
  • Page 98: Sound Fonts

    The different lockup modes for two momentary buttons setups are described in the following video: https://www.youtube.com/watch?v=P8-haIr4yl0 Sound Fonts Just as blade styles define the light effects of your saber, sound fonts define its sound effects. Each sound font contains a set of sound files for all effects our board supports. Thus, they contain swing sounds, clash sounds, stab sounds, spin sounds, lockup sounds, melt sounds, blaster block sounds, force push sounds, boot sounds, power sounds, menu sounds, hum sounds and many more.
  • Page 99: Sound Font Settings File

    Sound Font Settings File All sound fonts can be customized using a "settings.txt" file. The parameters contained in this file define the behavior of the Smooth Swing algorithm and allow to adjust the ignition and retraction speed of your blade. The parameters are shown in the picture below. PARAMETER DESCRIPTION motion_theshold...
  • Page 100 accent_swing_threshold Defines the minimum rotation speed of your saber required to trigger an accent swing. The lower this value, the more sensitive your accent swing detection is. accent_spin_threshold Defines the minimum rotation speed of your saber required to trigger an accent spin. The lower this value, the more sensitive your accent spin detection is.
  • Page 101 increases with the rotation speed of the saber from "tremolo_min_frequency" to "tremolo_max_frequency". This parameter defines the maximum modulation frequency of the tremolo effect. tremolo_sharpness To enhance the smooth swing experience, the Golden Harvest v3 applies real-time audio effects to the smooth swing sounds.
  • Page 102: Default Sound Font Package

    Default Sound Font Package Our Golden Harvest v3 comes with 16 default sound fonts that are already saved on the microSD card. The default sound fonts are listed below (in chronological order). Thanks to all of the sound font designers! Without you, this project wouldn't have been possible! Please make sure to explore more of their great work.
  • Page 103: Sound File Requirements

    13. "Dark Harvest" by Blueforce Company: Check out more of the epic fonts by Blueforce Company on https://www.blueforcecompany.com/ https://www.youtube.com/channel/UCVSMLABlRYnb7uovd9MOBfw. 15. "The Classic Villain" by Fourzze FX: Check out more of the mind-blowing fonts by Fourzze FX on http://repulsecustomsounds.com. 15. "Energy Pike" by The Proplicator: Check out more of the amazing fonts by The Proplicator on http://www.saberfont.com/The- Proplicator_bymfg_33-0-1.html.
  • Page 104: Background Music

    To add background music to your microSD card, please make sure that the music file you want the Golden Harvest v3 to play is a wave file with 16 bit and 22,050 Hz or 44,100 Hz sampling rate. Furthermore, rename the music file to "track[number].wav", whereby [number] enumerates your track files.
  • Page 105: One Momentary Button

    button while pointing the saber upwards. To go to the previous sound font, tap the auxiliary button while pointing the saber downwards. If you want to jump forward by a number of sound fonts that is given by the parameter "sound_font_jump", tap the power button while pointing the saber upwards. If you want to jump backwards, tap the power button while pointing the saber downwards.
  • Page 106: Pairing Of Sound Fonts With Blade Profiles, Color Profiles, On Top Effects And Accent Profiles

    saber counter clockwise. To jump forward or backward by a number of sound fonts, you need to tap the button. - sound_menu=2: When in the sound menu, you need to slowly twist the saber to go to the next or the previous sound font. If you point the saber upwards while doing this, you go to the next sound font.
  • Page 107: Postoff Sounds

    Firmware Updates The set of features of the Golden Harvest v3 is always expanding. It can be extended by firmware updates which are easy to install without requiring any coding skills. You can either install it directly on the microSD card or using the Seedling Module if you do not want to remove the microSD card.
  • Page 108: Installing Directly On The Microsd Card

    USB file transfer. To enter the mass storage device mode, connect your Seedling Module via USB to your computer when your Golden Harvest v3 is in idle mode. That’s the state the saber is in after booting and before igniting the blade. If the board is in deep sleep, make sure to wake it up before.
  • Page 109: Menu Navigation

    before and during charging and never leave the saber unsupervised during charging. We cannot be held responsible for any damage inflicted by the batteries. Menu Navigation Navigation Using Two Momentary Buttons The two buttons are reffered to as auxiliary and power button according to the wiring examples above. This button mode can be selected by setting the parameter "button_mode=2"...
  • Page 110 ∟ Save And Leave Sound Font ∟ Hold the auxiliary button Menu Show Battery Indicator Hold the power button while performing a stab before the saber is ignited ∟ Calibrate Battery ∟ When your battery is fully charged, perform a stab while battery level is displayed Enter Volume Control Hold the auxiliary button before the blade is ignited.
  • Page 111: Navigation Using Only One Momentary Button

    ∟ Button and Clashing ∟ Slowly twist the saber clockwise ∟ Button ∟ Slowly twist the saber counterclockwise ∟ Save and Leave Editor Mode ∟ Hold the power button ∟ Gesture Controls ∟ Stab Ignition ∟Turn stab ignition on ∟ Slowly twist the saber clockwise ∟Turn stab ignition off ∟...
  • Page 112 ∟ Change Ignited Accent Profile* ∟ Tap the button ∟ Save And Leave Hold the button until the confirmation sound is played Enter Color Change Menu Hold the button, then tap it. Point the saber upwards while doing this. ∟ Cycle Through Preset Color ∟...
  • Page 113 ∟ Save and Leave Editor Mode ∟ Hold the button ∟ Pixel Number ∟ Edit Pixel Number ∟ Slowly twist the saber ∟ Save and Leave Editor Mode ∟ Hold the button ∟ Ignition Speed ∟ Select Sound Font ∟ Slowly twist the saber ∟...
  • Page 114: Frequently Asked Questions

    * When changing the On Top Effect, Background Effect or Sound Font, you can go to the next one by pointing your saber upwards during selection or to the previous one by pointing your saber downwards. Frequently Asked Questions My blade is blinking white and does not respond to any button taps. How can I fix that? Answer: The white blinking indicates that your microSD card is not inserted properly or some files or folders are missing on it.

Table of Contents