Arnaud VALLEY / Mbed 2 deprecated Pinscape_Controller_V2_arnoz

Mirror with some correction

Dependencies:   mbed FastIO FastPWM USBDevice

config.h@89:c43cd923401c, 2017-05-12 (annotated)

Committer:
mjr
Date:
Fri May 12 17:57:59 2017 +0000
Revision:
89:c43cd923401c
Parent:
87:8d35c74403af
Child:
90:aa4e571da8e8
Added Flipper Logic to output port options

Who changed what in which revision?

UserRevisionLine numberNew contents of line
mjr 17:ab3cec0c8bf4 1 // Pinscape Controller Configuration
mjr 17:ab3cec0c8bf4 2 //
mjr 87:8d35c74403af 3 // !!! ATTENTION !!!
mjr 87:8d35c74403af 4 // If you've come here on advice in a forum to change a GPIO setting or
mjr 87:8d35c74403af 5 // to #define a macro to enable the expansion boards, >>>STOP NOW<<<. The
mjr 87:8d35c74403af 6 // advice you found is out of date and no longer applies. You don't need
mjr 87:8d35c74403af 7 // to edit this file or recompile the firmware, and you shouldn't. Instead,
mjr 87:8d35c74403af 8 // use the standard firmware, and set options using the Pinscape Config Tool
mjr 87:8d35c74403af 9 // on your Windows PC. All options that were formerly configurable by
mjr 87:8d35c74403af 10 // editing this file can be selected with the Config Tool. That's much
mjr 87:8d35c74403af 11 // cleaner and easier than editing the source code, and it eliminates the
mjr 87:8d35c74403af 12 // problem of re-synchronizing a private copy of the source code with future
mjr 87:8d35c74403af 13 // updates. With the config tool, you only need the standard firmware build,
mjr 87:8d35c74403af 14 // so future updates are a simple matter of downloading the latest version.
mjr 35:e959ffba78fd 15 //
mjr 35:e959ffba78fd 16 //
mjr 87:8d35c74403af 17 // IN THE PAST (but NOT NOW - see above), configuration was handled mostly
mjr 87:8d35c74403af 18 // with #defines and #ifdefs. To customize the setup, you had to create a
mjr 87:8d35c74403af 19 // private forked copy of the source code, edit the constants defined in
mjr 87:8d35c74403af 20 // config.h, and compile a custom binary. That's no longer necessary because
mjr 87:8d35c74403af 21 // the config tool lets you set all configurable options dynamically. Of
mjr 87:8d35c74403af 22 // course, you're still free to create a custom version if you want to add
mjr 87:8d35c74403af 23 // entirely new features or make changes that go beyond the configurable
mjr 87:8d35c74403af 24 // options.
mjr 35:e959ffba78fd 25 //
mjr 87:8d35c74403af 26 #ifndef CONFIG_H
mjr 87:8d35c74403af 27 #define CONFIG_H
mjr 35:e959ffba78fd 28
mjr 87:8d35c74403af 29
mjr 87:8d35c74403af 30 // TEST SETTINGS - FOR DEBUGGING PURPOSES ONLY. The macros below select
mjr 87:8d35c74403af 31 // special option combinations for debugging purposes.
mjr 55:4db125cd11a0 32 //
mjr 87:8d35c74403af 33 // IMPORTANT! If you're trying to create a custom configuration because
mjr 87:8d35c74403af 34 // you have a pin conflict or because you're using the expansion boards,
mjr 87:8d35c74403af 35 // DON'T modify this file, DON'T use these macros, and DON'T recompile
mjr 87:8d35c74403af 36 // the firmware. Use the Config Tool on your Windows PC instead.
mjr 55:4db125cd11a0 37 #define STANDARD_CONFIG 1 // standard settings, based on v1 base settings
mjr 55:4db125cd11a0 38 #define TEST_CONFIG_EXPAN 0 // configuration for the expansion boards
mjr 80:94dc2946871b 39 #define TEST_KEEP_PRINTF 0 // for debugging purposes, keep printf() enabled
mjr 55:4db125cd11a0 40 // by leaving the SDA UART GPIO pins unallocated
mjr 48:058ace2aed1d 41
mjr 35:e959ffba78fd 42 // Plunger type codes
mjr 35:e959ffba78fd 43 // NOTE! These values are part of the external USB interface. New
mjr 35:e959ffba78fd 44 // values can be added, but the meaning of an existing assigned number
mjr 35:e959ffba78fd 45 // should remain fixed to keep the PC-side config tool compatible across
mjr 35:e959ffba78fd 46 // versions.
mjr 35:e959ffba78fd 47 const int PlungerType_None = 0; // no plunger
mjr 82:4f6209cb5c33 48 const int PlungerType_TSL1410R = 1; // TSL1410R linear image sensor (1280x1 pixels, 400dpi), serial mode, edge detection
mjr 82:4f6209cb5c33 49 const int PlungerType_TSL1412S = 3; // TSL1412S linear image sensor (1536x1 pixels, 400dpi), serial mode, edge detection
mjr 35:e959ffba78fd 50 const int PlungerType_Pot = 5; // potentionmeter
mjr 35:e959ffba78fd 51 const int PlungerType_OptQuad = 6; // AEDR8300 optical quadrature sensor
mjr 35:e959ffba78fd 52 const int PlungerType_MagQuad = 7; // AS5304 magnetic quadrature sensor
mjr 82:4f6209cb5c33 53 const int PlungerType_TSL1401CL = 8; // TSL1401CL linear image sensor (128x1 pixels, 400dpi), bar code sensing
mjr 82:4f6209cb5c33 54 const int PlungerType_VL6180X = 9; // VL6180X time-of-flight distance sensor
mjr 82:4f6209cb5c33 55
mjr 82:4f6209cb5c33 56 // Plunger auto-zero flags
mjr 82:4f6209cb5c33 57 const int PlungerAutoZeroEnabled = 0x01; // auto-zeroing enabled
mjr 21:5048e16cc9ef 58
mjr 35:e959ffba78fd 59 // Accelerometer orientation codes
mjr 35:e959ffba78fd 60 // These values are part of the external USB interface
mjr 35:e959ffba78fd 61 const int OrientationFront = 0; // USB ports pointed toward front of cabinet
mjr 35:e959ffba78fd 62 const int OrientationLeft = 1; // ports pointed toward left side of cabinet
mjr 35:e959ffba78fd 63 const int OrientationRight = 2; // ports pointed toward right side of cabinet
mjr 35:e959ffba78fd 64 const int OrientationRear = 3; // ports pointed toward back of cabinet
mjr 25:e22b88bd783a 65
mjr 77:0b96f6867312 66 // Accelerometer dynamic range codes
mjr 77:0b96f6867312 67 const int AccelRange1G = 0; // +/-1G
mjr 77:0b96f6867312 68 const int AccelRange2G = 1; // +/-2G
mjr 77:0b96f6867312 69 const int AccelRange4G = 2; // +/-4G
mjr 77:0b96f6867312 70 const int AccelRange8G = 3; // +/-8G
mjr 77:0b96f6867312 71
mjr 35:e959ffba78fd 72 // input button types
mjr 53:9b2611964afc 73 const int BtnTypeNone = 0; // unused
mjr 35:e959ffba78fd 74 const int BtnTypeJoystick = 1; // joystick button
mjr 53:9b2611964afc 75 const int BtnTypeKey = 2; // keyboard key
mjr 67:c39e66c4e000 76 const int BtnTypeMedia = 3; // media control key
mjr 38:091e511ce8a0 77
mjr 38:091e511ce8a0 78 // input button flags
mjr 38:091e511ce8a0 79 const uint8_t BtnFlagPulse = 0x01; // pulse mode - reports each change in the physical switch state
mjr 38:091e511ce8a0 80 // as a brief press of the logical button/keyboard key
mjr 40:cc0d9814522b 81
mjr 40:cc0d9814522b 82 // button setup structure
mjr 40:cc0d9814522b 83 struct ButtonCfg
mjr 40:cc0d9814522b 84 {
mjr 66:2e3583fbd2f4 85 // physical GPIO pin - a Wire-to-PinName mapping index
mjr 66:2e3583fbd2f4 86 uint8_t pin;
mjr 66:2e3583fbd2f4 87
mjr 66:2e3583fbd2f4 88 // Key type and value reported to the PC
mjr 40:cc0d9814522b 89 uint8_t typ; // key type reported to PC - a BtnTypeXxx value
mjr 53:9b2611964afc 90 uint8_t val; // key value reported - meaning depends on 'typ' value:
mjr 53:9b2611964afc 91 // none -> no PC input reports (val is unused)
mjr 53:9b2611964afc 92 // joystick -> val is joystick button number (1..32)
mjr 53:9b2611964afc 93 // keyboard -> val is USB scan code
mjr 77:0b96f6867312 94 uint8_t IRCommand; // IR command to send when the button is pressed, as
mjr 77:0b96f6867312 95 // an IR command slot number: 1..MAX_IR_CODES, or 0
mjr 77:0b96f6867312 96 // if no IR command is to be sent
mjr 66:2e3583fbd2f4 97
mjr 66:2e3583fbd2f4 98 // Shifted key type and value. These used when the button is pressed
mjr 66:2e3583fbd2f4 99 // while the Local Shift Button is being held down. We send the key
mjr 66:2e3583fbd2f4 100 // code given here instead of the regular typ/val code in this case.
mjr 66:2e3583fbd2f4 101 // If typ2 is BtnTypeNone, we use the regular typ/val code whether or
mjr 66:2e3583fbd2f4 102 // not the shift button is being held.
mjr 66:2e3583fbd2f4 103 uint8_t typ2; // shifted key type
mjr 66:2e3583fbd2f4 104 uint8_t val2; // shifted key value
mjr 77:0b96f6867312 105 uint8_t IRCommand2; // IR command to send when shifted button is pressed
mjr 66:2e3583fbd2f4 106
mjr 66:2e3583fbd2f4 107 // key flags - a bitwise combination of BtnFlagXxx values
mjr 66:2e3583fbd2f4 108 uint8_t flags;
mjr 40:cc0d9814522b 109
mjr 40:cc0d9814522b 110 void set(uint8_t pin, uint8_t typ, uint8_t val, uint8_t flags = 0)
mjr 40:cc0d9814522b 111 {
mjr 40:cc0d9814522b 112 this->pin = pin;
mjr 40:cc0d9814522b 113 this->typ = typ;
mjr 40:cc0d9814522b 114 this->val = val;
mjr 77:0b96f6867312 115 this->IRCommand = 0;
mjr 40:cc0d9814522b 116 this->flags = flags;
mjr 77:0b96f6867312 117 this->typ2 = 0;
mjr 77:0b96f6867312 118 this->val2 = 0;
mjr 77:0b96f6867312 119 this->IRCommand2 = 0;
mjr 40:cc0d9814522b 120 }
mjr 40:cc0d9814522b 121
mjr 40:cc0d9814522b 122 } __attribute__((packed));
mjr 40:cc0d9814522b 123
mjr 33:d832bcab089e 124
mjr 65:739875521aae 125 // maximum number of input button mappings in configuration
mjr 65:739875521aae 126 const int MAX_BUTTONS = 48;
mjr 65:739875521aae 127
mjr 65:739875521aae 128 // extra slots for virtual buttons (ZB Launch Ball)
mjr 89:c43cd923401c 129 const int VIRTUAL_BUTTONS = 1; // total number of buttons
mjr 89:c43cd923401c 130 const int ZBL_BUTTON_CFG = MAX_BUTTONS; // index of ZB Launch Ball slot
mjr 33:d832bcab089e 131
mjr 35:e959ffba78fd 132 // LedWiz output port type codes
mjr 35:e959ffba78fd 133 // These values are part of the external USB interface
mjr 89:c43cd923401c 134 const int PortTypeDisabled = 0; // port is disabled - not visible to LedWiz/DOF host
mjr 89:c43cd923401c 135 const int PortTypeGPIOPWM = 1; // GPIO port, PWM enabled
mjr 89:c43cd923401c 136 const int PortTypeGPIODig = 2; // GPIO port, digital out
mjr 89:c43cd923401c 137 const int PortTypeTLC5940 = 3; // TLC5940 port
mjr 89:c43cd923401c 138 const int PortType74HC595 = 4; // 74HC595 port
mjr 89:c43cd923401c 139 const int PortTypeVirtual = 5; // Virtual port - visible to host software, but not connected
mjr 89:c43cd923401c 140 // to a physical output
mjr 89:c43cd923401c 141 const int PortTypeTLC59116 = 6; // TLC59116 port
mjr 17:ab3cec0c8bf4 142
mjr 35:e959ffba78fd 143 // LedWiz output port flag bits
mjr 89:c43cd923401c 144 const uint8_t PortFlagActiveLow = 0x01; // physical output is active-low
mjr 89:c43cd923401c 145 const uint8_t PortFlagNoisemaker = 0x02; // noisemaker device - disable when night mode is engaged
mjr 89:c43cd923401c 146 const uint8_t PortFlagGamma = 0x04; // apply gamma correction to this output
mjr 89:c43cd923401c 147 const uint8_t PortFlagFlipperLogic = 0x08; // enable Flipper Logic on the port (timed power limitation)
mjr 35:e959ffba78fd 148
mjr 35:e959ffba78fd 149 // maximum number of output ports
mjr 48:058ace2aed1d 150 const int MAX_OUT_PORTS = 128;
mjr 33:d832bcab089e 151
mjr 38:091e511ce8a0 152 // port configuration data
mjr 38:091e511ce8a0 153 struct LedWizPortCfg
mjr 38:091e511ce8a0 154 {
mjr 89:c43cd923401c 155 // port type: a PortTypeXxx value
mjr 89:c43cd923401c 156 uint8_t typ;
mjr 40:cc0d9814522b 157
mjr 89:c43cd923401c 158 // physical output pin:
mjr 89:c43cd923401c 159 //
mjr 89:c43cd923401c 160 // - for a GPIO port, this is an index in the
mjr 89:c43cd923401c 161 // USB-to-PinName mapping list
mjr 89:c43cd923401c 162 //
mjr 89:c43cd923401c 163 // - for a TLC5940 or 74HC595 port, it's the output
mjr 89:c43cd923401c 164 // number in the overall daisy chain, starting
mjr 89:c43cd923401c 165 // from 0 for OUT0 on the first chip in the chain
mjr 89:c43cd923401c 166 //
mjr 89:c43cd923401c 167 // - for a TLC59116, the high 4 bits are the chip
mjr 89:c43cd923401c 168 // address (the low 4 bits of the address only),
mjr 89:c43cd923401c 169 // and the low 4 bits are the output number on
mjr 89:c43cd923401c 170 // the chip
mjr 89:c43cd923401c 171 //
mjr 89:c43cd923401c 172 // - for inactive and virtual ports, this is unused
mjr 89:c43cd923401c 173 //
mjr 89:c43cd923401c 174 uint8_t pin;
mjr 89:c43cd923401c 175
mjr 89:c43cd923401c 176 // flags: a combination of PortFlagXxx values
mjr 89:c43cd923401c 177 uint8_t flags;
mjr 89:c43cd923401c 178
mjr 89:c43cd923401c 179 // flipper logic properties:
mjr 89:c43cd923401c 180 //
mjr 89:c43cd923401c 181 // - high 4 bits (0xF0) give full-power time in 50ms
mjr 89:c43cd923401c 182 // intervals, starting at 0=50ms
mjr 89:c43cd923401c 183 //
mjr 89:c43cd923401c 184 // - low 4 bits (0x0F) give reduced power level (used
mjr 89:c43cd923401c 185 // after full-power time expires), in 6.66% units
mjr 89:c43cd923401c 186 //
mjr 89:c43cd923401c 187 uint8_t flipperLogic;
mjr 89:c43cd923401c 188
mjr 89:c43cd923401c 189 void set(uint8_t typ, uint8_t pin, uint8_t flags = 0, uint8_t flipperLogic = 0)
mjr 40:cc0d9814522b 190 {
mjr 40:cc0d9814522b 191 this->typ = typ;
mjr 40:cc0d9814522b 192 this->pin = pin;
mjr 40:cc0d9814522b 193 this->flags = flags;
mjr 89:c43cd923401c 194 this->flipperLogic = flipperLogic;
mjr 40:cc0d9814522b 195 }
mjr 40:cc0d9814522b 196
mjr 77:0b96f6867312 197 } __attribute__ ((packed));
mjr 77:0b96f6867312 198
mjr 77:0b96f6867312 199 // IR command configuration flags
mjr 77:0b96f6867312 200 const uint8_t IRFlagTVON = 0x01; // send command at TV ON time
mjr 77:0b96f6867312 201 const uint8_t IRFlagDittos = 0x02; // use "ditto" codes on send
mjr 77:0b96f6867312 202
mjr 77:0b96f6867312 203 // IR command configuration data
mjr 77:0b96f6867312 204 struct IRCommandCfg
mjr 77:0b96f6867312 205 {
mjr 77:0b96f6867312 206 uint8_t flags; // flags: a combination of IRFlagXxx values
mjr 77:0b96f6867312 207 uint8_t keytype; // key type to send when IR command is received
mjr 77:0b96f6867312 208 uint8_t keycode; // key code to send when IR command is received
mjr 77:0b96f6867312 209 uint8_t protocol; // IR protocol ID (see IRRemote/IRProtocolID.h)
mjr 77:0b96f6867312 210 struct
mjr 77:0b96f6867312 211 {
mjr 77:0b96f6867312 212 uint32_t lo; // low 32 bits of code
mjr 77:0b96f6867312 213 uint32_t hi; // high 32 bits of code
mjr 77:0b96f6867312 214 } code; // 64-bit command code (protocol-specific; see IRProtocols.h)
mjr 77:0b96f6867312 215 } __attribute__ ((packed));
mjr 77:0b96f6867312 216
mjr 77:0b96f6867312 217 // Maximum number of IR commands
mjr 77:0b96f6867312 218 const int MAX_IR_CODES = 16;
mjr 38:091e511ce8a0 219
mjr 38:091e511ce8a0 220
mjr 53:9b2611964afc 221 // Convert a physical pin name to a wire pin name
mjr 53:9b2611964afc 222 #define PINNAME_TO_WIRE(p) \
mjr 53:9b2611964afc 223 uint8_t((p) == NC ? 0xFF : \
mjr 53:9b2611964afc 224 (((p) & 0xF000 ) >> (PORT_SHIFT - 5)) | (((p) & 0xFF) >> 2))
mjr 53:9b2611964afc 225
mjr 35:e959ffba78fd 226 struct Config
mjr 35:e959ffba78fd 227 {
mjr 35:e959ffba78fd 228 // set all values to factory defaults
mjr 35:e959ffba78fd 229 void setFactoryDefaults()
mjr 35:e959ffba78fd 230 {
mjr 35:e959ffba78fd 231 // By default, pretend to be LedWiz unit #8. This can be from 1 to 16. Real
mjr 35:e959ffba78fd 232 // LedWiz units have their unit number set at the factory, and the vast majority
mjr 35:e959ffba78fd 233 // are set up as unit #1, since that's the default for anyone who doesn't ask
mjr 35:e959ffba78fd 234 // for a different setting. It seems rare for anyone to use more than one unit
mjr 35:e959ffba78fd 235 // in a pin cab, but for the few who do, the others will probably be numbered
mjr 35:e959ffba78fd 236 // sequentially as #2, #3, etc. It seems safe to assume that no one out there
mjr 48:058ace2aed1d 237 // has a unit #8, so we'll use that as our default. This can be changed from
mjr 48:058ace2aed1d 238 // the config tool, but for the sake of convenience, it's better to pick a
mjr 48:058ace2aed1d 239 // default that most people won't have to change.
mjr 54:fd77a6b2f76c 240 usbVendorID = 0xFAFA; // LedWiz vendor code
mjr 48:058ace2aed1d 241 usbProductID = 0x00F7; // LedWiz product code for unit #8
mjr 61:3c7e6e9ec355 242
mjr 55:4db125cd11a0 243 // Set the default Pinscape unit number to #1. This is a separate identifier
mjr 55:4db125cd11a0 244 // from the LedWiz ID, so you don't have to worry about making this different
mjr 55:4db125cd11a0 245 // from your LedWiz units. Each Pinscape unit should have a unique value for
mjr 55:4db125cd11a0 246 // this ID, though.
mjr 55:4db125cd11a0 247 //
mjr 55:4db125cd11a0 248 // Note that Pinscape unit #1 corresponds to DOF Pinscape #51, PS 2 -> DOF 52,
mjr 55:4db125cd11a0 249 // and so on - just add 50 to get the DOF ID.
mjr 55:4db125cd11a0 250 psUnitNo = 1;
mjr 35:e959ffba78fd 251
mjr 51:57eb311faafa 252 // set a disconnect reboot timeout of 10 seconds by default
mjr 55:4db125cd11a0 253 disconnectRebootTimeout = 10;
mjr 51:57eb311faafa 254
mjr 35:e959ffba78fd 255 // enable joystick reports
mjr 35:e959ffba78fd 256 joystickEnabled = true;
mjr 35:e959ffba78fd 257
mjr 35:e959ffba78fd 258 // assume standard orientation, with USB ports toward front of cabinet
mjr 78:1e00b3fa11af 259 accel.orientation = OrientationFront;
mjr 78:1e00b3fa11af 260
mjr 78:1e00b3fa11af 261 // default dynamic range +/-1G
mjr 78:1e00b3fa11af 262 accel.range = AccelRange1G;
mjr 78:1e00b3fa11af 263
mjr 78:1e00b3fa11af 264 // default auto-centering time
mjr 78:1e00b3fa11af 265 accel.autoCenterTime = 0;
mjr 25:e22b88bd783a 266
mjr 52:8298b2a73eb2 267 // assume a basic setup with no expansion boards
mjr 53:9b2611964afc 268 expan.typ = 0;
mjr 53:9b2611964afc 269 expan.vsn = 0;
mjr 53:9b2611964afc 270 memset(expan.ext, 0, sizeof(expan.ext));
mjr 52:8298b2a73eb2 271
mjr 35:e959ffba78fd 272 // assume no plunger is attached
mjr 77:0b96f6867312 273 plunger.enabled = 0x00;
mjr 35:e959ffba78fd 274 plunger.sensorType = PlungerType_None;
mjr 35:e959ffba78fd 275
mjr 55:4db125cd11a0 276 #if TEST_CONFIG_EXPAN || STANDARD_CONFIG
mjr 77:0b96f6867312 277 plunger.enabled = 0x01;
mjr 82:4f6209cb5c33 278 plunger.sensorType = PlungerType_TSL1410R;
mjr 53:9b2611964afc 279 plunger.sensorPin[0] = PINNAME_TO_WIRE(PTE20); // SI
mjr 53:9b2611964afc 280 plunger.sensorPin[1] = PINNAME_TO_WIRE(PTE21); // SCLK
mjr 53:9b2611964afc 281 plunger.sensorPin[2] = PINNAME_TO_WIRE(PTB0); // AO1 = PTB0 = ADC0_SE8
mjr 53:9b2611964afc 282 plunger.sensorPin[3] = PINNAME_TO_WIRE(PTE22); // AO2 (parallel mode) = PTE22 = ADC0_SE3
mjr 43:7a6364d82a41 283 #endif
mjr 43:7a6364d82a41 284
mjr 48:058ace2aed1d 285 // default plunger calibration button settings
mjr 55:4db125cd11a0 286 plunger.cal.features = 0x03; // 0x01 = enable button, 0x02 = enable indicator lamp
mjr 55:4db125cd11a0 287 plunger.cal.btn = PINNAME_TO_WIRE(PTE29); // button input (DigitalIn port)
mjr 55:4db125cd11a0 288 plunger.cal.led = PINNAME_TO_WIRE(PTE23); // button output (DigitalOut port)
mjr 35:e959ffba78fd 289
mjr 44:b5ac89b9cd5d 290 // set the default plunger calibration
mjr 44:b5ac89b9cd5d 291 plunger.cal.setDefaults();
mjr 35:e959ffba78fd 292
mjr 35:e959ffba78fd 293 // disable the ZB Launch Ball by default
mjr 53:9b2611964afc 294 plunger.zbLaunchBall.port = 0; // 0 = disabled
mjr 65:739875521aae 295 plunger.zbLaunchBall.keytype = BtnTypeKey; // keyboard key
mjr 61:3c7e6e9ec355 296 plunger.zbLaunchBall.keycode = 0x28; // USB keyboard scan code for Enter key
mjr 61:3c7e6e9ec355 297 plunger.zbLaunchBall.pushDistance = 63; // 63/1000 in == .063" == about 1/16"
mjr 35:e959ffba78fd 298
mjr 35:e959ffba78fd 299 // assume no TV ON switch
mjr 53:9b2611964afc 300 TVON.statusPin = PINNAME_TO_WIRE(NC);
mjr 53:9b2611964afc 301 TVON.latchPin = PINNAME_TO_WIRE(NC);
mjr 53:9b2611964afc 302 TVON.relayPin = PINNAME_TO_WIRE(NC);
mjr 53:9b2611964afc 303 TVON.delayTime = 700; // 7 seconds
mjr 55:4db125cd11a0 304
mjr 55:4db125cd11a0 305 #if TEST_CONFIG_EXPAN
mjr 55:4db125cd11a0 306 // expansion board TV ON wiring
mjr 53:9b2611964afc 307 TVON.statusPin = PINNAME_TO_WIRE(PTD2);
mjr 53:9b2611964afc 308 TVON.latchPin = PINNAME_TO_WIRE(PTE0);
mjr 53:9b2611964afc 309 TVON.relayPin = PINNAME_TO_WIRE(PTD3);
mjr 53:9b2611964afc 310 TVON.delayTime = 700; // 7 seconds
mjr 38:091e511ce8a0 311 #endif
mjr 53:9b2611964afc 312
mjr 53:9b2611964afc 313 // assume no night mode switch or indicator lamp
mjr 53:9b2611964afc 314 nightMode.btn = 0;
mjr 53:9b2611964afc 315 nightMode.flags = 0;
mjr 53:9b2611964afc 316 nightMode.port = 0;
mjr 35:e959ffba78fd 317
mjr 35:e959ffba78fd 318 // assume no TLC5940 chips
mjr 35:e959ffba78fd 319 tlc5940.nchips = 0;
mjr 55:4db125cd11a0 320
mjr 55:4db125cd11a0 321 #if TEST_CONFIG_EXPAN
mjr 55:4db125cd11a0 322 // for expansion board testing purposes, assume the common setup
mjr 55:4db125cd11a0 323 // with one main board and one power board
mjr 48:058ace2aed1d 324 tlc5940.nchips = 4;
mjr 38:091e511ce8a0 325 #endif
mjr 38:091e511ce8a0 326
mjr 55:4db125cd11a0 327 // Default TLC5940 pin assignments. Note that it's harmless to set
mjr 55:4db125cd11a0 328 // these to valid pins even if no TLC5940 chips are actually present,
mjr 55:4db125cd11a0 329 // since the main program won't allocate the connections if 'nchips'
mjr 55:4db125cd11a0 330 // is zero. This means that the pins are free to be used for other
mjr 55:4db125cd11a0 331 // purposes (such as output ports) if not using TLC5940 chips.
mjr 53:9b2611964afc 332 tlc5940.sin = PINNAME_TO_WIRE(PTC6);
mjr 53:9b2611964afc 333 tlc5940.sclk = PINNAME_TO_WIRE(PTC5);
mjr 53:9b2611964afc 334 tlc5940.xlat = PINNAME_TO_WIRE(PTC10);
mjr 59:94eb9265b6d7 335 tlc5940.blank = PINNAME_TO_WIRE(PTC7);
mjr 59:94eb9265b6d7 336 #if TEST_KEEP_PRINTF
mjr 59:94eb9265b6d7 337 tlc5940.gsclk = PINNAME_TO_WIRE(PTA13); // PTA1 is reserved for SDA printf()
mjr 59:94eb9265b6d7 338 #else
mjr 53:9b2611964afc 339 tlc5940.gsclk = PINNAME_TO_WIRE(PTA1);
mjr 59:94eb9265b6d7 340 #endif
mjr 35:e959ffba78fd 341
mjr 35:e959ffba78fd 342 // assume no 74HC595 chips
mjr 35:e959ffba78fd 343 hc595.nchips = 0;
mjr 55:4db125cd11a0 344
mjr 55:4db125cd11a0 345 #if TEST_CONFIG_EXPAN
mjr 55:4db125cd11a0 346 // for expansion board testing purposes, assume one chime board
mjr 48:058ace2aed1d 347 hc595.nchips = 1;
mjr 40:cc0d9814522b 348 #endif
mjr 40:cc0d9814522b 349
mjr 55:4db125cd11a0 350 // Default 74HC595 pin assignments. As with the TLC5940 pins, it's
mjr 55:4db125cd11a0 351 // harmless to assign pins here even if no 74HC595 chips are used,
mjr 55:4db125cd11a0 352 // since the main program won't actually allocate the pins if 'nchips'
mjr 55:4db125cd11a0 353 // is zero.
mjr 53:9b2611964afc 354 hc595.sin = PINNAME_TO_WIRE(PTA5);
mjr 53:9b2611964afc 355 hc595.sclk = PINNAME_TO_WIRE(PTA4);
mjr 53:9b2611964afc 356 hc595.latch = PINNAME_TO_WIRE(PTA12);
mjr 53:9b2611964afc 357 hc595.ena = PINNAME_TO_WIRE(PTD4);
mjr 38:091e511ce8a0 358
mjr 87:8d35c74403af 359 // disable all TLC59116 chips by default
mjr 87:8d35c74403af 360 tlc59116.chipMask = 0;
mjr 87:8d35c74403af 361
mjr 87:8d35c74403af 362 // Default TLC59116 pin assignments
mjr 87:8d35c74403af 363 tlc59116.sda = PINNAME_TO_WIRE(PTC6);
mjr 87:8d35c74403af 364 tlc59116.scl = PINNAME_TO_WIRE(PTC5);
mjr 87:8d35c74403af 365 tlc59116.reset = PINNAME_TO_WIRE(PTC10);
mjr 77:0b96f6867312 366
mjr 77:0b96f6867312 367 // Default IR hardware pin assignments. On the expansion boards,
mjr 77:0b96f6867312 368 // the sensor is connected to PTA13, and the emitter LED is on PTC9.
mjr 77:0b96f6867312 369 #if TEST_CONFIG_EXPAN
mjr 77:0b96f6867312 370 IR.sensor = PINNAME_TO_WIRE(PTA13);
mjr 77:0b96f6867312 371 IR.emitter = PINNAME_TO_WIRE(PTC9);
mjr 77:0b96f6867312 372 #else
mjr 77:0b96f6867312 373 IR.sensor = PINNAME_TO_WIRE(NC);
mjr 77:0b96f6867312 374 IR.emitter = PINNAME_TO_WIRE(NC);
mjr 77:0b96f6867312 375 #endif
mjr 77:0b96f6867312 376
mjr 77:0b96f6867312 377 // clear out all IR slots
mjr 77:0b96f6867312 378 memset(IRCommand, 0, sizeof(IRCommand));
mjr 77:0b96f6867312 379 for (int i = 0 ; i < MAX_IR_CODES ; ++i)
mjr 77:0b96f6867312 380 {
mjr 77:0b96f6867312 381 IRCommand[i].protocol = 0;
mjr 77:0b96f6867312 382 IRCommand[i].keytype = BtnTypeNone;
mjr 77:0b96f6867312 383 }
mjr 77:0b96f6867312 384
mjr 35:e959ffba78fd 385 // initially configure with no LedWiz output ports
mjr 35:e959ffba78fd 386 outPort[0].typ = PortTypeDisabled;
mjr 66:2e3583fbd2f4 387
mjr 66:2e3583fbd2f4 388 // initially configure with no shift key
mjr 78:1e00b3fa11af 389 shiftButton.idx = 0;
mjr 78:1e00b3fa11af 390 shiftButton.mode = 0;
mjr 53:9b2611964afc 391
mjr 35:e959ffba78fd 392 // initially configure with no input buttons
mjr 35:e959ffba78fd 393 for (int i = 0 ; i < MAX_BUTTONS ; ++i)
mjr 53:9b2611964afc 394 button[i].set(PINNAME_TO_WIRE(NC), BtnTypeNone, 0);
mjr 38:091e511ce8a0 395
mjr 55:4db125cd11a0 396 #if STANDARD_CONFIG | TEST_CONFIG_EXPAN
mjr 55:4db125cd11a0 397 // For the standard configuration, assign 24 input ports to
mjr 55:4db125cd11a0 398 // joystick buttons 1-24. Assign the same GPIO pins used
mjr 55:4db125cd11a0 399 // in the original v1 default configuration. For expansion
mjr 55:4db125cd11a0 400 // board testing purposes, also assign the input ports, with
mjr 55:4db125cd11a0 401 // the noted differences.
mjr 38:091e511ce8a0 402 for (int i = 0 ; i < 24 ; ++i) {
mjr 55:4db125cd11a0 403 static const int bp[] = {
mjr 53:9b2611964afc 404 PINNAME_TO_WIRE(PTC2), // 1
mjr 53:9b2611964afc 405 PINNAME_TO_WIRE(PTB3), // 2
mjr 53:9b2611964afc 406 PINNAME_TO_WIRE(PTB2), // 3
mjr 53:9b2611964afc 407 PINNAME_TO_WIRE(PTB1), // 4
mjr 53:9b2611964afc 408 PINNAME_TO_WIRE(PTE30), // 5
mjr 48:058ace2aed1d 409 #if TEST_CONFIG_EXPAN
mjr 55:4db125cd11a0 410 PINNAME_TO_WIRE(PTC11), // 6 - expansion boards use PTC11 for this, since PTE22
mjr 55:4db125cd11a0 411 // is reserved for a plunger connection
mjr 55:4db125cd11a0 412 #elif STANDARD_CONFIG
mjr 55:4db125cd11a0 413 PINNAME_TO_WIRE(PTE22), // 6 - original standalone setup uses PTE22
mjr 48:058ace2aed1d 414 #endif
mjr 53:9b2611964afc 415 PINNAME_TO_WIRE(PTE5), // 7
mjr 53:9b2611964afc 416 PINNAME_TO_WIRE(PTE4), // 8
mjr 53:9b2611964afc 417 PINNAME_TO_WIRE(PTE3), // 9
mjr 53:9b2611964afc 418 PINNAME_TO_WIRE(PTE2), // 10
mjr 53:9b2611964afc 419 PINNAME_TO_WIRE(PTB11), // 11
mjr 53:9b2611964afc 420 PINNAME_TO_WIRE(PTB10), // 12
mjr 53:9b2611964afc 421 PINNAME_TO_WIRE(PTB9), // 13
mjr 53:9b2611964afc 422 PINNAME_TO_WIRE(PTB8), // 14
mjr 53:9b2611964afc 423 PINNAME_TO_WIRE(PTC12), // 15
mjr 53:9b2611964afc 424 PINNAME_TO_WIRE(PTC13), // 16
mjr 53:9b2611964afc 425 PINNAME_TO_WIRE(PTC16), // 17
mjr 53:9b2611964afc 426 PINNAME_TO_WIRE(PTC17), // 18
mjr 53:9b2611964afc 427 PINNAME_TO_WIRE(PTA16), // 19
mjr 53:9b2611964afc 428 PINNAME_TO_WIRE(PTA17), // 20
mjr 53:9b2611964afc 429 PINNAME_TO_WIRE(PTE31), // 21
mjr 53:9b2611964afc 430 PINNAME_TO_WIRE(PTD6), // 22
mjr 53:9b2611964afc 431 PINNAME_TO_WIRE(PTD7), // 23
mjr 53:9b2611964afc 432 PINNAME_TO_WIRE(PTE1) // 24
mjr 40:cc0d9814522b 433 };
mjr 48:058ace2aed1d 434 button[i].set(bp[i],
mjr 48:058ace2aed1d 435 #if TEST_CONFIG_EXPAN
mjr 55:4db125cd11a0 436 // For expansion board testing only, assign the inputs
mjr 55:4db125cd11a0 437 // to keyboard keys A, B, etc. This isn't useful; it's
mjr 55:4db125cd11a0 438 // just for testing purposes. Note that the USB key code
mjr 55:4db125cd11a0 439 // for "A" is 4, "B" is 5, and so on sequentially through
mjr 55:4db125cd11a0 440 // the alphabet.
mjr 55:4db125cd11a0 441 BtnTypeKey, i+4);
mjr 55:4db125cd11a0 442 #elif STANDARD_CONFIG
mjr 55:4db125cd11a0 443 // For the standard configuration, assign the input to
mjr 55:4db125cd11a0 444 // joystick buttons 1-24, as in the original v1 default
mjr 55:4db125cd11a0 445 // configuration.
mjr 55:4db125cd11a0 446 BtnTypeJoystick, i+1);
mjr 48:058ace2aed1d 447 #endif
mjr 48:058ace2aed1d 448
mjr 38:091e511ce8a0 449 }
mjr 38:091e511ce8a0 450 #endif
mjr 38:091e511ce8a0 451
mjr 55:4db125cd11a0 452 #if TEST_CONFIG_EXPAN
mjr 55:4db125cd11a0 453 // For testing purposes, configure the basic complement of
mjr 55:4db125cd11a0 454 // expansion board ports. AS MENTIONED ABOVE, THIS IS PURELY FOR
mjr 55:4db125cd11a0 455 // TESTING. DON'T USE THIS METHOD TO CONFIGURE YOUR EXPANSION
mjr 55:4db125cd11a0 456 // BOARDS FOR ACTUAL DEPLOYMENT. It's much easier and cleaner
mjr 55:4db125cd11a0 457 // to use the unmodified standard build, and customize your
mjr 55:4db125cd11a0 458 // installation with the Pinscape Config Tool on Windows.
mjr 40:cc0d9814522b 459 //
mjr 55:4db125cd11a0 460 // For this testing setup, we'll configure one main board, one
mjr 55:4db125cd11a0 461 // power board, and one chime board. The *physical* ports on
mjr 55:4db125cd11a0 462 // the board are shown below. The logical (LedWiz/DOF) numbering
mjr 55:4db125cd11a0 463 // ISN'T sequential through the physical ports, because we want
mjr 55:4db125cd11a0 464 // to arrange the DOF ports so that the most important and most
mjr 55:4db125cd11a0 465 // common toys are assigned to ports 1-32. Those ports are
mjr 55:4db125cd11a0 466 // special because they're accessible to ALL software on the PC,
mjr 55:4db125cd11a0 467 // including older LedWiz-only software such as Future Pinball.
mjr 55:4db125cd11a0 468 // Ports above 32 are accessible only to modern DOF software,
mjr 55:4db125cd11a0 469 // like Visual Pinball and PinballX.
mjr 40:cc0d9814522b 470 //
mjr 40:cc0d9814522b 471 // Main board
mjr 40:cc0d9814522b 472 // TLC ports 0-15 -> flashers
mjr 40:cc0d9814522b 473 // TLC ports 16 -> strobe
mjr 40:cc0d9814522b 474 // TLC ports 17-31 -> flippers
mjr 40:cc0d9814522b 475 // Dig GPIO PTC8 -> knocker (timer-protected outputs)
mjr 40:cc0d9814522b 476 //
mjr 40:cc0d9814522b 477 // Power board:
mjr 40:cc0d9814522b 478 // TLC ports 32-63 -> general purpose outputs
mjr 40:cc0d9814522b 479 //
mjr 40:cc0d9814522b 480 // Chime board:
mjr 40:cc0d9814522b 481 // HC595 ports 0-7 -> timer-protected outputs
mjr 40:cc0d9814522b 482 //
mjr 38:091e511ce8a0 483 {
mjr 38:091e511ce8a0 484 int n = 0;
mjr 40:cc0d9814522b 485
mjr 40:cc0d9814522b 486 // 1-15 = flashers (TLC ports 0-15)
mjr 40:cc0d9814522b 487 // 16 = strobe (TLC port 15)
mjr 40:cc0d9814522b 488 for (int i = 0 ; i < 16 ; ++i)
mjr 40:cc0d9814522b 489 outPort[n++].set(PortTypeTLC5940, i, PortFlagGamma);
mjr 40:cc0d9814522b 490
mjr 53:9b2611964afc 491 // 17 = knocker (PTC8)
mjr 53:9b2611964afc 492 outPort[n++].set(PortTypeGPIODig, PINNAME_TO_WIRE(PTC8));
mjr 35:e959ffba78fd 493
mjr 40:cc0d9814522b 494 // 18-49 = power board outputs 1-32 (TLC ports 32-63)
mjr 40:cc0d9814522b 495 for (int i = 0 ; i < 32 ; ++i)
mjr 40:cc0d9814522b 496 outPort[n++].set(PortTypeTLC5940, i+32);
mjr 40:cc0d9814522b 497
mjr 40:cc0d9814522b 498 // 50-65 = flipper RGB (TLC ports 16-31)
mjr 40:cc0d9814522b 499 for (int i = 0 ; i < 16 ; ++i)
mjr 40:cc0d9814522b 500 outPort[n++].set(PortTypeTLC5940, i+16, PortFlagGamma);
mjr 59:94eb9265b6d7 501
mjr 40:cc0d9814522b 502 // 66-73 = chime board ports 1-8 (74HC595 ports 0-7)
mjr 40:cc0d9814522b 503 for (int i = 0 ; i < 8 ; ++i)
mjr 40:cc0d9814522b 504 outPort[n++].set(PortType74HC595, i);
mjr 59:94eb9265b6d7 505
mjr 40:cc0d9814522b 506 // set Disabled to signify end of configured outputs
mjr 38:091e511ce8a0 507 outPort[n].typ = PortTypeDisabled;
mjr 38:091e511ce8a0 508 }
mjr 38:091e511ce8a0 509 #endif
mjr 48:058ace2aed1d 510
mjr 55:4db125cd11a0 511 #if STANDARD_CONFIG
mjr 55:4db125cd11a0 512 //
mjr 55:4db125cd11a0 513 // For the standard build, set up the original complement
mjr 55:4db125cd11a0 514 // of 22 ports from the v1 default onfiguration.
mjr 55:4db125cd11a0 515 //
mjr 55:4db125cd11a0 516 // IMPORTANT! As mentioned above, don't edit this file to
mjr 55:4db125cd11a0 517 // customize this for your machine. Instead, use the unmodified
mjr 55:4db125cd11a0 518 // standard build, and customize your installation using the
mjr 55:4db125cd11a0 519 // Pinscape Config Tool on Windows.
mjr 55:4db125cd11a0 520 //
mjr 48:058ace2aed1d 521 #if TEST_KEEP_PRINTF
mjr 55:4db125cd11a0 522 outPort[ 0].set(PortTypeVirtual, PINNAME_TO_WIRE(NC)); // port 1 = NC to keep debug printf (PTA1 is SDA UART)
mjr 55:4db125cd11a0 523 outPort[ 1].set(PortTypeVirtual, PINNAME_TO_WIRE(NC)); // port 2 = NC to keep debug printf (PTA2 is SDA UART)
mjr 48:058ace2aed1d 524 #else
mjr 53:9b2611964afc 525 outPort[ 0].set(PortTypeGPIOPWM, PINNAME_TO_WIRE(PTA1)); // port 1 = PTA1
mjr 53:9b2611964afc 526 outPort[ 1].set(PortTypeGPIOPWM, PINNAME_TO_WIRE(PTA2)); // port 2 = PTA2
mjr 48:058ace2aed1d 527 #endif
mjr 53:9b2611964afc 528 outPort[ 2].set(PortTypeGPIOPWM, PINNAME_TO_WIRE(PTD4)); // port 3 = PTD4
mjr 53:9b2611964afc 529 outPort[ 3].set(PortTypeGPIOPWM, PINNAME_TO_WIRE(PTA12)); // port 4 = PTA12
mjr 53:9b2611964afc 530 outPort[ 4].set(PortTypeGPIOPWM, PINNAME_TO_WIRE(PTA4)); // port 5 = PTA4
mjr 53:9b2611964afc 531 outPort[ 5].set(PortTypeGPIOPWM, PINNAME_TO_WIRE(PTA5)); // port 6 = PTA5
mjr 53:9b2611964afc 532 outPort[ 6].set(PortTypeGPIOPWM, PINNAME_TO_WIRE(PTA13)); // port 7 = PTA13
mjr 53:9b2611964afc 533 outPort[ 7].set(PortTypeGPIOPWM, PINNAME_TO_WIRE(PTD5)); // port 8 = PTD5
mjr 53:9b2611964afc 534 outPort[ 8].set(PortTypeGPIOPWM, PINNAME_TO_WIRE(PTD0)); // port 9 = PTD0
mjr 53:9b2611964afc 535 outPort[ 9].set(PortTypeGPIOPWM, PINNAME_TO_WIRE(PTD3)); // port 10 = PTD3
mjr 53:9b2611964afc 536 outPort[10].set(PortTypeGPIODig, PINNAME_TO_WIRE(PTD2)); // port 11 = PTD2
mjr 53:9b2611964afc 537 outPort[11].set(PortTypeGPIODig, PINNAME_TO_WIRE(PTC8)); // port 12 = PTC8
mjr 53:9b2611964afc 538 outPort[12].set(PortTypeGPIODig, PINNAME_TO_WIRE(PTC9)); // port 13 = PTC9
mjr 53:9b2611964afc 539 outPort[13].set(PortTypeGPIODig, PINNAME_TO_WIRE(PTC7)); // port 14 = PTC7
mjr 53:9b2611964afc 540 outPort[14].set(PortTypeGPIODig, PINNAME_TO_WIRE(PTC0)); // port 15 = PTC0
mjr 53:9b2611964afc 541 outPort[15].set(PortTypeGPIODig, PINNAME_TO_WIRE(PTC3)); // port 16 = PTC3
mjr 53:9b2611964afc 542 outPort[16].set(PortTypeGPIODig, PINNAME_TO_WIRE(PTC4)); // port 17 = PTC4
mjr 53:9b2611964afc 543 outPort[17].set(PortTypeGPIODig, PINNAME_TO_WIRE(PTC5)); // port 18 = PTC5
mjr 53:9b2611964afc 544 outPort[18].set(PortTypeGPIODig, PINNAME_TO_WIRE(PTC6)); // port 19 = PTC6
mjr 53:9b2611964afc 545 outPort[19].set(PortTypeGPIODig, PINNAME_TO_WIRE(PTC10)); // port 20 = PTC10
mjr 53:9b2611964afc 546 outPort[20].set(PortTypeGPIODig, PINNAME_TO_WIRE(PTC11)); // port 21 = PTC11
mjr 53:9b2611964afc 547 outPort[21].set(PortTypeGPIODig, PINNAME_TO_WIRE(PTE0)); // port 22 = PTE0
mjr 48:058ace2aed1d 548 #endif
mjr 35:e959ffba78fd 549 }
mjr 35:e959ffba78fd 550
mjr 35:e959ffba78fd 551 // --- USB DEVICE CONFIGURATION ---
mjr 35:e959ffba78fd 552
mjr 35:e959ffba78fd 553 // USB device identification - vendor ID and product ID. For LedLWiz
mjr 35:e959ffba78fd 554 // emulation, use vendor ID 0xFAFA and product ID 0x00EF + unit#, where
mjr 35:e959ffba78fd 555 // unit# is the nominal LedWiz unit number from 1 to 16. Alternatively,
mjr 35:e959ffba78fd 556 // if LedWiz emulation isn't desired or causes any driver conflicts on
mjr 35:e959ffba78fd 557 // the host, we have a private Pinscape assignment as vendor ID 0x1209
mjr 35:e959ffba78fd 558 // and product ID 0xEAEA (registered with http://pid.codes, a registry
mjr 35:e959ffba78fd 559 // for open-source USB projects).
mjr 35:e959ffba78fd 560 uint16_t usbVendorID;
mjr 35:e959ffba78fd 561 uint16_t usbProductID;
mjr 35:e959ffba78fd 562
mjr 35:e959ffba78fd 563 // Pinscape Controller unit number. This is the nominal unit number,
mjr 35:e959ffba78fd 564 // from 1 to 16. We report this in the status query; DOF uses it to
mjr 53:9b2611964afc 565 // distinguish among Pinscape units. Note that this doesn't affect
mjr 35:e959ffba78fd 566 // the LedWiz unit numbering, which is implied by the USB Product ID.
mjr 35:e959ffba78fd 567 uint8_t psUnitNo;
mjr 35:e959ffba78fd 568
mjr 35:e959ffba78fd 569 // Are joystick reports enabled? Joystick reports can be turned off, to
mjr 35:e959ffba78fd 570 // use the device as purely an output controller.
mjr 77:0b96f6867312 571 uint8_t joystickEnabled;
mjr 35:e959ffba78fd 572
mjr 51:57eb311faafa 573 // Timeout for rebooting the KL25Z when the connection is lost. On some
mjr 51:57eb311faafa 574 // hosts, the mbed USB stack has problems reconnecting after an initial
mjr 51:57eb311faafa 575 // connection is dropped. As a workaround, we can automatically reboot
mjr 51:57eb311faafa 576 // the KL25Z when it detects that it's no longer connected, after the
mjr 51:57eb311faafa 577 // interval set here expires. The timeout is in seconds; setting this
mjr 51:57eb311faafa 578 // to 0 disables the automatic reboot.
mjr 51:57eb311faafa 579 uint8_t disconnectRebootTimeout;
mjr 35:e959ffba78fd 580
mjr 35:e959ffba78fd 581 // --- ACCELEROMETER ---
mjr 78:1e00b3fa11af 582 struct
mjr 78:1e00b3fa11af 583 {
mjr 78:1e00b3fa11af 584 // accelerometer orientation (OrientationXxx value)
mjr 78:1e00b3fa11af 585 uint8_t orientation;
mjr 35:e959ffba78fd 586
mjr 78:1e00b3fa11af 587 // dynamic range (AccelRangeXxx value)
mjr 78:1e00b3fa11af 588 uint8_t range;
mjr 77:0b96f6867312 589
mjr 78:1e00b3fa11af 590 // Auto-centering mode:
mjr 78:1e00b3fa11af 591 // 0 = auto-centering on, 5-second timer
mjr 78:1e00b3fa11af 592 // 1-60 = auto-centering on with the given timer in seconds
mjr 78:1e00b3fa11af 593 // 255 = auto-centering off
mjr 78:1e00b3fa11af 594 uint8_t autoCenterTime;
mjr 78:1e00b3fa11af 595
mjr 78:1e00b3fa11af 596 } accel;
mjr 35:e959ffba78fd 597
mjr 35:e959ffba78fd 598
mjr 52:8298b2a73eb2 599 // --- EXPANSION BOARDS ---
mjr 52:8298b2a73eb2 600 struct
mjr 52:8298b2a73eb2 601 {
mjr 53:9b2611964afc 602 uint8_t typ; // expansion board set type:
mjr 53:9b2611964afc 603 // 1 -> Pinscape expansion boards
mjr 53:9b2611964afc 604 uint8_t vsn; // board set interface version
mjr 53:9b2611964afc 605 uint8_t ext[3]; // board set type-specific extended data
mjr 52:8298b2a73eb2 606
mjr 52:8298b2a73eb2 607 } expan;
mjr 52:8298b2a73eb2 608
mjr 52:8298b2a73eb2 609
mjr 35:e959ffba78fd 610 // --- PLUNGER CONFIGURATION ---
mjr 35:e959ffba78fd 611 struct
mjr 35:e959ffba78fd 612 {
mjr 77:0b96f6867312 613 // Plunger enabled/disabled. Note that we use the status flag
mjr 77:0b96f6867312 614 // bit 0x01 if enabled, 0x00 if disabled. This conveniently
mjr 77:0b96f6867312 615 // can be tested as though it's a bool, but should always be
mjr 77:0b96f6867312 616 // stored as 0x01 or 0x00 so that it can be OR'ed into the
mjr 77:0b96f6867312 617 // status report flag bits.
mjr 77:0b96f6867312 618 uint8_t enabled;
mjr 33:d832bcab089e 619
mjr 35:e959ffba78fd 620 // plunger sensor type
mjr 77:0b96f6867312 621 uint8_t sensorType;
mjr 35:e959ffba78fd 622
mjr 35:e959ffba78fd 623 // Plunger sensor pins. To accommodate a wide range of sensor types,
mjr 35:e959ffba78fd 624 // we keep a generic list of 4 pin assignments. The use of each pin
mjr 35:e959ffba78fd 625 // varies by sensor. The lists below are in order of the generic
mjr 35:e959ffba78fd 626 // pins; NC means that the pin isn't used by the sensor. Each pin's
mjr 35:e959ffba78fd 627 // GPIO usage is also listed. Certain usages limit which physical
mjr 35:e959ffba78fd 628 // pins can be assigned (e.g., AnalogIn or PwmOut).
mjr 35:e959ffba78fd 629 //
mjr 82:4f6209cb5c33 630 // TSL1410R/1412S/1401CL: SI (GPIO), CLK (GPIO), AO (AnalogIn), NC
mjr 35:e959ffba78fd 631 // Potentiometer: AO (AnalogIn), NC, NC, NC
mjr 35:e959ffba78fd 632 // AEDR8300: A (InterruptIn), B (InterruptIn), NC, NC
mjr 35:e959ffba78fd 633 // AS5304: A (InterruptIn), B (InterruptIn), NC, NC
mjr 82:4f6209cb5c33 634 // VL6180X: SDA (GPIO), SCL (GPIO), GPIO0/CE (GPIO)
mjr 53:9b2611964afc 635 //
mjr 53:9b2611964afc 636 // Note! These are stored in uint8_t WIRE format, not PinName format.
mjr 53:9b2611964afc 637 uint8_t sensorPin[4];
mjr 35:e959ffba78fd 638
mjr 82:4f6209cb5c33 639 // Automatic zeroing. If enabled, we'll reset the plunger position to
mjr 82:4f6209cb5c33 640 // the park position after a period of inactivity. This only applies
mjr 82:4f6209cb5c33 641 // to certain sensor types; sensors that don't use it simply ignore it.
mjr 82:4f6209cb5c33 642 struct
mjr 82:4f6209cb5c33 643 {
mjr 82:4f6209cb5c33 644 uint8_t flags; // flags bits - combination of PlungerAutoZeroXxx flags
mjr 82:4f6209cb5c33 645 uint8_t t; // inactivity time in seconds
mjr 82:4f6209cb5c33 646 } autoZero;
mjr 82:4f6209cb5c33 647
mjr 85:3c28aee81cde 648 // Jitter filter. This is the size of the hysteresis window, in joystick
mjr 85:3c28aee81cde 649 // units (-4095..+4095). One joystick unit is approximately 1/10000" of
mjr 85:3c28aee81cde 650 // physical travel. Zero disables the jitter filter.
mjr 85:3c28aee81cde 651 uint16_t jitterWindow;
mjr 85:3c28aee81cde 652
mjr 87:8d35c74403af 653 // bar code sensor parameters
mjr 87:8d35c74403af 654 struct
mjr 87:8d35c74403af 655 {
mjr 87:8d35c74403af 656 uint16_t startPix; // starting pixel offset
mjr 87:8d35c74403af 657 } barCode;
mjr 87:8d35c74403af 658
mjr 53:9b2611964afc 659 // ZB LAUNCH BALL button setup.
mjr 35:e959ffba78fd 660 //
mjr 35:e959ffba78fd 661 // This configures the "ZB Launch Ball" feature in DOF, based on Zeb's (of
mjr 35:e959ffba78fd 662 // zebsboards.com) scheme for using a mechanical plunger as a Launch button.
mjr 35:e959ffba78fd 663 // Set the port to 0 to disable the feature.
mjr 35:e959ffba78fd 664 //
mjr 35:e959ffba78fd 665 // The port number is an LedWiz port number that we monitor for activation.
mjr 53:9b2611964afc 666 // This port isn't meant to be connected to a physical device, although it
mjr 53:9b2611964afc 667 // can be if desired. It's primarily to let the host tell the controller
mjr 53:9b2611964afc 668 // when the ZB Launch feature is active. The port numbering starts at 1;
mjr 53:9b2611964afc 669 // set this to zero to disable the feature.
mjr 35:e959ffba78fd 670 //
mjr 53:9b2611964afc 671 // The key type and code has the same meaning as for a button mapping. This
mjr 53:9b2611964afc 672 // sets the key input sent to the PC when the plunger triggers a launch when
mjr 53:9b2611964afc 673 // the mode is active. For example, set keytype=2 and keycode=0x28 to send
mjr 53:9b2611964afc 674 // the Enter key (which is the key almost all PC pinball software uses for
mjr 53:9b2611964afc 675 // plunger and Launch button input).
mjr 35:e959ffba78fd 676 //
mjr 40:cc0d9814522b 677 // The "push distance" is the distance, in 1/1000 inch units, for registering a
mjr 40:cc0d9814522b 678 // push on the plunger as a button push. If the player pushes the plunger
mjr 40:cc0d9814522b 679 // forward of the rest position by this amount, we'll treat it as pushing the
mjr 40:cc0d9814522b 680 // button, even if the player didn't pull back the plunger first. This lets
mjr 40:cc0d9814522b 681 // the player treat the plunger knob as a button for games where it's meaningful
mjr 35:e959ffba78fd 682 // to hold down the Launch button for specific intervals (e.g., "Championship
mjr 35:e959ffba78fd 683 // Pub").
mjr 35:e959ffba78fd 684 struct
mjr 35:e959ffba78fd 685 {
mjr 53:9b2611964afc 686 uint8_t port;
mjr 53:9b2611964afc 687 uint8_t keytype;
mjr 53:9b2611964afc 688 uint8_t keycode;
mjr 53:9b2611964afc 689 uint16_t pushDistance;
mjr 35:e959ffba78fd 690
mjr 35:e959ffba78fd 691 } zbLaunchBall;
mjr 35:e959ffba78fd 692
mjr 35:e959ffba78fd 693 // --- PLUNGER CALIBRATION ---
mjr 35:e959ffba78fd 694 struct
mjr 35:e959ffba78fd 695 {
mjr 35:e959ffba78fd 696 // has the plunger been calibrated?
mjr 53:9b2611964afc 697 bool calibrated;
mjr 55:4db125cd11a0 698
mjr 55:4db125cd11a0 699 // Feature enable mask:
mjr 55:4db125cd11a0 700 //
mjr 55:4db125cd11a0 701 // 0x01 = calibration button enabled
mjr 55:4db125cd11a0 702 // 0x02 = indicator light enabled
mjr 55:4db125cd11a0 703 uint8_t features;
mjr 35:e959ffba78fd 704
mjr 35:e959ffba78fd 705 // calibration button switch pin
mjr 53:9b2611964afc 706 uint8_t btn;
mjr 35:e959ffba78fd 707
mjr 35:e959ffba78fd 708 // calibration button indicator light pin
mjr 53:9b2611964afc 709 uint8_t led;
mjr 35:e959ffba78fd 710
mjr 48:058ace2aed1d 711 // Plunger calibration min, zero, and max. These are in terms of the
mjr 48:058ace2aed1d 712 // unsigned 16-bit scale (0x0000..0xffff) that we use for the raw sensor
mjr 48:058ace2aed1d 713 // readings.
mjr 48:058ace2aed1d 714 //
mjr 48:058ace2aed1d 715 // The zero point is the rest position (aka park position), where the
mjr 48:058ace2aed1d 716 // plunger is in equilibrium between the main spring and the barrel
mjr 48:058ace2aed1d 717 // spring. In the standard setup, the plunger can travel a small
mjr 48:058ace2aed1d 718 // distance forward of the rest position, because the barrel spring
mjr 48:058ace2aed1d 719 // can be compressed a bit. The minimum is the maximum forward point
mjr 48:058ace2aed1d 720 // where the barrel spring can't be compressed any further.
mjr 48:058ace2aed1d 721 uint16_t min;
mjr 48:058ace2aed1d 722 uint16_t zero;
mjr 48:058ace2aed1d 723 uint16_t max;
mjr 52:8298b2a73eb2 724
mjr 52:8298b2a73eb2 725 // Measured release time, in milliseconds.
mjr 52:8298b2a73eb2 726 uint8_t tRelease;
mjr 35:e959ffba78fd 727
mjr 44:b5ac89b9cd5d 728 // Reset the plunger calibration
mjr 44:b5ac89b9cd5d 729 void setDefaults()
mjr 35:e959ffba78fd 730 {
mjr 44:b5ac89b9cd5d 731 calibrated = false; // not calibrated
mjr 48:058ace2aed1d 732 min = 0; // assume we can go all the way forward...
mjr 48:058ace2aed1d 733 max = 0xffff; // ...and all the way back
mjr 48:058ace2aed1d 734 zero = max/6; // the rest position is usually around 1/2" back = 1/6 of total travel
mjr 52:8298b2a73eb2 735 tRelease = 65; // standard 65ms release time
mjr 44:b5ac89b9cd5d 736 }
mjr 44:b5ac89b9cd5d 737
mjr 44:b5ac89b9cd5d 738 // Begin calibration. This sets each limit to the worst
mjr 44:b5ac89b9cd5d 739 // case point - for example, we set the retracted position
mjr 44:b5ac89b9cd5d 740 // to all the way forward. Each actual reading that comes
mjr 44:b5ac89b9cd5d 741 // in is then checked against the current limit, and if it's
mjr 44:b5ac89b9cd5d 742 // outside of the limit, we reset the limit to the new reading.
mjr 44:b5ac89b9cd5d 743 void begin()
mjr 44:b5ac89b9cd5d 744 {
mjr 48:058ace2aed1d 745 min = 0; // we don't calibrate the maximum forward position, so keep this at zero
mjr 48:058ace2aed1d 746 zero = 0xffff; // set the zero position all the way back
mjr 48:058ace2aed1d 747 max = 0; // set the retracted position all the way forward
mjr 52:8298b2a73eb2 748 tRelease = 65; // revert to a default release time
mjr 35:e959ffba78fd 749 }
mjr 17:ab3cec0c8bf4 750
mjr 35:e959ffba78fd 751 } cal;
mjr 18:5e890ebd0023 752
mjr 35:e959ffba78fd 753 } plunger;
mjr 29:582472d0bc57 754
mjr 35:e959ffba78fd 755
mjr 35:e959ffba78fd 756 // --- TV ON SWITCH ---
mjr 35:e959ffba78fd 757 //
mjr 35:e959ffba78fd 758 // To use the TV ON switch feature, the special power sensing circuitry
mjr 35:e959ffba78fd 759 // implemented on the Expansion Board must be attached (or an equivalent
mjr 35:e959ffba78fd 760 // circuit, as described in the Build Guide). The circuitry lets us
mjr 35:e959ffba78fd 761 // detect power state changes on the secondary power supply.
mjr 35:e959ffba78fd 762 struct
mjr 35:e959ffba78fd 763 {
mjr 35:e959ffba78fd 764 // PSU2 power status sense (DigitalIn pin). This pin goes LOW when the
mjr 35:e959ffba78fd 765 // secondary power supply is turned off, and remains LOW until the LATCH
mjr 35:e959ffba78fd 766 // pin is raised high AND the secondary PSU is turned on. Once HIGH,
mjr 35:e959ffba78fd 767 // it remains HIGH as long as the secondary PSU is on.
mjr 53:9b2611964afc 768 uint8_t statusPin;
mjr 35:e959ffba78fd 769
mjr 35:e959ffba78fd 770 // PSU2 power status latch (DigitalOut pin)
mjr 53:9b2611964afc 771 uint8_t latchPin;
mjr 35:e959ffba78fd 772
mjr 35:e959ffba78fd 773 // TV ON relay pin (DigitalOut pin). This pin controls the TV switch
mjr 35:e959ffba78fd 774 // relay. Raising the pin HIGH turns the relay ON (energizes the coil).
mjr 53:9b2611964afc 775 uint8_t relayPin;
mjr 35:e959ffba78fd 776
mjr 40:cc0d9814522b 777 // TV ON delay time, in 1/100 second units. This is the interval between
mjr 40:cc0d9814522b 778 // sensing that the secondary power supply has turned on and pulsing the
mjr 40:cc0d9814522b 779 // TV ON switch relay.
mjr 40:cc0d9814522b 780 int delayTime;
mjr 35:e959ffba78fd 781
mjr 35:e959ffba78fd 782 } TVON;
mjr 35:e959ffba78fd 783
mjr 53:9b2611964afc 784 // --- Night Mode ---
mjr 53:9b2611964afc 785 struct
mjr 53:9b2611964afc 786 {
mjr 55:4db125cd11a0 787 uint8_t btn; // night mode button number (1..MAX_BUTTONS, 0 = no button)
mjr 53:9b2611964afc 788 uint8_t flags; // flags:
mjr 53:9b2611964afc 789 // 0x01 = on/off switch (if not set, it's a momentary button)
mjr 55:4db125cd11a0 790 uint8_t port; // indicator output port number (1..MAX_OUT_PORTS, 0 = no indicator)
mjr 53:9b2611964afc 791 } nightMode;
mjr 53:9b2611964afc 792
mjr 29:582472d0bc57 793
mjr 35:e959ffba78fd 794 // --- TLC5940NT PWM Controller Chip Setup ---
mjr 35:e959ffba78fd 795 struct
mjr 35:e959ffba78fd 796 {
mjr 35:e959ffba78fd 797 // number of TLC5940NT chips connected in daisy chain
mjr 87:8d35c74403af 798 uint8_t nchips;
mjr 35:e959ffba78fd 799
mjr 53:9b2611964afc 800 // pin connections (wire pin IDs)
mjr 53:9b2611964afc 801 uint8_t sin; // Serial data - must connect to SPIO MOSI -> PTC6 or PTD2
mjr 53:9b2611964afc 802 uint8_t sclk; // Serial clock - must connect to SPIO SCLK -> PTC5 or PTD1
mjr 35:e959ffba78fd 803 // (but don't use PTD1, since it's hard-wired to the on-board blue LED)
mjr 53:9b2611964afc 804 uint8_t xlat; // XLAT (latch) signal - connect to any GPIO pin
mjr 53:9b2611964afc 805 uint8_t blank; // BLANK signal - connect to any GPIO pin
mjr 53:9b2611964afc 806 uint8_t gsclk; // Grayscale clock - must connect to a PWM-out capable pin
mjr 29:582472d0bc57 807
mjr 35:e959ffba78fd 808 } tlc5940;
mjr 35:e959ffba78fd 809
mjr 35:e959ffba78fd 810
mjr 35:e959ffba78fd 811 // --- 74HC595 Shift Register Setup ---
mjr 35:e959ffba78fd 812 struct
mjr 35:e959ffba78fd 813 {
mjr 35:e959ffba78fd 814 // number of 74HC595 chips attached in daisy chain
mjr 87:8d35c74403af 815 uint8_t nchips;
mjr 35:e959ffba78fd 816
mjr 35:e959ffba78fd 817 // pin connections
mjr 53:9b2611964afc 818 uint8_t sin; // Serial data - use any GPIO pin
mjr 53:9b2611964afc 819 uint8_t sclk; // Serial clock - use any GPIO pin
mjr 53:9b2611964afc 820 uint8_t latch; // Latch - use any GPIO pin
mjr 53:9b2611964afc 821 uint8_t ena; // Enable signal - use any GPIO pin
mjr 35:e959ffba78fd 822
mjr 35:e959ffba78fd 823 } hc595;
mjr 77:0b96f6867312 824
mjr 87:8d35c74403af 825 // --- TLC59116 PWM Controller Chip Setup --
mjr 87:8d35c74403af 826 struct
mjr 87:8d35c74403af 827 {
mjr 87:8d35c74403af 828 // Chip mask. Each bit represents an enabled chip at the
mjr 87:8d35c74403af 829 // corresponding 4-bit address (i.e., bit 1<<addr represents
mjr 87:8d35c74403af 830 // the chip at 'addr').
mjr 87:8d35c74403af 831 uint16_t chipMask;
mjr 87:8d35c74403af 832
mjr 87:8d35c74403af 833 // pin connections
mjr 87:8d35c74403af 834 uint8_t sda; // I2C SDA
mjr 87:8d35c74403af 835 uint8_t scl; // I2C SCL
mjr 87:8d35c74403af 836 uint8_t reset; // !RESET (hardware reset line, active low)
mjr 87:8d35c74403af 837
mjr 87:8d35c74403af 838 } tlc59116;
mjr 87:8d35c74403af 839
mjr 77:0b96f6867312 840
mjr 77:0b96f6867312 841 // --- IR Remote Control Hardware Setup ---
mjr 77:0b96f6867312 842 struct
mjr 77:0b96f6867312 843 {
mjr 77:0b96f6867312 844 // sensor (receiver) GPIO input pin; must be interrupt-capable
mjr 77:0b96f6867312 845 uint8_t sensor;
mjr 77:0b96f6867312 846
mjr 77:0b96f6867312 847 // IR emitter LED GPIO output pin; must be PWM-capable
mjr 77:0b96f6867312 848 uint8_t emitter;
mjr 77:0b96f6867312 849 } IR;
mjr 77:0b96f6867312 850
mjr 77:0b96f6867312 851
mjr 35:e959ffba78fd 852 // --- Button Input Setup ---
mjr 65:739875521aae 853 ButtonCfg button[MAX_BUTTONS + VIRTUAL_BUTTONS] __attribute__((packed));
mjr 66:2e3583fbd2f4 854
mjr 78:1e00b3fa11af 855 // Shift button. This can be used to give each physical button a
mjr 78:1e00b3fa11af 856 // second meaning.
mjr 78:1e00b3fa11af 857 struct
mjr 78:1e00b3fa11af 858 {
mjr 78:1e00b3fa11af 859 // Shift button index, 1..MAX_BUTTONS. If this is zero, there's
mjr 78:1e00b3fa11af 860 // no shift button.
mjr 78:1e00b3fa11af 861 uint8_t idx;
mjr 78:1e00b3fa11af 862
mjr 78:1e00b3fa11af 863 // Shift button mode. If the shift button has a key mapping or
mjr 78:1e00b3fa11af 864 // IR command assigned, this determines what happens when the
mjr 78:1e00b3fa11af 865 // shift button is pressed in combination with another key.
mjr 78:1e00b3fa11af 866 //
mjr 78:1e00b3fa11af 867 // 0 = Shift OR Key mode. In this mode, when you initially press
mjr 78:1e00b3fa11af 868 // the shift button, nothing happens. Instead, we wait to see if
mjr 78:1e00b3fa11af 869 // any other buttons are pressed. If so, we use the shifted meaning
mjr 78:1e00b3fa11af 870 // of the other button, and we DON'T send the shift button's key or
mjr 78:1e00b3fa11af 871 // IR command at all.
mjr 78:1e00b3fa11af 872 //
mjr 78:1e00b3fa11af 873 // 1 = Shift AND Key mode. In this mode, the shift button acts like
mjr 78:1e00b3fa11af 874 // any other button: its assigned key is sent to the PC as soon as
mjr 78:1e00b3fa11af 875 // you press it. If you also press another button while the shift
mjr 78:1e00b3fa11af 876 // button is down, the shifted meaning of the other button is used.
mjr 78:1e00b3fa11af 877 //
mjr 78:1e00b3fa11af 878 // Mode 0, the "OR" mode, is the default. This allows a button with
mjr 78:1e00b3fa11af 879 // a key assignment to do double duty as the shift button without
mjr 78:1e00b3fa11af 880 // creating any confusing situations where the shift button's own
mjr 78:1e00b3fa11af 881 // key is also sent to the PC during shift usage.
mjr 78:1e00b3fa11af 882 uint8_t mode;
mjr 78:1e00b3fa11af 883
mjr 78:1e00b3fa11af 884 } shiftButton;
mjr 17:ab3cec0c8bf4 885
mjr 35:e959ffba78fd 886 // --- LedWiz Output Port Setup ---
mjr 77:0b96f6867312 887 LedWizPortCfg outPort[MAX_OUT_PORTS] __attribute__ ((packed)); // LedWiz & extended output ports
mjr 48:058ace2aed1d 888
mjr 77:0b96f6867312 889 // --- IR Command Slots ---
mjr 77:0b96f6867312 890 IRCommandCfg IRCommand[MAX_IR_CODES] __attribute__ ((packed));
mjr 17:ab3cec0c8bf4 891 };
mjr 17:ab3cec0c8bf4 892
mjr 35:e959ffba78fd 893 #endif