Page 1
Laser Harp MIDI controller The KB2D Interactive Device is a detection system working as a MIDI controller. It enables to send customizable MIDI messages just by touching / interacting with lasers, and can be used with any scanning laser projector system in order to create an interactive projection.
Page 2
➢ V IGH DETECTION RANGE WITH PROGRAMMABLE AMPLIFICATION FOR LONG DISTANCE INTERACTIVE SHOWS TYPICAL APPLICATIONS ➢ L ASER ➢ L ASER TRACKING ➢ I NTERACTIVE LASER SHOWS ➢ I NTERACTIVE GAMES Lightdiction SAS KB2D User Manual March 2022 rev 2.0...
HOW TO QUICKLY SET A LASER HARP SYSTEM ....................28 Install The KB2D User Interface ........................28 Place the KB2D ..............................28 Connect the KB2D and start the interface ...................... 28 Start your favorite DAW............................. 29 Select the notes you want ..........................29 Calibrate detection parameters ........................
(*) When interacting with a Lambertian white target with ~80% reflectance (1) With a 3W laser projector. Maximum is obtained using the x16 software amplification. (2) With a 20W laser projector. Maximum is obtained using the x16 software amplification. Lightdiction SAS KB2D User Manual March 2022 rev 2.0...
➢ A laser projector to project the pattern you want to interact with. ➢ The KB2D interactive device with a USB (A – B) cable. ➢ A computer with Windows 10 or above with the KB2D Laser Harp Interface. The last KB2D setup can be downloaded at https://lightdiction.com/Ressources/...
The KB2D also detects the width of each interaction, and can send a MIDI signal varying in function of the width. As the KB2D is measuring the angle and not just detecting light (or laser) interactions, it does not have to be synchronized with the scanning system of the laser source.
The KB2D Laser Harp interface is an open-source software. The code can be found here: https://github.com/Lightdiction/KB2D_Interface_V3 It is recommended to always use the latest version of the Firmware and of the KB2D Laser Harp Interface, to benefit from all the performances and options available. If the computer running the KB2D Laser Harp Interface is connected to the internet, all available firmware and software updates will be automatically proposed at the start of the software.
Fig. 3: Information window when we start the interface with the KB2D connected If for some reason the KB2D is detected but the ports are not available, you will see this kind of warning window: Fig. 4: Warning window if MIDI ports are detected but are not available This generally happens when another software took the control of the KB2D.
Page 9
KB2D Page 9/32 Fig. 5: KB2D Laser Harp Interface when the device is detected and successfully connected If no device is found, the interface is almost empty like this: Fig. 6: KB2D Laser Harp Interface when no device is found...
Fig. 7: Button bar Button Description Enable or disable the detection of the KB2D. When the KB2D is started, we see a light Start / Pause on the button next to the USB connector on the KB2D. We can also manually go to Start state by pressing this same button on the KB2D device.
KB2D). Changing this may result in an incorrect communication with the KB2D. Select the MIDI port corresponding to the KB2D for the commands sent to KB2D (MIDI Out Commands) the device. By default, it Is the 1 output port of the KB2D.
KB2D Ports Enabled lets you select the number of Ports you want to use for the KB2D. By default, the KB2D uses 2 In / 2 Out. Indeed, 1 In and 1 Out is used for the feedback + command. One other Output of the KB2D is used to send the MIDI signals corresponding to the interaction and effects.
For the Position variable, the minimum and maximum of the Position correspond to the angle of the first beam and last beam. Click to learn Click to learn a beam (just like the “Learn One Angle” of the Button bar). Lightdiction SAS KB2D User Manual March 2022 rev 2.0...
KB2D. There is one tab for MIDI Effects Configuration for each port of the KB2D you have activated (1 in 2/2 mode, 2 in 3/3 mode, 3 in 4/4 mode, since 1 port In and Out is reserved for the control and feedback).
Page 15
Variable called “N° beam”. By selecting this variable, you indicate to the KB2D that you want the value to change in function of the beam you interact with. When you interact with the first beam, it will be channel 1. If you have 16 beams and you interact with beam number 16, It will send 16.
Page 16
This section is shown only if the “Keyboard” variable is used. A keyboard is displayed. The keys currently used are colored in yellow, and the corresponding beam number is indicated on the key. We also have a few options and buttons: Lightdiction SAS KB2D User Manual March 2022 rev 2.0...
Page 17
By clicking on a key of the keyboard, this will send the note. This is also a way to check if your KB2D is correctly connected to your DAW or synth. [Click on a key] Also, clicking on the Key will let you choose the beam you want to assign to this note.
At the top of this panel, we have the preset modes: Fig. 19: Preset modes This section lets you switch quickly between some preset modes. This also helps at the beginning to show you some examples, if you do not know how to set the KB2D. Variable Description...
Page 19
This is the minimum value (arbitrary unit) of lighting power that the sensor needs to receive to consider an interaction as potentially valid. If this value is too low, the KB2D can detection other elements in the environment, Detection threshold like the background (ceiling if you project your laser vertically indoor).
Page 20
It is recommended to not set it too low, or you could have brutal variation when removing your hand for instance. This sets the minimum number of frames before the KB2D starts modulating. It Attack filter avoids to have incorrect values at the start of the interaction, you should keep it quite high preferably.
Page 21
When uncheck, the position varies from the first beam angle to last beam angle. The width varies from small interaction to large interaction. Substitute values can be activated independently on each MIDI effect of each KB2D Activate Substitute port. By default, default values are disabled.
Page 22
Page 22/32 Main Config The main config section can be found on the right od the KB2D ports settings. Fig. 23: Main Config section In this section, you can create presets of all your parameters, to switch quickly from one configuration to another.
Page 23
Include Height settings in your configuration. Include Angles + N Beams Include the Beam Angles configuration section in your configuration. Include Notes and Effects Include the parameters in MIDI Effects configuration. Lightdiction SAS KB2D User Manual March 2022 rev 2.0...
This is where you choose the MIDI controller you want to use to control the interface (MIDI In). You can also select a MIDI Out port as a MIDI Thru. All incoming MIDI messages will be automatically transmitted to the MIDI Out port. Lightdiction SAS KB2D User Manual March 2022 rev 2.0...
Page 25
When a command is used for mapping, its color turns yellow. All values entered in this section are in hexadecimal! Load, Save File and Reset to Default Fig. 29: Load, save Files and reset to default for mapping Lightdiction SAS KB2D User Manual March 2022 rev 2.0...
Firmware Updater The Firmware Updater is used to update the firmware inside the KB2D. When activated, the KB2D will restart in this mode. The interface will automatically detect the KB2D in this mode and change the user interface to match the firmware updater needs.
Page 27
Fig. 31: Menu to start the Firmware Updater manually If for some reason, the loading fails, and you are unable to start the KB2D anymore, you can force the KB2D to restart in Firmware Updater mode, so you load the firmware again. To do so, unplug your KB2D. Then press the start button on your KB2D device, next to the USB connector, and plug the KB2D while pressing the button.
Else, just place the KB2D in front of your laser projector to have a position similar to the one on the picture above. The window of the detection system should be centered (approximatively) relatively to your laser emission point.
5. SELECT THE NOTES YOU WANT Select the MIDI Notes you want the KB2D to send by clicking on a key on the keyboard and assign it to a beam number. This will also force the KB2D to send the note you selected to its MIDI Out. If you cannot hear anything, check that “KB2D Interactive”...
• The KB2D device is able to detect variations on 2 dimensions: angle X (in the plane aligned with the length of KB2D box), and distance (height) Z. Place your device accordingly (see Fig. 2). •...
The Notes are not stable / Angles parameters are not correct Calibrate each beam independently with the KB2D does not detect for every all notes / The KB2D has “Learn One Angle”. correctly (Not all notes) been roughly calibrated. Is the background is close, increase the...
All Lightdiction products are sold pursuant to Lightdiction’s terms and conditions of sale. Purchasers are solely responsible for the choice, selection and use of the Lightdiction products and services described herein, and Lightdiction assumes no liability whatsoever relating to the choice, selection or use of the Lightdiction products and services described herein.
Need help?
Do you have a question about the KB2D and is the answer not in the manual?
Questions and answers