trackedbot

Hardware Architecture - tracked_bot

Comprehensive engineering documentation for the electrical hardware, controller boards, power distribution, and signal routing of the tracked_bot autonomous tracked robot platform.

📋 Table of Contents

System Architecture Overview
Hardware Stack & Core Boards
Master Unified Pinout & Interconnect Matrix
Hardware Documentation Sitemap
Component Datasheets Directory
Hardware Media & Images

🚀 System Architecture Overview

The tracked_bot platform implements a modular computing architecture using the standard Arduino Uno R3 mechanical and electrical footprint:

flowchart TD
    CLIENT["<b>Host Controller / Client</b><br/>PC / Raspberry Pi / ROS Node"]

    subgraph MainBoard ["<b>Main Controller Board: Arduino Uno R3</b>"]
        direction TB

        subgraph CommBridge ["USB-to-UART Serial Interface"]
            USB_UART["<b>USB-to-UART Bridge</b><br/>ATmega16U2 / CH340G"]
        end

        ATMEGA["<b>ATmega328P MCU Core</b><br/>Primary Real-Time Motion Engine (16 MHz)"]

        USB_UART <-->|"Hardware USART0 (D0/RX, D1/TX)"| ATMEGA
    end

    subgraph Shield ["<b>Motor Driver Shield: L293D</b>"]
        direction TB
        SHIFT["<b>74HC595</b><br/>8-Bit Shift Register<br/>Direction Demux Q0..Q7"]
        IC1["<b>L293D IC1</b><br/>Dual H-Bridge Driver<br/>Right Track M1"]
        IC2["<b>L293D IC2</b><br/>Dual H-Bridge Driver<br/>Left Track M3"]

        SHIFT ==>|"Direction Control Bits"| IC1
        SHIFT ==>|"Direction Control Bits"| IC2
    end

    subgraph Chassis ["<b>Locomotion Platform: T101 Aluminum Chassis</b>"]
        MOTOR_R["<b>Right Track DC Gearmotor</b><br/>Channel M1"]
        MOTOR_L["<b>Left Track DC Gearmotor</b><br/>Channel M3"]
        TRACKS["<b>Modular Caterpillar Tracks</b><br/>POM Interlocking Links"]

        MOTOR_R --> TRACKS
        MOTOR_L --> TRACKS
    end

    CLIENT ==>|"Serial UART (115200 Baud 8-N-1)"| USB_UART

    ATMEGA -->|"Fast PWM (D6/OC0A Left, D11/OC2A Right)"| IC2 & IC1
    ATMEGA -->|"74HC595 Shift Bus (D4, D7, D8, D12)"| SHIFT
    ATMEGA -.->|"Sensors & ADC Bus (A0..A5, D2/INT0)"| Shield

    IC1 ==>|"PWM Drive (M1)"| MOTOR_R
    IC2 ==>|"PWM Drive (M3)"| MOTOR_L

    classDef clientStyle fill:#0f766e,stroke:#14b8a6,stroke-width:2px,color:#ffffff;
    classDef commStyle fill:#312e81,stroke:#818cf8,stroke-width:2px,color:#ffffff;
    classDef mcuStyle fill:#0c4a6e,stroke:#38bdf8,stroke-width:2px,color:#ffffff;
    classDef driverStyle fill:#831843,stroke:#f472b6,stroke-width:2px,color:#ffffff;
    classDef motorStyle fill:#701a75,stroke:#e879f9,stroke-width:2px,color:#ffffff;

    class CLIENT clientStyle;
    class USB_UART commStyle;
    class ATMEGA mcuStyle;
    class SHIFT,IC1,IC2 driverStyle;
    class MOTOR_R,MOTOR_L,TRACKS motorStyle;

    style MainBoard fill:none,stroke:#38bdf8,stroke-width:2px,stroke-dasharray: 4 4
    style CommBridge fill:none,stroke:#818cf8,stroke-width:1px
    style Shield fill:none,stroke:#f472b6,stroke-width:2px,stroke-dasharray: 4 4
    style Chassis fill:none,stroke:#e879f9,stroke-width:2px,stroke-dasharray: 4 4

🧩 Hardware Stack & Core Boards

Layer	Component	Hardware Model	Function & Role	Detailed Guide
Main Board	Microcontroller Board	Arduino Uno R3 (ATmega328P)	Standard Arduino Uno R3 board with ATmega328P (16 MHz) for real-time motion control and hardware USART0.	main_board.md
Motor Driver	Dual Quadruple Half-H Shield	L293D Motor Shield	2x L293D H-bridges (up to 4 DC motors / 2 steppers) + 74HC595 shift register direction multiplexer.	motor_shield.md
Power Distribution	Dual-Supply Rail Architecture	`EXT_PWR` & USB Rail	Isolated motor power rail (2S Li-Ion 7.4V–8.4V) and clean MCU logic power (5V USB/power bank).	power_supply.md
Locomotion	Tracked Robot Chassis	T101 Platform	Aluminum alloy chassis with suspension wheels, rubber tracks, and dual high-torque DC gearmotors.	body/README.md & body_platform.png
Peripherals	Sensors & Telemetry	HC-SR04, MPU-6050, ADC	Ultrasonic obstacle detection, 6-axis IMU gyro/accelerometer on I2C, and battery voltage divider on A0.	main_board.md

📌 Master Unified Pinout & Interconnect Matrix

This master matrix consolidates all physical signal mappings between the ATmega328P microcontroller and the L293D Motor Driver Shield:

1. Digital I/O Pins (D0 - D13)

Arduino Pin	AVR Port	AVR Hardware Function	L293D Shield Interconnect	`tracked_bot` Dedicated Purpose
D0	`PD0`	`RXD` (USART0 Receiver)	Not connected	Serial In: Receives binary commands from Host via UART (115200 8-N-1)
D1	`PD1`	`TXD` (USART0 Transmitter)	Not connected	Serial Out: Transmits telemetry packets to Host via UART (115200 8-N-1)
D2	`PD2`	`INT0` (External Interrupt 0)	Not connected	FREE GPIO: Low-latency sensor interrupt or wheel encoder
D3	`PD3`	`OC2B` (Timer2 Output Compare B)	Motor 2 Speed PWM (`PWM2B`)	Reserved for Auxiliary Motor 2
D4	`PD4`	`XCK` / `T0` (General I/O)	74HC595 Shift Clock (`DIR_CLK`)	Shift Register Clock: Clocks direction bits into 74HC595
D5	`PD5`	`OC0B` (Timer0 Output Compare B)	Motor 4 Speed PWM (`PWM0B`)	Reserved for Auxiliary Motor 4
D6	`PD6`	`OC0A` (Timer0 Output Compare A)	Motor 3 Speed PWM (`PWM0A`)	Left Track Speed PWM: Timer0 Fast PWM (0–255)
D7	`PD7`	`AIN1` (General I/O)	74HC595 Output Enable (`DIR_EN`)	Shift Register Output Enable: Active-low output driver
D8	`PB0`	`ICP1` / `CLKO` (General I/O)	74HC595 Serial Data (`DIR_SER`)	Shift Register Serial Data: Serial bit-stream input
D9	`PB1`	`OC1A` (Timer1 Output Compare A)	Servo 2 PWM (`PWM1A`)	Reserved for Pan-Tilt Servo 2
D10	`PB2`	`OC1B` (Timer1 Output Compare B)	Servo 1 PWM (`PWM1B`)	Reserved for Pan-Tilt Servo 1
D11	`PB3`	`OC2A` / `MOSI`	Motor 1 Speed PWM (`PWM2A`)	Right Track Speed PWM: Timer2 Fast PWM (0–255)
D12	`PB4`	`MISO` (General I/O)	74HC595 Latch Clock (`DIR_LATCH`)	Shift Register Latch: Latches internal buffer to outputs
D13	`PB5`	`SCK` (Onboard LED)	Not connected (Arduino LED)	FREE GPIO: Built-in LED / SPI SCK clock

2. Analog Input & I2C Pins (A0 - A5 / D14 - D19)

All analog pins pass directly through the L293D shield to the top breakout pads without electrical interference:

Arduino Pin	AVR Port	Secondary Hardware Function	System Role in `tracked_bot`
A0	`PC0`	`ADC0` / `PCINT8`	Battery Voltage Sense: 4:1 resistor voltage divider to monitor 2S battery pack
A1	`PC1`	`ADC1` / `PCINT9`	Ultrasonic Sensor (HC-SR04): Trigger output pulse pin
A2	`PC2`	`ADC2` / `PCINT10`	Ultrasonic Sensor (HC-SR04): Echo input pulse measurement pin
A3	`PC3`	`ADC3` / `PCINT11`	Auxiliary GPIO / Analog Input (free for infrared or bumper switches)
A4	`PC4`	`ADC4` / `SDA` (I2C Data)	I2C Bus SDA: Connected to MPU-6050 6-DOF IMU gyroscope/accelerometer
A5	`PC5`	`ADC5` / `SCL` (I2C Clock)	I2C Bus SCL: Connected to MPU-6050 6-DOF IMU gyroscope/accelerometer

3. Power Supply and Ground Terminals

Terminal / Pin	Rail Voltage	Source / Destination	Functional Role
`EXT_PWR (+)`	4.5 V – 24 V DC	External Motor Battery (2S Li-Ion / 7.4V)	Powers L293D IC1 & IC2 H-bridge motor drive stages
`EXT_PWR (GND)`	0 V (GND)	Battery Negative Lead	Common ground return for motor current loop
`5V` (Header)	5.0 V DC	Arduino 5V Regulator / USB bus	Powers ATmega328P logic, 74HC595, and servo headers
`3V3` (Header)	3.3 V DC	Onboard 3.3V LDO Regulator	Auxiliary 3.3V supply for external low-voltage sensors
`GND` (Headers)	0 V (GND)	Shared System Ground Plane	Common reference for all logic, sensors, and peripherals
`VIN` (Header)	7.0 V – 12 V DC	Connected to DC Barrel Jack / `EXT_PWR`	Sourced via DC jack; connected to motor rail when `PWR` jumper is ON

📖 Hardware Documentation Sitemap

main_board.md: Complete specifications for the Arduino Uno R3, ATmega328P architecture, pinout, serial UART interface, and firmware flashing workflows.
motor_shield.md: L293D driver architecture, 74HC595 shift register bit definitions, Timer0 Fast PWM speed control, and DC/stepper/servo connection guides.
power_supply.md: Power distribution topology, battery chemistry selection, current budgets, inrush spike management, decoupling, and brownout protection.

📂 Component Datasheets Directory

The datasheets/ directory contains original manufacturer engineering documentation:

Integrated Circuit	Datasheet Link	Key Features & Focus
Microchip ATmega328P	atmega328p.pdf	8-bit AVR RISC microcontroller, Timer0/Timer1/Timer2 registers, USART0 hardware.
WCH CH340G	ch340.pdf	USB to Serial UART bridge controller and driver specifications.
TI / ST L293 / L293D	l293.pdf	Quadruple high-current half-H drivers, internal flyback clamping diodes, thermal limits.
TI SN74HCS595-Q1	sn74hcs595-q1.pdf	8-bit serial-in parallel-out shift register with output latches and Schmitt-trigger inputs.

🖼️ Hardware Media & Images

The images/ directory contains board layout and pinout diagrams:

Motor Driver Shield Assembly: images/motor_driver_shield.png
Motor Driver Shield Pinout Diagram: images/motor_driver_shield_pinout.png
Mechanical Chassis & Track Assembly: body_platform.png

This site is open source. Improve this page.