Arnaud VALLEY / Mbed 2 deprecated Pinscape_Controller_V2_arnoz

Mirror with some correction

Dependencies:   mbed FastIO FastPWM USBDevice

config.h@39:b3815a1c3802, 2016-01-11 (annotated)

Committer:
mjr
Date:
Mon Jan 11 21:08:36 2016 +0000
Revision:
39:b3815a1c3802
Parent:
38:091e511ce8a0
Child:
40:cc0d9814522b
USB fixes; accelerometer auto un-sticking with watchdog timer.

Who changed what in which revision?

UserRevisionLine numberNew contents of line
mjr 17:ab3cec0c8bf4 1 // Pinscape Controller Configuration
mjr 17:ab3cec0c8bf4 2 //
mjr 35:e959ffba78fd 3 // New for 2016: dynamic configuration! To configure the controller, connect
mjr 35:e959ffba78fd 4 // the KL25Z to your PC, install the .bin file, and run the Windows config tool.
mjr 35:e959ffba78fd 5 // There's no need (as there was in the past) to edit this file or to compile a
mjr 35:e959ffba78fd 6 // custom version of the binary (.bin) to customize setup options.
mjr 35:e959ffba78fd 7 //
mjr 35:e959ffba78fd 8 // In earlier versions, configuration was largely handled with compile-time
mjr 35:e959ffba78fd 9 // constants. To customize the setup, you had to create a private forked copy
mjr 35:e959ffba78fd 10 // of the source code, edit the constants defined in config.h, and compile a
mjr 35:e959ffba78fd 11 // custom binary. That's no longer necessary!
mjr 35:e959ffba78fd 12 //
mjr 35:e959ffba78fd 13 // The new approach is to do everything (or as much as possible, anyway)
mjr 35:e959ffba78fd 14 // via the Windows config tool. You shouldn't have to recompile a custom
mjr 35:e959ffba78fd 15 // version just to make a configurable change. Of course, you're still free
mjr 35:e959ffba78fd 16 // to create a custom version if you need to add or change features in ways
mjr 35:e959ffba78fd 17 // that weren't anticipated in the original design.
mjr 35:e959ffba78fd 18 //
mjr 35:e959ffba78fd 19
mjr 17:ab3cec0c8bf4 20
mjr 25:e22b88bd783a 21 #ifndef CONFIG_H
mjr 25:e22b88bd783a 22 #define CONFIG_H
mjr 17:ab3cec0c8bf4 23
mjr 33:d832bcab089e 24
mjr 35:e959ffba78fd 25 // Plunger type codes
mjr 35:e959ffba78fd 26 // NOTE! These values are part of the external USB interface. New
mjr 35:e959ffba78fd 27 // values can be added, but the meaning of an existing assigned number
mjr 35:e959ffba78fd 28 // should remain fixed to keep the PC-side config tool compatible across
mjr 35:e959ffba78fd 29 // versions.
mjr 35:e959ffba78fd 30 const int PlungerType_None = 0; // no plunger
mjr 35:e959ffba78fd 31 const int PlungerType_TSL1410RS = 1; // TSL1410R linear image sensor (1280x1 pixels, 400dpi), serial mode
mjr 35:e959ffba78fd 32 const int PlungerType_TSL1410RP = 2; // TSL1410R, parallel mode (reads the two sensor sections concurrently)
mjr 35:e959ffba78fd 33 const int PlungerType_TSL1412RS = 3; // TSL1412R linear image sensor (1536x1 pixels, 400dpi), serial mode
mjr 35:e959ffba78fd 34 const int PlungerType_TSL1412RP = 4; // TSL1412R, parallel mode
mjr 35:e959ffba78fd 35 const int PlungerType_Pot = 5; // potentionmeter
mjr 35:e959ffba78fd 36 const int PlungerType_OptQuad = 6; // AEDR8300 optical quadrature sensor
mjr 35:e959ffba78fd 37 const int PlungerType_MagQuad = 7; // AS5304 magnetic quadrature sensor
mjr 21:5048e16cc9ef 38
mjr 35:e959ffba78fd 39 // Accelerometer orientation codes
mjr 35:e959ffba78fd 40 // These values are part of the external USB interface
mjr 35:e959ffba78fd 41 const int OrientationFront = 0; // USB ports pointed toward front of cabinet
mjr 35:e959ffba78fd 42 const int OrientationLeft = 1; // ports pointed toward left side of cabinet
mjr 35:e959ffba78fd 43 const int OrientationRight = 2; // ports pointed toward right side of cabinet
mjr 35:e959ffba78fd 44 const int OrientationRear = 3; // ports pointed toward back of cabinet
mjr 25:e22b88bd783a 45
mjr 35:e959ffba78fd 46 // input button types
mjr 35:e959ffba78fd 47 const int BtnTypeJoystick = 1; // joystick button
mjr 35:e959ffba78fd 48 const int BtnTypeKey = 2; // regular keyboard key
mjr 35:e959ffba78fd 49 const int BtnTypeModKey = 3; // keyboard modifier key (shift, ctrl, etc)
mjr 35:e959ffba78fd 50 const int BtnTypeMedia = 4; // media control key (volume up/down, etc)
mjr 38:091e511ce8a0 51 const int BtnTypeSpecial = 5; // special button (night mode switch, etc)
mjr 38:091e511ce8a0 52
mjr 38:091e511ce8a0 53 // input button flags
mjr 38:091e511ce8a0 54 const uint8_t BtnFlagPulse = 0x01; // pulse mode - reports each change in the physical switch state
mjr 38:091e511ce8a0 55 // as a brief press of the logical button/keyboard key
mjr 33:d832bcab089e 56
mjr 35:e959ffba78fd 57 // maximum number of input button mappings
mjr 35:e959ffba78fd 58 const int MAX_BUTTONS = 32;
mjr 33:d832bcab089e 59
mjr 35:e959ffba78fd 60 // LedWiz output port type codes
mjr 35:e959ffba78fd 61 // These values are part of the external USB interface
mjr 35:e959ffba78fd 62 const int PortTypeDisabled = 0; // port is disabled - not visible to LedWiz/DOF host
mjr 35:e959ffba78fd 63 const int PortTypeGPIOPWM = 1; // GPIO port, PWM enabled
mjr 35:e959ffba78fd 64 const int PortTypeGPIODig = 2; // GPIO port, digital out
mjr 35:e959ffba78fd 65 const int PortTypeTLC5940 = 3; // TLC5940 port
mjr 35:e959ffba78fd 66 const int PortType74HC595 = 4; // 74HC595 port
mjr 35:e959ffba78fd 67 const int PortTypeVirtual = 5; // Virtual port - visible to host software, but not connected to a physical output
mjr 17:ab3cec0c8bf4 68
mjr 35:e959ffba78fd 69 // LedWiz output port flag bits
mjr 38:091e511ce8a0 70 const uint8_t PortFlagActiveLow = 0x01; // physical output is active-low
mjr 38:091e511ce8a0 71 const uint8_t PortFlagNoisemaker = 0x02; // noisemaker device - disable when night mode is engaged
mjr 35:e959ffba78fd 72
mjr 35:e959ffba78fd 73 // maximum number of output ports
mjr 35:e959ffba78fd 74 const int MAX_OUT_PORTS = 203;
mjr 33:d832bcab089e 75
mjr 38:091e511ce8a0 76 // port configuration data
mjr 38:091e511ce8a0 77 struct LedWizPortCfg
mjr 38:091e511ce8a0 78 {
mjr 38:091e511ce8a0 79 uint8_t typ; // port type: a PortTypeXxx value
mjr 38:091e511ce8a0 80 uint8_t pin; // physical output pin: for a GPIO port, this is an index in the
mjr 38:091e511ce8a0 81 // USB-to-PinName mapping list; for a TLC5940 or 74HC595 port, it's
mjr 38:091e511ce8a0 82 // the output number, starting from 0 for OUT0 on the first chip in
mjr 38:091e511ce8a0 83 // the daisy chain. For inactive and virtual ports, it's unused.
mjr 38:091e511ce8a0 84 uint8_t flags; // flags: a combination of PortFlagXxx values
mjr 38:091e511ce8a0 85 } __attribute__((packed));
mjr 38:091e511ce8a0 86
mjr 38:091e511ce8a0 87
mjr 35:e959ffba78fd 88 struct Config
mjr 35:e959ffba78fd 89 {
mjr 35:e959ffba78fd 90 // set all values to factory defaults
mjr 35:e959ffba78fd 91 void setFactoryDefaults()
mjr 35:e959ffba78fd 92 {
mjr 35:e959ffba78fd 93 // By default, pretend to be LedWiz unit #8. This can be from 1 to 16. Real
mjr 35:e959ffba78fd 94 // LedWiz units have their unit number set at the factory, and the vast majority
mjr 35:e959ffba78fd 95 // are set up as unit #1, since that's the default for anyone who doesn't ask
mjr 35:e959ffba78fd 96 // for a different setting. It seems rare for anyone to use more than one unit
mjr 35:e959ffba78fd 97 // in a pin cab, but for the few who do, the others will probably be numbered
mjr 35:e959ffba78fd 98 // sequentially as #2, #3, etc. It seems safe to assume that no one out there
mjr 35:e959ffba78fd 99 // has a unit #8, so we'll use that as our default starting number. This can
mjr 35:e959ffba78fd 100 // be changed from the config tool, but for the sake of convenience we want the
mjr 35:e959ffba78fd 101 // default to be a value that most people won't have to change.
mjr 35:e959ffba78fd 102 usbVendorID = 0xFAFA; // LedWiz vendor code
mjr 38:091e511ce8a0 103 usbProductID = 0x00F0; // LedWiz product code for unit #1
mjr 35:e959ffba78fd 104 psUnitNo = 8;
mjr 35:e959ffba78fd 105
mjr 35:e959ffba78fd 106 // enable joystick reports
mjr 35:e959ffba78fd 107 joystickEnabled = true;
mjr 35:e959ffba78fd 108
mjr 35:e959ffba78fd 109 // assume standard orientation, with USB ports toward front of cabinet
mjr 35:e959ffba78fd 110 orientation = OrientationFront;
mjr 25:e22b88bd783a 111
mjr 35:e959ffba78fd 112 // assume no plunger is attached
mjr 35:e959ffba78fd 113 plunger.enabled = false;
mjr 35:e959ffba78fd 114 plunger.sensorType = PlungerType_None;
mjr 35:e959ffba78fd 115
mjr 35:e959ffba78fd 116 // assume that there's no calibration button
mjr 35:e959ffba78fd 117 plunger.cal.btn = NC;
mjr 35:e959ffba78fd 118 plunger.cal.led = NC;
mjr 35:e959ffba78fd 119
mjr 35:e959ffba78fd 120 // clear the plunger calibration
mjr 35:e959ffba78fd 121 plunger.cal.reset(4096);
mjr 35:e959ffba78fd 122
mjr 35:e959ffba78fd 123 // disable the ZB Launch Ball by default
mjr 35:e959ffba78fd 124 plunger.zbLaunchBall.port = 0;
mjr 35:e959ffba78fd 125 plunger.zbLaunchBall.btn = 0;
mjr 35:e959ffba78fd 126
mjr 35:e959ffba78fd 127 // assume no TV ON switch
mjr 38:091e511ce8a0 128 #if 1
mjr 38:091e511ce8a0 129 TVON.statusPin = PTD2;
mjr 38:091e511ce8a0 130 TVON.latchPin = PTE0;
mjr 38:091e511ce8a0 131 TVON.relayPin = PTD3;
mjr 38:091e511ce8a0 132 TVON.delayTime = 7;
mjr 38:091e511ce8a0 133 #else
mjr 35:e959ffba78fd 134 TVON.statusPin = NC;
mjr 35:e959ffba78fd 135 TVON.latchPin = NC;
mjr 35:e959ffba78fd 136 TVON.relayPin = NC;
mjr 35:e959ffba78fd 137 TVON.delayTime = 0;
mjr 38:091e511ce8a0 138 #endif
mjr 35:e959ffba78fd 139
mjr 35:e959ffba78fd 140 // assume no TLC5940 chips
mjr 38:091e511ce8a0 141 #if 1 // $$$
mjr 38:091e511ce8a0 142 tlc5940.nchips = 2;
mjr 38:091e511ce8a0 143 #else
mjr 35:e959ffba78fd 144 tlc5940.nchips = 0;
mjr 38:091e511ce8a0 145 #endif
mjr 38:091e511ce8a0 146
mjr 38:091e511ce8a0 147 // default TLC5940 pin assignments
mjr 38:091e511ce8a0 148 tlc5940.sin = PTC6;
mjr 38:091e511ce8a0 149 tlc5940.sclk = PTC5;
mjr 38:091e511ce8a0 150 tlc5940.xlat = PTC10;
mjr 38:091e511ce8a0 151 tlc5940.blank = PTC7;
mjr 38:091e511ce8a0 152 tlc5940.gsclk = PTA1;
mjr 35:e959ffba78fd 153
mjr 35:e959ffba78fd 154 // assume no 74HC595 chips
mjr 35:e959ffba78fd 155 hc595.nchips = 0;
mjr 35:e959ffba78fd 156
mjr 38:091e511ce8a0 157 // default 74HC595 pin assignments
mjr 38:091e511ce8a0 158 hc595.sin = PTA5;
mjr 38:091e511ce8a0 159 hc595.sclk = PTA4;
mjr 38:091e511ce8a0 160 hc595.latch = PTA12;
mjr 38:091e511ce8a0 161 hc595.ena = PTD4;
mjr 38:091e511ce8a0 162
mjr 35:e959ffba78fd 163 // initially configure with no LedWiz output ports
mjr 35:e959ffba78fd 164 outPort[0].typ = PortTypeDisabled;
mjr 38:091e511ce8a0 165 for (int i = 0 ; i < sizeof(specialPort)/sizeof(specialPort[0]) ; ++i)
mjr 38:091e511ce8a0 166 specialPort[i].typ = PortTypeDisabled;
mjr 35:e959ffba78fd 167
mjr 35:e959ffba78fd 168 // initially configure with no input buttons
mjr 35:e959ffba78fd 169 for (int i = 0 ; i < MAX_BUTTONS ; ++i)
mjr 35:e959ffba78fd 170 button[i].pin = 0; // 0 == index of NC in USB-to-PinName mapping
mjr 38:091e511ce8a0 171
mjr 38:091e511ce8a0 172 #if 1
mjr 38:091e511ce8a0 173 for (int i = 0 ; i < 24 ; ++i) {
mjr 38:091e511ce8a0 174 static int bp[] = {
mjr 38:091e511ce8a0 175 21, // 1 = PTC2
mjr 38:091e511ce8a0 176 12, // 2 = PTB3
mjr 38:091e511ce8a0 177 11, // 3 = PTB2
mjr 38:091e511ce8a0 178 10, // 4 = PTB1
mjr 38:091e511ce8a0 179 54, // 5 = PTE30
mjr 38:091e511ce8a0 180 30, // 6 = PTC11
mjr 38:091e511ce8a0 181 48, // 7 = PTE5
mjr 38:091e511ce8a0 182 47, // 8 = PTE4
mjr 38:091e511ce8a0 183 46, // 9 = PTE3
mjr 38:091e511ce8a0 184 45, // 10 = PTE2
mjr 38:091e511ce8a0 185 16, // 11 = PTB11
mjr 38:091e511ce8a0 186 15, // 12 = PTB10
mjr 38:091e511ce8a0 187 14, // 13 = PTB9
mjr 38:091e511ce8a0 188 13, // 14 = PTB8
mjr 38:091e511ce8a0 189 31, // 15 = PTC12
mjr 38:091e511ce8a0 190 32, // 16 = PTC13
mjr 38:091e511ce8a0 191 33, // 17 = PTC16
mjr 38:091e511ce8a0 192 34, // 18 = PTC17
mjr 38:091e511ce8a0 193 7, // 19 = PTA16
mjr 38:091e511ce8a0 194 8, // 20 = PTA17
mjr 38:091e511ce8a0 195 55, // 21 = PTE31
mjr 38:091e511ce8a0 196 41, // 22 = PTD6
mjr 38:091e511ce8a0 197 42, // 23 = PTD7
mjr 38:091e511ce8a0 198 44 // 24 = PTE1
mjr 38:091e511ce8a0 199 };
mjr 38:091e511ce8a0 200 button[i].pin = bp[i];
mjr 38:091e511ce8a0 201 button[i].typ = BtnTypeKey;
mjr 38:091e511ce8a0 202 button[i].val = i+4; // A, B, C...
mjr 38:091e511ce8a0 203 }
mjr 38:091e511ce8a0 204 #endif
mjr 38:091e511ce8a0 205
mjr 38:091e511ce8a0 206 #if 0
mjr 38:091e511ce8a0 207 button[23].typ = BtnTypeJoystick;
mjr 38:091e511ce8a0 208 button[23].val = 5; // B
mjr 38:091e511ce8a0 209 button[23].flags = 0x01; // pulse button
mjr 38:091e511ce8a0 210
mjr 38:091e511ce8a0 211 button[22].typ = BtnTypeModKey;
mjr 38:091e511ce8a0 212 button[22].val = 0x02; // left shift
mjr 38:091e511ce8a0 213
mjr 38:091e511ce8a0 214 button[21].typ = BtnTypeMedia;
mjr 38:091e511ce8a0 215 button[21].val = 0x02; // vol down
mjr 38:091e511ce8a0 216
mjr 38:091e511ce8a0 217 button[20].typ = BtnTypeMedia;
mjr 38:091e511ce8a0 218 button[20].val = 0x01; // vol up
mjr 39:b3815a1c3802 219
mjr 38:091e511ce8a0 220 #endif
mjr 38:091e511ce8a0 221
mjr 38:091e511ce8a0 222 #if 1 // $$$
mjr 38:091e511ce8a0 223 {
mjr 38:091e511ce8a0 224 int n = 0;
mjr 38:091e511ce8a0 225 for (int i = 0 ; i < 32 ; ++i, ++n) {
mjr 38:091e511ce8a0 226 outPort[n].typ = PortTypeTLC5940;
mjr 38:091e511ce8a0 227 outPort[n].pin = i;
mjr 38:091e511ce8a0 228 outPort[n].flags = 0;
mjr 38:091e511ce8a0 229 }
mjr 38:091e511ce8a0 230 outPort[n].typ = PortTypeGPIODig;
mjr 38:091e511ce8a0 231 outPort[n].pin = 27; // PTC8
mjr 38:091e511ce8a0 232 outPort[n++].flags = 0;
mjr 35:e959ffba78fd 233
mjr 38:091e511ce8a0 234 outPort[n].typ = PortTypeDisabled;
mjr 38:091e511ce8a0 235 }
mjr 38:091e511ce8a0 236 #endif
mjr 38:091e511ce8a0 237 #if 0
mjr 38:091e511ce8a0 238 outPort[0].typ = PortTypeGPIOPWM;
mjr 38:091e511ce8a0 239 outPort[0].pin = 17; // PTB18 = LED1 = Red LED
mjr 38:091e511ce8a0 240 outPort[0].flags = PortFlagActiveLow;
mjr 38:091e511ce8a0 241 outPort[1].typ = PortTypeGPIOPWM;
mjr 38:091e511ce8a0 242 outPort[1].pin = 18; // PTB19 = LED2 = Green LED
mjr 38:091e511ce8a0 243 outPort[1].flags = PortFlagActiveLow;
mjr 38:091e511ce8a0 244 outPort[2].typ = PortTypeGPIOPWM;
mjr 38:091e511ce8a0 245 outPort[2].pin = 36; // PTD1 = LED3 = Blue LED
mjr 38:091e511ce8a0 246 outPort[2].flags = PortFlagActiveLow;
mjr 38:091e511ce8a0 247
mjr 38:091e511ce8a0 248 outPort[3].typ = PortTypeDisabled;
mjr 38:091e511ce8a0 249 #endif
mjr 35:e959ffba78fd 250 }
mjr 35:e959ffba78fd 251
mjr 35:e959ffba78fd 252 // --- USB DEVICE CONFIGURATION ---
mjr 35:e959ffba78fd 253
mjr 35:e959ffba78fd 254 // USB device identification - vendor ID and product ID. For LedLWiz
mjr 35:e959ffba78fd 255 // emulation, use vendor ID 0xFAFA and product ID 0x00EF + unit#, where
mjr 35:e959ffba78fd 256 // unit# is the nominal LedWiz unit number from 1 to 16. Alternatively,
mjr 35:e959ffba78fd 257 // if LedWiz emulation isn't desired or causes any driver conflicts on
mjr 35:e959ffba78fd 258 // the host, we have a private Pinscape assignment as vendor ID 0x1209
mjr 35:e959ffba78fd 259 // and product ID 0xEAEA (registered with http://pid.codes, a registry
mjr 35:e959ffba78fd 260 // for open-source USB projects).
mjr 35:e959ffba78fd 261 uint16_t usbVendorID;
mjr 35:e959ffba78fd 262 uint16_t usbProductID;
mjr 35:e959ffba78fd 263
mjr 35:e959ffba78fd 264 // Pinscape Controller unit number. This is the nominal unit number,
mjr 35:e959ffba78fd 265 // from 1 to 16. We report this in the status query; DOF uses it to
mjr 35:e959ffba78fd 266 // distinguish multiple Pinscape units. Note that this doesn't affect
mjr 35:e959ffba78fd 267 // the LedWiz unit numbering, which is implied by the USB Product ID.
mjr 35:e959ffba78fd 268 uint8_t psUnitNo;
mjr 35:e959ffba78fd 269
mjr 35:e959ffba78fd 270 // Are joystick reports enabled? Joystick reports can be turned off, to
mjr 35:e959ffba78fd 271 // use the device as purely an output controller.
mjr 35:e959ffba78fd 272 char joystickEnabled;
mjr 35:e959ffba78fd 273
mjr 35:e959ffba78fd 274
mjr 35:e959ffba78fd 275 // --- ACCELEROMETER ---
mjr 35:e959ffba78fd 276
mjr 35:e959ffba78fd 277 // accelerometer orientation (ORIENTATION_xxx value)
mjr 35:e959ffba78fd 278 char orientation;
mjr 35:e959ffba78fd 279
mjr 35:e959ffba78fd 280
mjr 35:e959ffba78fd 281 // --- PLUNGER CONFIGURATION ---
mjr 35:e959ffba78fd 282 struct
mjr 35:e959ffba78fd 283 {
mjr 35:e959ffba78fd 284 // plunger enabled/disabled
mjr 35:e959ffba78fd 285 char enabled;
mjr 33:d832bcab089e 286
mjr 35:e959ffba78fd 287 // plunger sensor type
mjr 35:e959ffba78fd 288 char sensorType;
mjr 35:e959ffba78fd 289
mjr 35:e959ffba78fd 290 // Plunger sensor pins. To accommodate a wide range of sensor types,
mjr 35:e959ffba78fd 291 // we keep a generic list of 4 pin assignments. The use of each pin
mjr 35:e959ffba78fd 292 // varies by sensor. The lists below are in order of the generic
mjr 35:e959ffba78fd 293 // pins; NC means that the pin isn't used by the sensor. Each pin's
mjr 35:e959ffba78fd 294 // GPIO usage is also listed. Certain usages limit which physical
mjr 35:e959ffba78fd 295 // pins can be assigned (e.g., AnalogIn or PwmOut).
mjr 35:e959ffba78fd 296 //
mjr 35:e959ffba78fd 297 // TSL1410R/1412R, serial: SI (DigitalOut), CLK (DigitalOut), AO (AnalogIn), NC
mjr 35:e959ffba78fd 298 // TSL1410R/1412R, parallel: SI (DigitalOut), CLK (DigitalOut), AO1 (AnalogIn), AO2 (AnalogIn)
mjr 35:e959ffba78fd 299 // Potentiometer: AO (AnalogIn), NC, NC, NC
mjr 35:e959ffba78fd 300 // AEDR8300: A (InterruptIn), B (InterruptIn), NC, NC
mjr 35:e959ffba78fd 301 // AS5304: A (InterruptIn), B (InterruptIn), NC, NC
mjr 35:e959ffba78fd 302 PinName sensorPin[4];
mjr 35:e959ffba78fd 303
mjr 35:e959ffba78fd 304 // Pseudo LAUNCH BALL button.
mjr 35:e959ffba78fd 305 //
mjr 35:e959ffba78fd 306 // This configures the "ZB Launch Ball" feature in DOF, based on Zeb's (of
mjr 35:e959ffba78fd 307 // zebsboards.com) scheme for using a mechanical plunger as a Launch button.
mjr 35:e959ffba78fd 308 // Set the port to 0 to disable the feature.
mjr 35:e959ffba78fd 309 //
mjr 35:e959ffba78fd 310 // The port number is an LedWiz port number that we monitor for activation.
mjr 35:e959ffba78fd 311 // This port isn't connected to a physical device; rather, the host turns it
mjr 35:e959ffba78fd 312 // on to indicate that the pseudo Launch button mode is in effect.
mjr 35:e959ffba78fd 313 //
mjr 35:e959ffba78fd 314 // The button number gives the button that we "press" when a launch occurs.
mjr 35:e959ffba78fd 315 // This can be connected to the physical Launch button, or can simply be
mjr 35:e959ffba78fd 316 // an otherwise unused button.
mjr 35:e959ffba78fd 317 //
mjr 35:e959ffba78fd 318 // The "push distance" is the distance, in inches, for registering a push
mjr 35:e959ffba78fd 319 // on the plunger as a button push. If the player pushes the plunger forward
mjr 35:e959ffba78fd 320 // of the rest position by this amount, we'll treat it as pushing the button,
mjr 35:e959ffba78fd 321 // even if the player didn't pull back the plunger first. This lets the
mjr 35:e959ffba78fd 322 // player treat the plunger knob as a button for games where it's meaningful
mjr 35:e959ffba78fd 323 // to hold down the Launch button for specific intervals (e.g., "Championship
mjr 35:e959ffba78fd 324 // Pub").
mjr 35:e959ffba78fd 325 struct
mjr 35:e959ffba78fd 326 {
mjr 35:e959ffba78fd 327 int port;
mjr 35:e959ffba78fd 328 int btn;
mjr 35:e959ffba78fd 329 float pushDistance;
mjr 35:e959ffba78fd 330
mjr 35:e959ffba78fd 331 } zbLaunchBall;
mjr 35:e959ffba78fd 332
mjr 35:e959ffba78fd 333 // --- PLUNGER CALIBRATION ---
mjr 35:e959ffba78fd 334 struct
mjr 35:e959ffba78fd 335 {
mjr 35:e959ffba78fd 336 // has the plunger been calibrated?
mjr 35:e959ffba78fd 337 int calibrated;
mjr 35:e959ffba78fd 338
mjr 35:e959ffba78fd 339 // calibration button switch pin
mjr 35:e959ffba78fd 340 PinName btn;
mjr 35:e959ffba78fd 341
mjr 35:e959ffba78fd 342 // calibration button indicator light pin
mjr 35:e959ffba78fd 343 PinName led;
mjr 35:e959ffba78fd 344
mjr 35:e959ffba78fd 345 // Plunger calibration min, zero, and max. The zero point is the
mjr 35:e959ffba78fd 346 // rest position (aka park position), where it's in equilibrium between
mjr 35:e959ffba78fd 347 // the main spring and the barrel spring. It can travel a small distance
mjr 35:e959ffba78fd 348 // forward of the rest position, because the barrel spring can be
mjr 35:e959ffba78fd 349 // compressed by the user pushing on the plunger or by the momentum
mjr 35:e959ffba78fd 350 // of a release motion. The minimum is the maximum forward point where
mjr 35:e959ffba78fd 351 // the barrel spring can't be compressed any further.
mjr 35:e959ffba78fd 352 int min;
mjr 35:e959ffba78fd 353 int zero;
mjr 35:e959ffba78fd 354 int max;
mjr 35:e959ffba78fd 355
mjr 35:e959ffba78fd 356 // reset the plunger calibration
mjr 35:e959ffba78fd 357 void reset(int npix)
mjr 35:e959ffba78fd 358 {
mjr 35:e959ffba78fd 359 calibrated = 0; // not calibrated
mjr 35:e959ffba78fd 360 min = 0; // assume we can go all the way forward...
mjr 35:e959ffba78fd 361 max = npix; // ...and all the way back
mjr 35:e959ffba78fd 362 zero = npix/6; // the rest position is usually around 1/2" back = 1/6 of total travel
mjr 35:e959ffba78fd 363 }
mjr 17:ab3cec0c8bf4 364
mjr 35:e959ffba78fd 365 } cal;
mjr 18:5e890ebd0023 366
mjr 35:e959ffba78fd 367 } plunger;
mjr 29:582472d0bc57 368
mjr 35:e959ffba78fd 369
mjr 35:e959ffba78fd 370 // --- TV ON SWITCH ---
mjr 35:e959ffba78fd 371 //
mjr 35:e959ffba78fd 372 // To use the TV ON switch feature, the special power sensing circuitry
mjr 35:e959ffba78fd 373 // implemented on the Expansion Board must be attached (or an equivalent
mjr 35:e959ffba78fd 374 // circuit, as described in the Build Guide). The circuitry lets us
mjr 35:e959ffba78fd 375 // detect power state changes on the secondary power supply.
mjr 35:e959ffba78fd 376 struct
mjr 35:e959ffba78fd 377 {
mjr 35:e959ffba78fd 378 // PSU2 power status sense (DigitalIn pin). This pin goes LOW when the
mjr 35:e959ffba78fd 379 // secondary power supply is turned off, and remains LOW until the LATCH
mjr 35:e959ffba78fd 380 // pin is raised high AND the secondary PSU is turned on. Once HIGH,
mjr 35:e959ffba78fd 381 // it remains HIGH as long as the secondary PSU is on.
mjr 35:e959ffba78fd 382 PinName statusPin;
mjr 35:e959ffba78fd 383
mjr 35:e959ffba78fd 384 // PSU2 power status latch (DigitalOut pin)
mjr 35:e959ffba78fd 385 PinName latchPin;
mjr 35:e959ffba78fd 386
mjr 35:e959ffba78fd 387 // TV ON relay pin (DigitalOut pin). This pin controls the TV switch
mjr 35:e959ffba78fd 388 // relay. Raising the pin HIGH turns the relay ON (energizes the coil).
mjr 35:e959ffba78fd 389 PinName relayPin;
mjr 35:e959ffba78fd 390
mjr 35:e959ffba78fd 391 // TV ON delay time, in seconds. This is the interval between sensing
mjr 35:e959ffba78fd 392 // that the secondary power supply has turned on and pulsing the TV ON
mjr 35:e959ffba78fd 393 // switch relay.
mjr 35:e959ffba78fd 394 float delayTime;
mjr 35:e959ffba78fd 395
mjr 35:e959ffba78fd 396 } TVON;
mjr 35:e959ffba78fd 397
mjr 29:582472d0bc57 398
mjr 35:e959ffba78fd 399 // --- TLC5940NT PWM Controller Chip Setup ---
mjr 35:e959ffba78fd 400 struct
mjr 35:e959ffba78fd 401 {
mjr 35:e959ffba78fd 402 // number of TLC5940NT chips connected in daisy chain
mjr 35:e959ffba78fd 403 int nchips;
mjr 35:e959ffba78fd 404
mjr 35:e959ffba78fd 405 // pin connections
mjr 35:e959ffba78fd 406 PinName sin; // Serial data - must connect to SPIO MOSI -> PTC6 or PTD2
mjr 35:e959ffba78fd 407 PinName sclk; // Serial clock - must connect to SPIO SCLK -> PTC5 or PTD1
mjr 35:e959ffba78fd 408 // (but don't use PTD1, since it's hard-wired to the on-board blue LED)
mjr 35:e959ffba78fd 409 PinName xlat; // XLAT (latch) signal - connect to any GPIO pin
mjr 35:e959ffba78fd 410 PinName blank; // BLANK signal - connect to any GPIO pin
mjr 35:e959ffba78fd 411 PinName gsclk; // Grayscale clock - must connect to a PWM-out capable pin
mjr 29:582472d0bc57 412
mjr 35:e959ffba78fd 413 } tlc5940;
mjr 35:e959ffba78fd 414
mjr 35:e959ffba78fd 415
mjr 35:e959ffba78fd 416 // --- 74HC595 Shift Register Setup ---
mjr 35:e959ffba78fd 417 struct
mjr 35:e959ffba78fd 418 {
mjr 35:e959ffba78fd 419 // number of 74HC595 chips attached in daisy chain
mjr 35:e959ffba78fd 420 int nchips;
mjr 35:e959ffba78fd 421
mjr 35:e959ffba78fd 422 // pin connections
mjr 35:e959ffba78fd 423 PinName sin; // Serial data - use any GPIO pin
mjr 35:e959ffba78fd 424 PinName sclk; // Serial clock - use any GPIO pin
mjr 35:e959ffba78fd 425 PinName latch; // Latch - use any GPIO pin
mjr 35:e959ffba78fd 426 PinName ena; // Enable signal - use any GPIO pin
mjr 35:e959ffba78fd 427
mjr 35:e959ffba78fd 428 } hc595;
mjr 34:6b981a2afab7 429
mjr 25:e22b88bd783a 430
mjr 35:e959ffba78fd 431 // --- Button Input Setup ---
mjr 35:e959ffba78fd 432 struct
mjr 35:e959ffba78fd 433 {
mjr 35:e959ffba78fd 434 uint8_t pin; // physical input GPIO pin - a USB-to-PinName mapping index
mjr 35:e959ffba78fd 435 uint8_t typ; // key type reported to PC - a BtnTypeXxx value
mjr 35:e959ffba78fd 436 uint8_t val; // key value reported - meaning depends on 'typ' value
mjr 38:091e511ce8a0 437 uint8_t flags; // key flags - a bitwise combination of BtnFlagXxx values
mjr 35:e959ffba78fd 438
mjr 38:091e511ce8a0 439 } __attribute__((packed)) button[MAX_BUTTONS] __attribute((packed));
mjr 35:e959ffba78fd 440
mjr 17:ab3cec0c8bf4 441
mjr 35:e959ffba78fd 442 // --- LedWiz Output Port Setup ---
mjr 38:091e511ce8a0 443 LedWizPortCfg outPort[MAX_OUT_PORTS] __attribute__((packed)); // LedWiz & extended output ports
mjr 38:091e511ce8a0 444 LedWizPortCfg specialPort[1]; // special ports (Night Mode indicator, etc)
mjr 17:ab3cec0c8bf4 445 };
mjr 17:ab3cec0c8bf4 446
mjr 35:e959ffba78fd 447 #endif