Alpha3 General Overview 1. What is Alpha3? Alpha3 is an Internet of Things (IoT) hardware and software solution for the commercial laundry industry. Alpha2 talks to a washer's or dryer's controller board. Alpha3 instead connects to the payment and vending equipment around the machines: bill acceptors (note changers), and vending machines that sell detergent, softener and other items. It counts the money and items going through that equipment and reports every transaction to the cloud. Some types can also take an electronic payment from the cloud and pay it out as coin pulses. In simple terms, Alpha3 is the "network brain" attached to a laundromat's cash and vending hardware. Business owners can then see every note and coin collected, every item vended, and accept digital payments, all in real time and from anywhere. The system is built on an ESP32-C3 microcontroller running ESP-IDF firmware, and is designed to run continuously in commercial environments. It replaces the Arduino-based v4 firmware. 2. Core Capabilities For anyone interacting with the Alpha3 ecosystem, it is important to understand its defining features: Pulse and Serial Input: Alpha3 reads the equipment in one of two ways. Pulse types count electrical pulses on the board's inputs, where each pulse (of the configured width, within a tolerance) is one unit of money or one vended item. Serial types decode the bill acceptor's own UART data stream (9600 baud), which reports the exact note value accepted. Electronic Payment Output: On VendingA and BillAcceptorN, an e-payment from the cloud is paid out as coin pulses on the CA1 output, exactly as if coins had been inserted into the machine. The pulse width and the interval between pulses are configurable. Duplicate payment messages are detected and ignored. Real-Time Monitoring: The equipment is checked every 5 seconds. A status update is published whenever the bill or coin count changes, when the WiFi signal (RSSI) moves by more than 5 dBm, and at least once a minute otherwise. The status format is the same for every type: 1___. One Thing at a Time: Payments, cloud commands and status checks are all run one after another by a single task, so a payment can never land in the middle of a status check. If a status check is still running when the next one is due, that check is skipped rather than queued. Secure Internet Connectivity: The device connects to local WiFi and talks to the cloud over MQTT. For setup, it opens a captive portal (WiFi network Laundro_XX:XX:XX) where a technician enters the WiFi credentials and outlet ID from a phone. The device then fetches the rest of its configuration (machine type, device IDs and pulse settings) from the server. Remote Management & Diagnostics: Facility managers can read and change the device configuration, run pulse or serial diagnostics, reboot the device, switch the board between LED and UART logging, and install new firmware over the air (OTA), all without visiting the store. Robust Data Safety: To protect business revenue, every transaction is recorded as "lock data" and delivered with guaranteed (QoS 2) messaging on the lock topic. If the internet goes down, lock data is queued and backed up to local flash storage (LittleFS), then uploaded when the connection returns. Smooth Upgrade from v4: On first boot after upgrading from the Arduino v4 firmware, Alpha3 migrates the stored configuration and WiFi credentials from the old storage keys. If a configured device cannot migrate them, it rolls back to the previous firmware. Two Board Revisions: The same firmware supports Alpha3 board v4.1 and v4.2, which have different pin layouts. A factory-reset device assumes v4.2. 3. Alpha3 Machine Types and Configurations To support different equipment, the Alpha3 firmware is modular. Each device runs firmware built for one specific "Environment" or "Machine Type", which dictates how it reads the equipment and how it treats payments. The naming follows a simple pattern: VendingA: a vending machine (coins and notes in, items out). BillAcceptor A / B: bill acceptors that report notes as pulses. BillAcceptor M / N: bill acceptors that report notes over a serial (UART) link. Every type reports the same status format. Notes collected are reported as lock data in the format 0_