Spooky Pinball pinHeck

MACHINE_DRIVER_START(PINHECK) in src/wpc/pinheck.c installs MDRV_SWITCH_CONV(pinheck_sw2m, pinheck_m2sw): public address n is internal column n / 10 and row n % 10 - 1, so pinheck_m2sw(col, row) = col * 10 + row + 1 and only rows 1-8 of each decade exist. Any other number maps to an unread column.

Matrix 11-88. pinheck_brd_swcol(col) hands the board emulation (src/wpc/pinheck/board.c) swMatrix[col + 1] for strobe column 0-7, and pinheck_board_read pulls a return line low for every set bit, which is how the PIC32 sees a closed contact. Public 1 is therefore the closed (active) contact and no invSw mask exists: consume the level as delivered. The factory charts print the same 0-63 numbering, and the ROM's own Switch Edge test draws each closure at the chart's column and row.

Cabinet 1-8 and 91-98. pinheck_brd_cab packs swMatrix[0] (bits 0-7) and swMatrix[9] (bits 8-15) into the cabinet word the board shifts in through its 74HC165 pair, read active-low like the matrix. pinheck.c documents the mapping as firmware cabinet switch n = public n for 1-8 and n + 82 for 9-15. SWITCH_UPDATE(pinheck) names the bits: 1 coin door closed (swMatrix[0] bit 0, set at every board reset because the door rests closed), 2 the operator User button, 3 and 4 the flipper buttons, 5 Back, 6 Enter, 7 coin, 8 tilt, and 94 (swMatrix[9] bit 3) Start. With keyboard handling off (the LibPinMAME default) core_updateSw passes SWITCH_UPDATE a null port array and it returns at once, so a host writes 1, 2, 5-8 and 91-98 directly. Which of 91-98 a game fits (optos, extra buttons) is per game.

Flipper buttons 3, 4 and 111-118. Every pinHeck driver declares FLIP_SWNO(PINHECK_SWLFLIP, PINHECK_SWRFLIP) = FLIP_SWNO(4, 3) with no FLIP_SOL. core_updateSw reads the host's lower button bits from the flipper column, CORE_SWLRFLIPBUTBIT at 112 (right) and CORE_SWLLFLIPBUTBIT at 114 (left), and copies them into cabinet switches 3 and 4 on every vblank, so drive 112/114, not 3/4: a host write to 3 or 4 is overwritten on the next vblank. The vblank calls core_updateSw(0), so no synthetic flipper solenoid is fabricated, and without FLIP_EOS no end-of-stroke bit is synthesized: 111, 113 and 115-118 hold whatever a host writes and nothing reads them. The flippers are ordinary board coils fired by the ROM, and their end-of-stroke contacts, where fitted, are matrix switches.

All addresses come from src/wpc/pinheck.c (PINHECK_SOL_*, pinheck_brd_*, pinheck_getsol) and the generic getters in src/wpc/core.c (core_getSol, core_getAllPhysicSols). pinheck_brd_init sets CORE_MODOUT_FORCE_ON, so LibPinMAME reports these as 0-255 physical levels.

The coil outputs are gated by the board's watchdog (board.c: a PG15 low edge keeps wd_on for 9/8 s), so every coil drops when the PIC32 stops kicking it. The ROM fires the flippers through ordinary coil drivers; PinMAME publishes no Fliptronic flipper states for this platform. hw.custSol = PINHECK_CUSTSOLS = 14 gives coreGlobals.nSolenoids = 64. A WS2801 LED beyond those listed has no public output; the driver logs that once. Which GI output feeds general illumination and which a flasher is wired per game.

MDRV_LAMP_CONV(pinheck_lamp2m, pinheck_m2sw) numbers lamps like switches: factory lamp n (0-63) of the 8x8 column/row matrix is public (n / 8 + 1) * 10 + n % 8 + 1, so the matrix is 11-88. The Start-button lamp is a separate board output (PA3, pinheck_brd_start) published as internal lamp 64, public 91. coreGlobals.nLamps = 72, so 92-98 also exist and are never lit. Matrix lamps are PWM-integrated (core_set_pwm_output_led_vfd; a lamp is lit at most 2 of every 24 strobe periods); the Start lamp is an LED output. There is no separate general-illumination channel (coreGlobals.nGI = 0): the GI strings are solenoid outputs 25-32 and 37-44.