Skip to content

armgit / moss

Public Imported from GitHub
0

MOSS: a small, mostly 3D-printed litter-picking rover. Cleaner streets, one maker at a time.

Python

docs: add illustrated custom 3S4P battery tutorial (#14)

metr0xb44b2a64eff4
diff --git a/Assembly.md b/Assembly.md
index 39e279c..b0901a9 100644
--- a/Assembly.md
+++ b/Assembly.md
@@ -3,3 +3,5 @@
Each step lists the printed parts, components and fasteners to prepare, followed by assembly instructions and the available clip. Quantities are for one rover unless stated otherwise.
[Visual guide](https://www.showrobotics.ai/moss/build/#assembly) · [Step-by-step instructions](docs/build/ASSEMBLY.md) · [Spacer and shaft-collar references](docs/build/PART_REFERENCES.md)
+
+**Optional battery build:** [Custom 3S4P pack tutorial](hardware/power/custom-3s4p-battery/) — parts, photos, wiring, assembly and initial checks. Read its workshop disclaimer before starting; the larger pack's fit must be checked separately from the compact battery listed in the original BOM.
diff --git a/BOM.md b/BOM.md
index 391f64b..72f47c0 100644
--- a/BOM.md
+++ b/BOM.md
@@ -50,6 +50,8 @@ LK05/LK06/LK08 are guide identifiers for purchased shaft collars, also called lo
## Power and wiring — module-based rover
+**Optional custom battery:** [3S4P / twelve EVE 21700 cells — parts and illustrated build](hardware/power/custom-3s4p-battery/). Its rated capacity is 20 Ah and assembled mass is 910 g; usable capacity and runtime are not yet measured. The 110 × 67 × 35 mm dimensions below refer to the earlier compact pack, **not** this custom build. Choose one battery solution; do not add both to the shopping list.
+
| Item | Quantity | Note |
|---|---:|---|
| 12-cell battery pack, 3S4P, with BMS | 1 | 110 × 67 × 35 mm. |
diff --git a/README.md b/README.md
index b167ed5..cc61f94 100644
--- a/README.md
+++ b/README.md
@@ -40,6 +40,7 @@ I pick up litter by hand on my walks. MOSS is the robot I want next to me doing
## News
+- 28 October 2026: **[Build a custom 3S4P battery for MOSS](hardware/power/custom-3s4p-battery/)** — twelve EVE 21700 cells, illustrated assembly, wiring diagram and parts list. 20 Ah from the cell ratings, 910 g assembled; usable energy and collection runtime still to be measured.
- 27 October 2026: **[Orange Pi + MightyCam experiment](experiments/orange-pi-mightycam/)** — dimOS, YOLO on the NPU and a first memory/load test with simulated rover I/O. Code, cockpit image and the limits of this early bench demo.
- 27 October 2026: **[SO-101 dual-servo shoulder R2: complete upgrade guide](hardware/mechanical/dual-shoulder-r2/)** — editable CAD, two printable parts, screws, assembly, paired-servo setup and testing in one place.
- 24 October 2026: **BOM and print plates updated.** Hoco HB1 four-port hub, GameSir Nova 2 Lite controller, all 38 spacers on one plate, and one tensioner-slider reference (print four). [Updated package](https://github.com/metrox-eth/moss/releases/download/v0.6-r92/MOSS_R92_Mechanical_20261024.zip) · [Print plates](https://www.showrobotics.ai/moss/build/print-plates.html).
diff --git a/docs/build/README.md b/docs/build/README.md
index a519ece..3624007 100644
--- a/docs/build/README.md
+++ b/docs/build/README.md
@@ -7,3 +7,5 @@ Each step lists the printed parts, components and fasteners to prepare. Seven sh
[Grouped print list and quantities](printed_parts.csv) · [Original filename aliases](print_aliases.json). The current archive and both 3MF projects include the two Jetson retaining tabs.
[Ready-to-print 3MF projects](PRINT_PLATES.md) · [Complete package](https://github.com/metrox-eth/moss/releases/download/v0.6-r92/MOSS_R92_Mechanical_20261024.zip).
+
+[Custom 3S4P battery tutorial](../../hardware/power/custom-3s4p-battery/) — optional twelve-cell EVE 21700 build, with parts, wiring and workshop photos. Read the disclaimer and check fit before building this larger pack.
diff --git a/hardware/README.md b/hardware/README.md
index d6a1615..0ddf985 100644
--- a/hardware/README.md
+++ b/hardware/README.md
@@ -6,6 +6,10 @@ See the [print catalogue](../3DPrinting.md), [BOM](../BOM.md) and [assembly guid
`bench/` retains the raw bench traces. The 20 September INA219 trace is not a motor-current measurement.
+## Custom battery
+
+[3S4P battery build tutorial](power/custom-3s4p-battery/) — parts, photographs, wiring and assembly for the twelve-cell EVE 21700 pack, with a 15 A fuse and 14 AWG leads. Rated 20 Ah from the cell specifications; assembled mass 910 g. Actual capacity and collection runtime still need measuring. Read the workshop disclaimer before considering this build.
+
## Electronics prototypes
[MOSS Core V1D](electronics/moss-core-v1d/) is the current routed design review: editable KiCad files, schematics, BOM, connector guide and static review evidence. **Draft only: not approved for fabrication or assembly.** Rover fit and hardware validation remain pending.
diff --git a/hardware/power/custom-3s4p-battery/README.md b/hardware/power/custom-3s4p-battery/README.md
new file mode 100644
index 0000000..630c264
--- /dev/null
+++ b/hardware/power/custom-3s4p-battery/README.md
@@ -0,0 +1,202 @@
+# Building a custom battery for MOSS
+
+> [!WARNING]
+> **I'm not an engineer — this is a hobby project. Do not copy this build unless you have the skills and equipment to work safely with lithium-ion cells. They can catch fire and release dangerous gases. Work outdoors, in a dry area away from flammable materials, on a firebrick or another non-combustible surface. Wear appropriate eye protection and gloves, and use insulated tools.**
+
+MOSS, the litter-picking rover, needed a better battery. This is how I built a **3S4P pack from twelve EVE 21700 cells**, with a BMS, a 15 A fuse and 14 AWG power leads.
+
+The pack is assembled and fitted in the rover. Its **20 Ah rating comes from the cell specifications**; usable energy and collection runtime still need measuring. This guide records the workshop build, including the details still missing before someone can reproduce it exactly.
+
+![The custom blue battery fitted inside MOSS](images/07-installed-in-moss.jpg)
+
+**[Watch or download the 61-second workshop film](video/moss-battery-build.mp4)** — silent edition. **[Parts](#parts-for-one-pack) · [Assembly](#assembly) · [Wiring diagram](#4-wire-the-bms) · [Testing](#8-charge-and-test) · [Open measurements](#what-still-needs-measuring)**
+
+## Why I made one
+
+I tried several inexpensive packs before building this one. One was labelled **40,000 mAh**, weighed **420 g**, and cost me about **US$24**. In use, I got roughly **30 minutes**, and its voltage dropped quickly when the motors worked hard. I also found that charging did not take it above 12 V.
+
+My estimate is **4–5 Ah at the pack's 12 V-class voltage**, but I have not measured its discharge capacity. Weight, price and voltage alone do not prove capacity, and the charging ceiling can also depend on the charger, BMS and cell balance. These are my observations from that pack, not a test of every battery on the market.
+
+![The different packs tried for MOSS, with the custom pack on the right](images/08-packs-tried.jpg)
+
+## What this pack contains
+
+| Property | Value | Basis |
+|---|---|---|
+| Cells | 12 × EVE INR21700/50E, 5 Ah each | Ordered model; cells not independently capacity-tested |
+| Configuration | 3S4P | Three groups in series, four cells in parallel per group |
+| Rated capacity | 20 Ah | 4 × 5 Ah |
+| Nominal voltage | 10.95 V | 3 × 3.65 V |
+| Full-charge voltage | 12.6 V | 3 × 4.2 V |
+| Nominal energy | 219 Wh, approximately 220 Wh | 12 × 3.65 V × 5 Ah |
+| Usable-energy budget | Approximately 175–180 Wh | Assumed 80% of nominal energy; not measured |
+| Finished mass | 910 g | Workshop measurement |
+| Build cost | About US$65–70 | Reported cost; reusable tools not separately itemized |
+| Output fuse / main wires | 15 A / 14 AWG | Used for this build |
+| Collection-runtime target | 1.5–2 hours | Estimate; actual collection test pending |
+
+The cell voltage and capacity are from [EVE's 21700 50E specifications](https://www.evemall.eu/consumer-battery/cylindrical-ncm-cell/21700-50e). This is a **12 V-class battery with a varying output voltage**, not a regulated 12 V supply. Do not multiply 20 Ah by the full-charge voltage to describe its nominal energy.
+
+An approximately 180 Wh usable budget would support 1.5–2 hours only if average consumption is about 90–120 W. Track tension, terrain, computer load and arm use all matter; the new pack has not yet been compared with the old one under the same conditions.
+
+## Parts for one pack
+
+| Quantity | Part | Specification / selection note |
+|---:|---|---|
+| 12 | EVE INR21700/50E cells | Matched, genuine 21700 lithium-ion cells, rated 5 Ah |
+| 8 | Three-slot 21700 cell holders | 24 slots total, supporting both ends of the twelve cells |
+| 1 | 3S lithium-ion BMS | The pictured board is marked **3S40A**, 12.6 V, REV2.3, with common charge/discharge output. [Ordered board](https://www.lazada.co.th/products/i4970988029-s20928330051.html) |
+| As needed | Spot-welding strip | Alloy, width and thickness were not recorded; select interconnects for the actual current and welding equipment |
+| 1 set | Group-voltage wires | Connections for the four electrical nodes; small-wire gauge and lengths were not recorded |
+| 1 red + 1 black length | Main power wire | **14 AWG**, cut to the routing |
+| 1 | Inline fuse holder | DC-rated, suitable for the selected fuse and power wiring |
+| 1 | Fuse | **15 A**. The rover BOM uses ATC blade format; the format fitted to this pack was not separately recorded |
+| 1 matched set | Power connector | Match the rover harness and its current requirement; exact connector fitted to this pack not yet recorded |
+| 12 + barriers as needed | Positive-terminal insulating rings and battery-grade insulating sheet | Protect the positive rims, interconnects and underside of the BMS; coverage cannot all be verified from the photos |
+| As needed | Polyimide tape | Kapton tape was already available and used in this build |
+| 1 sleeve | Blue PVC battery heat-shrink | **120 mm flat width**, cut to length; check fit around the pack, BMS and insulation |
+| As needed | Small heat-shrink and strain relief | Cover wire joints and keep cable pull off the board pads |
+| 1 | 3S lithium-ion CC/CV charger | Ordered listing: **12.6 V, 5 A**. Confirm the actual plug, polarity and suitability for the assembled pack. [Charger listing](https://www.lazada.co.th/products/pdp-i4692319951-s19334045449.html) |
+| 1 arrangement | Pack restraint / protective mounting | Secure the pack inside the rover without squeezing it or rubbing through the sleeve |
+
+Two BMS boards were ordered, but **one is used per pack**. The other is a spare. The “40 A” printing is a board claim, not a verified continuous-current rating for the complete battery. The fuse, strips, wires, connectors and board must be considered together.
+
+The existing [rover BOM](../../../BOM.md#power-and-wiring--module-based-rover) lists XT30 connectors. That does not confirm the connector on this new battery. Do not assume a barrel charging connector is suitable for the full rover current.
+
+### Tools
+
+- A spot welder suitable for the chosen cells and strip. The photographed tool is an AIRREPAIR handheld kit.
+- A multimeter, wire cutters and strippers, insulated tools, eye protection and suitable gloves.
+- A soldering iron for **wires and board pads**, not for soldering directly onto cells.
+- A suitable heat source for the sleeve and a dry outdoor workspace with a firebrick or other non-combustible work surface.
+
+## Assembly
+
+### 1. Inspect the cells and lay out the holders
+
+Inspect each cell and wrapper. Do not use damaged cells. Measure and record the cell voltages, and use matched cells at closely matched states of charge before connecting them in parallel. Do not use the interconnect strips to equalize mismatched cells.
+
+Arrange the twelve cells as **two rows of six**. Four cells make each group: A, B and C. Each group occupies two columns. Eight three-slot holders support the two ends of the pack; these holders position the cells and do not make electrical connections.
+
+Dry-fit the assembly and its insulation in the intended battery space before welding. The finished dimensions of this custom pack are still to be recorded. The **110 × 67 × 35 mm** dimension in the older rover BOM refers to the earlier compact pack, not this one.
+
+### 2. Orient the groups and spot-weld the interconnects
+
+Use the [diagram below](#4-wire-the-bms) as the orientation reference. Looking at its **FRONT** view, both rows read:
+
+```text
+Group: A A B B C C
+Cell ends: + + − − + +
+Cell ends: + + − − + +
+```
+
+The **BACK** view is the opposite end of the same cells. Keep A on the left as drawn; flipping the pack top-to-bottom preserves that convention. Its signs are reversed:
+
+```text
+Group: A A B B C C
+Cell ends: − − + + − −
+Cell ends: − − + + − −
+```
+
+Fit the positive-end insulating rings and required barriers before working on the connections. Establish suitable weld settings on a representative test sample using the welder and cell guidance; settings depend on the strip and tool, so none are prescribed here. Spot-weld the interconnects without bridging adjacent electrical nodes. Keep unused conductive areas covered while working.
+
+The four electrical nodes are:
+
+- **0:** group A negative.
+- **1:** group A positive joined to group B negative.
+- **2:** group B positive joined to group C negative.
+- **3:** group C positive.
+
+![The actual interconnects after spot welding, before final insulation](images/01-cell-interconnects.jpg)
+
+*Workshop photo of one end after welding. Use the node diagram for electrical connections; the photographs show intermediate, partly uninsulated stages.*
+
+### 3. Check the group voltages
+
+Before connecting the BMS, measure adjacent nodes: **0→1**, **1→2**, and **2→3**. Each should show the voltage of one parallel group, with the expected positive polarity and closely matched readings. Then measure the cumulative voltages from node 0 to nodes 1, 2 and 3.
+
+The BMS markings **4.2 V, 8.4 V and 12.6 V are full-charge values**. Partly charged cells should read lower. A reversed reading or an unexpected group voltage needs resolving before connecting the board.
+
+### 4. Wire the BMS
+
+![Landscape diagram showing the two ends of the same 12 cells and the six pads of the pictured BMS](images/wiring-3s4p.jpg)
+
+**This diagram is specific to the photographed board.** Match the markings on the actual board and obtain its supplier's connection sequence. The table is a node mapping, not a universal connection order for every BMS.
+
+| Pack connection | Marking on this BMS | Meaning |
+|---|---|---|
+| Node 0 | 0V | Group A negative / battery negative |
+| Node 1 | 4.2V | Junction between groups A and B |
+| Node 2 | 8.4V | Junction between groups B and C |
+| Node 3 | 12.6V | Group C positive / battery positive |
+| Protected positive output | + | Positive lead, through the 15 A fuse |
+| Protected negative output | − | Negative lead for the rover and compatible charger |
+
+**Cell negative (0V / B−) and protected output negative (P−) are different connections. Do not bridge them and bypass the BMS.** The photographed board has common charge/discharge output pads; other boards may differ.
+
+Position the BMS on an appropriate insulating barrier so its underside cannot contact cell cans or strips. Route group wires clear of sharp edges and support them so they cannot pull on the pads.
+
+![Component side and reverse side of the BMS used for this build](images/02-bms-board.jpg)
+
+![The BMS wired to the pack, with loose output leads before final insulation and connector installation](images/03-bms-wiring.jpg)
+
+### 5. Add the fuse and output connection
+
+Use the **14 AWG** main leads and install the **15 A fuse in the positive output**, close to the pack, protecting the cable run. Insulate and secure the unfused section too. Fit a keyed connector that matches the rover harness and is rated for the current. Confirm polarity with a meter before connecting anything.
+
+The charger listing says 12.6 V / 5 A, but its plug dimensions and polarity still need recording. Mechanical fit alone does not establish electrical compatibility. Keep charging and rover-current connector ratings separate when selecting the harness.
+
+### 6. Insulate and wrap
+
+Cover exposed interconnects, wire joints and board contacts with suitable insulation. Keep a mechanically protective insulating barrier between the BMS and the cells; thin tape alone is not a substitute where an edge can rub or puncture it.
+
+![The ends covered with insulation before adding the outer sleeve](images/04-insulation.jpg)
+
+Fit the PVC sleeve over the assembly. The ordered **120 mm flat width** corresponds to about 240 mm circumference before shrinking. Check the actual fit, including the BMS and insulation. Use controlled heat according to the sleeve instructions and avoid prolonged heating of the cells.
+
+The end openings must remain electrically protected. Provide strain relief for the leads. The photos document the build; they do not establish that every underlying insulation layer has been checked.
+
+![The custom pack in its blue outer sleeve](images/05-finished-pack.jpg)
+
+![End detail showing the sleeve opening and the underlying insulation](images/06-pack-end.jpg)
+
+### 7. Secure it inside MOSS
+
+Restrain the battery so it cannot slide into electronics or moving parts. Keep cables clear of sharp edges, fan openings and the cover. Do not use the output wires as a restraint or compress the cells to make the pack fit.
+
+The assembled pack weighs **910 g**. Check cover clearance and record the finished dimensions for your build before making a carrier. Keep the rover's existing fuse, switching and emergency-stop arrangement functional.
+
+### 8. Charge and test
+
+Use a compatible **3S lithium-ion CC/CV charger with a 12.6 V endpoint**. Confirm the allowed charging current for the complete pack, not just the individual cells. Attend the first charge in the same dry outdoor, non-combustible workspace, checking group voltages and abnormal heating; do not continue charging an abnormal pack.
+
+For the first rover test, support the rover so the tracks can move clear of the work surface, and keep a way to stop it immediately. Check operation at low load before a normal collection run.
+
+Measure delivered **Wh and Ah**, voltage under load, runtime and the operating conditions with a suitable logger. An instantaneous voltage reading is not a capacity measurement. Respect the battery and rover operating limits; do not bypass the BMS or discharge until the computer crashes to extend a runtime result.
+
+## What still needs measuring
+
+The **1.5–2 hour collection target is not a demonstrated result**. The pack's next useful test is a real MOSS run with the load and terrain recorded.
+
+| Record | Current status |
+|---|---|
+| Finished mass | 910 g |
+| Final external dimensions and retaining method | Not recorded |
+| Installed power/charge connectors and polarity | Exact references not recorded |
+| Strip material, width, thickness; small-wire gauge | Not recorded |
+| Insulation coverage, strain relief and BMS thermal behavior | Full verification not recorded |
+| Starting / ending voltage of each series group | Test pending |
+| Delivered Wh and Ah | Test pending |
+| Average and peak current, voltage sag, temperatures | Test pending |
+| Runtime, terrain, track tension, computer and arm duty | Collection test pending |
+
+## Sources and media
+
+- [EVE 21700 50E manufacturer specifications](https://www.evemall.eu/consumer-battery/cylindrical-ncm-cell/21700-50e).
+- [Ordered BMS listing](https://www.lazada.co.th/products/i4970988029-s20928330051.html) and [charger listing](https://www.lazada.co.th/products/pdp-i4692319951-s19334045449.html). Listing titles identify the items; they are not independent electrical test results.
+- Laurent's order screenshots, workshop photos and observations, October 2026.
+- [Battery and charging safety — Fire and Rescue NSW](https://www.fire.nsw.gov.au/fire-safety/home-fire-safety/battery-and-charging-safety).
+
+Photos © 2026 Laurent Genoud / SHOW ROBOTICS. Wiring illustration generated with imagegen and checked against the supplied drawing and BMS photo. Images are resized exports of the originals, with camera metadata removed. The video is the silent edition of the workshop film. Documentation and media follow the repository's [CC BY 4.0 notice](../../../NOTICE).
+
+[Back to hardware](../../README.md) · [Rover BOM](../../../BOM.md) · [MOSS assembly guide](../../../Assembly.md)
diff --git a/hardware/power/custom-3s4p-battery/images/01-cell-interconnects.jpg b/hardware/power/custom-3s4p-battery/images/01-cell-interconnects.jpg
new file mode 100644
index 0000000..055cb30
Binary files /dev/null and b/hardware/power/custom-3s4p-battery/images/01-cell-interconnects.jpg differ
diff --git a/hardware/power/custom-3s4p-battery/images/02-bms-board.jpg b/hardware/power/custom-3s4p-battery/images/02-bms-board.jpg
new file mode 100644
index 0000000..2f64b12
Binary files /dev/null and b/hardware/power/custom-3s4p-battery/images/02-bms-board.jpg differ
diff --git a/hardware/power/custom-3s4p-battery/images/03-bms-wiring.jpg b/hardware/power/custom-3s4p-battery/images/03-bms-wiring.jpg
new file mode 100644
index 0000000..0bdd488
Binary files /dev/null and b/hardware/power/custom-3s4p-battery/images/03-bms-wiring.jpg differ
diff --git a/hardware/power/custom-3s4p-battery/images/04-insulation.jpg b/hardware/power/custom-3s4p-battery/images/04-insulation.jpg
new file mode 100644
index 0000000..c7b54af
Binary files /dev/null and b/hardware/power/custom-3s4p-battery/images/04-insulation.jpg differ
diff --git a/hardware/power/custom-3s4p-battery/images/05-finished-pack.jpg b/hardware/power/custom-3s4p-battery/images/05-finished-pack.jpg
new file mode 100644
index 0000000..feb94fe
Binary files /dev/null and b/hardware/power/custom-3s4p-battery/images/05-finished-pack.jpg differ
diff --git a/hardware/power/custom-3s4p-battery/images/06-pack-end.jpg b/hardware/power/custom-3s4p-battery/images/06-pack-end.jpg
new file mode 100644
index 0000000..98f4118
Binary files /dev/null and b/hardware/power/custom-3s4p-battery/images/06-pack-end.jpg differ
diff --git a/hardware/power/custom-3s4p-battery/images/07-installed-in-moss.jpg b/hardware/power/custom-3s4p-battery/images/07-installed-in-moss.jpg
new file mode 100644
index 0000000..f20a292
Binary files /dev/null and b/hardware/power/custom-3s4p-battery/images/07-installed-in-moss.jpg differ
diff --git a/hardware/power/custom-3s4p-battery/images/08-packs-tried.jpg b/hardware/power/custom-3s4p-battery/images/08-packs-tried.jpg
new file mode 100644
index 0000000..7149607
Binary files /dev/null and b/hardware/power/custom-3s4p-battery/images/08-packs-tried.jpg differ
diff --git a/hardware/power/custom-3s4p-battery/images/wiring-3s4p.jpg b/hardware/power/custom-3s4p-battery/images/wiring-3s4p.jpg
new file mode 100644
index 0000000..0b80a76
Binary files /dev/null and b/hardware/power/custom-3s4p-battery/images/wiring-3s4p.jpg differ
diff --git a/hardware/power/custom-3s4p-battery/video/moss-battery-build.mp4 b/hardware/power/custom-3s4p-battery/video/moss-battery-build.mp4
new file mode 100644
index 0000000..73fa67c
Binary files /dev/null and b/hardware/power/custom-3s4p-battery/video/moss-battery-build.mp4 differ