docs(parts): fill the gaps a build order exposed - #251
Conversation
|
Added one more row to the Optional Enclosure Inclinometer table: a Mouser-stocked Qwiic-to-Dupont cable, so the whole optional inclinometer can be ordered from the shared Mouser project instead of splitting the order with Amazon.
This is the female-socket counterpart of Adafruit 4209 (the male-header version). Female is the correct end here: the Pi GPIO header is male pins, so the sockets push straight on. On "shortest": 150 mm is the only length Adafruit produces in this JST-SH-to-female-socket configuration. The shorter 50 mm and 100 mm Qwiic cables are Qwiic-to-Qwiic and have no Dupont end at all, so there is nothing shorter to pick. The Amazon multi-cable kit stays listed and still carries the "used in the validated build" note — this row is the single-cable alternative, not a replacement, so the $16 optional-inclinometer cost line is unchanged. Verification caveat, same as the SC1148 row: Mouser serves a bot wall to scripted requests, so the 4397 product page was confirmed to exist and be indexed under that URL but its stock and price were not machine-read. Worth one human click before merge. |
|
Named the jumper wires. Three rows previously said
Why female/female for the trigger wiring: the Pi GPIO header, the OPS243 J3 header, and headers soldered onto the SEN-14262 are all male pins, so both ends have to be female. The IWR6843 Why female/male as well: these are pin extensions — the female end goes onto a Pi GPIO pin and the male end re-presents that pin for a second connector. That is what keeps the 5V rail reachable for the OPS243 when the Touch Display 2 is also wired to the header, instead of one connector covering the whole rail. On "shortest": 75 mm is the floor in both genders. Adafruit's jumper line starts at 75 mm (the longer options are 150 mm and 300 mm), and no other brand Mouser stocks goes below it — SparkFun's shortest premium jumpers are 4″/100 mm, and Pololu, who do make 1″ and 2″, is not a Mouser line. Cost summary
+$2 for the F/M ribbon, carried through subtotal and total. The F/F wires were already priced into the existing $5 sound-trigger line, so they do not move anything. Verification caveat, same as the SC1148 and 4397 rows: Mouser bot-walls scripted requests, so both product pages were confirmed to exist and be indexed under those URLs and part numbers, but live stock and price were not machine-read. Worth a human click before merge. Adafruit's direct prices are $3.95 (794) and $1.95 (1953). |
fdb866a to
555df28
Compare
Builders order from PARTS.md, so a part that is needed in practice but missing, unnamed, or unlinked becomes a second order and a second wait. Working through a build surfaced several. New rows: - Raspberry Pi Active Cooler (SC1148, ~$8). The kiosk drives the UI, rolling-buffer capture, and FFT processing continuously, and a passively cooled Pi 5 throttles under that sustained load. - STEMMA QT / Qwiic-to-Qwiic cable (~$1). The section already covered wiring the LIS3DH at the Pi but not mounting it elsewhere, which is the actual use case for a tilt sensor. Length is left TODO because it depends on the enclosure and the case is still in development. - Qwiic-to-Dupont single cable (Adafruit 4397, Mouser 485-4397, $0.95), so the optional inclinometer can be ordered from the shared Mouser project instead of splitting the order with Amazon. 150 mm is the only length Adafruit makes in that JST-SH-to-female-socket configuration. - Qwiic-to-male-headers cable (Adafruit 4209, Mouser 485-4209, $0.95). Its male pins chain into the 75 mm female/female strip below, so the LIS3DH run can be lengthened from wires already on hand rather than committing to one fixed Qwiic-to-Qwiic length while the case layout is still unsettled. Listed as an alternative, so it does not move totals. Jumper wires, previously three rows that just said "Any", now named and split by gender because both are needed: - Female/female, 75 mm (Adafruit 794, Mouser 485-794, $3.95) for the sound-trigger runs and the OPS243 -> Pi ground. The Pi GPIO header, the OPS243 J3 header, and headers soldered to the SEN-14262 are all male pins, so both ends have to be female. The IWR6843 GATE -> BCM17 wire comes out of the same strip and now points at the same part. - Female/male, 75 mm (Adafruit 1953, Mouser 485-1953, $1.95) as header-pin extensions. The Touch Display 2's supplied 3-pin power cable spans header pins 2/4/6 and so covers both 5V pins; an extension re-presents one for the OPS243. 75 mm is the shortest length Mouser stocks in either gender. Every row above carries Adafruit's direct list price and says so, because the rows link to Mouser and Mouser's prices for those part numbers are unverified. Clarified rows: - The DS3502's role was a bare TODO. It is intended for the SEN-14262 R17 gain trim: in series with a fixed 37k resistor the 10K digital pot gives a software-adjustable 37-47k range, so preamp gain can be tuned from code instead of desoldering a fixed resistor. Not built or tested yet, and the row says so -- nothing drives it in code and sound-trigger-wiring.md still documents a soldered R17. - The IWR6843LEVM cable is named as micro-USB rather than pushing a "check your board revision" question onto the builder. - The Qwiic-to-Dupont kit row spells out that it avoids soldering a header onto the breakout. Cost summary: Power & Accessories $27 -> $37 (cooler $8, F/M ribbon $2) and Sound Trigger $18 -> $17, the latter because naming the F/F strip replaced a $5 guess with its $3.95 list price. Net effect on the subtotal ~$400 -> ~$409 and the total ~$556 -> ~$565. New optional inclinometer line at $16 (LIS3DH $5 + Qwiic-to-Dupont kit $10 + Qwiic-to-Qwiic cable $1); it sits under the optional section, which the subtotal does not roll up. Docs-only: no source, config, or build file is touched. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01QKe5hMZ6Ws3NXe6HyJJHtc
555df28 to
5ad03d0
Compare
HuggeK
changed the title
|
TODO is to measure once the rpi touch screen 2 model and placement of sensors land of the lengths of the recomended cables length so they reach in the new case. |
2 participants
What does this PR do?
Parts-list maintenance from a build: four new rows, three rows that were unnamed or unlinked now named, two clarified rows, and the cost-summary arithmetic that follows.
Any)TODO)raspberry-pi-setup.mdJumper wires, named and split by gender
Three rows previously said
Anyfor their link, which left both the gender and the length to the builder and kept the wires out of the shared Mouser project. Both genders are needed, for different reasons.GATEto BCM17Why female/female for the trigger wiring: the Pi GPIO header, the OPS243 J3 header, and headers soldered onto the SEN-14262 are all male pins, so both ends have to be female. The IWR6843
GATEto BCM17 wire comes out of the same strip, so that row points at the same part rather than repeating the spec.Why female/male as well: these are pin extensions — the female end goes onto a Pi GPIO pin and the male end re-presents that pin for a second connector. The Touch Display 2 supplied 3-pin power cable lands on header pins 2 (5V) and 6 (GND) and its shell spans pins 2/4/6, so it covers both 5V pins. The extension re-presents one for the OPS243.
On "shortest": 75 mm is the floor in both genders
The Adafruit jumper line starts at 75 mm — the longer options are 150 mm and 300 mm — and no other brand Mouser stocks goes below it. The shortest SparkFun premium jumpers are 4 inch / 100 mm, and Pololu, who do make 1 inch and 2 inch, is not a Mouser line.
Raspberry Pi Active Cooler (SC1148)
The kiosk drives the UI, rolling-buffer capture, and FFT processing continuously. A passively cooled Pi 5 throttles under that sustained load, so the clip-on active cooler is worth listing as a recommended accessory rather than leaving builders to discover the throttling themselves.
Note on the price and the vendor link
Listed at ~$8. Street pricing varies a fair bit by reseller — PiShop US $10.95, Adafruit $13.50, Mouser around the $8 mark — so treat it the way the rest of the table treats its
~Pricecolumn.The link points at mouser.com, matching the existing OpenFlight Mouser project reference at the top of the file. It was sourced from mouser.se for this build, but the .com product page lists the same part.
Qwiic cabling for the inclinometer
Three rows, covering the ways an LIS3DH actually gets connected. The Amazon multi-cable kit stays listed and keeps its "used in the validated build" note — the new rows are alternatives, not replacements, so none of them move the totals.
Qwiic-to-Dupont, single cable (Adafruit 4397, Mouser 485-4397) is the Mouser-stocked equivalent of that kit, so the whole optional inclinometer can be ordered from the Mouser project instead of splitting the order across two vendors. 150 mm is the only length Adafruit makes in this JST-SH-to-female-socket configuration; the shorter 50-100 mm Qwiic cables are Qwiic-to-Qwiic and have no Dupont end at all.
Qwiic-to-Qwiic (Adafruit 4399) is the run that lets the LIS3DH be mounted somewhere other than right next to the Pi. Adafruit sells these in 50-400 mm; which length is right depends on where the sensor ends up in the enclosure, and the case is still in development, so the row names the part and flags the length as an open question rather than guessing a number that would need correcting later.
Qwiic-to-male-headers (Adafruit 4209, Mouser 485-4209) is the answer to that open question in the meantime. Its male pins chain straight into the 75 mm female/female strip already needed for the sound trigger, so the LIS3DH run can be lengthened from wires on hand instead of committing to one fixed Qwiic-to-Qwiic length before the case layout is settled.
DS3502 digital potentiometer
The row previously said its role was
TODO. It is intended for the SEN-14262R17gain trim: in series with a fixed 37k resistor, the 10K digital pot gives a software-adjustable 37-47k range, so preamp gain can be tuned from code instead of desoldering and swapping a fixed resistor.This is not built or tested yet — nothing drives it in code, and sound-trigger-wiring.md still documents a soldered R17. The row says both things plainly rather than implying a working configuration.
Cost summary
Power & Accessories takes +$8 for the cooler and +$2 for the F/M ribbon. Sound Trigger drops $1 because naming the F/F strip replaced a $5 guess with its $3.95 list price. Both carry through the subtotal and total.
The three Qwiic cables sit under the optional inclinometer section, which the subtotal does not roll up, so they do not move the totals. The new $16 optional line is LIS3DH $5 + Qwiic-to-Dupont kit $10 + Qwiic-to-Qwiic cable $1.
Why was this required?
Builders order from this file, so a part that is needed in practice but missing, unnamed, or unlinked becomes a second order and a second wait.
Anyis not orderable. It does not say which gender, does not say how short, and cannot go into the Mouser project — so the one category of part every build needs was the one category you had to work out yourself.TODOrow invites someone to buy a part with no idea what it is for, or to delete it as dead weight.Automated tests
None — this PR changes only Markdown documentation (
docs/PARTS.md,docs/raspberry-pi-setup.md). No source, config, or build file is touched, so there is no behavior for a unit or integration test to cover. The repository has no docs-linting suite to extend either.In place of tests, the mechanical properties of the change were checked directly (see below): table structure, internal link targets, external link reachability, and the cost arithmetic.
Manual (human) testing
Docs-only, so verification was link-checking and proof-reading rather than a bench run.
PARTS.mdwas checked for consistent column counts; no mismatches, so the new rows render inside their tables rather than breaking out of them.PARTS.mdresolve to files that exist (including thesound-trigger-wiring.mdreference on the DS3502 row).Known gaps, worth a reviewer eye
docs/sound-trigger-wiring.mdnever states connector genders; it assumes headers get soldered to the SEN-14262 but not which kind. F/F follows from the Pi header, OPS243 J3, and a male-headered SEN-14262 all being male pins. If a build uses female headers on the detector, that row needs to say F/M instead.~Pricecolumn, left alone rather than silently widening the scope of this PR.Checklist