Project Specification
Design Summary
Status: Draft
Manufacturing target: Prototype
Software / firmware: ESP32-based wireless telemetry firmware
Scope
Purpose
This project updates the slot-machine telemetry PCB to use a fixed onboard ESP32 instead of a removable ESP32 module, rely on the ESP32 for all wireless internet connectivity, accept either 5 V or 12 V machine power input, monitor money-in and money-out harness signals from the machine, expose BOOT and RESET controls, and remain practical to manufacture. The visual and mechanical direction should be informed by the attached sample photo, but only as a reference until exact mechanical constraints are confirmed.
In scope
- Replace the removable ESP32 approach with a fixed onboard ESP32 implementation
- Define the board-level requirements for WiFi-only telemetry through the onboard ESP32
- Capture external power-input requirements for operation from either 5 V or 12 V
- Capture the machine harness interface requirements for money-in and money-out signals
- Capture the need for BOOT and RESET user-accessible service controls
- Capture manufacturability and layout-style requirements inspired by the sample photo
- Document ambiguities and information still required before schematic and PCB decisions are made
Out of scope for this revision plan
- Detailed circuit topology decisions
- Final connector part selection
- Final protection, isolation, or signal-conditioning method
- Final regulator architecture
- Firmware implementation details beyond high-level interface needs
- Regulatory or certification documentation
System context
This board sits inside or alongside a slot-machine environment and acts as a telemetry interface between the machine and a wireless backend. The board receives power from the machine, observes two money-related machine signals, and sends telemetry over WiFi using the onboard ESP32.
Key interfaces
- Power input from machine: 5 V or 12 V source
- Telemetry path: wireless internet connectivity through onboard ESP32 only
- Machine I/O: money-in harness input and money-out harness input
- Service interface: BOOT and RESET buttons
- Mechanical intent: manufacturable PCB with placement/style direction informed by the attached sample photo
Revised requirements
Functional
- The design shall use a fixed onboard ESP32 rather than a removable ESP32 module.
- The ESP32 shall be the board's only intended wireless internet interface.
- The board shall operate from either a 5 V input or a 12 V input supplied by the machine.
- The board shall accept two machine-originated telemetry-related inputs: money-in and money-out.
- The board shall include BOOT and RESET controls for bring-up, programming, and recovery.
- The board shall be suitable for practical PCB fabrication and assembly.
- The PCB layout direction shall be visually informed by the attached sample photo, subject to final mechanical constraints.
Interface / integration
- The money-in and money-out signals shall remain configurable requirements until their exact voltage, polarity, source type, and reference scheme are confirmed.
- The machine-side power-input connector and signal harness details shall remain open requirements until the exact mating hardware is identified.
- The onboard ESP32 requirement shall be refined to a specific ESP32 family or variant once software, RF, memory, and provisioning needs are confirmed.
Mechanical / manufacturing
- The board should target standard prototype-friendly PCB fabrication and assembly.
- The sample photo should be treated as a style and arrangement reference, not yet as a locked mechanical copy.
- Mechanical requirements still need confirmation for board outline, mounting, connector orientation, button accessibility, and any enclosure or harness clearance limits.
Implementation plan (requirements capture only)
1) Freeze the product-direction changes
- Record the architectural shift from removable ESP32 module to fixed onboard ESP32.
- Record that all network connectivity is now wireless through the ESP32 only.
- Remove any remaining requirement assumptions that depend on a removable module or non-ESP32 networking path.
2) Capture the minimum external-interface definition
- Confirm what the machine provides for input power: allowed nominal voltages, tolerance, polarity expectations, and whether both 5 V and 12 V are possible in the same product family or on the same harness.
- Confirm the harness definition for money-in and money-out as far as currently known: signal names, common return/reference, expected event behavior, and connector ownership.
- Explicitly mark unknown signal-electrical details as blockers for later circuit definition rather than guessing them now.
3) Capture the onboard-ESP32 requirements at a product level
- Confirm that the ESP32 is fixed on the PCB and not user-removable.
- Confirm the required wireless role at a high level: WiFi telemetry to a backend service.
- Capture any still-open product requirements that affect ESP32 selection, such as provisioning method, expected RF environment, memory needs, antenna constraints, or service access expectations.
4) Capture service and bring-up access requirements
- Define BOOT and RESET as required board-level service functions.
- Confirm whether the buttons are intended only for development/service access or also for field access.
- Capture any need for programming, test, or debug access that should coexist with those buttons.
5) Capture mechanical and visual intent from the sample reference
- Use the attached sample photo as a visual reference for board style, connector/button accessibility, and general placement priorities.
- Treat any dimensions, hole locations, and connector spacing as unconfirmed until measured or specified.
- Record manufacturability as a first-class requirement so the final layout favors standard fabrication and assembly processes.
6) Convert unknowns into tracked requirement questions
- Create an explicit list of unanswered integration questions.
- Separate "must know before schematic capture" items from "can be resolved during layout refinement" items.
- Avoid locking in circuit choices until these questions are answered.
Key ambiguities to resolve
- What is the exact voltage range of the money-in and money-out signals?
- Are the money signals referenced to machine ground, open-collector/open-drain style, actively driven, AC-like pulses, or something else?
- What are the expected pulse width, frequency, idle state, polarity, and noise environment for each harness signal?
- Is there one physical connector for power and both money signals, or separate harnesses?
- What connector family, pin order, and pin labeling must the PCB support?
- Which ESP32 family or exact part should be treated as the product target?
- What antenna placement constraints, keepout needs, or enclosure limitations apply to the fixed onboard ESP32 approach?
- Are BOOT and RESET intended to be reachable only during bench service, or in the installed product?
- What exact features from the sample photo are mandatory versus only inspirational?
- Are there board-size, mounting-hole, standoff, or enclosure constraints not yet documented?
Requirements-capture acceptance criteria
- The project documentation clearly states that the ESP32 is onboard and fixed.
- The project documentation clearly states that connectivity is wireless through the ESP32 only.
- The project documentation clearly captures dual-voltage power-input intent at the requirements level.
- The project documentation identifies money-in and money-out as external machine interfaces while explicitly flagging their electrical ambiguity.
- The project documentation records BOOT and RESET as required service features.
- The project documentation records manufacturability and sample-photo-inspired layout intent without prematurely locking detailed circuit or PCB decisions.
- The remaining unknowns are listed clearly enough to drive the next round of stakeholder clarification.