Mirror with some correction
Dependencies: mbed FastIO FastPWM USBDevice
config.h
- Committer:
- mjr
- Date:
- 2016-01-11
- Revision:
- 39:b3815a1c3802
- Parent:
- 38:091e511ce8a0
- Child:
- 40:cc0d9814522b
File content as of revision 39:b3815a1c3802:
// Pinscape Controller Configuration // // New for 2016: dynamic configuration! To configure the controller, connect // the KL25Z to your PC, install the .bin file, and run the Windows config tool. // There's no need (as there was in the past) to edit this file or to compile a // custom version of the binary (.bin) to customize setup options. // // In earlier versions, configuration was largely handled with compile-time // constants. To customize the setup, you had to create a private forked copy // of the source code, edit the constants defined in config.h, and compile a // custom binary. That's no longer necessary! // // The new approach is to do everything (or as much as possible, anyway) // via the Windows config tool. You shouldn't have to recompile a custom // version just to make a configurable change. Of course, you're still free // to create a custom version if you need to add or change features in ways // that weren't anticipated in the original design. // #ifndef CONFIG_H #define CONFIG_H // Plunger type codes // NOTE! These values are part of the external USB interface. New // values can be added, but the meaning of an existing assigned number // should remain fixed to keep the PC-side config tool compatible across // versions. const int PlungerType_None = 0; // no plunger const int PlungerType_TSL1410RS = 1; // TSL1410R linear image sensor (1280x1 pixels, 400dpi), serial mode const int PlungerType_TSL1410RP = 2; // TSL1410R, parallel mode (reads the two sensor sections concurrently) const int PlungerType_TSL1412RS = 3; // TSL1412R linear image sensor (1536x1 pixels, 400dpi), serial mode const int PlungerType_TSL1412RP = 4; // TSL1412R, parallel mode const int PlungerType_Pot = 5; // potentionmeter const int PlungerType_OptQuad = 6; // AEDR8300 optical quadrature sensor const int PlungerType_MagQuad = 7; // AS5304 magnetic quadrature sensor // Accelerometer orientation codes // These values are part of the external USB interface const int OrientationFront = 0; // USB ports pointed toward front of cabinet const int OrientationLeft = 1; // ports pointed toward left side of cabinet const int OrientationRight = 2; // ports pointed toward right side of cabinet const int OrientationRear = 3; // ports pointed toward back of cabinet // input button types const int BtnTypeJoystick = 1; // joystick button const int BtnTypeKey = 2; // regular keyboard key const int BtnTypeModKey = 3; // keyboard modifier key (shift, ctrl, etc) const int BtnTypeMedia = 4; // media control key (volume up/down, etc) const int BtnTypeSpecial = 5; // special button (night mode switch, etc) // input button flags const uint8_t BtnFlagPulse = 0x01; // pulse mode - reports each change in the physical switch state // as a brief press of the logical button/keyboard key // maximum number of input button mappings const int MAX_BUTTONS = 32; // LedWiz output port type codes // These values are part of the external USB interface const int PortTypeDisabled = 0; // port is disabled - not visible to LedWiz/DOF host const int PortTypeGPIOPWM = 1; // GPIO port, PWM enabled const int PortTypeGPIODig = 2; // GPIO port, digital out const int PortTypeTLC5940 = 3; // TLC5940 port const int PortType74HC595 = 4; // 74HC595 port const int PortTypeVirtual = 5; // Virtual port - visible to host software, but not connected to a physical output // LedWiz output port flag bits const uint8_t PortFlagActiveLow = 0x01; // physical output is active-low const uint8_t PortFlagNoisemaker = 0x02; // noisemaker device - disable when night mode is engaged // maximum number of output ports const int MAX_OUT_PORTS = 203; // port configuration data struct LedWizPortCfg { uint8_t typ; // port type: a PortTypeXxx value uint8_t pin; // physical output pin: for a GPIO port, this is an index in the // USB-to-PinName mapping list; for a TLC5940 or 74HC595 port, it's // the output number, starting from 0 for OUT0 on the first chip in // the daisy chain. For inactive and virtual ports, it's unused. uint8_t flags; // flags: a combination of PortFlagXxx values } __attribute__((packed)); struct Config { // set all values to factory defaults void setFactoryDefaults() { // By default, pretend to be LedWiz unit #8. This can be from 1 to 16. Real // LedWiz units have their unit number set at the factory, and the vast majority // are set up as unit #1, since that's the default for anyone who doesn't ask // for a different setting. It seems rare for anyone to use more than one unit // in a pin cab, but for the few who do, the others will probably be numbered // sequentially as #2, #3, etc. It seems safe to assume that no one out there // has a unit #8, so we'll use that as our default starting number. This can // be changed from the config tool, but for the sake of convenience we want the // default to be a value that most people won't have to change. usbVendorID = 0xFAFA; // LedWiz vendor code usbProductID = 0x00F0; // LedWiz product code for unit #1 psUnitNo = 8; // enable joystick reports joystickEnabled = true; // assume standard orientation, with USB ports toward front of cabinet orientation = OrientationFront; // assume no plunger is attached plunger.enabled = false; plunger.sensorType = PlungerType_None; // assume that there's no calibration button plunger.cal.btn = NC; plunger.cal.led = NC; // clear the plunger calibration plunger.cal.reset(4096); // disable the ZB Launch Ball by default plunger.zbLaunchBall.port = 0; plunger.zbLaunchBall.btn = 0; // assume no TV ON switch #if 1 TVON.statusPin = PTD2; TVON.latchPin = PTE0; TVON.relayPin = PTD3; TVON.delayTime = 7; #else TVON.statusPin = NC; TVON.latchPin = NC; TVON.relayPin = NC; TVON.delayTime = 0; #endif // assume no TLC5940 chips #if 1 // $$$ tlc5940.nchips = 2; #else tlc5940.nchips = 0; #endif // default TLC5940 pin assignments tlc5940.sin = PTC6; tlc5940.sclk = PTC5; tlc5940.xlat = PTC10; tlc5940.blank = PTC7; tlc5940.gsclk = PTA1; // assume no 74HC595 chips hc595.nchips = 0; // default 74HC595 pin assignments hc595.sin = PTA5; hc595.sclk = PTA4; hc595.latch = PTA12; hc595.ena = PTD4; // initially configure with no LedWiz output ports outPort[0].typ = PortTypeDisabled; for (int i = 0 ; i < sizeof(specialPort)/sizeof(specialPort[0]) ; ++i) specialPort[i].typ = PortTypeDisabled; // initially configure with no input buttons for (int i = 0 ; i < MAX_BUTTONS ; ++i) button[i].pin = 0; // 0 == index of NC in USB-to-PinName mapping #if 1 for (int i = 0 ; i < 24 ; ++i) { static int bp[] = { 21, // 1 = PTC2 12, // 2 = PTB3 11, // 3 = PTB2 10, // 4 = PTB1 54, // 5 = PTE30 30, // 6 = PTC11 48, // 7 = PTE5 47, // 8 = PTE4 46, // 9 = PTE3 45, // 10 = PTE2 16, // 11 = PTB11 15, // 12 = PTB10 14, // 13 = PTB9 13, // 14 = PTB8 31, // 15 = PTC12 32, // 16 = PTC13 33, // 17 = PTC16 34, // 18 = PTC17 7, // 19 = PTA16 8, // 20 = PTA17 55, // 21 = PTE31 41, // 22 = PTD6 42, // 23 = PTD7 44 // 24 = PTE1 }; button[i].pin = bp[i]; button[i].typ = BtnTypeKey; button[i].val = i+4; // A, B, C... } #endif #if 0 button[23].typ = BtnTypeJoystick; button[23].val = 5; // B button[23].flags = 0x01; // pulse button button[22].typ = BtnTypeModKey; button[22].val = 0x02; // left shift button[21].typ = BtnTypeMedia; button[21].val = 0x02; // vol down button[20].typ = BtnTypeMedia; button[20].val = 0x01; // vol up #endif #if 1 // $$$ { int n = 0; for (int i = 0 ; i < 32 ; ++i, ++n) { outPort[n].typ = PortTypeTLC5940; outPort[n].pin = i; outPort[n].flags = 0; } outPort[n].typ = PortTypeGPIODig; outPort[n].pin = 27; // PTC8 outPort[n++].flags = 0; outPort[n].typ = PortTypeDisabled; } #endif #if 0 outPort[0].typ = PortTypeGPIOPWM; outPort[0].pin = 17; // PTB18 = LED1 = Red LED outPort[0].flags = PortFlagActiveLow; outPort[1].typ = PortTypeGPIOPWM; outPort[1].pin = 18; // PTB19 = LED2 = Green LED outPort[1].flags = PortFlagActiveLow; outPort[2].typ = PortTypeGPIOPWM; outPort[2].pin = 36; // PTD1 = LED3 = Blue LED outPort[2].flags = PortFlagActiveLow; outPort[3].typ = PortTypeDisabled; #endif } // --- USB DEVICE CONFIGURATION --- // USB device identification - vendor ID and product ID. For LedLWiz // emulation, use vendor ID 0xFAFA and product ID 0x00EF + unit#, where // unit# is the nominal LedWiz unit number from 1 to 16. Alternatively, // if LedWiz emulation isn't desired or causes any driver conflicts on // the host, we have a private Pinscape assignment as vendor ID 0x1209 // and product ID 0xEAEA (registered with http://pid.codes, a registry // for open-source USB projects). uint16_t usbVendorID; uint16_t usbProductID; // Pinscape Controller unit number. This is the nominal unit number, // from 1 to 16. We report this in the status query; DOF uses it to // distinguish multiple Pinscape units. Note that this doesn't affect // the LedWiz unit numbering, which is implied by the USB Product ID. uint8_t psUnitNo; // Are joystick reports enabled? Joystick reports can be turned off, to // use the device as purely an output controller. char joystickEnabled; // --- ACCELEROMETER --- // accelerometer orientation (ORIENTATION_xxx value) char orientation; // --- PLUNGER CONFIGURATION --- struct { // plunger enabled/disabled char enabled; // plunger sensor type char sensorType; // Plunger sensor pins. To accommodate a wide range of sensor types, // we keep a generic list of 4 pin assignments. The use of each pin // varies by sensor. The lists below are in order of the generic // pins; NC means that the pin isn't used by the sensor. Each pin's // GPIO usage is also listed. Certain usages limit which physical // pins can be assigned (e.g., AnalogIn or PwmOut). // // TSL1410R/1412R, serial: SI (DigitalOut), CLK (DigitalOut), AO (AnalogIn), NC // TSL1410R/1412R, parallel: SI (DigitalOut), CLK (DigitalOut), AO1 (AnalogIn), AO2 (AnalogIn) // Potentiometer: AO (AnalogIn), NC, NC, NC // AEDR8300: A (InterruptIn), B (InterruptIn), NC, NC // AS5304: A (InterruptIn), B (InterruptIn), NC, NC PinName sensorPin[4]; // Pseudo LAUNCH BALL button. // // This configures the "ZB Launch Ball" feature in DOF, based on Zeb's (of // zebsboards.com) scheme for using a mechanical plunger as a Launch button. // Set the port to 0 to disable the feature. // // The port number is an LedWiz port number that we monitor for activation. // This port isn't connected to a physical device; rather, the host turns it // on to indicate that the pseudo Launch button mode is in effect. // // The button number gives the button that we "press" when a launch occurs. // This can be connected to the physical Launch button, or can simply be // an otherwise unused button. // // The "push distance" is the distance, in inches, for registering a push // on the plunger as a button push. If the player pushes the plunger forward // of the rest position by this amount, we'll treat it as pushing the button, // even if the player didn't pull back the plunger first. This lets the // player treat the plunger knob as a button for games where it's meaningful // to hold down the Launch button for specific intervals (e.g., "Championship // Pub"). struct { int port; int btn; float pushDistance; } zbLaunchBall; // --- PLUNGER CALIBRATION --- struct { // has the plunger been calibrated? int calibrated; // calibration button switch pin PinName btn; // calibration button indicator light pin PinName led; // Plunger calibration min, zero, and max. The zero point is the // rest position (aka park position), where it's in equilibrium between // the main spring and the barrel spring. It can travel a small distance // forward of the rest position, because the barrel spring can be // compressed by the user pushing on the plunger or by the momentum // of a release motion. The minimum is the maximum forward point where // the barrel spring can't be compressed any further. int min; int zero; int max; // reset the plunger calibration void reset(int npix) { calibrated = 0; // not calibrated min = 0; // assume we can go all the way forward... max = npix; // ...and all the way back zero = npix/6; // the rest position is usually around 1/2" back = 1/6 of total travel } } cal; } plunger; // --- TV ON SWITCH --- // // To use the TV ON switch feature, the special power sensing circuitry // implemented on the Expansion Board must be attached (or an equivalent // circuit, as described in the Build Guide). The circuitry lets us // detect power state changes on the secondary power supply. struct { // PSU2 power status sense (DigitalIn pin). This pin goes LOW when the // secondary power supply is turned off, and remains LOW until the LATCH // pin is raised high AND the secondary PSU is turned on. Once HIGH, // it remains HIGH as long as the secondary PSU is on. PinName statusPin; // PSU2 power status latch (DigitalOut pin) PinName latchPin; // TV ON relay pin (DigitalOut pin). This pin controls the TV switch // relay. Raising the pin HIGH turns the relay ON (energizes the coil). PinName relayPin; // TV ON delay time, in seconds. This is the interval between sensing // that the secondary power supply has turned on and pulsing the TV ON // switch relay. float delayTime; } TVON; // --- TLC5940NT PWM Controller Chip Setup --- struct { // number of TLC5940NT chips connected in daisy chain int nchips; // pin connections PinName sin; // Serial data - must connect to SPIO MOSI -> PTC6 or PTD2 PinName sclk; // Serial clock - must connect to SPIO SCLK -> PTC5 or PTD1 // (but don't use PTD1, since it's hard-wired to the on-board blue LED) PinName xlat; // XLAT (latch) signal - connect to any GPIO pin PinName blank; // BLANK signal - connect to any GPIO pin PinName gsclk; // Grayscale clock - must connect to a PWM-out capable pin } tlc5940; // --- 74HC595 Shift Register Setup --- struct { // number of 74HC595 chips attached in daisy chain int nchips; // pin connections PinName sin; // Serial data - use any GPIO pin PinName sclk; // Serial clock - use any GPIO pin PinName latch; // Latch - use any GPIO pin PinName ena; // Enable signal - use any GPIO pin } hc595; // --- Button Input Setup --- struct { uint8_t pin; // physical input GPIO pin - a USB-to-PinName mapping index uint8_t typ; // key type reported to PC - a BtnTypeXxx value uint8_t val; // key value reported - meaning depends on 'typ' value uint8_t flags; // key flags - a bitwise combination of BtnFlagXxx values } __attribute__((packed)) button[MAX_BUTTONS] __attribute((packed)); // --- LedWiz Output Port Setup --- LedWizPortCfg outPort[MAX_OUT_PORTS] __attribute__((packed)); // LedWiz & extended output ports LedWizPortCfg specialPort[1]; // special ports (Night Mode indicator, etc) }; #endif