Settings

Configuration settings for KL25Z CPU ID unknown


Hardware setup. Are you using this KL25Z on its own, or with a set of expansion boards? Help
If you're using the Pinscape expansion boards, select that option below, and the setup tool will automatically fill in the appropriate GPIO pin assignments throughout the configuration. If you're using external circuitry of your own design (e.g., output channel power booster circuits), select "standalone" so that you can set custom pin assignments to match your wiring.
Expansion board details:
Number of MOSFET power boards:
Number of chime boards:

The KL25Z pin assignments are hidden by default because you've selected the expansion board configuration. All pin assignments are pre-determined in this configuration. Check the box above if you want to view the pin assignments anyway, but be aware that any changes to pin assignments will probably cause problems.

USB Identification. This is how the KL25Z identifies itself to Windows through the USB port.
Vendor ID: Product ID:
  • If you have a real LedWiz unit in your system, choose LedWiz Unit 8 for your first Pinscape unit, 9 for the second, etc.
  • If you don't have any real LedWiz units, choose LedWiz Unit 1 for the first unit, 2 for the second, etc.
I want more details!
  • For LedWiz compatibility, choose an LedWiz unit number. LedWiz compatibility lets older programs, like Future Pinball, control outputs through this Pinscape unit.
  • LedWiz unit numbers must be unique. Be sure to choose an ID that isn't used by your real LedWiz, or by another Pinscape controller. Programs on the PC use the unit number to tell the devices apart, so each device needs a different number.
  • If you have Windows device driver conflicts using the LedWiz IDs, you can try the Pinscape ID. This is a USB ID registered to Pinscape, so it should be free of conflicts with all other products. However, using this ID will forfeit LedWiz compatibility. This means that older software like Future Pinball won't be able to access the output controller features. Newer software based on DOF R3 will still be able to take full advantage of the output features. This includes Visual Pinball and PinballX. And the input features will still work for everyone.
  • The Custom ID option is only there for techies doing something tricky. Don't use it unless you have a good reason. Using a custom ID will make the output features unreachable even from DOF. (The input features will still work, though.)

Pinscape ID. This is a separate ID from the LedWiz unit number. DOF R3 and the DOF Config Tool use this ID to identify the unit. Set this to 1 for your first unit, 2 for the second, and so on.

This is completely unrelated to the LedWiz unit number, so it doesn't need to match that, and by the same token doesn't need to be different.


Reset on disconnect. If the USB connection is broken, and can't be re-established within a time limit, the KL25Z can automatically reset itself as an attempt to fix whatever's wrong. Select the time interval (in seconds) before this happens.
Time before reboot (seconds):
Details
Details
On some systems, the KL25Z has trouble re-establishing a broken USB connection, such as after rebooting or power-cycling the PC. This can usually be solved by resetting the KL25Z. If you set this option, the KL25Z will reset itself automatically when it detects a broken connection and can't reconnect within the specified time limit. The delay is there to avoid unnecessary resets when the connection only glitches momentarily. The recommended setting is 10 seconds.

TV ON switch. If one or more of your monitors needs to be turned on manually every time you power up your cabinet, you can use this feature to switch them on automatically. See the Build Guide for wiring instructions.
Test
Power status input:
Status latch output:
Relay output:
Startup delay time (seconds): This is how long to wait after power-on before pulsing the relay

Joystick input. The controller acts like a Windows USB Joystick in order to send the plunger position, accelerometer readings (for nudging), and button inputs to the PC. You can disable these inputs if desired.
Why would I want to disable this?
Why would I want to disable this?
By default, each Pinscape unit reports its accelerometer readings to the PC via the joystick interface. If you have more than one unit installed, that means you'll have more than one set of these reports coming in. The extra reports can confuse some pinball software, and can also affect system performance. This option lets you disable the extra reports from the secondary units. If you have a plunger attached to one of the units, you should consider that one to be your primary unit and leave its joystick interface enabled. You should disable the joystick interface on any other units.

Accelerometer orientation. If you're using the accelerometer (for nudge sensing), the software needs to know how the KL25Z is oriented in the cabinet so that it can report motion in the right direction. Install the KL25Z in one of the orientations shown below, level with the floor of the cabinet, with the chips and LEDs facing up.

Plunger sensor setup
Sensor type: Live Sensor View
TSL1410R/1412R pin assignments:
SI (serial data):
CLK (serial clock):
AO (analog data): Requires an ADC-capable (analog in) pin
Connect the sensor to the PLUNGER connector (JP2) on the main interface board:
  • Sensor AO1/AO2 to pin 1
  • Sensor CLK to pin 3
  • Sensor VDD to pin 5
  • Sensor VPP (GND) to pin 6
  • Sensor SI to pin 8
Potentiometer pin assignments:
Wiper: Requires an ADC (analog in) pin
Connect the sensor to the PLUNGER connector (JP2) on the main interface board:
  • Pot wiper to pin 1
  • One fixed-resistor end to pin 5
  • Other fixed-resistor end to pin 6
Note: this sensor type setting can be used with other sensors that represents the plunger position as an analog voltage level, such as an LVDT or analog IR distance finder. Connect the sensor's analog output pin to JP2 pin 1. Connect sensor power to pin 5 and GND to pin 6.

Plunger calibration button. If you wish, you can install a pushbutton in your cabinet to activate plunger calibration mode. This is optional, since you can also run the calibration from this setup program. See the Build Guide for wiring instructions.
Button input:
Indicator lamp output:
(The calibration button is only applicable when you have a plunger sensor installed.)
Connect the calibration button to the CAL BTN connector (JP3) on the main interface board.

ZB Launch Ball setup. You can set up your mechanical plunger to act as a "virtual" Launch Ball button for tables that use a button instead of a plunger. Details
This feature lets you use a mechanical plunger in lieu of a Launch Ball button, for tables that need it, in case you don't want to install a separate physical Launch button. When this is enabled, you treat the plunger knob like a button: push it a little forward to "click" the button. You can also pull back and release the plunger to simulate a brief button push.
  • The feature is only activated when a non-plunger table is running on the PC. We can tell because Visual Pinball turns on the output port selected below when such a table is loaded.
  • The port you designate can be any type, including a "virtual" port that isn't connected to any physical output wiring.
  • In the DOF Config Tool, be sure to set the port number you designate here as your ZB Launch Ball port. That connects everything on the PC to the right port.
  • Select the keyboard key or joystick button to send to the PC when the plunger triggers a launch. This is usually the Enter key, because that's what almost all PC pinball software uses.
  • The push distance sets the sensitivity. When you push the plunger forward by this amount or more (and the feature has been activated by the output port), the controller simulates pressing the Launch Ball button. Set the distance far enough that it doesn't trip randomly, but short enough that you don't have to push too hard. We recommend about .06 to .08 inches.
(The ZB Launch Ball feature only applies when you have a plunger sensor installed.)
Output port number: Important! Set this port to "ZB Launch Ball" in the DOF Config Tool
Key/button: Most PC pinball software uses the Enter key for ball launch
Push distance (inches): Recommended value is 0.063 (about 1/16")

Button inputs. You can use the KL25Z as a key encoder to connect pinball-style buttons on your cabinet to the PC. Set up the wiring connections and key assignments below. Each input can be mapped as a joystick button or keyboard key. Click an input pin or key assignment to change a setting.
Test Buttons
Shift button number: What's this?
You can designate one button as the local Shift button. When you hold down this button, pressing any other button will use the "shifted" key assignment for the other button. (If the other button doesn't have a shifted meaning assigned, its ordinary un-shifted meaning is used.) This lets you give every button a second meaning, expanding the number of controls without adding more physical buttons. Select the button number to use as the Shift button if desired, or set it to zero to disable this feature. This is unrelated to the PC keyboard Left Shift and Right Shift keys, which you can assign to buttons of your choice like any other keyboard keys. Note that the shift button itself can't have a shifted meaning assigned, as there'd be no way to activate it.
Set standard joystick buttons | Set standard keyboard keys | View standard key assignments
Note: your current firmware version supports up to 0 physical buttons. New rows will be added to the table above as you fill in more values, up to the limit.

TLC5940 (external PWM controller chip) setup What's this?
The TLC5940 is an integrated circuit chip that you can connect to the KL25Z to add extra outputs for more feedback devices (lights, solenoids, motors, etc). The TLC5940 outputs have full PWM (Pulse Width Modulation) capabilities, allowing the software to control the brightness of an attached light or the speed of a motor.

These chips let you go beyond the KL25Z's limited PWM capabilities. The KL25Z only has 10 PWM channels of its own, which isn't enough for most virtual pinball machines. Each TLC5940 chip provides 16 PWM outputs, and you can connect two or more of the chips in a daisy chain to add almost unlimited outputs.

The Pinscape Expansion Boards use these chips to provide extra PWM outputs. You can also install them with your own custom wiring. The circuitry needed is outlined in the Build Guide. The settings below configure the data signal connections between the KL25Z and the TLC5940's.

The TLC5940 configuration is automatically set up for your expansion boards.
Number of TLC5940 chips:
SI (serial data) output: Requires an SPI MOSI output pin
SCLK (serial clock) output: Requires an SPI SCLK output pin
XLAT output:
BLANK output:
GSCLK output: Requires a PWM-capable output pin

74HC595 (external digital out chip) setup What's this?
The 74HC595 is an integrated circuit chip that can be connected to the KL25Z to add more digital outputs for feedback devices like solenoids and replay knockers. "Digital" means that the outputs are strictly on/off: the software can't modulate intensity or brightness. Digital outputs are ideal for feedback devices that inherently need only on/off control, such as solenoids.

The Pinscape "Chime Board" uses this chip to add outputs for replay knockers and chime units. You can also add these chips with your own custom wiring; the circuitry is described in the Build Guide. The settings below let you configure the data connections between the KL25Z and the 74HC595's.

The 74HC595 configuration is automatically set up for your chime boards.
Number of 74HC595 chips:
SI (serial data) output:
SCLK (serial clock) output:
LATCH output:
ENA output:

Pinscape After Dark. You can set up a button or switch to activate Night Mode, which disables the feedback device outputs that you designate as noise-makers. This lets you play during late-night hours without disturbing your party-pooper housemates and neighbors. Details
  • Select an input button to turn Night Mode on and off. Wire this like any other button.
  • You'll probably want to configure the button you select for "No PC Input" in the button setup, but you can have it send a keystroke if that's useful to you for some reason.
  • If you don't want to wire a physical button for this, just set the button number to 0 (zero). You can still control Night Mode with the NightMode.exe program on the PC (it's in your Pinscape Setup Tool folder).
  • You can also optionally select an output port to serve as an indicator light, so that you can tell when night mode is turned on. If you don't need an indicator, just set this to 0. If you do assign a port, you should leave it unassigned in your DOF port layout.
Button input number: 0 = no input button assigned
(see Button Setup)
Button type:
Indicator lamp output port: 0 = no indicator output

Feedback device outputs. Pinball software on the PC can control output devices connected to the KL25Z to create special effects during play, such as tactile feedback and lighting displays. The PC software uses the port numbers in the list below to address the outputs. Use these port numbers when you set up your DOF configuration. For each port, you can select the physical output pin that the port is wired to.
Test Outputs
Port No. Type Location Pin Port Options [?]
Chip 1
Chip 1
JP9
Flashers
N/C
Board 1
Board 1
A "virtual" output is a software port that isn't connected to a physical output. This can be used as a placeholder in your DOF setup, or for a special function, such as the ZB Launch Ball control port.

Virtual

ZB Launch Port

GPIO
PWM Out

GPIO
Digital Out

SPI (MOSI)

SPI (SCLK)

Analog In

Digital In

Interrupt In

TLC5940 Out

74HC595 Out

Main Board
PWM Out

Main Board
Digital Out

Main Board

Power Board

Chime Board

Virtual Out
Select this option if you don't want the button to send any input to the PC when pressed.

No PC Input
Select special functions for the key, separate from any PC input.

Night Mode
Joystick Buttons