|
1 | 1 | # PurpleDrop |
2 | 2 |
|
3 | | -This holds the hardware design for PurpleDrop, a digital microfluidic device. The hardware is designed in KiCad, and consists of a [main driver board](/hardware), and a ["cartridge" board](/cartridge) containing the electrode array. |
| 3 | +This holds the main board electronics design for [PurpleDrop](https://misl.cs.washington.edu/projects/fluidics.html), |
| 4 | +a digital microfluidic device. The design is done in KiCad v5.x. |
4 | 5 |
|
5 | 6 | PurpleDrop is open-source, and you are welcome to build it as-is, or use it as a |
6 | 7 | starting point for your own projects. If you are thinking about building your |
7 | | -own PurpleDrop, please feel free to reach out first. This project is under active |
8 | | -development, and there may be some recent updates not yet reflected here worth |
9 | | -considering. This repository is maintained by Jeff McBride, who can be reached at |
10 | | -mcbridej@cs.washington.edu. |
| 8 | +own PurpleDrop, you are encouraged to reach out first. This project is under active |
| 9 | +development, and there may be some recent updates or issues not yet reflected here |
| 10 | +that you should consider. This repository is maintained by Jeff McBride, who can be |
| 11 | +reached at mcbridej@cs.washington.edu. |
11 | 12 |
|
12 | | -# Documentation |
| 13 | +The latest release of PurpleDrop is v6.0, but this board has some design flaws that |
| 14 | +require re-work to work-around. Building this version is not recommended. These issues |
| 15 | +are fixed in v6.1, but this board has not been fully tested yet and so has not been |
| 16 | +released. |
13 | 17 |
|
14 | | -See the [wiki for PurpleDrop documentation](https://github.com/uwmisl/purpledrop/wiki). |
| 18 | +# PurpleDrop System Documentation |
| 19 | + |
| 20 | +For higher level documentation on the PurpleDrop, see the [wiki](https://github.com/uwmisl/purpledrop/wiki). |
| 21 | + |
| 22 | +# PC Design Documentation |
| 23 | + |
| 24 | +Schematic print: [PurpleDrop_rev6.1_schematic.pdf](hardware/output/PurpleDrop_rev6.1_schematic.pdf) |
| 25 | + |
| 26 | +Fab drawing: [PurpleDrop_rev6.1_fab.pfd](hardware/output/PurpleDrop_rev6.1_fab.pdf) |
| 27 | + |
| 28 | + |
| 29 | + |
15 | 30 |
|
16 | 31 | # Embedded Software |
17 | 32 |
|
18 | 33 | This design contains an STM32F413 microcontroller. The software that runs it can be found at [https://github.com/uwmisl/purpledrop-stm32](). |
| 34 | + |
| 35 | +# Development Notes |
| 36 | + |
| 37 | +Tips for working on this project |
| 38 | +## BOM Generation |
| 39 | + |
| 40 | +The [KiBom](https://github.com/SchrodingersGat/KiBoM) plugin is used to generate a BOM file, based on settings in `bom.ini`. |
| 41 | + |
| 42 | +To re-generate the BOM output: |
| 43 | + |
| 44 | +First, install kibom: `pip install kibom`. |
| 45 | + |
| 46 | +Add a new BOM plugin in the "Generate BOM" dialog in eeschema, and configure it |
| 47 | +with this command line: |
| 48 | +`python -m kibom "%I" "%O.csv"` |
| 49 | + |
| 50 | +Run the BOM plugin. |
0 commit comments