Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions SwitchBox/SwitchBox5/New
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
New Board
65 changes: 65 additions & 0 deletions SwitchBox/SwitchBox5/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,65 @@
# Cab Switchbox 5

ESP32-based 16-input network switchbox for the AgOpenGPS Rate Controller.

## Repository contents

- `firmware/ESP32_Cab_Switchbox/` — Arduino firmware source.
- `release/` — precompiled ESP32 firmware files.
- `docs/` — user manual, printable HTML, screenshots, and manual generator.
- `hardware/SwitchBox5_Terminals_PCB_01/` — Rev 01 PCB production files.

## Hardware target

- ESP32 board: ESP32 DevKit / DOIT ESP32 DEVKIT V1
- Arduino FQBN: `esp32:esp32:esp32doit-devkit-v1`
- PCB: `SwitchBox5-Terminals-PCB-01`
- Recommended enclosure: Hammond `E1555K2GY`, NEMA 4X
- Board supply: 12-24 VDC
- Onboard buzzer: 12 V only; use a 12 V supply if buzzer operation is required

## Build

Install Arduino CLI and the Espressif ESP32 Arduino core, then run from the
repository root:

```powershell
arduino-cli compile `
--fqbn esp32:esp32:esp32doit-devkit-v1 `
--output-dir build `
firmware/ESP32_Cab_Switchbox
```

## Flashing

The easiest full-device image is:

```text
release/ESP32_Cab_Switchbox.ino.merged.bin
```

Flash the merged image at address `0x0` with an ESP32 flashing tool.

Arduino CLI can also compile and upload the source directly:

```powershell
arduino-cli upload `
-p COMx `
--fqbn esp32:esp32:esp32doit-devkit-v1 `
firmware/ESP32_Cab_Switchbox
```

Replace `COMx` with the switchbox serial port.

## Documentation

See `docs/CAB_SWITCHBOX_MANUAL.pdf` for setup, terminal assignments, network
configuration, wiring, buzzer behavior, and troubleshooting.

## Current build

Compiled June 19, 2026:

- Program storage: 1,045,571 bytes (79%)
- Dynamic memory: 50,504 bytes (15%)

18 changes: 18 additions & 0 deletions SwitchBox/SwitchBox5/RELEASE_NOTES.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,18 @@
# Release Notes

## Cab Switchbox 5 — June 19, 2026

- Supports 16 configurable 12-24 VDC switch inputs.
- Ethernet and WiFi communication with the Rate Controller.
- Web-based setup, status, and troubleshooting pages.
- Board-mounted 12 V alarm buzzer with Off, Reduced, and Full settings.
- Rate Controller alarm packet support.
- Rev 01 terminal PCB documentation and production files.
- Updated manual for the Hammond E1555K2GY NEMA 4X enclosure.

### Important power note

The PCB inputs and electronics support 12-24 VDC. The installed buzzer is a
12 V component connected to input power, so buzzer operation requires a 12 V
board supply.

Loading