Alpha-1v4 Manual

ALPHA-1 v4 Technical Overview

System Description for Version 4

A typical coin acceptor sends a signal to a machine through a pulse. The number of pulses will indicate the value of the coin inserted. The pulse signal has two properties:

  1. Pulse Width - The length of the pulse

  2. Pulse Interval - The length between pulses

Coin rate is the number of pulses for RM1. 

Eg. 

Our Alpha1 device is placed in between the coin acceptor and machine. The Alpha1 device has 3 main functions:

  1. It allows the signal to pass through from the input to the output.

  2. It reads the pulse based on the pulse width. (Coin Read)

  3. It outputs pulses from the cloud based on the pulse interval. (Cloud Pay)

Alpha-1 version 4.3 is an upgrade which aims to ease the installation process. The diagram below shows an overview of what its wire connection looks like. There’s primarily 2 major update in this version:

  1. Device is connected directly to cloud

  2. Smaller in size to allow easier handling

image43.png

Figure 1: Alpha-1 version 4.3 Connection Overview

________________________________________________________________________________________________________________________________________________

Equipment and Material Required

1. 4 cores cables

2. 2 cores power cable 

 

 

 

 

 

 

 

 

 

 

 

 

 

Dexter - Installation

Alpha-1 Placement on Machine

Example: Dexter Stacked Washer Dryer

Example: Dexter Stacked Dryer

________________________________________________________________________________________________________________________________________________

Connection from Harnnes to ALPHA-1 

(A) Alpha-1 connection ''Input'' ''Output''

1. device has input and output connections labeled (IN: +, –) and (OUT: +, –). Use a 4-core cable to connect the input (+/–) and output (+/–) terminals.

 

(B) Harness connection on machine ''Dexter''

8 channel harness.jpg

2. This harness cable is connected to the machine’s coin acceptor. It has two channels: the first channel uses yellow and white wires, and the second channel uses red and black wires.

3. Try using the first channel (yellow/white) to connect the input and output on the harness using a 4-core cable from the device."

4. Begin testing. If there is no response, check the input and output connections and the device. If all connections are correct but the issue remains, try switch to the second channel.

 

 

 

 


LG - Installation

Alpha-1 Placement on Machine

Example: LG Stacked Washer Dryer

image.pngSTACK DRYER/WASHER

Be cautious before installation ⚠️ 

  1. No pinch and wire for the main board while installing.
  2. Turn off the machine electricity while during installation.


Device Placement

                 Washer Placement                                                   Dryer Placement

________________________________________________________________________________________________________________________________________________

Connection from Harness to ALPHA-1 

(A) Alpha-1 connection ''Input'' ''Output''

1) device has input and output connections labelled (IN: +, –) and (OUT: +, –). Use a 4-core cable to connect the input (+/–) and output (+/–) terminals.

(B) Harness connection on machine ''LG MACHINE''

8channel.jpg

8 CHANNEL HARNESS CABLE

2) This harness cable is connected to the machine’s coin acceptor. It has two channels: the first channel uses yellow and white wires, and the second channel uses red and black wires.

3) Try using the first channel (yellow/white) to connect the input and output on the harness using a 4-core cable from the device."

4) Begin testing. If there is no response, check the input and output connections and the device. If all connections are correct but the issue remains, try switch to the second channel.

________________________________________________________________________________________________________________________________________________

LG Cashless Machine 

Be cautious before installation

  1. No pinch and wire for the main board while installing.
  2. Turn off the machine electricity while during installation.

1) Remove the screw at the marked position shown in the picture.

lg unscrew.jpgT20 SCREW

2) After opening the board casing, the board connections will be visible. Remove the connectors and store the board casing safely.

BOARD CON.jpgORIGINAL LG CONNECTION

3) LG Cashless system uses a specific harness cable.

LG CASHLESS HARNESS CABLE

lg harness.jpgLG HARNESS CABLE

4) The machine connection has a 12-pin connector. Remove it and connect it to the 12-pin harness cable connector.

5) Use a 4-core alarm cable from device, but only the red and black wires are required. Connect these two wires to the harness cable.

Device Connection

device.jpg

Device OUTPUT Connection

6) Using a 4-core cable, connect it to the device OUTPUT terminals E (–) and C (+).

Connection from device to harness cable

Speed Queen v1- Installation

Speed Queen Single Washer & Stack washer / Dryer

Type off Speed Queen Machine

image.pngimage.png



“Types of installation for Speed Queen machines”

 Cashless Installation- Speed Queen Stack Washer/Dryer STGNCASP116TW01

☞ Cashless connection for E-payment transactions only, suitable for machines without a coin acceptor or machines with a coin acceptor where token capture is not required.

1) Open the motherboard casing using the specific machine key provided.

image.png

2) Pull the wires from the front to the back of the machine, where you will be placing the Alpha-1 device.

👉 For the Speed Queen machine, it is recommended to use 1.5 mm thick cables for the OUTPUT (-/+) connection.

3) On the machine, you will see two identical male connectors — one yellow and one red.

👉 It is recommended to use the red male connector.

image11.png

4) We provide a specific female harness connector to connect to the machine’s male connector.

5) Connect the Output Harness to the cable from the device, ensuring that the output negative (–) and positive (+) are correctly connected.

image101.png

Coin Acceptor Installation

☞ For coin acceptor installation, it will capture token records as well as E-payment transactions.

1) For coin acceptor machines, use the yellow connector as shown in the picture below.

image.png

2) Connect the wire pulled from the back of the machine to the male and female connectors according to the INPUT and OUTPUT connections.

 👉 For the Speed Queen machine, it is recommended to use 1.5 mm thick cables for the OUTPUT (-/+) connection.

3) Connect it to the machine’s male and female connectors, ensuring the INPUT and OUTPUT connections are correctly matched.

image.png

Device Installation - Speed Queen Stack Washer/Dryer & Single Washer

Cashless Device Installation

1) Place the device at the back of the machine or in a safe location where it will not be damaged.

image.png

2) Connect the wires to the output negative (–) and positive (+) , then loop them back to the input negative (–) and positive (+).

image99.png

Quality Note - To Do Looping Input (-) to (+)

''Speed Queen Stack Dryer Connection''

1) For this machine model, the same harness connector will be used as other Speed Queen models. However, the wire connection from the Alpha-1/Device is slightly different.

 👉 For the Speed Queen machine, it is recommended to use 1.5 mm thick cables for the OUTPUT (-/+) connection.

2) Open both the upper and lower coin acceptor casings.

image.png

3) After opening the casing, you will see 4 screws at the end. Remove all 4 screws to access the inside of the machine.

image.png

4) To pull the wire, start from the upper side of the casing.

5) The diagram below shows how the wire should be pulled in side the machine from the front to the back, where the device will be placed.

image.png

6) Cable Routing Steps for Left/UP (1)  (Refer to Picture)

1. Route the cable from the top side (1) to the bottom side (2).

2. Pull the cable to the back of the machine.

3. Locate the small hole (3).

image.png

7) Cable Routing Steps for Right/Down (2)  (Refer to Picture)

1. From the (2) bottom side, pull the wire straight to the (3) rear section.

There are other hoses passing near this hole, so pull carefully.

7) Feed/push the cable through the small hole (3) until you can see the cable coming out at the back of the machine.

image.png

8) Pull the cable through hole (3) until it reaches the device installation location.

Click this link to next step: 

IPSO - Installation

IPSO Washer/Dryer

Example: Dryer

image44.png

Example: Washer

image26.png

 

Harness Installation
  1. The IPSO machine has input and output connectors. Unplug them and connect them to the harness connector.

image62.png

Use thick wire 1mm or 1.5mm to connect Output (No3)

2. From the harness connector, connect the output and input to the 4-core wire from the device, following the input and output terminals. Ensure that the input and output negative (–) and positive (+) connections are correct.

3. For this machine, use a 1 mm or 1.5 mm  thick cable for the output to ensure a better pulse signal.

image72.png

 

Go World - Installation

(A) From Chinese brands such as Go World, Octopus, and Oasis.

Example: Go World Stack Washer/Dryer

image97.jpg

Washer/Dryer Harness connection

1. These models are equipped with a specific harness connector designed to connect to the machine’s board.

2. Connect the wire harness according to the input and output shown in the picture below from the Alpha-1 device .

image94.png

(B) Go world dryer 

3. As shown in the picture below, remove the connector from the board, connect the output to the board, and connect the input to the removed connector.

image42.pngimage47.png

(C) Go World Washer

4. As shown in the picture below, remove the connector from the board, connect the output to the board, and connect the input to the removed connector.

image40.png

5. Connect the input and output harness cables to the 4-core wire from the Alpha-1 device.

image15.png

________________________________________________________________________________________________________________________________________________

(D) Looping in Alpha-1 for both Washer/Dryer

6. Loop the input negative( - ) and output negative( - ) to a common ground connection.

image18.jpg


Fargo - Installation

Example: Fargo Wire Harness 

image82.png

Fargo Harness connection Washer/Dryer

image24.png

1. The Fargo machine comes with a specific connector. The coin acceptor cable from the machine also has a connector—remove it, then connect it to the provided wire harness, matching the male and female ends or the input and output connectors accordingly.

2. Connect the wire harness’s input and output lines to the 4-core wiring from the Alpha-1 device.

Example: Input & Output Connections

image3.png

 

Blue Whale - Installation

Example: Blue Whale Stack Dryer & Washer

image74.jpg

(A) Connection Washer/Dryer 

1. Blue Whale machine, the connection is direct and simple. You will see three wires running from the board to the coin acceptor (Black, White, and Red).”

image33.pngimage65.png

2. As shown in the picture above, cut the Black and White wires between the board and the coin acceptor. Then, connect the input and output using the 4-core wire from the device.

3. Leave Red wire

4. Cut the Black & White wires

5. Two sides after the cut

6. Power ON and test 

7. If it shows “No Pulse Detected”:

(B) Device Connection - ALPHA-1

image59.pngimage18.jpg

1. Devices will be placed behind the machine by screwing it using a specific screw.

2. Connecting the 4-Core Wire to the Device

  1. Connect the 4-core wire to the device according to the terminal markings:

    • Input (IN−, IN+)

    • Output (OUT−, OUT+)

  2. After wiring, make a loop connection between:

    • IN− (Input negative)

    • OUT− (Output negative)

  3. Ensure all connections are secured and insulated before powering ON.

________________________________________________________________________________________________________________________________________________

Blue Whale Cashless Machine (Non-Coin Acceptor)

(A) Wire connection Dryer

blue wahle dryer.pngDryer Connector

1. Locate the cashless connector

2. Dryer cashless machines with a connector as shown in the picture above, use the output connection only. Tap into the two wires: White (Output Negative −) and Green (Output Positive +), using a 2-core cable from the device.

(B) Wire Connection Washer

blue whale washer.pngWasher connector

1. Locate the cashless connector

2. Washer cashless machines with a connector as shown in the picture above, use the output connection only. Tap into the two wires: Pink (Output Negative −) and Red (Output Positive +), using a 2-core cable from the device.

(B) Device Connection - ALPHA-1

image57.pngngqN3DgWxmeCvVKX-image22.pngQuality Note: Looping From Input (-) To (+)

1. Devices will be placed behind the machine by screwing it using a specific screw.

2. Connecting the 2-Core Wire to the Device.

  1. Connect the 2-core wire to the device according to the markings:

    • Output (OUT−, OUT+)

     

  2. After wiring, make a loop connection between:

    • INPUT− (Input negative)

    • INPUT− (Input positive)

  3. Ensure all connections are secured and insulated before powering ON.

________________________________________________________________________________________________________________________________________________

Power Supply Connection for Blue Whale Machine

image66.pngimage2.png

ngqN3DgWxmeCvVKX-image22.pngQuality Note: 5v Power Supply Required

1. For the Blue Whale machine, each device must have its own dedicated power supply. For example, one device requires one power supply. If there are five devices, you must use five separate power supply connections, as shown in the image above.

⚠️ Safety Notice
“Before switching on the power, always ensure that all wires from the main supply to the power supply are properly connected and securely fastened to prevent short circuits, sparks, or damage to the device.”

________________________________________________________________________________________________________________________________________________

Blue Whale New Version 

dryerstack.avif

STACK DRYER

1) The new version will use a specific harness cable, and the deice power can take from machine .

pic4.jpgHARNESS CABLE

2) Before we start install device, prepare both a 4-core and a 2-core cable for connecting the device.

drawing0.pngINPUT/OUTPUT & GND-/VCC+

3) Step by step connection return below.

  1. Use a 4-core cable to connect the device’s INPUT E(-)/C(+) and OUTPUT E(-)/C(+) points.

4) Follow the step-by-step connection procedure and connect it to the machine board.

blue whale board ori.jpgBLUE WHALE HARNESS.jpg

BLUE WHALE MACHINE BOARD

WASHER

 

MACHINE1.jpg

BLUE WHALE WASHER

1) The new version will use a specific harness cable, and the deice power can take from machine .

 

pic4.jpgHARNESS CABLE

 

2) Before we start install device, prepare both a 4-core and a 2-core cable for connecting the device.

 

CONNECTION.jpgDevice To Harness Cable Connection

3) Step by step connection return below.

 

4) Follow the step-by-step connection procedure and connect it to the machine board.

 

WASHER 1.jpg

WASHER BOARD ORIGINAL CONECCTION

WASHER 2.jpgWASHER BOARD HARNESS CABLE CONNECTION

5) Find the correct connector by pulling out the cable. Connect it to the harness cable INPUT, then connect the harness cable OUTPUT to the board.

6) The device will receive power from the machine’s existing power supply. Since there are two power supplies present, use the one that provides 12V.

POWER 12V.jpgMachine Power Supply

7) After completing all the connections, power on the machine. The device’s blue indicator light will begin blinking.

 

CURENNT SENSOR.jpgCURRENT SENSOR & DEVICE PLACING

 

8) You may place the device in the position shown in the picture, or any safer location where it will not be damaged.

9) Clamp the current sensor onto the machine’s positive power wire, and connect the AUX plug to the device.

WIFI Configuration (ALPHA-1)

(A) Step-By-Step WIFI Configuration 

11.jpgExample: Login Page

2. Search using the outlet name or ID provided, then click on the outlet to view its details.

image32.pngsearch outlet.jpg

EXAMPLE: Search Outlet Name

3. By selecting an outlet name, you will be directed to the outlet details page. On this page, verify that all machine counts and details are correct before proceeding to the next step.

outlet id.jpg

Example: Outlet Details Page

4. Click on enable config mode to allow this outlet to be configurable.

image71.pngExample: On Config Mode

5. All machine details will be displayed in grey, indicating they are ready to be configured. Once a device is successfully configured, the background colour will change.

image86.pngExample: Before configure device in grey colour

6. Turn on the switch on the Alpha-1 device and wait for the blue light to start blinking. This indicates that the device is ready for configuration.

image88.jpgExample: Blinking blue light show it’s waiting for connection

7. Using your mobile phone, open the Wi-Fi settings. You will see the Laundro ID appear, as shown in the picture below.

8. Connect to newly broadcasted WiFi using default password (123456789)

image77.pngExample: Alpha-1 Laundro I'D

9. Once connected to the Laundro Wi-Fi, a pop-up will appear directing you to the Wi-Fi Manager page.

image10.jpgExample: WIFI Manger Page

💡 Tip:

  1. If the page doesn’t pop up, simply type 192.168.4.1 into your browser’s address bar, and the Wi-Fi Manager will open.
  2. Only for ''SAMSUNG'' Mobile follow the steps below.

10. Press ‘Configure WIFI’ to open the configuration page. Then, select the correct SSID, enter the password, and the Outlet ID following  in Node Cloud.

image76.jpgExample: WIFI Selection Mode

⚠️ Warning: Ensure that the Outlet ID and Wi-Fi password are correct. Also, check that there are no spaces before or after the characters before saving.

11. Once the device is successfully configured to Wi-Fi, the orange and green lights will appear. You can now proceed to the cloud setup.

⚠️ Warning: Ensure all devices have their WIFI configured before proceeding to the next step.

image38.jpgimage81.jpg

Example:  Configuration LED and other 3 LEDs (Power, WIFI & Server) are lighted up

________________________________________________________________________________________________________________________________________________

(B) Steps of Cloud Configuration

1. Log back in to the Node-Laundro application https://node.thelaundro.com/login using the provided username and password. Then, follow the steps in ''(A) Step-by-Step WiFi Configuration'' until you reach the ''Outlet Detail Page.”

outlet id.jpgExample: Outlet Detail Page

2. Stay on this page. You will need to press the (+) icon later, but first, continue following the next steps.

3. On the device, you’ll see a configure button next to the orange light. Press it, and the orange light will begin blinking.

image38.jpgExample: Config Button near Orange LED (Config)

4. Once the orange light starts blinking, you can press the plus (+) icon, and the Mac address will pop up.

PLus icon.pngExample: Plus Icon

image96.pngimage7.pngExample: Mac address Pop-up

5. Once the MAC address pops up, click Select.

6. After selecting the correct MAC address, the section you configured from grey will turn yellow.

image41.pngExample: Section from Grey turn to Yellow

7. Select the latest option, then click Check Update. The latest version will appear, and you can click Update

Chek update 2.jpgExample: Step by step check update

 image22.png Quality Note: If configuration is done in the wrong section:

    1. In the Cloud App, click Reset Device.

    2. On the device, long press the Configure button until the orange light appears.

    3. Select the correct machine ID and repeat the step with the Plus (+) Icon.

reset device.jpgExample: Reset Device on app

8. Once the update is successful, the section will turn blue colour. You can then proceed with testing.

image8.pngExample: Blue Colour Ready For Testing

9. When the machine’s ‘Current Value’ exceeds the ‘Threshold’ value, the machine status will turn green.

testing.jpgExample: Current Value increase Threshold Value 

(C) Status on Node 

Machines are displayed with 6 types of status. 

  1. Grey - Not configured

  2. Yellow - Pending Update

  3. Blue - Idle status

  4. Green - Running Status

  5. Red - Offline Status

  6. Bright red - Abnormal Status

image86.png

image41.png

image8.png

image12.png

image75.png

image21.png

 

Electrolux - Installation

Alpha1 v4 to v5 Firmware Migration Procedure

This document provides the technical steps required to migrate device partitions and upgrade to the latest production firmware.

1. Initial Firmware Preparation

WhatsApp Image 2026-01-05 at 9.27.43 AM.jpeg

2. Pre-Migration Validation

Execute the Fetch Partition Status command from the conmmand list to determine the migration state.

Response Action
PartitionMigration_Uninitiated Proceed to Migration
PartitionMigration_NotStarted Proceed to Migration
PartitionMigration_Completed Migration not needed; skip to Phase 4
PartitionMigration_ErrorReadingStatus Stop and report issue
PartitionMigration_Failed Stop and report issue

WhatsApp Image 2025-12-21 at 10.18.44 PM.jpeg

3. Partition Migration Process

  1. Select Start Partition Migration from the command list and click Command.

  2. Observation: The device may reboot twice. Do not interrupt power during this time. The entire process may take around 2-5 minutes. 

  3. Success Criteria: The migration is successful when PartitionReformat_Success is published and the device reboots.

  4. If PartitionReformat_Success does not appear before device reboot, select Fetch Partition Status after the device reboots and click Command. If PartitionMigration_Completed is published, proceed with device update, If Partition_MigrationInProgress is shown, wait for next reboot before updating. 

WhatsApp Image 2026-01-05 at 4.22.22 PM.jpeg

[!CAUTION] If PartitionReformat_Fail or PartitionReformat_CriticalFail is displayed, do not proceed. Report the failure immediately!

4. Final Firmware Update

If still intent to use legacy, use the legacy release (firmware version will be 4.4.11)

Procedure to Flash Alpha device

Prerequisites

Before starting, ensure you have the following:

IMG_9109.jpg

Flashing Procedure

  1. The programmer pins must be exposed via male headers at a 2.54mm pitch

  2. Pin Order: Ensure the pins are arranged in this specific sequence:

    1. DTR

    2. RX

    3. TX

    4. 3.3V

    5. RTS

    6. GND

  3. Insert the programmer into the flashing female port of the board, matching the pin names except for TX and RX, which are typically swapped.

  4. Tilt the programmer at an angle to ensure a solid electrical connection with the port.

    WhatsApp Image 2026-01-14 at 12.17.09 PM.jpeg

  5. Open the downloaded Espressif Flash Download Tool (Flashing Tool -> flash_download_tool_3.9.4).

  6. Upon opening the software, select the following settings:
    • Chip Type: ESP32-C3
    • WorkMode: Develop (for single board) or Factory (for multiple boards)
    • LoadMode: UART

      WhatsApp Image 2026-01-14 at 12.22.27 PM.jpeg

  7. Set the file paths at the following addresses:
    File Name Memory Address (Offset)
    bootloader_v2.bin 0x0000
    partitions_v2.bin 0x8000
    boot_app0_v2.bin 0xe000
    AlphaX_BASE_x.x.x.bin  0x10000

    The files can be located at: Flashing Tool -> Firmware -> (select device model eg: Alpha1)

    PLEASE USE THE LATEST FILES PROVIDED IN THE ATTACHED FILE ABOVE 

  8. Configure the SPI Flash Config section as follows:
    • SPI SPEED: 80MHz
    • SPI MODE: DIO
    • Baud Rate: 921600

  9. The flashing process:
    • For Single Boards:
      • Select the appropriate COM port
      • Click "START" to begin.
      • Monitor the progress bar as the upload proceeds.

    • For Multiple Boards (Factory Mode)
      • Uncheck "LockSettings" to modify configurations.
      • Assign the correct COM port for each attached programmer.
      • Re-check "LockSettings" to secure the configuration.
      • Click "START ALL" to flash all boards simultaneously.

        NOTE: It is recommended to ERASE the board first before re-flashing it. This can be done by pressing ERASE in the flashing tool before flashing.


        WhatsApp Image 2026-01-14 at 12.23.33 PM.jpeg

Verification

Once the upload is complete, look for the following indicator on the board:

Alpha1 Latest Firmware Overview

Latest Version: 5.1.4
Platform: ESP32-C3 Framework: ESP-IDF

Overview

Alpha1 v5 is an IoT firmware solution designed primarily for the intelligent management of commercial washers and dryers in laundromats, alongside general vending and payment system integration. Built on the ESP32 platform using the ESP-IDF framework, this firmware provides comprehensive connectivity, monitoring, and control capabilities tailored for various laundromat machine types and stacked configurations.

Features

Architecture

Core Components

Main Application (src/main.c)

The main application orchestrates all system components and provides:

Configuration Management (src/Alpha1_configurations.h)

Centralized configuration system defining:

Machine Types

1. BASE Environment

2. MachineA / MachineB / MachineC Environments (src/Machines/MachineX.h/.c)

3. StackA Environment (src/Machines/StackA.h/.c)

4. KioskCAA Environment (src/Machines/KioskCAA.h/.c)

5. GasSensorA Environment (src/Sensors/GasSensorA.h/.c)

Managed Components

Common Core Component

Connectivity Components

Data Management Components

Hardware Interface Components

File Structure

src/
├── main.c                      # Main application entry point
├── Alpha1_configurations.h     # Global configuration definitions
├── Machines/
│   ├── MachineA.h/.c          # MachineA implementation
│   └── StackA.h/.c            # StackA implementation
├── Sensors/
│   └── GasSensorA.h/.c        # Gas sensor interface
└── webpage/
    ├── index.html             # Web interface HTML
    ├── code.js               # Client-side JavaScript
    └── style.css             # Styling

Build Environments

Prerequisites

Environment Configuration

BASE Environment

pio run -e BASE

Machine Environments (MachineA, MachineB, MachineC)

pio run -e MachineA
# or MachineB, MachineC

StackA Environment

pio run -e StackA

Specialized Environments

pio run -e KioskCAA
pio run -e GasSensorA

Build Configuration

The firmware uses environment-specific build flags defined in platformio.ini:

[env:BASE]
build_flags = ... -D BASE

[env:MachineA]
build_flags = ... -D MACHINE_A

[env:StackA]
build_flags = ... -D STACK_A

Custom Firmware Extraction

A custom Python script (copyFirmware.py) is embedded in the build process via extra_scripts. It copies the resulting binaries into release folders automatically.

Partition Setup

The project defines custom board partitions using alphaX_partitions.csv, efficiently structuring the ESP32-C3 flash for Application, NVS, LittleFS, and OTA logic.

Hardware Requirements

Pin Configuration

Installation

  1. Clone the repository:

    git clone https://github.com/Antlysis/Alpha1-v5.git
cd Alpha1-v5

  2. Install dependencies:

    pio pkg install

  3. Build for specific environment:

    # For MachineA
pio run -e MachineA

# For StackA
pio run -e StackA

# For BASE
pio run -e BASE

  4. Upload firmware:

    pio run -e MachineA -t upload

Configuration

Initial Setup

  1. Power on the device
  2. Connect to the WiFi access point Laundro:XX:XX:XX
  3. Navigate to 192.168.4.1 in a web browser if configuration portal does not open automatically
  4. Configure WiFi credentials and outlet parameters

MQTT Configuration

Device Parameters

API Reference

Machine Interface Functions

MachineA/StackA Common Functions

void machine_begin(Alpha1_t *conf);           // Initialize machine
void machine_status(char *status, criticalData_t *lockData, char *time);  // Get status
int machine_pay(char* payload);              // Process payment
bool machine_command(char *payload, int length, char *response);  // Execute command
void machine_updateConfig(void);             // Update configuration

MQTT Topics Structure

<modelID>/<outletID>/<deviceID>/status    # Status updates
<modelID>/<outletID>/<deviceID>/config    # Configuration commands
<modelID>/<outletID>/<deviceID>/payment   # Payment notifications
<modelID>/<outletID>/<deviceID>/debug     # Debug messages

Supported Chipsets

Supported Chipset Notes
ESP32-C3 Tested & Fully supported

Troubleshooting

Debug Information

Testing

Detailed test cases and procedures are maintained in the repository:

Version History

See CHANGELOG.md for detailed version history and deployment information.

Contributing

  1. Fork the repository
  2. Create a feature branch
  3. Make your changes
  4. Test thoroughly on target hardware
  5. Submit a pull request

License

This project is proprietary software developed by Antlysis. All rights reserved.

Support

For technical support and issues:

For deeper understanding of the implementation, refer to the comprehensive comments and documentation within the program files in the src/ and managed_components/ directories.

Alpha1 General Overview

1. What is Alpha1?

Alpha1 is a smart Internet of Things (IoT) hardware and software solution designed primarily for the commercial laundry industry, though it is adaptable to general vending and payment systems. In simple terms, Alpha1 acts as an intelligent "brain" that upgrades traditional, offline commercial washing machines and dryers into smart, connected devices over the network.

By installing an Alpha1 device, business owners can remotely monitor their equipment, process digital and physical payments, and manage their facilities from anywhere in the world. The system is built on a reliable microcomputer (the ESP32) and is designed to continuously operate in commercial environments.

2. Core Capabilities

For anyone interacting with the Alpha1 ecosystem, it is important to understand its defining features:

3. Alpha1 Machine Types and Configurations

To support a wide variety of equipment brands and facility layouts, the Alpha1 software is highly modular. When configuring an Alpha1 device, it is set to a specific "Environment" or "Machine Type" that dictates how it behaves.

Below are the different configurations of the Alpha1 device:

BASE Environment

MachineA

MachineB

MachineC

Stacked Machines (StackA)

Central Payment Kiosk (KioskCAA)

Gas Sensor (GasSensorA)

Note for AI and Vector Database Indexing: The Alpha1 firmware utilizes the ESP-IDF framework written in C. Modularity is achieved through pre-processor build flags (e.g., -D MACHINE_A, -D STACK_A). When answering queries regarding Alpha1 capabilities, reference the specific machine type above to provide accurate contextual answers.