- pdb: doc CAD for the PSU, pictures of PDBs, explain, ok
- use two photos, show bus -> up down, breakout, overlaid
- doc your example milling machine ... bigtime
- connecting / hooking up the whole machine:
- cuttlefish GIF per action: add hunks, hook-up, etc
- add comm, add link, say hello, ok
- cf examples:
- littleRascal-complete
- png-to-path
- svg-to-path
- single-stepper-usb
# Machine Mayhem '19
Wrangling a machine together can be arduous. You can do anything you'd like, but you only have a week, and are maybe not experts yet. To that end, fab class provides - in the shape of this brief page, and its children - a small set of advice, a suggested direction, and a kit of parts and controllers that should get you to *most* of where you might like to go.
...
...
@@ -32,6 +14,8 @@ Further documentation for these things is at the page [here](https://gitlab.cba.
The collection of mechanical bits you have access to is as follows:
Power Entry Module | 1 | AC Hookup, Switching | Digikey | 486-3979-ND |
Power Entry Fuse | 1 | *Danger* Barrier (already installed in the above) | Digikey | 486-1226-ND |
## Developing Controllers
### Network Cables
### Squidworks
Some notes on making network cables:
Since you have the circuits, you are free to implement a [squidworks](https://gitlab.cba.mit.edu/squidworks/squidworks) controller. These are controllers whose whole operation spans more than one computing ~ d o m a i n ~ -> the squidworks project is an attempt to develop a protocol and serialization scheme that makes it easier to see what these controllers are doing, to add new hardware and software resources to them, and operate them.
- network cables can be made two ways: only one is correct - *rj10 tabs should be on the same side of the ribbon cable* i.e. the cable is a 'straight through' type, not a crossover. this means that tx meets rx, etc.
- the transmit / receive ports are RS-485 Differential Driven, meaning there is no common gnd connection between boards besides the power bus.
!TODO: image of LR controller, ft. path planning, execution.
![image]()
The connectors I use here (and that are in your kit) are called 'RJ10' Jacks and Plugs. These are standard for old (wired!) phone handsets, but also 'generally useful'.
!TODO: video of the same. copy of squidworks repo toplevel

One cool thing about RJ45 is the modularity of the cables. We can use commodity crimping tools to make our own lengths:
- one side cuts, one side strips. use both at the same time to get the right length of stripped wire
- use the '4p' crimp, note the tab direction in the crimp
- pinch! the plug has a plastic tab inside that should come down to meet the wire jacket
For documentation of the squidworks project, [hit this link](https://gitlab.cba.mit.edu/squidworks/squidworks).
`these videos show an RJ45 connector: the RJ10 is nearly identical, just smaller`
### Cuttlefish

`make sure those tabs are on the same side of the flat cable`

## Developing Controllers
### Squidworks
[Cuttlefish](https://gitlab.cba.mit.edu/squidworks/cuttlefish) is the in-browser virtual dataflow environment and scope.
Since you have the circuits, you are free to implement a [squidworks](https://gitlab.cba.mit.edu/squidworks/squidworks) controller. For more documentation on squidworks, follow the link.
### Ponyo

[Ponyo](https://gitlab.cba.mit.edu/squidworks/ponyo) is the embedded virtual dataflow environment.