Skip to content

part-specs: I/O board SPEC.md update (drive-wheel R, connectors, battery, LiDAR)#31

Open
OsakaTX wants to merge 19 commits into
makerspet:mainfrom
OsakaTX:part-specs-io-board-spec-jul18-update
Open

part-specs: I/O board SPEC.md update (drive-wheel R, connectors, battery, LiDAR)#31
OsakaTX wants to merge 19 commits into
makerspet:mainfrom
OsakaTX:part-specs-io-board-spec-jul18-update

Conversation

@OsakaTX

@OsakaTX OsakaTX commented Jul 19, 2026

Copy link
Copy Markdown

Summary

Records the new verifiable facts added to the upstream makerspet/oomwoo-io-board docs/SPEC.md on 2026-07-18 (commits dba0d1c3, 75803b7e, 4e6c0134) that the OsakaTX part-specs compilation did not previously cover. All facts are quoted/paraphrased directly from that SPEC.md — no reverse-engineering.

What this adds

io-board-spec-jul18-update.md:

  • Drive-wheel coil resistance = 19 Ω (new electrical parameter; notes the Ohm's-law inconsistency vs the TODO check 3.5 A stall and offers plausible readings).
  • Roborock S5 Max wheel connector = JST ZH 1.5mm male 7p, with the manufacturer-side pinout, cross-checked against Scowt PR Drive wheel pinout Roborock S4/S5 #13 (agreements + a switch-polarity/Hall-function convention difference flagged).
  • 9 suction-fan SKUs with per-module connector types, incl. the BL24131607 ID FG SP - + PH2.0 pinout and the MSD-G-V1 Molex Micro-Fit 3.0.
  • Battery BRR-2P4S-5200 4-pin Micro-Fit 3.0 pinout, first recording of the 10.7 kΩ NTC thermistor and 0.62 MΩ ID resistor.
  • 4 alternative LiDAR modules on JST GH 1.25mm.
  • Cross-confirms 2× OV5647 CSI connectors on the I/O board (complements PR part-specs: obstacle-avoidance camera (OmniVision OV5647) #28).

Source verification

Every fact was checked verbatim against the current upstream oomwoo-io-board/docs/SPEC.md: 19 Ohm (drive-wheel row), the JST ZH 1.5mm male 7p wheel pinout and wheel-drop-switch ... orange/blue/brown hall ... MOT, MOT line, the [o66o] 4321 BAT+ 10.7K/NTC 0.62M/ID GND battery pinout, the 9 fan lines, the four JST GH 1.25mm LiDAR entries, and 2x 15-pin ArduCam-style connectors for OV5647 — all present. Distinguishes the original Roborock wheel connector from the OOMWOO board's own 5-pin ZH J12/J13 (separate file). Open items (J25/J26 map, per-pin LiDAR maps) marked. Single-file addition, based on current main.

OsakaTX added 19 commits July 5, 2026 23:03
…re), add verified calibrations

Corrects multiple factual errors in the initial part-specs README.md that
propagated to upstream main via PR makerspet#11:

ENCODER:
- 'quadrature' -> 'single-channel Hall-effect' (confirmed by Scowt PR makerspet#13
  physical inspection: exactly one encoder signal wire, blue)
- PPR updated from 'NOT FOUND' to ~228 PPR raw / ~911 ticks/rev post-4x
  edge counting (derived from VacuumTiger calibrated ticks_per_meter=4464.0)

GEARBOX:
- Updated from 'NOT FOUND' to ~190:1 (derived from VELOCITY_TO_DEVICE_UNITS
  = 523.0 and verified max 0.3 m/s, self-consistent with 911 ticks/rev)

MOTOR DRIVER IC:
- Added TMI8870 (TOLL Microelectronic, top mark T8870, ESOP8) - corrected
  from earlier TB8870 references

CONNECTORS:
- Added full 7-pin JST wheel module pinout with wire colors (Scowt PR makerspet#13)
- Documented J24/J27 as separate motor-power connectors (2-pin PH 2.0mm)
- J25/J26 signal groups per codetiger motherboard analysis

CASTER:
- Added Roomba caster (4624869) specs alongside Roborock caster (9.01.1272/1273)
- Both documented with dimensions, weight, mounting type

ODOMETRY:
- Added calibrated ticks_per_meter=4464.0, wheel_base=0.233m
- Added gyro scale CRL200S_GYRO_SCALE ≈ 0.000179 rad/s per raw unit
- Added encoder data format (u16 LE at offsets 0x10/0x18, 110 Hz)

New companion file: vacuumtiger-verified-specs.md with derivations.

Sources: codetiger/VacuumTiger source analysis (mock config.rs, commands.rs,
reader.rs, dhruva.toml, calibration.rs, encoder_sim.rs, wheel_odometry.rs),
Scowt PR makerspet#13 physical inspection, TMI8870 datasheet, Nidec catalog.
Review-pass fixes: correct the suction-fan count (10 rows / 9 distinct SKUs;
20N704R990F is listed at two voltages) to match the file's own table, and soften
'measured/authoritative' 19 Ohm to 'listed' since SPEC.md does not say it was measured.
@OsakaTX
OsakaTX force-pushed the part-specs-io-board-spec-jul18-update branch from aee9aac to fbf02df Compare July 19, 2026 21:34
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant