From: Erik Andresen Date: Fri, 11 Sep 2026 11:50:29 +0000 (+0200) Subject: Added some documentation X-Git-Url: https://defiant.homedns.org/gitweb/?a=commitdiff_plain;h=d3b95663c92a153bf19571a42faf9a8a2636539a;p=a4wd3.git Added some documentation a4wd3_components.svg generated by hermes/Qwen3.8-27B --- diff --git a/docs/a4wd3_components.svg b/docs/a4wd3_components.svg new file mode 100644 index 0000000..693b8f6 --- /dev/null +++ b/docs/a4wd3_components.svg @@ -0,0 +1,230 @@ + + + + + + + + + + A4WD3 ROBOT — COMPONENTS & CONNECTIONS + + + + CHASSIS (top-down) · display on the front border · F1 protects the 12 V bus · lower/aft line (right): POWER IN / POWER OUT / I2C + + + FL (M4) + FR (M2) + RL (M3) + RR (M1) + + + USB-3 + USB-C + + POWER OUT + POWER IN + 12 V (off-robot) + I2C + + + + Wi-Fi ×2 + + + + + LiDAR + GPS + A2M12 + u-blox + optional (detached) + via USB-3 port + + + + + + 12 V + + + + display + 128×64 panel + front borderline + + + + BANANA PI M7 + SBC — Rockchip RK3588 + RK3588 SoC / quad A76 + quad A55 + Wi-Fi: onboard radio + + + + AVR MCU + I2C 0x50 (odometry 0x38) + 4× H-bridge → M1..M4 + PID + manual mode (per motor) + + + + BME680 + I2C 0x77 + temp / RH / pressure + + + MAX44009 + I2C 0x94 + illuminance + + + INA260 + I2C 0x80 + current sense (~7 W) + + + LED stripe + I2C 0x62 + 10-LED RGBWW + CW + + + BNO085 IMU + UART /dev/ttyS2 + orientation / nav + + + + + LM74500 + ideal diode + + + + LTC4010 + battery charger + + + + NiMH battery + 9.6 V · 4.5 Ah + + + + LM74500 + ideal diode + + + + BUS + + + + LM2940 + 5 V regulator + F2 + + 5V RAIL + + + + USB-PD + power delivery + + + + + + + + PCA9517 + 3.3V ⇆ 5V + + + + + + + + 3.3V + 5V + + + + + + + + + + + 5 V rail + + + + + + + + F1 + + + 12 V → motors + LED light + + + + UART /dev/ttyS2 + + + + UDP :5004 + + + + + + + + + + + + + + + + + F3 + + + + + + + + LEGEND + I2C bus 7 + power (12 V / 5 V) + UART + USB / UDP (data) + compute (RK3588) + drive (AVR) + sensors / display + power + optional / external + diff --git a/docs/i2c_sal8_cable_wireviz.bom.tsv b/docs/i2c_sal8_cable_wireviz.bom.tsv new file mode 100644 index 0000000..1fba175 --- /dev/null +++ b/docs/i2c_sal8_cable_wireviz.bom.tsv @@ -0,0 +1,6 @@ +Id Description Qty Unit Designators +1 Connector, SAL M8, male, 4 pins 1 X1 +2 Wire, 0.14 mm², BK 0 m W1 +3 Wire, 0.14 mm², BN 0 m W1 +4 Wire, 0.14 mm², BU 0 m W1 +5 Wire, 0.14 mm², WH 0 m W1 diff --git a/docs/i2c_sal8_cable_wireviz.html b/docs/i2c_sal8_cable_wireviz.html new file mode 100644 index 0000000..c13ff52 --- /dev/null +++ b/docs/i2c_sal8_cable_wireviz.html @@ -0,0 +1,190 @@ + + + + + i2c_sal8_cable_wireviz + + +

i2c_sal8_cable_wireviz

+

Diagram

+ +
+ +
+ +
+ + + + + +%3 + + + +X1 + + +X1 + +SAL M8 + +male + +4-pin + +SCL + +1 + +GND + +2 + +SDA + +3 + +5V + +4 + + + +W1 + + +W1 + +4x + +0.14 mm² +  +X1:1:SCL +     BN     + + + +X1:2:GND +     WH     + + + +X1:3:SDA +     BU     + + + +X1:4:5V +     BK     + + + +  + + + +X1:e--W1:w + + + + + + +X1:e--W1:w + + + + + + +X1:e--W1:w + + + + + + +X1:e--W1:w + + + + + + + +
+ +
+ +
+ +

Bill of Materials

+ +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
IdDescriptionQtyUnitDesignators
1Connector, SAL M8, male, 4 pins1X1
2Wire, 0.14 mm², BK0mW1
3Wire, 0.14 mm², BN0mW1
4Wire, 0.14 mm², BU0mW1
5Wire, 0.14 mm², WH0mW1
+ +
+ + diff --git a/docs/i2c_sal8_cable_wireviz.png b/docs/i2c_sal8_cable_wireviz.png new file mode 100644 index 0000000..91c4306 Binary files /dev/null and b/docs/i2c_sal8_cable_wireviz.png differ diff --git a/docs/i2c_sal8_cable_wireviz.svg b/docs/i2c_sal8_cable_wireviz.svg new file mode 100644 index 0000000..d48294b --- /dev/null +++ b/docs/i2c_sal8_cable_wireviz.svg @@ -0,0 +1,103 @@ + + + + + + +%3 + + + +X1 + + +X1 + +SAL M8 + +male + +4-pin + +SCL + +1 + +GND + +2 + +SDA + +3 + +5V + +4 + + + +W1 + + +W1 + +4x + +0.14 mm² +  +X1:1:SCL +     BN     + + + +X1:2:GND +     WH     + + + +X1:3:SDA +     BU     + + + +X1:4:5V +     BK     + + + +  + + + +X1:e--W1:w + + + + + + +X1:e--W1:w + + + + + + +X1:e--W1:w + + + + + + +X1:e--W1:w + + + + + + diff --git a/docs/i2c_sal8_cable_wireviz.yml b/docs/i2c_sal8_cable_wireviz.yml new file mode 100644 index 0000000..a5804df --- /dev/null +++ b/docs/i2c_sal8_cable_wireviz.yml @@ -0,0 +1,16 @@ +connectors: + X1: + type: SAL M8 + subtype: male + pinlabels: [SCL, GND, SDA, 5V] + +cables: + W1: + category: bundle + gauge: 0.14 mm2 + colors: [BN, WH, BU, BK] + +connections: + - + - X1: [1,2,3,4] + - W1: [1,2,3,4]