KIT.md

 # The Kit
 
-| Part | QTY | Ordered ? | Arrived ? | Kitted ? |
+> TODO: kit pic
+
+| Ordered ? | Arrived ? | Kitted ? | Part | QTY |
 | --- | --- | --- | --- | --- |
-| **Hardware** | --- | --- | --- | --- |
-| FHCS M5x10 | x | x | x | x |
-| FHCS M5x20 | x | x | x | x |
-| FHCS M5x30 | x | x | x | x |
-| FHCS M5x40 | x | x | x | x |
-| SHCS M5x10 | x | x | x | x |
-| SHCS M5x20 | x | x | x | x |
-| Nylock M5  | x | x | x | x |
-| Washer M5 | x | x | x | x |
-| FHCS M3x8 | x | x | x | x |
-| SHCS M3x8 | x | x | x | x |
-| SHCS M3x16 | x | x | x | x |
-| Nylock M3  | x | x | x | x |
-| Washer M3 | x | x | x | x |
-| [Aluminum Spacer](https://www.mcmaster.com/94669A042/) | 10 | x | x | x |
-| [Eccentric Spacers](https://www.amazon.com/Micro-Traders-Eccentric-Aluminium-Extrusion/dp/B09CYK9P43/) | 10 | x | x | no |
-| **Extrusion Situations** | --- | --- | --- | --- |
-| [V-Groove Extrusion 2020](https://www.amazon.com/BC-Labs-Slot-Aluminum-Extrusion/dp/B092HD1353/) | 2x 1000mm | x | x | x |
-| HFS5-2060 | 3x 2000mm | x | x | x |
-| Extrusion Corner Brackets | 20 | x | x | x |
-| [Extrusion Post-Install T-Nuts](https://www.amazon.com/Qjaiune-Aluminum-Extrusion-Printer-Profile/dp/B09H5B55ZG/) | x | x | x | x |
-| **USB** | --- | --- | --- | --- |
-| [8-Port Powered USB Hub](https://www.amazon.com/Sokiwi-Aluminum-Expender-Splitter-Individual/dp/B099YS5DGX/?th=1) | 1 | x | x | x |
-| USB A to C Cables | 7 | x | x | x |
-| [USB C to C 240W Cables](https://www.amazon.com/LISEN-Charger-Certified-Charging-MacBook/dp/B0CL26CTYG/) | 1 | x | x | x |
-| [USB PD Charger](https://www.amazon.com/Charger-Charging-Station-Foldable-Portable/dp/B0C6K2PJJ8/) | 1 | x | x | x |
-| [USB PD Decoys](https://www.amazon.com/Type-C-Trigger-Polling-Detector-Notebook/dp/B0BCW2LQP8) | 2 | x | x | x |
-| **Motors** | --- | --- | --- | --- |
-| [NEMA17 Motors](https://www.amazon.com/STEPPERONLINE-Stepper-Bipolar-4-Lead-Printer/dp/B00QEYADRQ/) | 5 | x | x | x |
-| [Standard Size Servos](https://www.amazon.com/Youleke-Torque-Digital-Servo%EF%BC%8CWaterproof-Horn%EF%BC%88270%C2%B0%EF%BC%89/dp/B08739MGPL/) | 2 | x | x | x |
-| [Mini Size Servos](https://www.amazon.com/Miuzei-MG90S-Servo-Helicopter-Arduino/dp/B0BWJ26PX2/) | 2 | x | x | x |
-| **Transmission** | --- | --- | --- | --- |
-| Kevlar 8800K43 | 50ft | x | x | no |
-| [GT2 Pulleys](https://www.amazon.com/Printing-Zeelo-Fiberglass-Rostock-Printers/dp/B08SMFM3Z6/?th=1) | 4 | x | x | x |
-| [GT2 Belt Open](https://www.amazon.com/Printing-Zeelo-Fiberglass-Rostock-Printers/dp/B08SMFM3Z6/?th=1) | - | x | x | x |
-| GT2 Belt Closed 280mm | 2 | x | x | x |
-| [6808 Bearings](https://www.amazon.com/XIKE-6808-2RS-Bearings-40x52x7mm-Pre-Lubricated/dp/B09D2VY3BK/?th=1) | 2 | x | x | x |
-| [625 Bearings](https://www.amazon.com/uxcell-625-2RS-Bearing-5x16x5mm-Bearings/dp/B07TML6YP4/?th=1) | 10 | x | x | x |
-| [625F Bearings](https://www.amazon.com/%EF%BC%BB12-Pack%EF%BC%BD625-2RS-Ball-Bearings-Miniature/dp/B0BRQP2QG7/) | 10 | x | x | x |
-| [Standard Roller Wheels](https://www.amazon.com/Official-Creality-3D-Printer-Plastic/dp/B09QPG7XGR/) | 20 | x | x | x |
-| [Small Roller Wheels](https://www.amazon.com/3Dman-Plastic-Pulley-Passive-Bearing/dp/B07V4GHLL8/) | 20 | x | x | x |
-| **Misc** | --- | --- | --- | --- |
-| [Limit Switches](https://www.amazon.com/JANDECCN-Switch-Straight-Action-V-153-1C25/dp/B0BDDCYTPP/) | 5 | x | x | x |
+| --- | --- | --- | **Hardware** | --- |
+| y | y | y | [M5 SHCS 304SS Kit iexcell](https://www.amazon.com/iExcell-Metric-Stainless-Socket-Assortment/dp/B09TTP2RCY) | 
+| y | y | y | [M3 SHCS 304SS Kit iexcell](https://www.amazon.com/iExcell-Stainless-Metric-Socket-Washers/dp/B0812TYT5L) | 
+| --- | --- | --- | **Extrusion Situations** | --- |
+| b | n | n | [V-Groove Extrusion 2020](https://www.amazon.com/BC-Labs-Slot-Aluminum-Extrusion/dp/B092HD1353/) | 2x 1000mm |
+| y | y | n | HFS5-2060 | 3x 2000mm |
+| y | y | n | Extrusion Corner Brackets | 20 |
+| y | y | n | [Extrusion Post-Install T-Nuts](https://www.amazon.com/Qjaiune-Aluminum-Extrusion-Printer-Profile/dp/B09H5B55ZG/) | ? |
+| --- | --- | --- | **Motors** | --- |
+| y | y | n | [NEMA17 Motors](https://www.amazon.com/STEPPERONLINE-Stepper-Bipolar-4-Lead-Printer/dp/B00QEYADRQ/) | 5 |
+| y | y | y | [Standard Size Servos](https://www.amazon.com/Youleke-Torque-Digital-Servo%EF%BC%8CWaterproof-Horn%EF%BC%88270%C2%B0%EF%BC%89/dp/B08739MGPL/) | 2 |
+| y | y | y | [Mini Size Servos](https://www.amazon.com/Miuzei-MG90S-Servo-Helicopter-Arduino/dp/B0BWJ26PX2/) | 2 |
+| --- | --- | --- | **Transmission** | --- |
+| y | y | y | [GT2 Pulleys](https://www.amazon.com/Printing-Zeelo-Fiberglass-Rostock-Printers/dp/B08SMFM3Z6/?th=1) | 4 | 
+| y | y | y | [GT2 Belt Open](https://www.amazon.com/Printing-Zeelo-Fiberglass-Rostock-Printers/dp/B08SMFM3Z6/?th=1) | - | 
+| y | y | y | [GT2 Belt Closed Assortment](https://www.amazon.com/PAGOW-Printer-Timing-Closed-Rubber/dp/B088M3V865) | 1 |
+| y | y | y | [6808 Bearings](https://www.amazon.com/XIKE-6808-2RS-Bearings-40x52x7mm-Pre-Lubricated/dp/B09D2VY3BK/?th=1) | 2 |
+| y | y | y | [625 Bearings](https://www.amazon.com/uxcell-625-2RS-Bearing-5x16x5mm-Bearings/dp/B07TML6YP4/?th=1) | 20 |
+| y | (one set missing) | (one set missing) | [625F Bearings](https://www.amazon.com/uxcell-Bearing-5x16x5mm-Shielded-Bearings/dp/B07Z3DXF14) | 10 |
+| y | y | y | [Roller Wheels](https://www.amazon.com/Official-Creality-3D-Printer-Plastic/dp/B09QPG7XGR/) | 20 |
+| y | n | n | [5mm Bore Tapped Flange / Hub](https://www.servocity.com/1309-series-sonic-hub-5mm-bore/) | 2 | 
+| --- | --- | --- | **Misc** | --- |
+| y | y | y | [Limit Switches](https://www.amazon.com/JANDECCN-Switch-Straight-Action-V-153-1C25/dp/B0BDDCYTPP/) | 5 |
+| y | n | n | [Solenoid Push-Pull 10mm 5N](https://www.amazon.com/Solenoid-Electromagnet-Spring-Push-Pull-Through/dp/B0CGDB1FG6) | 2 |
+| y | n | n | [Solenoid Push-Pull 4mm](https://www.amazon.com/Stroke-Push-Pull-Solenoid-Electromagnet-Electric/dp/B098KVBH4L) | 2 | 
+| --- | --- | --- | **Circuits** | --- |
+| y | y | y | [USB C PD Brick](https://www.amazon.com/Charger-Charging-Station-Foldable-Portable/dp/B0C6K2PJJ8) | 1 |
+| y | y | y | [USB C2C Cable](https://www.amazon.com/Anker-2-Pack-Charging-MacBook-Samsung/dp/B09LCJPZ1P) | 1 | 
+| n | n | n | Router | 1 |
+| n | n | n | Backpack Dually | 1 |
+| n | n | n | Backpack UART/RS485 | 4 |
+| n | n | n | Ribbon Cable | 50ft ? |
+| n | n | n | 10-Pin IDC | 12 ? |
+
+```
+'n' - no 
+'y' - yes 
+'b' - check basemento 
+'o' - order this 
+```
\ No newline at end of file

LINKS.md

@@ -22,10 +22,3 @@
 
 [accuracy vs. precision](https://fab.cba.mit.edu/classes/865.21/topics/metrology/01_concepts.html)  
 
-## MechE (examples)
-
-- clank
-- corexy (of dave)
-- beehive axes
-- clank-mudstack-extruder design pattern
-- ... add some more
\ No newline at end of file

README.md

-# Machine Week 2023
+# Machine Week 2024
 
 ```
 everything's connected but nothing's working !
 ```
 
-**Toiler Paper Plotter:** [Arch Section Repo](https://gitlab.cba.mit.edu/classes/863.23/Architecture/machine)  
-**Damatictron:** [CBA Section Repo](https://gitlab.cba.mit.edu/classes/863.23/CBA/machine) / [CBA Section Website](https://fab.cba.mit.edu/classes/863.23/CBA/machine/index.html)   
-**Gershenforcer:** [EECS Section Repo](https://gitlab.cba.mit.edu/classes/863.23/EECS/machine) / [EECS Website](https://fab.cba.mit.edu/classes/863.23/EECS/machine/index.html)  
-**Photo Bleach:** [Harvard Section Repo](https://gitlab.cba.mit.edu/classes/863.23/Harvard/machine) / [Harvard Website](https://fab.cba.mit.edu/classes/863.23/Harvard/machine/index.html)   
+> [Controls Repository: machineweek-2024-control](https://gitlab.cba.mit.edu/jakeread/machineweek-2024-control)
 
 # 1. Your (Group) Task
 
-Each section will design and build a "machine" - this means anything that includes **mechanism, actuation, automation and application**, that just means:
+Each section will design and build a "machine" - this means anything that includes **mechanism, actuation, automation and application.** 
+
+You'll get a [**kit of parts**](KIT.md) to do this, and we have [**an example linear axis**](TODO) and [**an example rotary axis**](TODO) that you can use as building blocks. We also have two example projects: [**a xylophone that plays itself**](TODO) and a [**small, very fast drawing machine**](TODO). We also provide a [**set of modular hardware and software for motion control**](https://gitlab.cba.mit.edu/jakeread/machineweek-2024-control) (requires a gitlab login) to help get things moving. 
+
+You should also **document your machine** and **use git to collaborate** a-la last year's examples:
+
+- CBA Section 2023: [repo](https://gitlab.cba.mit.edu/classes/863.23/CBA/machine) and [website](https://fab.cba.mit.edu/classes/863.23/CBA/machine/index.html)
+- Harvard Section 2023: [repo](https://gitlab.cba.mit.edu/classes/863.23/Harvard/machine) and [website](https://fab.cba.mit.edu/classes/863.23/Harvard/machine/index.html) 
 
 ### **Mechanism:** mechanical degrees-of-freedom (DOF)
 
-Stuff shuld move around.
+Stuff should move around!
+
+- [Kinematics, Constraint](https://fab.cba.mit.edu/classes/865.21/topics/mechanical_design//kinematics/)
+- [Mechanical Principles](https://fab.cba.mit.edu/classes/865.21/topics/mechanical_design//principles/)
 
 ### **Actuation:** computer-controllable motion of the above DOFs
 
 The motion should be computer controlled.
 
-### **Automation / Application** software-coordinated computer-control of the above, and i.e. sequences therein
+- [Stepper Controllers](https://gitlab.cba.mit.edu/jakeread/machineweek-2024-control/-/tree/main/circuits/simple-stepper?ref_type=heads) (TODO: improve doc) 
+- [Transmissions](https://fab.cba.mit.edu/classes/865.21/topics/mechanical_design//transmissions/)  
+
+### **Automation / Application** software-coordinated computer-control of the above, to accomplish a task. 
 
 The motion should result in some desired outcome... maybe make something, draw something, change something, assemble something, sort something, cast a spell, etc. 
 
+- [Path Planning](https://fab.cba.mit.edu/classes/865.24/topics/path_planning/index.html)  
+- [Computer Vision ?](https://quentinbolsee.pages.cba.mit.edu/mas865.24_computer-vision/)  
+
 ---
 
-# 2. Tools, Tools, Tools !
+# 2. Examples / Ideas
 
-> [Ilan](https://web.mit.edu/imoyer/www/index.html) (inventor of [CoreXY](http://www.corexy.com/)) would urge us to think more carefully about "tools" - what does it mean to build a computer-controlled system that acts like a tool, interacting with the world but being mediated by some designer's intent... it's a [foamcore world](https://web.mit.edu/imoyer/www/portfolio/foamcore/index.html).
+The machines you design and build **don't need to be complicated** - try to de-risk ideas early, and do stuff that "works right away" rather than complex projects that require hundreds of details to come together all at once in order to work. This can be fun; have fun.
 
-### Shaper Origin [[YouTube](https://www.youtube.com/watch?v=QxjE5WOAGi4)]
+<!--- 
+### Xylo [(full source available)](LINK2PrivyRepo)  
 
-![origin](img/shaper_origin.webp)
+TODO: ... upd8 xylo, put it here 
 
-### Turn-By-Wire [[UIST](https://dl.acm.org/doi/abs/10.1145/3332165.3347918)]
+### VVelocity [(full source available)](LINK2PrivyRepo) (or the little guy) 
 
-![tbw](img/turn_by_wire.jpg)
+--->
 
----
+### Label Maker [YT /  MrInnovative](https://www.youtube.com/watch?v=Y_rrbo6_42U&t=73s)
 
-# 3. Examples / Ideas
+![tape-labels](img/tape-labels.png)
 
-The machines you design and build **don't need to be complicated** - try to de-risk ideas early, and do stuff that "works right away" rather than complex projects that require hundreds of details to come together all at once in order to work. This can be fun; have fun.
+### Wire Cutter [YT / MrInnovative](https://youtu.be/7E6iHRjvH_k?t=20)
+
+![wire-cutter](img/wire-cutter.png)
+
+### String / Floating Machines [HangPrinter](https://youtu.be/dZLtPFJEQi0?t=104)
+
+![hang-printer](img/hangprinter.png)
+
+### Architecture-Scale / Space Transforming [Gil Sunshine](https://fab.cba.mit.edu/classes/865.21/people/gilsunshine/systems.html)
+
+![gil](img/gil-machine.png)
+
+## Scara Arm [YT / How To Mechatronics](https://www.youtube.com/watch?v=1QHJksTrk8s&t=38s)
+
+![scara](img/scara.png)
+
+### Light Painting
+
+![lp](img/maxl-hello-world.jpg)
+
+### Robot Chainsaw Machine: [YT / Stuff Made Here](https://youtu.be/ix68oRfI5Gw?t=1160)
+
+![robosaw](img/robot-chainsaw.png)
+
+### Robot Basketball Hoop: [YT / Stuff Made Here](https://youtu.be/myO8fxhDRW0?t=598)
 
-### [Light Painting](img/maxl-hello-world.jpg)
-### [Label Maker](https://www.youtube.com/watch?v=Y_rrbo6_42U&t=73s)
-### [Wire Cutter](https://youtu.be/7E6iHRjvH_k?t=20)
-### [Music Machines](https://youtu.be/dhKYxDzyXqI?t=5) aka [Clangers / Bangers](https://ekswhyzee.com/2023/07/21/clangers-and-bangers.html) 
-### [String / Floating Machines](https://youtu.be/dZLtPFJEQi0?t=104)
-### [Architecture-Scale / Space Transforming](https://fab.cba.mit.edu/classes/865.21/people/gilsunshine/systems.html)
-### [Claw Machine](https://youtu.be/zR3BLM_TAmg?t=117)
-### [Robot Chainsaw Machine](https://youtu.be/ix68oRfI5Gw?t=1160)
-### [Robot Basketball Hoop](https://youtu.be/myO8fxhDRW0?t=598)
+![robohoop](img/robot-hoop.png)
+
+### Claw Machine: [Toy Story](https://www.youtube.com/watch?v=N-Esh4W3dfI&t=55s)
+
+### Shaper Origin [YT / Ilan Moyer](https://www.youtube.com/watch?v=QxjE5WOAGi4)
+
+![origin](img/shaper_origin.webp)
+
+### Turn-By-Wire: [UIST](https://dl.acm.org/doi/abs/10.1145/3332165.3347918)
+
+![tbw](img/turn_by_wire.jpg)
+
+### Xylo (WIP) 
+
+![xylo-wip](img/xylo-wip.jpg)
 
 --- 
 
-# 4. Strategies
+# 3. Strategies
 
 - teamworks! 
   - have a project manager 
@@ -75,7 +119,7 @@ The machines you design and build **don't need to be complicated** - try to de-r
 
 ---
 
-# 5. Examples from this Kit
+# 4. Component Examples from this Kit
 
 ### Framing
 
@@ -95,16 +139,6 @@ Kit [[stl](CAD/belt_axis/belt_axis_kit.stl)]
 
 <img src=img/belt_axis_kit.png width=50%><br>
 
-### Leadscrew Axis
-
-Assembly [[CAD](CAD/leadscrew_axis/leadscrew_axis.f3z)]
-
-<img src=img/leadscrew_axis.png width=50%><br>
-
-Kit [[stl](CAD/leadscrew_axis/leadscrew_axis_kit.stl)]
-
-<img src=img/leadscrew_axis_kit.png width=50%><br>
-
 ### Rotary Axis
 
 Assembly [[CAD](CAD/rotary_axis/rotary_axis.f3z)] [[notes](https://ekswhyzee.com/2019/04/09/gt2-belt-rotary-cad.html)]
@@ -115,35 +149,27 @@ Kit [[stl](CAD/rotary_axis/rotary_axis_kit.stl)]
 
 <img src=img/rotary_axis_kit.png width=50%><br>
 
-## The Blot / Drawing Machine [[notes](https://blot.hackclub.dev/)]
-
-![blot](img/blot-clear-bg.png)
-
-## The Xylophone 
-
-![xylo](img/xylophone_teaser.jpg)
+---
 
-## Scara Arm [[YouTube](https://www.youtube.com/watch?v=1QHJksTrk8s&t=38s)]
+# 5. [The Kit](KIT.md)
 
-TODO
+![controllers](img/kit-controller.jpg)
 
 ---
 
-# 6. [The Kit](KIT.md)
+# 6. How to Start 
 
-## [Modular Things !](https://github.com/modular-things/modular-things/)
-
-### [... Circuits](https://modular-things.github.io/modular-things/things/) 
+- elect a contact-person
+- have them contact us (Jake and Quentin) (we will open a #machines channel in [the discord](https://discord.gg/uUn49gAdTV)) 
+- convene a kickoff meeting, schedule it with us!
+  - we will bring your kit-of-parts to the meeting! 
 
 --- 
 
-# 7. What to Do Now
-
-- elect a contact-person (or dictator)
-- have them contact us (Jake and Quentin) (contact info will be in a gitlab issue) 
-- convene a kickoff meeting, schedule it with us!
-- kits, demos, and more to come... 
+# 7. [Extended Resources](LINKS.md)
 
 ---
 
-# 8. [Extended Resources](LINKS.md)
\ No newline at end of file
+# 8. Prior Years
+
+- [Machine Week 2023](https://gitlab.cba.mit.edu/jakeread/machineweek-2023) 
\ No newline at end of file

TODO.md

 # Machine Week TODO 
 
+## Prepatory Hardware Actions 
+
+- hardware kit... aligning with demo parts ? 
+	- i.e. improve that belt axis a little ? 
+- router circuits reflow, assembly ? 
+- circuits on motors, fertha kids ? 
+	- 16 motors... either we reflow the known codes or we deploy-test the new lads 
+	- we have enough of each, but need to PNP by hand 
+	- tbd if this is worth it over the cost of the new boards:
+		- spend the few-hours bringing up firmware instead... at the cost of 1/2 circuit stash, 
+		- re-ups possible, but maybe time consuming... but testing is also worthwhile 
+- limit switch boards, or some other way to Reduce Limit Switch Suffering (or fk it, focus on code) 
+- backpack-to-whatever circuit ?
+	- jlcpcb rush assy ? 
+
+## Prepatory SI Actions 
+
+- important: *NOT SURE ABOUT FIRMWARE UPDATES YET* 
+- minimum:
+	- non-blocking queue planner / segments transmitter 
+	- (!) forwards and reverse transforms, for homing cycles ? 
+- the handbook ? 
+- ... graphs, or what ? 
+- deadbugger, hbridge, stepper firmwares ? 
+- docs for circuits, python, etc ? 
+- consider: more productive to do nuts-and-bolts perf for the segment solver (etc), than full-on graphs - though the latter is more fun 
+- how to rename devices, besides just uploading new firmwares ? 
+
 ## Demo Desires
 
-- finish the xylophone, in-modular-things, and as a standalone ?
-	- do it for the deploy / wall sitter 
-- scara plotter ! 
-- want a way to bottle demos
-	- cad / cam / circuits, each as standalone mono-repo ? 
-	- web UI is for sketching, deploy is different... 
-- a plotter ? (servo and axes) 
-- a lil robot arm, 3dof 
-- accelerometer-to-stage ? 
-- etc-a-sketch the plotter
-- a walking robot ? it'd be a good demo for the graphs thing also, anyways... sequencing, etc... 
+- make the xylophone into a standalone example project 
+- samesies for the little guy, vvelocity 
+
+## When is it Over 
+
+- prep is done when:
+	- kits are ready 
+		- and pic acquired 
+  - routers are ready 
+  - ... other circuits are ready:
+    - either firmware-and-test for the new drivers *or* build and test the og's 
+    - one deadbugger, one hbridge each, with firmwares and APIs for those ? 
+	- limit switch switchuation ? 
+  - demos are ready:
+    - piano-or-midi xylo
+    - little guy 
+    - this includes unfking maxl (and it might just be that one bad await-all call)
+    - and i.e. a rasbpi setup w/ power situation, etc - the little guy should be finish, bottled ! 
+		- the mega / multi plotter ? 
+	- docs: 
+		- cable building ? 
+		- cad, interfaces for circuits (mount holes...) 
+		- firmware loading / reloading ? 
+		- what happens when multiples of the same name connected ? 
+		- how to connect servo-z-axes, etc ? 
+  - handbook OK ? 
\ No newline at end of file