# K2Aley GAR-BOT Updated

Copyright (c) 2026 K2Aley. GAR-BOT. All rights reserved.

This direct-open package contains the current GAR-BOT connection map, BOM,
two-claw layout, water-resistance plan, and 3D print queue.

## Open These First

| File | Purpose |
| --- | --- |
| `GAR-BOT_CONNECTIONS.md` | Wiring and connection map. |
| `GAR-BOT_USER_MANUAL.html` | Photo user manual with assembly instructions. |
| `GAR-BOT_BOM.html` | Visual bill of materials with hardware and printed parts. |
| `docs/GAR-BOT_ASSEMBLY_INSTRUCTIONS.md` | Printable assembly instructions and PASS checklist. |
| `GAR-BOT_BOM.md` | Bill of materials. |
| `GAR-BOT_TWO_CLAW_LAYOUT.md` | Left/right two-claw layout. |
| `GAR-BOT_PRINT_QUEUE.md` | 3D print queue. |
| `GAR-BOT_WATER_RESISTANCE.md` | Water-resistant build rules. |
| `GAR-BOT_RP5_AI_AGENT.md` | Raspberry Pi 5 local AI agent overview. |
| `GAR-BOT_REMOTE_TRANSMITTER.md` | RP Zero 2 W + Pico Voice remote transmitter plan. |
| `docs/PROJECT_INTEGRITY_REPORT.md` | Latest integrity audit and verification results. |
| `docs/GAR-BOT_PART_ACCURACY_REPORT.md` | Measured STL dimensions and accuracy definition. |
| `docs/K2ALEY_DNS_RECOVERY.md` | K2Aley.com DNS restore plan for Mac mini hosting. |
| `rp5_ai_agent/README.md` | Install and run the local AI agent. |
| `remote_control/README.md` | Remote transmitter starter files. |
| `3d_print_parts/stl_exports/` | Generated starter STL files for slicing. |
| `3d_print_parts/STL_MESH_INTEGRITY_AUDIT.md` | Per-part mesh integrity audit for all STL files. |
| `COPYRIGHT.md` | K2Aley GAR-BOT copyright notice. |

## Current Hardware

- Raspberry Pi 5
- RP5 relay HAT
- Pico Voice board / voice hardware on RP5 40-pin header
- 7 inch USB touchscreen
- 4x direct-drive 24V / 500 rpm XD-60GA775-style wheel motors
- 4x IBT-2 / BTS7960 motor drivers
- 24V-to-5V / 5A buck converter
- 2x front claws: `Claw Left 1` and `Claw Right 2`
- 2x Keyestudio PLUS-style claw servo boards
- DX-LR30 / SX1262 LoRa module
- Remote transmitter: Raspberry Pi Zero 2 W + Pico Voice board
- Arduino Pro Mini removed from transmitter design

## Network Plan

Both Raspberry Pi boards have Wi-Fi:

- Raspberry Pi 5 Wi-Fi is used for setup, SSH, touchscreen/API access, and
  local network maintenance.
- Raspberry Pi Zero 2 W Wi-Fi is used for transmitter setup, SSH, Picovoice
  testing, and short-range LAN command testing.

LoRa remains the active long-range control/status radio path. Wi-Fi is useful
for setup and bench testing, but it should not be the only control path for
field operation.

## Drive System

GAR-BOT uses four independent direct-drive wheel motors. Each 24V gear motor
drives one wheel through its own IBT-2 / BTS7960 motor driver. Chain, sprockets,
and exposed belt reductions are removed from the active water-resistant build;
use the printed motor splash shields and covered wiring routes instead.

## Connect Rule

Power and motor current stay on the fused 24V side. Raspberry Pi, radios,
touchscreen, relay logic, and claw logic stay on regulated 5V/3.3V supplies.
All logic grounds meet at one common ground point.

No electronics may be exposed during wet use.

RP5 USB plan uses the four built-in ports for left claw, right claw,
touchscreen, and LoRa/radio USB bridge or hub. Pico Voice is on the 40-pin
header, and FT232RL USB-TTL is removed from the active USB plan.

## One-Command LoRa PASS Verification

From the Windows project workspace, run:

```powershell
.\scripts\verify_garbot_lora_pass.ps1
```

Optional override example:

```powershell
.\scripts\verify_garbot_lora_pass.ps1 -Rp5Host 192.168.0.226 -Rp5User gar-bot -RpZeroHost 192.168.0.161 -RpZeroUser aleyrec
```

The script checks:

- RP5 config, LoRa serial path, service status, and HTTP API response.
- RP Zero 2 W config and LoRa serial write path.
- End-to-end control delivery visibility by validating RP5 `last_command`.

Default mode reports PASS when control reaches RP5 by either:

- direct LoRa transport, or
- RP Zero fallback HTTP transport (for temporary non-LoRa operation).

To make LoRa mandatory, add `-RequireLoRaTransport`.

## One-Command K2Aley DNS Check

From the Windows project workspace, run:

```powershell
.\outputs\GAR-BOT_Updated\scripts\verify_k2aley_dns.ps1
```

PASS means `k2aley.com` and `www.k2aley.com` resolve toward the current home
WAN IP for Mac mini hosting.
