
Button Light Master of the Death that Kills Documentation
Button Light Master of the Death that Kills Documentation
CREDITS AND ACKNOWLEDGMENTS

Writing + creation: Arnoz
Based on the work of MJR: http://mjrnet.org/pinscape/
Please do not copy or publish this material without the prior permission of the author or you will be forever cursed and your children will be born with pinball balls instead of eyes.
PRESENTATION :
Button Light Master of the Death that Kills

The name rocks, don’t you think? (in french it’s « La Maitresse des Boutons Lumineux de la Mort qui Tue »)
But what is it exactly?
To begin with, let’s assume that Button Light Master of the Death that Kills is a bit long for me to write, and that I’m not going to get into the copy paste festival…
We’ll call it BLMDK to keep things simple.
This card is used at the base (I say at the base, because you will see later that we can use this last for other uses), so I said, it is painful this habit of cutting myself when I start a sentence, this card is used to manage the 5 lights that make up a backboard, as well as strobes (I warn you right away, I hate people who say « stromboscope » …)
It is connected to a KL25Z by means of 5 data wires (4 digital outputs and 1 PWM output), as well as a + 5V and a GND also coming from the KL25Z.
It is powered by 12 Volts DC and has output connectors on screw terminal blocks (you will need a quality 2 mm precision screwdriver to use them properly) grouped by use.
You will therefore have 5 connectors named LED from 1 to 5 each with 1 line R (Red GND), 1 line G (Green GND), B (Blue GND) and its + 12V.
The last connector is stamped STROBE with a + 12V and a GND.
This card supplies 12 V LEDs, be careful not to directly connect your 3 or 3.4 Volts LEDs otherwise you will have a nice fireworks display for which I will not be responsible …
The BLMDK allows 16 PWM outputs to be added to the KL25Z, and several BLMDKs can be connected one after the other to add as many PWM outputs as you want, using only the 5 cables on the KL25Z.
BLMDKs are of course compatible with 16 PWM Mosfet extensions, as well as most solutions on the market.
Each output goes through an optocoupler to separate the electrical signals, and into a ULN.
Each line is calculated to pass 0.8 amps.
You say to me « Hey man, you work with ULN2064B which offers 1.5 amps per line, and you limit us to 0.8 amps, did you take us for hams? » «
So already, you are going to relax, I will explain my point of view to you.
Shoot 1.5 per line, no worries, on the other hand if you do it on the 4 lines of your ULN at the same time, it pumps a little of the world, and there is a data which can be useful, it is the power of dissipation of the case….
So we are not going to spread out 3 weights above, I invite you to scan your favorite search engine, or to discuss it in the comments, I have already lost half of the guys who just want to plug in their pretty card (she is beautiful eh 🙂)
I give the card for 0.8 amps per line, I say that we can do the pig and go up to 1 amp on output 16 because it is for strobe, and if it does not sting the eyes, well, it is useless, but we will say that it does not come out of here, but I will not give for more.
Besides, I don’t give it away, I sell it …
1 – INSTALLING THE CARD :
a – Card wiring
Above all, this card manages ONLY THE DIRECT CURRENT, do not connect any AC voltage on it, never, even under threat!)
Photos are V1, now it’s all plug instead of dupont or screw terminal, i will made some new pictures soon !!!
Always wire de-energized, once the wiring is done, check it carefully for the first time, take a break for a few minutes, and recheck your wiring. The first cause of error remains humans!
All voltages given in this document are direct current DC
Let’s start with the expansion card.
This has several connectors.

The INSIDE « DEDANS » (7 pins) this is where we make the connection from the KL25Z.
The OUTSIDE « DEHORS » (7 pins) which allows you to connect the following expansion card if you want to add more.
The Alim TOYS 12V (2 pins) that we must connect to the + 12V and the GND of the toys power supply.
The LED outputs from 1 to 5 and the STROBE output (also stamped from 1 to 16 for use of the BLMDK for your Button LEDs, or vibrator, or other …)
IN – DEDANS
Here we plug what we want to send IN the card, so the layer of wires that comes from the KL25Z, KLSHIELD or from another BLMDK or extension.

By default, here are the pins or connect the cables:
GSCLK → PTC4 (one PWM output)
SCLK → PTC5 (SPI SCLK PTC5 ou PTD1)
Sin → PTC6 (SPI MOSI PTC6 ou PTD2)
XLAT → PTC10 (one digital output)
BLANK → PTC11 (one digital output)
+5V KL → P5V_USB (5V KL)
GND KL → GND (GND KL)
If you are using a KL Shield, simply plug the plug into the slot provided on the latter, respecting the direction of the plug (the black wire on GND)

As for + 5V and GND, you can either take them from the power supply of the PC where your KL25Z is connected, or directly from the KL25Z (the second choice is preferable in my opinion)
OUT – DEHORS
If you have an expansion card following this one, you connect the 2 cards together simply like this:

GSCLK → GSCLK
SCLK → SCLK
Sout → Sin
XLAT → XLAT
BLANK → BLANK
+5V KL → +5V KL
GND KL → GND KL
ALIM TOYS
Please just connect + 12V and GND to your 12V Toys power supply
Warning !
The cable that will power the GND terminals will withstand all the intensity of the Toys (this is where the current from ALL the toys passes).
Make sure that it is of sufficient section to withstand the 13 amps that can be accepted maximum card (use 18AWG or 1mm²)

Fuses
There are 6 fuse holders on the BLMDK
The first 5 are for LED outputs
Fuse holder 1: Outputs 1,2 and 3 / LED1 RG and B
Fuse holder 2: Outputs 4,5 and 6 / LED2 RG and B
Fuse holder 3: Outputs 7,8 and 9 / LED3 RG and B
Fuse holder 4: Outputs 10,11 and 12 / LED4 RG and B
Fuse holder 5: Outputs 13,14 and 15 / LED5 RG and B
Each of its fuse holder contains a 2.5 amp fuse (it protects 3 * 0.8 amps)
The 6th fuse holder manages the Strobe output, it contains a 1 Ampere fuse.
LED and STROBE outputs
Please connect each of the outputs as shown in the diagram, the RG and B lines connect to the negative side (GND) of the LED or TOY.

If you use this board to power 12 Volt button LEDs, or 12V low power vibrators, connect the output number (from 1 to 16) to the negative side of your toy, and the positive side to the + 12V side of the board .
Remember to always use a suitable fuse on each fuse holder.
An unsuitable fuse is as if no protection was put on, too small it will blow immediately, too large it will never blow and therefore is useless.
At the end of this document you will find several wiring diagrams corresponding to the majority of situations.
b – Software part
Now let’s look at the programming side of the card.
First, your KL25Z must be flashed with the latest Firmware (0605 version of 05/03/2019 minimum) and you must have installed at least DirectOutput V3.1.7011.27968 built 2019.03.13.
More info on this link: http://mjrnet.org/pinscape/BuildGuideV2/BuildGuide.php?custom=EU&expver=R3.201602xx&sid=DOF
So that your KL25Z can use these outputs, you must already declare it and configure it in the Pinscape Config Tool, this will also allow you to know where to connect the wires to the KL.
Launch the Pinscape config tool
go to SETUP as if to configure your KL, by going down a little you will find TLC5940 Setup, in « Number of TCL » enter the number of expansion cards that you connect to the KL (in my case I connect 2 cards of extension), then choose the pins to be connected to the various inputs of the expansion card, First choose the same pins as me, later if you wish you can change the configuration as you see fit.

The « SI Output » will be connected to the SIn on the expansion card (Signal OUTPUT which is plugged into Signal INPUT)
The rest is the same denomination.
If you add one or more expansion cards, and you just change the number of TLCs, the rest of the config does not move.
Then go to the part where we configure the outputs, and the, Oh surprise, a new item is available in the menu on the right (TLC5940 OUT), click on it, you will see your new outputs appear. If you have several cards, you will have as many « chips » available.

If you ever see a red exclamation mark appear next to an output, you have assigned it to two different places, please correct that otherwise it will not work.
Assign these outputs to your toys, you do it for the outputs of the KL25Z in usual time. As you can see below, we can have more than 32 outputs, and we can wire the outputs in any order that suits us.
In this example we have the BLMDK on outputs 1 through 16.

Note which toy corresponds to each output, save all that, make a backup of the config, then go do your DOF and download the Directoutput config files.
To use more than 32 outputs with our setup, we are no longer going to declare a KL25Z
in the « account » part of the DOF CONFIG TOOL, but a Pinscape Device (in absolute terms, the KL25 runs under PINSCAPE, we should always declare as this)
And there we end up with 128 outputs available in the “Port Assignments” section.
Of course, if you only have one card, you can use the 16 outputs of the latter plus the outputs of the KL (digital or other PWM). Fill in the toys according to their outputs declared in Pinscape config tool.


Advantage of PWM outputs to manage contactors, shakers, and other LEDs …
Using PWM outputs on our toys has an advantage, we can from the DOF vary the maximum voltages that we apply to our toys, this allows for example if the LEDs on your backboard are too powerful to limit them in a software way ( without having to go tinker with the power supply to lower its voltage), to make the contactors or solenoids sound differently by feeding them a little less, to limit the maximum speed of a shaker

All this happens in the DOF config tool, in the window where you assign your toys, on the right there is this
SHAKER MOTOR is used to manage the minimum and maximum speed of the shaker, enter a value in min and max to define them.
FAN allows the same, but for the fan.
Custom Brightness is used to manage the maximum level of the lights, similarly we enter here the desired maximum value for the Strobe, the PF Strob MX (strob on addressable led teensy / wemos), the flashers (the RGB LEDs on the backboard) and Ledstrip Flasher ( the RGB strips undercab and behind the backglass)
3 – WIRING DIAGRAMS AND EXAMPLES
Classic use with 5 FLASH RGB 12V and 2 STROBES 12V
