Merge branch 'martinbudden-extrusion1515_dimensions'

Fixed missing space in veroboard vitamin decription.

.gitattributes

@@ -0,0 +1,16 @@
+# Set the default behavior, in case people don't have core.autocrlf set.
+* text=auto eol=lf
+
+# Declare text files that are normalized and converted on checkout.
+*.scad text
+*.py   text
+*.md   text
+
+# Handle Windows batch and command files 
+*.{bat,[bB][aA][tT]} text eol=crlf
+*.{cmd,[cC][mM][dD]} text eol=crlf
+
+# Denote files that are binary and should not be modified.
+*.png binary
+*.jpg binary
+

.gitignore

@@ -7,6 +7,7 @@ tests/bom/
 *.log
 *.html
 bounds.json
+options.json
 times.txt
 *_diff.png
 *.echo

core.scad

@@ -18,10 +18,10 @@
 //
 
 //
-// Include this file to use the miniumum library
+// Include this file to use the minimum library plus screws, nuts and washers
 //
-include <global_defs.scad>
+include <utils/core/core.scad>
 //
-// Global functions and modules
+// Fasteners used by a lot of other vitamins
 //
-use <utils/core/global.scad>
+include <vitamins/screws.scad>

docs/usage.md

@@ -1,7 +1,7 @@
 # NopSCADlib usage
 
 ## Requirements
-1. OpenSCAD 2019.05 or later, download it from here: https://www.openscad.org/downloads.html
+1. OpenSCAD 2021.01 or later, download it from here: https://www.openscad.org/downloads.html
 1. Python 2.7+ or 3.6+ from https://www.python.org/downloads/
 1. ImageMagick 7 www.imagemagick.org
 
@@ -22,37 +22,37 @@ The 7 SEGMENT.TTF font from the docs directory is needed for simulating 7 segmen
 
 ## Installation
 
-OpenSCAD has to be setup to find libraries by setting the ```OPENSCADPATH``` environment variable to where you want to file your libraries and NopSCADlib needs to be installed
-in the directory it points to. This can be done with ```git clone https://github.com/nophead/NopSCADlib.git``` while in that directory or, if you don't want to use GIT,
+OpenSCAD has to be setup to find libraries by setting the `OPENSCADPATH` environment variable to where you want to file your libraries and NopSCADlib needs to be installed
+in the directory it points to. This can be done with `git clone https://github.com/nophead/NopSCADlib.git` while in that directory or, if you don't want to use GIT,
 by downloading https://github.com/nophead/NopSCADlib/archive/master.zip and unzipping it to a directory called NopSCADlib.
 
-The ```NopSCADlib/scripts``` directory needs to be added to the executable search path.
+The `NopSCADlib/scripts` directory needs to be added to the executable search path, `PATH` on Windows and `path` on Linux and Mac.
 
-The installation can be tested by opening ```NopSCADlib/libtest.scad``` in the OpenSCAD GUI. It should render all the objects in the library in about 1 minute.
+The installation can be tested by opening `NopSCADlib/libtest.scad` in the OpenSCAD GUI. It should render all the objects in the library in about 1 minute.
 
-Running ```tests``` from the command line will run all the tests in the ```tests``` directory and build the ```readme.md``` catalog for GitHub and render it to ```readme.html```
+Running `tests` from the command line will run all the tests in the `tests` directory and build the `readme.md` catalog for GitHub and render it to `readme.html`
 for local preview.
 
 ## Directory structure
 
 | Path | Contents |
 |:-----|:------|
-| ```NopSCADlib``` | Top level scad files, e.g. ```lib.scad``` |
-| ```NopSCADlib/doc``` | Documentation like this that is not automatically generated |
-| ```NopSCADlib/examples``` | Example projects |
-| ```NopSCADlib/gallery``` | Pictures of items that have been made with the library |
-| ```NopSCADlib/printed``` | Scad files for making reusable printed parts |
-| ```NopSCADlib/scripts``` | Python scripts |
-| ```NopSCADlib/tests``` | A stand alone test for each type of vitamin and most of the utilities |
-| ```NopSCADlib/utils```   | Utility scad files |
-| ```NopSCADlib/utils/core``` | Core utilities used by nearly everything |
-| ```NopSCADlib/vitamins``` | Generally a pair of .scad files for each type of vitamin. The plural version contains object definitions to be included and it uses the singular version. |
+| `NopSCADlib` | Top level scad files, e.g. `lib.scad` |
+| `NopSCADlib/doc` | Documentation like this that is not automatically generated |
+| `NopSCADlib/examples` | Example projects |
+| `NopSCADlib/gallery` | Pictures of items that have been made with the library |
+| `NopSCADlib/printed` | Scad files for making reusable printed parts |
+| `NopSCADlib/scripts` | Python scripts |
+| `NopSCADlib/tests` | A stand alone test for each type of vitamin and most of the utilities |
+| `NopSCADlib/utils`   | Utility scad files |
+| `NopSCADlib/utils/core` | Core utilities used by nearly everything |
+| `NopSCADlib/vitamins` | Generally a pair of .scad files for each type of vitamin. The plural version contains object definitions to be included and it uses the singular version. |
 
 
 ## Making a project
 
 Each project has its own directory and that is used to derive the project's name.
-There should also be a subdirectory called ```scad``` with a scad file in it that contains the main assembly.
+There should also be a subdirectory called `scad` with a scad file in it that contains the main assembly.
 A skeleton project looks like this: -
 
     //! Project description in Markdown format before the first include.
@@ -72,30 +72,30 @@ A skeleton project looks like this: -
 
 Other scad files can be added to the scad directory and included or used as required.
 
-* Subassemblies can be added in the same format as ```main_assembly()```, i.e. a module called ```something_assembly()```, taking no parameters and calling ```assembly("something")```
+* Subassemblies can be added in the same format as `main_assembly()`, i.e. a module called `something_assembly()`, taking no parameters and calling `assembly("something")`
  with the rest of its contents passed as children.
-It needs to be called directly or indirectly from ```main_assembly()``` to appear in the view and on the BOM.
-Assembly instructions should be added directly before the module definition in comments marked with ```//!```.
+It needs to be called directly or indirectly from `main_assembly()` to appear in the view and on the BOM.
+Assembly instructions should be added directly before the module definition in comments marked with `//!`.
 
-* Any printed parts should be made by a module called ```something_stl()```, taking no parameters and calling ```stl("something")``` so they appear on the BOM when called from
-an assembly. Printed parts are usually ```color```ed and ```render```ed at the point they are used in the assembly.
+* Any printed parts should be made by a module called `something_stl()`, taking no parameters and calling `stl("something")` so they appear on the BOM when called from
+an assembly. Printed parts are usually `color`ed and `render`ed at the point they are used in the assembly.
 
-* Any 2D routed parts should be made by a module called ```something_dxf()```, taking no parameters and calling ```dxf("something")``` so they appear on the BOM when called from an
-assembly. They are generally made from a ```sheet_2D()``` with holes subtracted from it. That will also put the sheet material on the BOM.
-They are then expanded to 3D using ```render_2D_sheet()``` when they are placed in an assembly.
+* Any 2D routed parts should be made by a module called `something_dxf()`, taking no parameters and calling `dxf("something")` so they appear on the BOM when called from an
+assembly. They are generally made from a `sheet_2D()` with holes subtracted from it. That will also put the sheet material on the BOM.
+They are then expanded to 3D using `render_2D_sheet()` when they are placed in an assembly.
 
-When ```make_all``` is run from the top level directory of the project it will create the following sub-directories and populate them:-
+When `make_all` is run from the top level directory of the project it will create the following sub-directories and populate them:-
 
 | Directory | Contents |
 |:----------|:---------|
 | assemblies | For each assembly: an assembled view and an exploded assembly view, in large and small formats |
-| bom | A flat BOM in ```bom.txt``` for the whole project, flat BOMs in text format for each assembly and a hierarchical BOM in JSON format: ```bom.json```.|
+| bom | A flat BOM in `bom.txt` for the whole project, flat BOMs in text format for each assembly and a hierarchical BOM in JSON format: `bom.json`.|
 | deps | Dependency files for each scad file in the project, so that subsequent builds can be incremental |
 | dxfs | DXF files for all the CNC routed parts in the project and small PNG images of them |
 | stls | STL files for all the printed parts in the project and small PNG images of them |
 
-It will also make a Markdown assembly manual called ```readme.md``` suitable for GitHub, a version rendered to HTML for viewing locally called ```readme.html``` and a second
-HTML version called ```printme.html```. This has page breaks instead of horizontal rules between sections and can be converted to PDF using Chrome to make a stand alone manual.
+It will also make a Markdown assembly manual called `readme.md` suitable for GitHub, a version rendered to HTML for viewing locally called `readme.html` and a second
+HTML version called `printme.html`. This has page breaks instead of horizontal rules between sections and can be converted to PDF using Chrome to make a stand alone manual.
 
 Each time OpenSCAD is run to produce STL files, DXF files or assembly views, the time it takes is recorded and compared with the previous time.
 At the end the times are printed with the delta from the last run and coloured red or green if they have got significantly faster or slower.
@@ -112,28 +112,38 @@ All the vitamins and utilities are included if you include [NopSCADlib/lib.scad]
 Printed parts are not included and need to be used or included explicitly, their documentation states which files need to be included rather than used.
 
 This is the easiest way to use the library and is reasonably efficient because the only files included are the object list definitions, all the functions and modules are used, so
-get shared if other files in the project include ```lib.scad``` as well, or if you have multiple projects open in the same instance of OpenSCAD.
+get shared if other files in the project include `lib.scad` as well, or if you have multiple projects open in the same instance of OpenSCAD.
 
 One downside is that any change to the library will mean all the project files need regenerating.
 A more optimised approach for large projects is to include [NopSCADlib/core.scad](../core.scad) instead.
-That only has the a small set of utilities and the global settings in [global_defs.scad](../global_defs.scad). Any vitamins used need to be included explicitly.
-One can copy the include or use line from [NopSCADlib/lib.scad](../lib.scad).
+That only has the a small set of utilities and the global settings in [global_defs.scad](../global_defs.scad) plus screws, nuts and washers that are required by a lot of other vitamins.
+Any other vitamins used need to be included explicitly. One can copy the includes or use a line from [NopSCADlib/lib.scad](../lib.scad).
+
+### Project Description
+
+A description of the project can be placed in comments in Markdown format before the first include file.
+By default this is followed by a picture of the main assembly unless the description contains any pictures.
+
+The description can be divided into two or three sections using //! ***, which is a Markdown horizontal rule in a comment.
+If there is a second section it is placed after the table of contents and a third section will be placed after the parts list.
+
+If an actual horizontal rule is desired the alternative Markdown markup //! --- can be used.
 
 ### Parametric parts.
 
 Modules that generate parts and assemblies need to take no parameters so that they can be called from the framework to make the STL files and assembly views, etc.
 Sometimes parts or asemblies need to be parametric, for example fan guards take the fan as a parameter.
-To work around this the ```fan_guard()``` module calls the ```stl()``` module with a variable name which has a suffix of the fan width, e.g. "fan_guard_60".
+To work around this the `fan_guard()` module calls the `stl()` module with a variable name which has a suffix of the fan width, e.g. "fan_guard_60".
 This ensures that if there are different sized fans in the same project the STL files have unique names.
-It is then up to the user to add a wrapper to their project called ```fan_guard_60_stl()``` that calls ```fan_guard()``` with a 60mm fan: -
+It is then up to the user to add a wrapper to their project called `fan_guard_60_stl()` that calls `fan_guard()` with a 60mm fan: -
 
     module fan_guard_60_stl() fan_guard(fan60x15);
 
-Calling ```fan_guard(fan60x15)``` draws a fan guard for a 60mm fan and puts ```fan_guard_60.stl``` on the BOM. The framework then looks for a module ```fan_guard_60_stl()``` to
+Calling `fan_guard(fan60x15)` draws a fan guard for a 60mm fan and puts `fan_guard_60.stl` on the BOM. The framework then looks for a module `fan_guard_60_stl()` to
 generate it.
 
 This is OK if the fan will always be 60mm but what if the project is parametric and the fan size can vary?
-To cater for that ```fan_guard()``` can be passed a ```name``` parameter to name the STL.
+To cater for that `fan_guard()` can be passed a `name` parameter to name the STL.
 For example a 3D printer might have a bed cooling fan and different sized machines might have different size fans.
 
     bed_fan = fan80x38;
@@ -144,7 +154,7 @@ In this case the STL file has a constant name related to its use, regardless of
 
 ### Assembly boundaries
 
-The ```assembly()``` module is used to mark assemblies that correspond to a step of construction.
+The `assembly()` module is used to mark assemblies that correspond to a step of construction.
 Each assembly named in this way gets a page in the build manual with a list of the parts and sub-assemblies that it uses, an exploded view,
 some build instructions and then the assembled view.
 This doesn't always correspond with how one would want to structure the code.
@@ -162,9 +172,9 @@ This is achieved by having a pair of modules: -
     //! Place inserts in the bottom of the posts and push them home with a soldering iron with a conical bit heated to 200°C.
     //
     module handle_assembly() pose([225, 0, 150], [0, 0, 14]) //! Printed part with inserts in place
-    assembly("handle") {
+    assembly("handle", ngb = true) {
         translate_z(handle_height())
-            color(pp1_colour) vflip() handle_stl();
+            stl_colour(pp1_colour) vflip() handle_stl();
 
         handle_screw_positions()
             vflip()
@@ -172,7 +182,7 @@ This is achieved by having a pair of modules: -
     }
 
     module handle_fastened_assembly(thickness) { //! Assembly with fasteners in place
-        screw_length = screw_longer_than(thickness + insert_length(insert) + 2 * washer_thickness(screw_washer(screw)));
+        screw_length = screw_length(screw, thickness, 2, true, longer = true);
 
         handle_assembly();
 
@@ -182,26 +192,29 @@ This is achieved by having a pair of modules: -
                     screw_and_washer(screw, screw_length, true);
     }
 
-Notice how the first module ```handle_assembly()``` uses ```assembly()``` and has a build instruction. It isn't used directly in a project though, ```handle_fastened_assembly()``` is
+Notice how the first module `handle_assembly()` uses `assembly()` and has a build instruction. It isn't used directly in a project though, `handle_fastened_assembly()` is
 what is actually called from the parent assembly.
-Because it doesn't have a call to ```assembly()```, the fasteners are added to the parent but the STL and the inserts become a sub-assembly.
+Because it doesn't have a call to `assembly()`, the fasteners are added to the parent but the STL and the inserts become a sub-assembly.
 
 When the parent assembly is shown exploded the handle's screws will be exploded but the inserts won't. They only explode when the sub-assembly is shown exloded.
 
-Note also the ```pose([225, 0, 150], [0, 0, 14])``` call before the ```assembly()``` call. This allows the sub-assembly to be posed differently in its build step but doesn't
+Note also the `pose([225, 0, 150], [0, 0, 14])` call before the `assembly()` call. This allows the sub-assembly to be posed differently in its build step but doesn't
 affect its orientation in the parent assembly. The pose parameters are the rotation and the translation taken from the GUI.
 
+Setting `ngb = true` in the `assembly()` prevents the handle assembly appearing as a columun in the top level BOM in the build instructions.
+Instead its parts are merged into the parent BOM so the correct quantites are listed.
+
 ### Exploded diagrams
 
-A lot of vitamins explode themselves when ```$explode=1```. This is done with module ```explode()``` that can be passed a Z offset, or a 3D vector that gives the displacement
-and it draws a line from the origial position to the exploded position. The line can be offset from the origin of the component by specifying an offset vector.
+A lot of vitamins explode themselves when `$explode=1`. This is done with module `explode()` that can be passed a Z offset, or a 3D vector that gives the displacement
+and it draws a line from the original position to the exploded position. The line can be offset from the origin of the component by specifying an offset vector.
 
-Often user assemblies need to add ```explode()``` in various places to explode printed parts, for example.
+Often user assemblies need to add `explode()` in various places to explode printed parts, for example.
 
 ### Creating vitamins
 
 Most vitamins are parametric and use a named list of properties to describe them is a pseudo OO style.
-These lists are passed to every function or module related to the vitamin as the first parameter called ```type```.
+These lists are passed to every function or module related to the vitamin as the first parameter called `type`.
 They need to be included in the user code, so that the list names are visible. The functions and modules however only need to be used, not included.
 
 This leads to a pair of files for each vitamin. One with a plural name that defines the objects and then uses the file with a singular name
@@ -216,20 +229,66 @@ These functions take a particular form, so they can be scraped out and added to
 
     function spring_od(type)     = type[1]; //! Outside diameter
 
-Other functions and modules with ```//!``` comments will be added to the documentation as functions and modules.
+Other functions and modules with `//!` comments will be added to the documentation as functions and modules.
 Functions and modules without these special comments are considered private and do not appear in the documentation.
 
-A vitamin announces itself to the BOM by calling the ```vitamin()``` module with a string description composed of two parts separated by a colon.
+A vitamin announces itself to the BOM by calling the `vitamin()` module with a string description composed of two parts separated by a colon.
 The first part is a string representation of the module instantiation.
 This is used in the documentation to show how to instantiate every part available.
-To facilitate this the first element in the type list is the name of the list as a string and is simply accessed as ```type[0]```.
+To facilitate this the first element in the type list is the name of the list as a string and is simply accessed as `type[0]`.
 
 The part of the description after the colon is free format text that appears on the BOM. Since vitamins are listed alphabetically starting the description with the broad
 category of the part and leaving the more refined description to the end generates tidier parts lists.
-For example ```Screw M3 pan x 30mm``` ensures all the screws appear together and are ordered by their diameter before length, although ```M3 x 30mm pan screw``` would be
+For example `Screw M3 pan x 30mm` ensures all the screws appear together and are ordered by their diameter before length, although `M3 x 30mm pan screw` would be
 more natural.
 
 Vitamins are only ever previewed, so they are optimised to draw quickly in F5 and don't need to worry about being manifold.
 In OpenCSG 3D difference and intersection are relatively slow and the negative volumes interfere with nearby objects when they are composed into assemblies. For this reason as much
-as possible is done by unioning primitives and extruded 2D shapes. Any 3D differences or intersections are wrapped in ```render()``` so that CGAL will compute a polyhedron
+as possible is done by unioning primitives and extruded 2D shapes. Any 3D differences or intersections are wrapped in `render()` so that CGAL will compute a polyhedron
 that is cached and reused. This will be very slow the first time it renders but very fast afterwards.
+
+### Panels and Platters
+
+The `stls` and `dxfs` scripts produce a file for each part but often it is desirable to print or route collections of parts laid out together.
+This can be done by adding scad files to folders called `platters` for STL files and `panels` for DXF files.
+These can aggregate and lay out parts by including `NopSCADlib/core.scad` and using modules `use_stl(name)` and `use_dxf(name)`.
+These modules import the already generated singular STL and DXF files, so they are relatively fast. The name does not include the suffix.
+The scad files typically also need to include other files from the project to get the dimensions of the parts to calculate their positions.
+
+The composite part files have the same name as the scad file that generates them, with the suffix changed to `.stl` or `.dxf`.
+
+The generated files are placed in `stls/printed` and `dxfs/routed`.
+Any parts that are not covered by the platters / panels are copied into the `printed` / `routed` directories, so that they contain everything to be made.
+
+### Multiple configurations
+
+Some parametric designs might have several configurations, for example a 3D printer with different size options. If several configurations need to be supported at the
+ same time multiple sets of BOMS, STLS and DXFs need to be generated in separate diectories. NopSCADlib supports this by having multiple configuration files named
+`config_<target_name>.scad`. All the scripts take an optional first parameter that selects one of these config files by specifying `target_name`.
+
+The target config file is selected by generating `target.scad` that includes `config_<target_name>.scad`.
+The rest of the project includes `target.scad` to use the configuration.
+Additionally all the generated file directories (assemblies, bom, stls, dxfs, etc.) are placed in a sub-directory called `<target_name>`.
+
+The build system will look for a `<target_name>_assembly` module and use it as the top level module instead of `main_assembly` if it it exists.
+That allows the project description to be target specific if the top level modules are in different scad files.
+The top level assembly instructions and assembly contents could also be different if appropriate.
+
+If the top level module is just a shell wrapper that simply includes one other assembly, with no additional parts, then it is removed from the build instructions and
+the assembly it calls becomes the top level. This allows a different project description for each target but only one set of top level instructions without repeating them.
+
+### Costed BOMs
+
+A costed bill of materials can be made by opening the generated file `bom/bom.csv` in a spreadsheet program using a single quote as the string delimiter and comma as the field separator.
+That gets a list of part descriptions and quantities to which prices can be added to get the total cost and perhaps a URL of where to buy each part.
+
+If a Python file called `parts.py` is found then `bom.py` will attempt to call functions for each part to get a price and URL.
+Any functions not found are printed, so you can see the format expected.
+The function are passed the quantity to allow them to calculate volume discounts, etc.
+
+### Other libraries
+
+The build scripts need to be able to locate the source files where the modules to generate the STL files and assemblies reside. They will search all the scad files
+in the project plus any `printed` directories outside the project. This covers the printed parts in NopSCADlib but also allows other libraries of printed parts.
+
+Other libraries of vitamins and utilities can be used provided they follow the same convensions of NopSCADlib. The build scripts don't need to search those.

examples/EnviroPlus/bom/RPI_assembly.txt

@@ -0,0 +1,5 @@
+RPI_assembly:
+Vitamins:
+  1 Micro SD card
+  1 Raspberry Pi Zero
+  1 Pin header 20 x 2 right_angle

examples/EnviroPlus/bom/RPI_case_assembly.txt

@@ -0,0 +1,7 @@
+RPI_case_assembly:
+Vitamins:
+  2 Screw M2.5 pan x  6.4mm
+
+Assemblies:
+  1 RPI_assembly
+  1 enviro_case_assembly

examples/EnviroPlus/bom/back_assembly.txt

@@ -0,0 +1,8 @@
+back_assembly:
+Vitamins:
+  1 Fan 17mm x 8mm
+  1 PMS5003 particle detector
+
+Printed:
+  1 enviro_plus_case_base.stl
+  1 fan_duct.stl

examples/EnviroPlus/bom/bom.csv

@@ -0,0 +1,21 @@
+'Micro SD card',  1
+'Fan 17mm x 8mm',  1
+'Heatfit insert M2',  4
+'Nut M2.5 x 2.2mm nyloc',  4
+'Enviro+',  1
+'Raspberry Pi Zero',  1
+'Pin header 20 x 2 right_angle',  1
+'PMS5003 particle detector',  1
+'Screw M2 cap x  6mm',  4
+'Screw M2.5 pan x  6.4mm',  2
+'Screw M2.5 pan x  8mm',  4
+'Screw M3 pan x  6mm',  3
+'SMD capacitor 1206 10uF',  1
+'SMD resistor 0805 3K3 0.125W',  1
+'SOT223 package FZT851',  1
+'Veroboard 6 holes x 6strips',  1
+'Washer  M2 x 5mm x 0.3mm',  4
+'Washer  M2.5 x 5.9mm x 0.5mm',  4
+'Washer  M3 x 7mm x 0.5mm',  3
+'Wire link 0.8mm x 6.5mm',  3
+'Wire link 0.8mm x 0.4"',  1

examples/EnviroPlus/bom/bom.json

@@ -0,0 +1,194 @@
+[
+    {
+        "name": "back_assembly",
+        "big": null,
+        "ngb": false,
+        "zoomed": 0,
+        "count": 1,
+        "assemblies": {},
+        "vitamins": {
+            "pms5003(): PMS5003 particle detector": {
+                "count": 1
+            },
+            "fan(fan17x8): Fan 17mm x 8mm": {
+                "count": 1
+            }
+        },
+        "printed": {
+            "fan_duct.stl": {
+                "count": 1,
+                "colour": "darkorange"
+            },
+            "enviro_plus_case_base.stl": {
+                "count": 1,
+                "colour": "grey"
+            }
+        },
+        "routed": {}
+    },
+    {
+        "name": "RPI_assembly",
+        "big": null,
+        "ngb": false,
+        "zoomed": 0,
+        "count": 1,
+        "assemblies": {},
+        "vitamins": {
+            "pcb(RPI0): Raspberry Pi Zero": {
+                "count": 1
+            },
+            ": Micro SD card": {
+                "count": 1
+            },
+            "pin_header(2p54header, 20, 2, right_angle = true): Pin header 20 x 2 right_angle": {
+                "count": 1
+            }
+        },
+        "printed": {},
+        "routed": {}
+    },
+    {
+        "name": "fan_controller_assembly",
+        "big": null,
+        "ngb": false,
+        "zoomed": 0,
+        "count": 1,
+        "assemblies": {},
+        "vitamins": {
+            "veroboard(fan_vb): Veroboard 6 holes x 6strips": {
+                "count": 1
+            },
+            "wire_link(0.8, 10.16, tail = 2.5): Wire link 0.8mm x 0.4\"": {
+                "count": 1
+            },
+            "wire_link(0.8, 0, h = 4, tail = 2.5): Wire link 0.8mm x 6.5mm": {
+                "count": 3
+            },
+            "smd_resistor(RES0805, 3K3): SMD resistor 0805 3K3 0.125W": {
+                "count": 1
+            },
+            "smd_capacitor(CAP1206): SMD capacitor 1206 10uF": {
+                "count": 1
+            },
+            "smd_sot(SOT223): SOT223 package FZT851": {
+                "count": 1
+            }
+        },
+        "printed": {},
+        "routed": {}
+    },
+    {
+        "name": "enviro_assembly",
+        "big": null,
+        "ngb": false,
+        "zoomed": 0,
+        "count": 1,
+        "assemblies": {
+            "fan_controller_assembly": 1
+        },
+        "vitamins": {
+            "pcb(EnviroPlus): Enviro+": {
+                "count": 1
+            }
+        },
+        "printed": {},
+        "routed": {}
+    },
+    {
+        "name": "case_assembly",
+        "big": null,
+        "ngb": false,
+        "zoomed": 0,
+        "count": 1,
+        "assemblies": {},
+        "vitamins": {
+            "insert(F1BM2): Heatfit insert M2": {
+                "count": 4
+            },
+            "washer(M3_washer): Washer  M3 x 7mm x 0.5mm": {
+                "count": 3
+            },
+            "screw(M3_pan_screw, 6): Screw M3 pan x  6mm": {
+                "count": 3
+            }
+        },
+        "printed": {
+            "enviro_plus_case.stl": {
+                "count": 1,
+                "colour": "grey"
+            },
+            "bulkhead.stl": {
+                "count": 1,
+                "colour": "[0.862745, 0.0784314, 0.235294]"
+            },
+            "foot.stl": {
+                "count": 3,
+                "colour": "darkorange"
+            }
+        },
+        "routed": {}
+    },
+    {
+        "name": "enviro_case_assembly",
+        "big": null,
+        "ngb": false,
+        "zoomed": 0,
+        "count": 1,
+        "assemblies": {
+            "case_assembly": 1,
+            "enviro_assembly": 1
+        },
+        "vitamins": {
+            "screw(M2p5_pan_screw, 8): Screw M2.5 pan x  8mm": {
+                "count": 4
+            },
+            "washer(M2p5_washer): Washer  M2.5 x 5.9mm x 0.5mm": {
+                "count": 4
+            },
+            "nut(M2p5_nut, nyloc = true): Nut M2.5 x 2.2mm nyloc": {
+                "count": 4
+            }
+        },
+        "printed": {},
+        "routed": {}
+    },
+    {
+        "name": "RPI_case_assembly",
+        "big": null,
+        "ngb": false,
+        "zoomed": 0,
+        "count": 1,
+        "assemblies": {
+            "enviro_case_assembly": 1,
+            "RPI_assembly": 1
+        },
+        "vitamins": {
+            "screw(M2p5_pan_screw, 6.4): Screw M2.5 pan x  6.4mm": {
+                "count": 2
+            }
+        },
+        "printed": {},
+        "routed": {}
+    },
+    {
+        "name": "main_assembly",
+        "big": null,
+        "ngb": false,
+        "zoomed": 0,
+        "count": 1,
+        "assemblies": {
+            "RPI_case_assembly": 1,
+            "back_assembly": 1
+        },
+        "vitamins": {
+            "washer(M2_washer): Washer  M2 x 5mm x 0.3mm": {
+                "count": 4
+            },
+            "screw(M2_cap_screw, 6): Screw M2 cap x  6mm": {
+                "count": 4
+            }
+        },
+        "printed": {},
+        "routed": {}
+    }
+]

examples/EnviroPlus/bom/bom.txt

@@ -0,0 +1,53 @@
+Vitamins:
+                   F   
+                   a   
+                   n   
+                E      
+                n  c   
+                v  o   
+    R           i  n   
+    p           r  t   
+    i        E  o  r   
+             n     o   
+    c  B  C  v  c  l  M
+ R  a  a  a  i  a  l  a
+ p  s  c  s  r  s  e  i
+ i  e  k  e  o  e  r  n
+ 1|  |  |  |  |  |  |  |  1 Micro SD card
+  |  | 1|  |  |  |  |  |  1 Fan 17mm x 8mm
+  |  |  | 4|  |  |  |  |  4 Heatfit insert M2
+  |  |  |  |  | 4|  |  |  4 Nut M2.5 x 2.2mm nyloc
+  |  |  |  | 1|  |  |  |  1 Enviro+
+ 1|  |  |  |  |  |  |  |  1 Raspberry Pi Zero
+ 1|  |  |  |  |  |  |  |  1 Pin header 20 x 2 right_angle
+  |  | 1|  |  |  |  |  |  1 PMS5003 particle detector
+  |  |  |  |  |  |  | 4|  4 Screw M2 cap x  6mm
+  | 2|  |  |  |  |  |  |  2 Screw M2.5 pan x  6.4mm
+  |  |  |  |  | 4|  |  |  4 Screw M2.5 pan x  8mm
+  |  |  | 3|  |  |  |  |  3 Screw M3 pan x  6mm
+  |  |  |  |  |  | 1|  |  1 SMD capacitor 1206 10uF
+  |  |  |  |  |  | 1|  |  1 SMD resistor 0805 3K3 0.125W
+  |  |  |  |  |  | 1|  |  1 SOT223 package FZT851
+  |  |  |  |  |  | 1|  |  1 Veroboard 6 holes x 6strips
+  |  |  |  |  |  |  | 4|  4 Washer  M2 x 5mm x 0.3mm
+  |  |  |  |  | 4|  |  |  4 Washer  M2.5 x 5.9mm x 0.5mm
+  |  |  | 3|  |  |  |  |  3 Washer  M3 x 7mm x 0.5mm
+  |  |  |  |  |  | 3|  |  3 Wire link 0.8mm x 6.5mm
+  |  |  |  |  |  | 1|  |  1 Wire link 0.8mm x 0.4"
+
+Printed:
+  |  |  | 1|  |  |  |  |  1 bulkhead.stl
+  |  |  | 1|  |  |  |  |  1 enviro_plus_case.stl
+  |  | 1|  |  |  |  |  |  1 enviro_plus_case_base.stl
+  |  | 1|  |  |  |  |  |  1 fan_duct.stl
+  |  |  | 3|  |  |  |  |  3 foot.stl
+
+Assemblies:
+  1 RPI_assembly
+  1 RPI_case_assembly
+  1 back_assembly
+  1 case_assembly
+  1 enviro_assembly
+  1 enviro_case_assembly
+  1 fan_controller_assembly
+  1 main_assembly

examples/EnviroPlus/bom/case_assembly.txt

@@ -0,0 +1,10 @@
+case_assembly:
+Vitamins:
+  4 Heatfit insert M2
+  3 Screw M3 pan x  6mm
+  3 Washer  M3 x 7mm x 0.5mm
+
+Printed:
+  1 bulkhead.stl
+  1 enviro_plus_case.stl
+  3 foot.stl

examples/EnviroPlus/bom/enviro_assembly.txt

@@ -0,0 +1,6 @@
+enviro_assembly:
+Vitamins:
+  1 Enviro+
+
+Assemblies:
+  1 fan_controller_assembly

examples/EnviroPlus/bom/enviro_case_assembly.txt

@@ -0,0 +1,9 @@
+enviro_case_assembly:
+Vitamins:
+  4 Nut M2.5 x 2.2mm nyloc
+  4 Screw M2.5 pan x  8mm
+  4 Washer  M2.5 x 5.9mm x 0.5mm
+
+Assemblies:
+  1 case_assembly
+  1 enviro_assembly

examples/EnviroPlus/bom/fan_controller_assembly.txt

@@ -0,0 +1,8 @@
+fan_controller_assembly:
+Vitamins:
+  1 SMD capacitor 1206 10uF
+  1 SMD resistor 0805 3K3 0.125W
+  1 SOT223 package FZT851
+  1 Veroboard 6 holes x 6strips
+  3 Wire link 0.8mm x 6.5mm
+  1 Wire link 0.8mm x 0.4"

examples/EnviroPlus/bom/main_assembly.txt

@@ -0,0 +1,8 @@
+main_assembly:
+Vitamins:
+  4 Screw M2 cap x  6mm
+  4 Washer  M2 x 5mm x 0.3mm
+
+Assemblies:
+  1 RPI_case_assembly
+  1 back_assembly

examples/EnviroPlus/readme.md

@@ -0,0 +1,298 @@
+<a name="TOP"></a>
+# EnviroPlus
+Environmental monitor using Enviro+ sensor board and a Raspberry Pi Zero.
+
+![Main Assembly](assemblies/main_assembled.png)
+
+<span></span>
+
+---
+## Table of Contents
+1. [Parts list](#Parts_list)
+1. [Back Assembly](#back_assembly)
+1. [RPI Assembly](#RPI_assembly)
+1. [Fan Controller Assembly](#fan_controller_assembly)
+1. [Enviro Assembly](#enviro_assembly)
+1. [Case Assembly](#case_assembly)
+1. [Enviro Case Assembly](#enviro_case_assembly)
+1. [RPI Case Assembly](#RPI_case_assembly)
+1. [Main Assembly](#main_assembly)
+
+<span></span>
+[Top](#TOP)
+
+---
+<a name="Parts_list"></a>
+## Parts list
+| <span style="writing-mode: vertical-rl; text-orientation: mixed;">Back</span> | <span style="writing-mode: vertical-rl; text-orientation: mixed;">RPI</span> | <span style="writing-mode: vertical-rl; text-orientation: mixed;">Fan&nbsp;Controller</span> | <span style="writing-mode: vertical-rl; text-orientation: mixed;">Enviro</span> | <span style="writing-mode: vertical-rl; text-orientation: mixed;">Case</span> | <span style="writing-mode: vertical-rl; text-orientation: mixed;">Enviro&nbsp;Case</span> | <span style="writing-mode: vertical-rl; text-orientation: mixed;">RPI&nbsp;Case</span> | <span style="writing-mode: vertical-rl; text-orientation: mixed;">Main</span> | <span style="writing-mode: vertical-rl; text-orientation: mixed;">TOTALS</span> |  |
+|---:|---:|---:|---:|---:|---:|---:|---:|---:|:---|
+|  |  |  |  |  |  |  |  | | **Vitamins** |
+| &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;1&nbsp; | &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;.&nbsp; |  &nbsp;&nbsp;1&nbsp; | &nbsp;&nbsp; Enviro+ |
+| &nbsp;&nbsp;1&nbsp; | &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;.&nbsp; |  &nbsp;&nbsp;1&nbsp; | &nbsp;&nbsp; Fan 17mm x 8mm |
+| &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;4&nbsp; | &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;.&nbsp; |  &nbsp;&nbsp;4&nbsp; | &nbsp;&nbsp; Heatfit insert M2 |
+| &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;1&nbsp; | &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;.&nbsp; |  &nbsp;&nbsp;1&nbsp; | &nbsp;&nbsp; Micro SD card |
+| &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;4&nbsp; | &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;.&nbsp; |  &nbsp;&nbsp;4&nbsp; | &nbsp;&nbsp; Nut M2.5 x 2.2mm nyloc |
+| &nbsp;&nbsp;1&nbsp; | &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;.&nbsp; |  &nbsp;&nbsp;1&nbsp; | &nbsp;&nbsp; PMS5003 particle detector |
+| &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;1&nbsp; | &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;.&nbsp; |  &nbsp;&nbsp;1&nbsp; | &nbsp;&nbsp; Pin header 20 x 2 right_angle |
+| &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;1&nbsp; | &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;.&nbsp; |  &nbsp;&nbsp;1&nbsp; | &nbsp;&nbsp; Raspberry Pi Zero |
+| &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;1&nbsp; | &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;.&nbsp; |  &nbsp;&nbsp;1&nbsp; | &nbsp;&nbsp; SMD capacitor 1206 10uF |
+| &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;1&nbsp; | &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;.&nbsp; |  &nbsp;&nbsp;1&nbsp; | &nbsp;&nbsp; SMD resistor 0805 3K3 0.125W |
+| &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;1&nbsp; | &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;.&nbsp; |  &nbsp;&nbsp;1&nbsp; | &nbsp;&nbsp; SOT223 package FZT851 |
+| &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;4&nbsp; |  &nbsp;&nbsp;4&nbsp; | &nbsp;&nbsp; Screw M2 cap x  6mm |
+| &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;2&nbsp; | &nbsp;&nbsp;.&nbsp; |  &nbsp;&nbsp;2&nbsp; | &nbsp;&nbsp; Screw M2.5 pan x  6.4mm |
+| &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;4&nbsp; | &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;.&nbsp; |  &nbsp;&nbsp;4&nbsp; | &nbsp;&nbsp; Screw M2.5 pan x  8mm |
+| &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;3&nbsp; | &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;.&nbsp; |  &nbsp;&nbsp;3&nbsp; | &nbsp;&nbsp; Screw M3 pan x  6mm |
+| &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;1&nbsp; | &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;.&nbsp; |  &nbsp;&nbsp;1&nbsp; | &nbsp;&nbsp; Veroboard 6 holes x 6strips |
+| &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;4&nbsp; |  &nbsp;&nbsp;4&nbsp; | &nbsp;&nbsp; Washer  M2 x 5mm x 0.3mm |
+| &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;4&nbsp; | &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;.&nbsp; |  &nbsp;&nbsp;4&nbsp; | &nbsp;&nbsp; Washer  M2.5 x 5.9mm x 0.5mm |
+| &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;3&nbsp; | &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;.&nbsp; |  &nbsp;&nbsp;3&nbsp; | &nbsp;&nbsp; Washer  M3 x 7mm x 0.5mm |
+| &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;1&nbsp; | &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;.&nbsp; |  &nbsp;&nbsp;1&nbsp; | &nbsp;&nbsp; Wire link 0.8mm x 0.4" |
+| &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;3&nbsp; | &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;.&nbsp; |  &nbsp;&nbsp;3&nbsp; | &nbsp;&nbsp; Wire link 0.8mm x 6.5mm |
+| &nbsp;&nbsp;2&nbsp; | &nbsp;&nbsp;3&nbsp; | &nbsp;&nbsp;8&nbsp; | &nbsp;&nbsp;1&nbsp; | &nbsp;&nbsp;10&nbsp; | &nbsp;&nbsp;12&nbsp; | &nbsp;&nbsp;2&nbsp; | &nbsp;&nbsp;8&nbsp; | &nbsp;&nbsp;46&nbsp; | &nbsp;&nbsp;Total vitamins count |
+|  |  |  |  |  |  |  |  | | **3D printed parts** |
+| &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;1&nbsp; | &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;.&nbsp; |  &nbsp;&nbsp;1&nbsp; | &nbsp;&nbsp;bulkhead.stl |
+| &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;1&nbsp; | &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;.&nbsp; |  &nbsp;&nbsp;1&nbsp; | &nbsp;&nbsp;enviro_plus_case.stl |
+| &nbsp;&nbsp;1&nbsp; | &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;.&nbsp; |  &nbsp;&nbsp;1&nbsp; | &nbsp;&nbsp;enviro_plus_case_base.stl |
+| &nbsp;&nbsp;1&nbsp; | &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;.&nbsp; |  &nbsp;&nbsp;1&nbsp; | &nbsp;&nbsp;fan_duct.stl |
+| &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;3&nbsp; | &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;.&nbsp; |  &nbsp;&nbsp;3&nbsp; | &nbsp;&nbsp;foot.stl |
+| &nbsp;&nbsp;2&nbsp; | &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;5&nbsp; | &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;7&nbsp; | &nbsp;&nbsp;Total 3D printed parts count |
+
+<span></span>
+[Top](#TOP)
+
+---
+<a name="back_assembly"></a>
+## Back Assembly
+### Vitamins
+|Qty|Description|
+|---:|:----------|
+|1| Fan 17mm x 8mm|
+|1| PMS5003 particle detector|
+
+
+### 3D Printed parts
+
+| 1 x enviro_plus_case_base.stl | 1 x fan_duct.stl |
+|---|---|
+| ![enviro_plus_case_base.stl](stls/enviro_plus_case_base.png) | ![fan_duct.stl](stls/fan_duct.png) 
+
+
+
+### Assembly instructions
+![back_assembly](assemblies/back_assembly.png)
+
+1. Print the fan duct in flexible TPE with low infill.
+1. Slide the pms5003 into the printed receptacle with the fan to the outside. Secure with tape if it is loose.
+1. Slide the fan into the fan duct.
+1. Slide the fan duct into the printed recepacle.
+
+![back_assembled](assemblies/back_assembled.png)
+
+<span></span>
+[Top](#TOP)
+
+---
+<a name="RPI_assembly"></a>
+## RPI Assembly
+### Vitamins
+|Qty|Description|
+|---:|:----------|
+|1| Micro SD card|
+|1| Pin header 20 x 2 right_angle|
+|1| Raspberry Pi Zero|
+
+
+### Assembly instructions
+![RPI_assembly](assemblies/RPI_assembly_tn.png)
+
+* Solder a right angle connector to the Raspberry Pi Zero.
+
+![RPI_assembled](assemblies/RPI_assembled_tn.png)
+
+<span></span>
+[Top](#TOP)
+
+---
+<a name="fan_controller_assembly"></a>
+## Fan Controller Assembly
+### Vitamins
+|Qty|Description|
+|---:|:----------|
+|1| SMD capacitor 1206 10uF|
+|1| SMD resistor 0805 3K3 0.125W|
+|1| SOT223 package FZT851|
+|1| Veroboard 6 holes x 6strips|
+|1| Wire link 0.8mm x 0.4"|
+|3| Wire link 0.8mm x 6.5mm|
+
+
+### Assembly instructions
+![fan_controller_assembly](assemblies/fan_controller_assembly_tn.png)
+
+The fan controller is a single transistor wired as a Miller integrator that effectively multiplies the capacitor value by the gain of the transistor.
+It converts the PWM signal on GPI4 to a stead DC voltage so that the fan doesn't whine, or stutter.
+
+![Schematic](docs/fan_controller.jpg)
+
+***
+* Make two track cuts as shown, one wide and the other narrow.
+
+![TrackCuts](docs/cuts.jpg)
+
+1. Add the SMT compeonents and then the wire links.
+1. Add more solder around the transistor to act as a heatsink.
+
+![SMT](docs/smt.jpg)
+
+
+![fan_controller_assembled](assemblies/fan_controller_assembled_tn.png)
+
+<span></span>
+[Top](#TOP)
+
+---
+<a name="enviro_assembly"></a>
+## Enviro Assembly
+### Vitamins
+|Qty|Description|
+|---:|:----------|
+|1| Enviro+|
+
+
+### Sub-assemblies
+
+| 1 x fan_controller_assembly |
+|---|
+| ![fan_controller_assembled](assemblies/fan_controller_assembled_tn.png) 
+
+
+
+### Assembly instructions
+![enviro_assembly](assemblies/enviro_assembly_tn.png)
+
+* Solder the fan_controller to the Enviro+ expansion connector at the 5V, GND and #4 pins.
+
+![enviro_assembled](assemblies/enviro_assembled_tn.png)
+
+<span></span>
+[Top](#TOP)
+
+---
+<a name="case_assembly"></a>
+## Case Assembly
+### Vitamins
+|Qty|Description|
+|---:|:----------|
+|4| Heatfit insert M2|
+|3| Screw M3 pan x  6mm|
+|3| Washer  M3 x 7mm x 0.5mm|
+
+
+### 3D Printed parts
+
+| 1 x bulkhead.stl | 1 x enviro_plus_case.stl | 3 x foot.stl |
+|---|---|---|
+| ![bulkhead.stl](stls/bulkhead.png) | ![enviro_plus_case.stl](stls/enviro_plus_case.png) | ![foot.stl](stls/foot.png) 
+
+
+
+### Assembly instructions
+![case_assembly](assemblies/case_assembly.png)
+
+1. Solvent weld or glue the bulkhead into the recess in the bottom of the case.
+1. Fit the heatfit inserts with a soldering iron with a conical bit heated to about 200&deg;C.
+1. Tap the three holes for the feet with an M3 tap.
+1. Screw on the three feet with M3 x 6mm pan screws and washers.
+
+![case_assembled](assemblies/case_assembled.png)
+
+<span></span>
+[Top](#TOP)
+
+---
+<a name="enviro_case_assembly"></a>
+## Enviro Case Assembly
+### Vitamins
+|Qty|Description|
+|---:|:----------|
+|4| Nut M2.5 x 2.2mm nyloc|
+|4| Screw M2.5 pan x  8mm|
+|4| Washer  M2.5 x 5.9mm x 0.5mm|
+
+
+### Sub-assemblies
+
+| 1 x case_assembly | 1 x enviro_assembly |
+|---|---|
+| ![case_assembled](assemblies/case_assembled_tn.png) | ![enviro_assembled](assemblies/enviro_assembled_tn.png) 
+
+
+
+### Assembly instructions
+![enviro_case_assembly](assemblies/enviro_case_assembly.png)
+
+* Screw the Enviro+ PCB to the front of the case using M2.5 x 8mm pan screws with washer and nuts on the inside.
+
+![enviro_case_assembled](assemblies/enviro_case_assembled.png)
+
+<span></span>
+[Top](#TOP)
+
+---
+<a name="RPI_case_assembly"></a>
+## RPI Case Assembly
+### Vitamins
+|Qty|Description|
+|---:|:----------|
+|2| Screw M2.5 pan x  6.4mm|
+
+
+### Sub-assemblies
+
+| 1 x RPI_assembly | 1 x enviro_case_assembly |
+|---|---|
+| ![RPI_assembled](assemblies/RPI_assembled_tn.png) | ![enviro_case_assembled](assemblies/enviro_case_assembled_tn.png) 
+
+
+
+### Assembly instructions
+![RPI_case_assembly](assemblies/RPI_case_assembly.png)
+
+* Plug the RPi into the Enviro+ socket and secure with two screws self tapped into the bosses in the case.
+
+![RPI_case_assembled](assemblies/RPI_case_assembled.png)
+
+<span></span>
+[Top](#TOP)
+
+---
+<a name="main_assembly"></a>
+## Main Assembly
+### Vitamins
+|Qty|Description|
+|---:|:----------|
+|4| Screw M2 cap x  6mm|
+|4| Washer  M2 x 5mm x 0.3mm|
+
+
+### Sub-assemblies
+
+| 1 x RPI_case_assembly | 1 x back_assembly |
+|---|---|
+| ![RPI_case_assembled](assemblies/RPI_case_assembled_tn.png) | ![back_assembled](assemblies/back_assembled_tn.png) 
+
+
+
+### Assembly instructions
+![main_assembly](assemblies/main_assembly.png)
+
+* Solder the fan wires to the veroboard assembly
+
+![FanWires](docs/fan_connection.jpg)
+
+* Slide the back assembly into the case and secure with four M2 x 6mm cap screws and washers.
+
+![main_assembled](assemblies/main_assembled.png)
+
+<span></span>
+[Top](#TOP)

examples/EnviroPlus/scad/fan_controller.scad

@@ -0,0 +1,45 @@
+//
+//! Environmental monitor using Enviro+ sensor board and a Raspberry Pi Zero.
+//
+// GNU GPL v2
+// nop.head@gmail.com
+// hydraraptor.blogspot.com
+//
+// Top level model
+//
+
+include <NopSCADlib/core.scad>
+use <NopSCADlib/vitamins/veroboard.scad>
+include <NopSCADlib/vitamins/smds.scad>
+
+fan_vb = vero("fan_vb", "fan_controller", 6, 6, breaks = [[2, 1], [2 + eps, 5]],
+    components = [
+        [5, 3,    90, "link", inch(0.4), undef, undef, 2.5],
+        [0, 5,     0, "link", 0, 4, undef, 2.5],
+        [0, 1,     0, "link", 0, 4, undef, 2.5],
+        [0, 0,     0, "link", 0, 4, undef, 2.5],
+        [2, 5,     0, "-smd_res", RES0805, "3K3"],
+        [4, 4.7,  90, "-smd_cap", CAP1206, 1.2, "10uF"],
+        [2, 2.5, 180, "-smd_sot", SOT223, "FZT851"],
+    ],
+    joints = [[5, 1], [5, 5], [0, [0, 1, 5]]]
+ );
+
+//! The fan controller is a single transistor wired as a Miller integrator that effectively multiplies the capacitor value by the gain of the transistor.
+//! It converts the PWM signal on GPI4 to a stead DC voltage so that the fan doesn't whine, or stutter.
+//!
+//! ![Schematic](docs/fan_controller.jpg)
+//!
+//! ***
+//! * Make two track cuts as shown, one wide and the other narrow.
+//!
+//! ![TrackCuts](docs/cuts.jpg)
+//!
+//! 1. Add the SMT compeonents and then the wire links.
+//! 1. Add more solder around the transistor to act as a heatsink.
+//!
+//! ![SMT](docs/smt.jpg)
+//!
+module fan_controller_assembly() rotate(90) vflip(!exploded()) veroboard_assembly(fan_vb, -vero_thickness(fan_vb) - 1.4, 0);
+
+fan_controller_assembly();

examples/EnviroPlus/scad/main.scad

@@ -0,0 +1,518 @@
+//
+//! Environmental monitor using Enviro+ sensor board and a Raspberry Pi Zero.
+//
+// GNU GPL v2
+// nop.head@gmail.com
+// hydraraptor.blogspot.com
+//
+// Top level model
+//
+$explode = 0; // [0, 1]
+assembly = "main"; // [main, back, RPI, case, enviro_case, RPI_case]
+
+/* [Hidden] */
+
+show_box = true;
+show_enviroplus = true;
+$pp1_colour = "grey";
+$extrusion_width = 0.5;
+
+include <NopSCADlib/core.scad>
+include <NopSCADlib/vitamins/pin_headers.scad>
+include <NopSCADlib/vitamins/pcbs.scad>
+include <NopSCADlib/vitamins/fans.scad>
+
+use <NopSCADlib/vitamins/insert.scad>
+use <NopSCADlib/vitamins/veroboard.scad>
+use <NopSCADlib/utils/round.scad>
+use <NopSCADlib/printed/foot.scad>
+use <NopSCADlib/printed/printed_box.scad>
+use <fan_controller.scad>
+
+rpi = RPI0;
+pcb = EnviroPlus;
+fan = fan17x8;
+foot = Foot(d = 13, h = 5, t = 2, r = 1, screw = M3_pan_screw);
+module foot_stl() foot(foot);
+
+rpi_offset = [0, -pcb_width(pcb) / 2 + 0.5, pcb_width(rpi) / 2 + 8.6];
+rpi_holes = [0, 1];
+wall = 2;
+top_thickness = 2;
+base_thickness = 2;
+case_inner_rad = 8;
+
+width = pcb_length(pcb) + 9 + 10;
+pcb_x = -(width - pcb_length(pcb) - 9) / 2;
+depth = pcb_width(pcb) + 9;
+height = pcb_width(rpi) / 2 + rpi_offset.z + 9;
+bulkhead_outset = 2;
+bulkhead_inset = 0.5;
+bulkhead_t = 2;
+clearance = 0.1;
+pcb_screw = alternate_screw(hs_pan, pcb_screw(pcb));
+
+box = pbox(name = "enviro_plus_case", wall = wall, top_t = top_thickness, base_t = base_thickness, screw = M2_cap_screw, radius = case_inner_rad, ridges = [8, 1],
+    size = [width,  depth, height]);
+
+pms5003 = [50, 38, 21];
+pms5003_wall = 1;
+pms5003_pos = [width / 2 - pms5003.x / 2 - pms5003_wall - pbox_screw_inset(box) - insert_boss_radius(screw_insert(pbox_screw(box)), wall) - 0.5,
+               depth / 2 - pms5003.z / 2 - wall - 1,
+               height + top_thickness - pms5003.y / 2];
+
+
+fan_duct_t = 1.7;
+foam_t = 0;
+fan_pos = [pms5003_pos.x - pms5003.x / 2 - pms5003_wall - fan_width(fan) / 2 - fan_duct_t, 1 + foam_t, 12 + top_thickness + fan_depth(fan) / 2];
+fan_socket = 8;
+
+module fan_shape() {
+    w = fan_width(fan);
+    p = fan_hole_pitch(fan);
+    r = w / 2 - p;
+
+    rounded_square([w, w], r);
+}
+
+module fan_duct_stl() {
+    module frame(z, offset, y = -fan_pos.y)
+        translate([0, y, z])
+            linear_extrude(height = eps)
+                offset(offset)
+                    fan_shape();
+
+    z = height + top_thickness - fan_pos.z + fan_depth(fan) / 2 - fan_socket;
+
+    translate([0, -fan_pos.y, z])
+        linear_extrude(height = fan_socket)
+            difference() {
+                fan_shape();
+
+                round(1)
+                    offset(-fan_duct_t)
+                        fan_shape();
+            }
+
+    stl("fan_duct") union() {
+        difference() {
+            hull() {
+                frame(z, 0);
+
+                frame(fan_depth(fan), fan_duct_t + foam_t, 0);
+            }
+            hull() {
+                frame(z, -fan_duct_t);
+
+                frame(fan_depth(fan), foam_t -extrusion_width / 2, 0);
+            }
+        }
+
+        linear_extrude(height = fan_depth(fan))
+            difference() {
+                offset(fan_duct_t + foam_t)
+                    fan_shape();
+
+                offset(foam_t)
+                    fan_shape();
+            }
+    }
+}
+
+module pms5003() {
+    vitamin("pms5003(): PMS5003 particle detector");
+
+    w = pms5003.x;
+    d = pms5003.y;
+    h = pms5003.z;
+    t = 0.1;
+    color("silver")
+        difference() {
+            linear_extrude(height = h, center = true)
+                difference() {
+                    square([w, d], center = true);
+
+                    for(x = [-1, 1], y = [-1, 1])
+                        translate([x * w / 2, y * d / 2])
+                            square(2, center = true);
+                }
+            cube([w + 2 * eps, d + 2 * eps, t * 2], center = true);
+         }
+
+    color("black")
+        rounded_rectangle([w - 2 * t, d - 2 * t, h - 2 * t], r = 1, center = true);
+}
+
+module pcb_shape(offset)
+    rounded_square([pcb_length(pcb) + 2 * offset, pcb_width(pcb) + 2 * offset], pcb_radius(pcb) + offset);
+
+module gap() {
+    gap = pcb_component_position(pcb, "-chip");
+
+    translate([gap.x, -gap.y])
+        square([17.5, 20], center = true);
+}
+
+module rpi_holes()
+    for(i = rpi_holes) {
+        hole = pcb_coord(rpi, pcb_holes(rpi)[i]);
+        translate([hole.x, rpi_offset.y, -hole.y + rpi_offset.z + top_thickness])
+            rotate([90, 0, 0])
+                children();
+    }
+
+module feet_positions() {
+    clearance = 2;
+    foot_r = foot_diameter(foot) / 2;
+    x_inset = case_inner_rad + foot_r - pbox_ridges(box).y;
+    z_inset = foot_r + clearance;
+    h = height + base_thickness;
+
+    for(p = [[-1, -1], [1, -1], [0, 1]])
+        translate([p.x * (width / 2 - x_inset), depth / 2 + wall + pbox_ridges(box).y, top_thickness + h / 2 + p.y * (h / 2 - z_inset)])
+            rotate([90, 0, 0])
+                children();
+}
+
+module slots(h = 10, expand = 0) {
+    for(comp = [["uSD", 2, 11, 0.7], ["flat_flex", 1, 12, 0.5]]) {
+        p = pcb_component_position(rpi, comp[0]);
+        translate([sign(p.x) * (width / 2 + wall / 2 + pbox_ridges(box).y / 2), rpi_offset.y + pcb_thickness(rpi) + comp[3], top_thickness + rpi_offset.z - p.y])
+            rotate([90, 0, 90])
+                hull() {
+                    vertical_tearslot(r = comp[1] + expand, l = comp[2], h = h);
+
+                    if(expand)
+                         vertical_tearslot(r = comp[1] + expand + h / 2, l = comp[2], h = eps);
+                }
+     }
+}
+
+module box_internal_additions() {
+    translate([pcb_x, 0]) {
+        linear_extrude(height = top_thickness + bulkhead_t)
+            difference() {
+                pcb_shape(bulkhead_outset + wall + pbox_ridges(box).y + eps);
+
+                gap();
+
+                pcb_shape(bulkhead_outset + clearance);
+            }
+
+        rpi_holes()
+            hull() {
+                wall = 1.8;
+                r =  screw_radius(pcb_screw) + wall;
+                z = depth / 2 + rpi_offset.y + pbox_ridges(box).y + eps;
+                offset = max(r, z);
+                cylinder(r =r, h = z);
+
+                translate([0, -offset - r, z])
+                    cube(eps);
+            }
+    }
+    d = washer_diameter(screw_washer(foot_screw(foot))) + 1;
+    h = pbox_ridges(box).y;
+    feet_positions()
+        translate_z(wall - eps)
+            cylinder(d2 = d, d1 = d + 2 * h, h = h);
+
+    slots(wall + pbox_ridges(box).y + eps, 1);
+}
+
+module box_external_additions() {
+    amp = pbox_ridges(box).y + eps;
+    d = foot_diameter(foot) + 1;
+    feet_positions()
+        cylinder(d1 = d, d2 = d + 2 * amp, h = amp);
+
+    slots(wall + pbox_ridges(box).y + eps, 1);
+}
+
+
+module box_holes() {
+    translate([pcb_x, 0]) {
+        linear_extrude(height = top_thickness + eps)
+            pcb_shape(clearance);
+
+        rpi_holes()
+            teardrop_plus(r = screw_pilot_hole(pcb_screw), h = 7 - 1.6, center = false);
+    }
+    feet_positions()
+        teardrop(r = screw_pilot_hole(foot_screw(foot)), h = 10, center = true);
+
+    grills = 7;
+    bar = 1.6;
+    x = pcb_x + pcb_length(pcb) / 2 + 2 * wall +  pbox_ridges(box).y + 2 * eps;
+    w = width / 2 - x;
+    d = depth - case_inner_rad;
+    pitch = d / (grills - 1);
+    for(i = [0 : grills -1])
+        let(w = i == 0 || i == grills -1 ? w - 1 : w)
+            translate([x + w / 2, -d / 2 + i * pitch])
+                rounded_rectangle([w, pitch - bar, 10], 1);
+
+    slots();
+}
+
+module bulkhead_stl() {
+    holes = pcb_holes(pcb);
+    pitch = max([for(h = holes) pcb_coord(pcb, h).x]) - min([for(h = holes)  pcb_coord(pcb, h).x]);
+    boss_r = (pitch - 51.4) / 2;
+
+    stl("bulkhead")
+        linear_extrude(height = bulkhead_t)
+            difference() {
+                pcb_shape(bulkhead_outset);
+
+                gap();
+
+                difference() {
+                    pcb_shape(-bulkhead_inset);
+
+                    pcb_screw_positions(pcb)
+                        rotate($i * 90)
+                            hull() {
+                                circle(boss_r);
+
+                                translate([boss_r - eps, -boss_r])
+                                    square([eps, boss_r]);
+
+                                translate([-boss_r, boss_r - eps])
+                                    square([boss_r, eps]);
+
+                                translate([-boss_r, -boss_r])
+                                    square(eps);
+                            }
+                }
+
+                pcb_screw_positions(pcb)
+                    poly_circle(screw_clearance_radius(pcb_screw));
+            }
+}
+
+module enviro_plus_case_stl() {
+     pbox(box) {
+        box_internal_additions();
+        box_holes();
+        box_external_additions();
+     }
+}
+
+module base_additions() {
+    w = pms5003.x + clearance;
+    d = pms5003.z + clearance;
+    wall = pms5003_wall;
+
+    translate([pms5003_pos.x, -pms5003_pos.y])
+        linear_extrude(height = base_thickness + pms5003.y)
+            difference() {
+                square([w + 2 * wall, d + 2 * wall], center = true);
+                square([w, d], center = true);
+            }
+
+    translate([fan_pos.x, 0])
+        linear_extrude(height = top_thickness + fan_socket)
+            difference() {
+                offset(wall)
+                    fan_shape();
+
+                fan_shape();
+            }
+}
+
+module base_holes() {
+    for(i = [0 : 1]) {
+        p = pcb_component_position(rpi, "usb_uA", i);
+        translate([p.x + pcb_x, -rpi_offset.y - pcb_thickness(rpi) - 1.3])
+            rounded_rectangle([11,7, 100], 0.5, true);
+    }
+
+    translate([pms5003_pos.x, -pms5003_pos.y])
+        rounded_rectangle([pms5003.x - 2 ,pms5003.z - 2, 100], 2, true);
+
+    translate([fan_pos.x, 0])
+        linear_extrude(height = 2 * base_thickness + eps, center = true)
+            round(1)
+                offset(-fan_duct_t)
+                    fan_shape();
+}
+
+module enviro_plus_case_base_stl()
+    pbox_base(box) {
+        base_additions();
+        base_holes();
+    }
+
+//! * Solder a right angle connector to the Raspberry Pi Zero.
+module RPI_assembly()
+assembly("RPI") {
+    pcb(rpi);
+
+    pcb_grid(rpi, 9.5, 0.5, -0.6)
+        rotate(180)
+            explode(20)
+                pin_header(2p54header, 20, 2, right_angle = true);
+}
+
+//! 1. Solvent weld or glue the bulkhead into the recess in the bottom of the case.
+//! 1. Fit the heatfit inserts with a soldering iron with a conical bit heated to about 200&deg;C.
+//! 1. Tap the three holes for the feet with an M3 tap.
+//! 1. Screw on the three feet with M3 x 6mm pan screws and washers.
+module case_assembly() pose([ 29.60, 0.00, 158.00 ], exploded = true) pose([ 198.00, 0.00, 352.80 ], exploded = false)
+assembly("case") {
+    if(show_box)
+        stl_colour(pp1_colour) render() enviro_plus_case_stl();
+    else
+        render() difference() {
+            enviro_plus_case_stl();
+
+            translate_z(height / 2)
+                cube([100, 100, height - 20], center = true);
+        }
+
+    pbox_inserts(box);
+
+    translate([pcb_x, 0, top_thickness])
+        explode(20)
+            stl_colour(pp2_colour) render() bulkhead_stl();
+
+    feet_positions() {
+        foot_assembly(0, foot);
+
+        vflip()
+            explode(20, explode_children = true)
+                translate_z(foot_thickness(foot))
+                    screw_and_washer(foot_screw(foot), 6);
+    }
+
+}
+
+//! * Solder the fan_controller to the Enviro+ expansion connector at the 5V, GND and #4 pins.
+module enviro_assembly() hflip(exploded())
+assembly("enviro") {
+    if(show_enviroplus)
+        pcb(pcb);
+
+    pcb_grid(pcb, 5.5, 2.5, -pcb_thickness(pcb)) {
+        hflip()
+            explode(15)
+                fan_controller_assembly();
+    }
+    if(!exploded())
+        for(x = [8, 7, 3])
+            pcb_grid(pcb, x, 0, 0.05)
+                solder_meniscus(pcb, 0.39, 1);
+}
+
+//! * Screw the Enviro+ PCB to the front of the case using M2.5 x 8mm pan screws with washer and nuts on the inside.
+module enviro_case_assembly() pose([ 231.40, 0.00, 1.20 ])
+assembly("enviro_case") {
+    case_assembly();
+
+    translate([pcb_x, 0, top_thickness])
+        vflip() explode(20, explode_children = true) {
+            t = pcb_thickness(pcb);
+            nut = screw_nut(pcb_screw);
+            washer = screw_washer(pcb_screw);
+
+            no_explode() enviro_assembly();
+
+            pcb_screw_positions(pcb) {
+                translate_z(t)
+                    screw(pcb_screw, screw_longer_than(t + bulkhead_t + nut_thickness(nut, true) + washer_thickness(washer)));
+
+                translate_z(-bulkhead_t)
+                    vflip()
+                        explode(20, explode_children = true)
+                            nut_and_washer(nut, true);
+            }
+        }
+}
+
+//! * Plug the RPi into the Enviro+ socket and secure with two screws self tapped into the bosses in the case.
+module RPI_case_assembly() pose([ 20.50, 0.00, 153.30 ])
+assembly("RPI_case") {
+    enviro_case_assembly();
+
+    translate([pcb_x, 0]) {
+        translate_z(top_thickness) {
+
+            translate(rpi_offset)
+                rotate([-90, 0, 0])
+                    RPI_assembly();
+        }
+        rpi_holes()
+            vflip()
+                translate_z(pcb_thickness(rpi))
+                    screw(pcb_screw, 6.4);
+    }
+}
+
+//! 1. Print the fan duct in flexible TPE with low infill.
+//! 1. Slide the pms5003 into the printed receptacle with the fan to the outside. Secure with tape if it is loose.
+//! 1. Slide the fan into the fan duct.
+//! 1. Slide the fan duct into the printed recepacle.
+module back_assembly() pose([ 228.60, 0.00, 24.30 ])
+assembly("back") {
+    translate(pms5003_pos)
+        explode(-50)
+            rotate([90, 0, 0])
+                pms5003();
+
+    explode(-20, explode_children = true)
+        translate(fan_pos) {
+            explode(-20)
+                fan(fan);
+
+            translate_z(-fan_depth(fan) / 2)
+                stl_colour(pp4_colour)
+                    render()
+                        fan_duct_stl();
+        }
+
+    translate_z(height + top_thickness + base_thickness + eps) vflip()
+        stl_colour(show_box ? pp1_colour : pp2_colour) render() enviro_plus_case_base_stl();
+}
+
+//! * Solder the fan wires to the veroboard assembly
+//!
+//! ![FanWires](docs/fan_connection.jpg)
+//!
+//! * Slide the back assembly into the case and secure with four M2 x 6mm cap screws and washers.
+module main_assembly() pose([170, 335, 0], exploded = false) pose([ 42.20, 0.00, 159.60 ], exploded = true)
+assembly("main") {
+    RPI_case_assembly();
+
+    explode(20, explode_children = true) {
+        pbox_base_screws(box);
+
+        back_assembly();
+    }
+}
+
+if($preview) {
+    if(assembly == "main")
+        main_assembly();
+    else if(assembly == "case")
+        case_assembly();
+    else if(assembly == "back")
+        back_assembly();
+    else if(assembly == "RPI")
+        RPI_assembly();
+    else if(assembly == "RPI_case")
+        RPI_case_assembly();
+    else if(assembly == "enviro_case")
+        enviro_case_assembly();
+}
+else {
+    gap = 5;
+
+    enviro_plus_case_stl();
+
+    translate([0, -depth - gap])
+        enviro_plus_case_base_stl();
+
+    translate([0, -2 * (depth + gap)])
+        bulkhead_stl();
+}

examples/MainsBreakOutBox/bom/bom.csv

@@ -0,0 +1,16 @@
+'Ferrule for 1.5mm^2 wire - not shown',  3
+'Wire blue 30/0.25mm strands, length 150mm - not shown',  2
+'Wire brown 30/0.25mm strands, length 150mm - not shown',  2
+'Wire green & yellow 30/0.25mm strands, length 150mm - not shown',  2
+'IEC inlet for ATX',  1
+'Heatfit insert M3',  2
+'4mm shielded jack socket blue',  2
+'4mm shielded jack socket brown',  1
+'4mm shielded jack socket green',  2
+'Mains socket 13A',  1
+'Nut M3 x 2.4mm nyloc',  6
+'Screw M3 cs cap x 12mm',  2
+'Screw M3 cs cap x 20mm',  2
+'Screw M3 dome x 10mm',  4
+'Heatshrink sleeving ID 3.2mm x 15mm - not shown',  8
+'Washer  M3 x 7mm x 0.5mm', 10

examples/MainsBreakOutBox/bom/bom.json

@@ -1,67 +1,127 @@
 [
     {
         "name": "base_assembly",
+        "big": null,
+        "ngb": false,
+        "zoomed": 0,
         "count": 1,
         "assemblies": {},
         "vitamins": {
-            "insert(F1BM3): Heatfit insert M3": 2
+            "insert(F1BM3): Heatfit insert M3": {
+                "count": 2
+            }
         },
         "printed": {
-            "socket_box.stl": 1
+            "socket_box.stl": {
+                "count": 1,
+                "colour": "dimgrey"
+            }
         },
         "routed": {}
     },
     {
         "name": "feet_assembly",
+        "big": null,
+        "ngb": false,
+        "zoomed": 0,
         "count": 1,
         "assemblies": {
             "base_assembly": 1
         },
         "vitamins": {
-            "washer(M3_washer): Washer  M3 x 7mm x 0.5mm": 8,
-            "screw(M3_dome_screw, 10): Screw M3 dome x 10mm": 4,
-            "nut(M3_nut, nyloc = true): Nut M3 x 2.4mm nyloc": 4
+            "washer(M3_washer): Washer  M3 x 7mm x 0.5mm": {
+                "count": 8
+            },
+            "screw(M3_dome_screw, 10): Screw M3 dome x 10mm": {
+                "count": 4
+            },
+            "nut(M3_nut, nyloc = true): Nut M3 x 2.4mm nyloc": {
+                "count": 4
+            }
         },
         "printed": {
-            "foot.stl": 4
+            "foot.stl": {
+                "count": 4,
+                "colour": "darkorange"
+            }
         },
         "routed": {}
     },
     {
         "name": "mains_in_assembly",
+        "big": null,
+        "ngb": false,
+        "zoomed": 0,
         "count": 1,
         "assemblies": {
             "feet_assembly": 1
         },
         "vitamins": {
-            ": Wire green & yellow 30/0.25mm strands, length 150mm - not shown": 1,
-            ": Wire blue 30/0.25mm strands, length 150mm - not shown": 1,
-            ": Wire brown 30/0.25mm strands, length 150mm - not shown": 2,
-            "tubing(HSHRNK32): Heatshrink sleeving ID 3.2mm x 15mm - not shown": 3,
-            "iec(IEC_inlet_atx): IEC inlet for ATX": 1,
-            "screw(M3_cs_cap_screw, 12): Screw M3 cs cap x 12mm": 2,
-            "washer(M3_washer): Washer  M3 x 7mm x 0.5mm": 2,
-            "nut(M3_nut, nyloc = true): Nut M3 x 2.4mm nyloc": 2
+            ": Wire green & yellow 30/0.25mm strands, length 150mm - not shown": {
+                "count": 1
+            },
+            ": Wire blue 30/0.25mm strands, length 150mm - not shown": {
+                "count": 1
+            },
+            ": Wire brown 30/0.25mm strands, length 150mm - not shown": {
+                "count": 2
+            },
+            "tubing(HSHRNK32): Heatshrink sleeving ID 3.2mm x 15mm - not shown": {
+                "count": 3
+            },
+            "iec(IEC_inlet_atx): IEC inlet for ATX": {
+                "count": 1
+            },
+            "screw(M3_cs_cap_screw, 12): Screw M3 cs cap x 12mm": {
+                "count": 2
+            },
+            "washer(M3_washer): Washer  M3 x 7mm x 0.5mm": {
+                "count": 2
+            },
+            "nut(M3_nut, nyloc = true): Nut M3 x 2.4mm nyloc": {
+                "count": 2
+            }
         },
         "printed": {},
         "routed": {}
     },
     {
         "name": "main_assembly",
+        "big": null,
+        "ngb": false,
+        "zoomed": 0,
         "count": 1,
         "assemblies": {
             "mains_in_assembly": 1
         },
         "vitamins": {
-            ": Wire green & yellow 30/0.25mm strands, length 150mm - not shown": 1,
-            ": Wire blue 30/0.25mm strands, length 150mm - not shown": 1,
-            "tubing(HSHRNK32): Heatshrink sleeving ID 3.2mm x 15mm - not shown": 5,
-            ": Ferrule for 1.5mm^2 wire - not shown": 3,
-            "mains_socket(Contactum): Mains socket 13A": 1,
-            "screw(M3_cs_cap_screw, 20): Screw M3 cs cap x 20mm": 2,
-            "jack_4mm_shielded(\"blue\", 3, \"royalblue\"): 4mm shielded jack socket blue": 2,
-            "jack_4mm_shielded(\"brown\", 3, \"sienna\"): 4mm shielded jack socket brown": 1,
-            "jack_4mm_shielded(\"green\", 3): 4mm shielded jack socket green": 2
+            ": Wire green & yellow 30/0.25mm strands, length 150mm - not shown": {
+                "count": 1
+            },
+            ": Wire blue 30/0.25mm strands, length 150mm - not shown": {
+                "count": 1
+            },
+            "tubing(HSHRNK32): Heatshrink sleeving ID 3.2mm x 15mm - not shown": {
+                "count": 5
+            },
+            ": Ferrule for 1.5mm^2 wire - not shown": {
+                "count": 3
+            },
+            "mains_socket(Contactum): Mains socket 13A": {
+                "count": 1
+            },
+            "screw(M3_cs_cap_screw, 20): Screw M3 cs cap x 20mm": {
+                "count": 2
+            },
+            "jack_4mm_shielded(\"blue\", 3, \"royalblue\"): 4mm shielded jack socket blue": {
+                "count": 2
+            },
+            "jack_4mm_shielded(\"brown\", 3, \"sienna\"): 4mm shielded jack socket brown": {
+                "count": 1
+            },
+            "jack_4mm_shielded(\"green\", 3): 4mm shielded jack socket green": {
+                "count": 2
+            }
         },
         "printed": {},
         "routed": {}

examples/MainsBreakOutBox/platters/all.scad

@@ -0,0 +1,11 @@
+include <NopSCADlib/core.scad>
+
+*use_stl("socket_box"); // Importing the STL gives a CGAL error although NetFabb finds nothing wrong with it.
+
+use <../scad/bob_main.scad>
+
+render() socket_box_stl();
+
+for(i = [0 : 3])
+    translate([i * 25 - 1.5 * 25, -70])
+        use_stl("foot");

examples/MainsBreakOutBox/readme.md

@@ -15,6 +15,7 @@ Earth leakage can be measured Canadian CSA style by disconnected the neutral lin
 
 ![Main Assembly](assemblies/main_assembled.png)
 
+<span></span>
 
 ---
 ## Table of Contents
@@ -24,13 +25,15 @@ Earth leakage can be measured Canadian CSA style by disconnected the neutral lin
 1. [Mains In Assembly](#mains_in_assembly)
 1. [Main Assembly](#main_assembly)
 
+<span></span>
 [Top](#TOP)
 
 ---
 <a name="Parts_list"></a>
 ## Parts list
 | <span style="writing-mode: vertical-rl; text-orientation: mixed;">Base</span> | <span style="writing-mode: vertical-rl; text-orientation: mixed;">Feet</span> | <span style="writing-mode: vertical-rl; text-orientation: mixed;">Mains&nbsp;In</span> | <span style="writing-mode: vertical-rl; text-orientation: mixed;">Main</span> | <span style="writing-mode: vertical-rl; text-orientation: mixed;">TOTALS</span> |  |
-|--:|--:|--:|--:|--:|:--|
+|---:|---:|---:|---:|---:|:---|
+|  |  |  |  | | **Vitamins** |
 | &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;2&nbsp; |  &nbsp;&nbsp;2&nbsp; | &nbsp;&nbsp; 4mm shielded jack socket blue |
 | &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;1&nbsp; |  &nbsp;&nbsp;1&nbsp; | &nbsp;&nbsp; 4mm shielded jack socket brown |
 | &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;2&nbsp; |  &nbsp;&nbsp;2&nbsp; | &nbsp;&nbsp; 4mm shielded jack socket green |
@@ -47,10 +50,13 @@ Earth leakage can be measured Canadian CSA style by disconnected the neutral lin
 | &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;1&nbsp; | &nbsp;&nbsp;1&nbsp; |  &nbsp;&nbsp;2&nbsp; | &nbsp;&nbsp; Wire blue 30/0.25mm strands, length 150mm - not shown |
 | &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;2&nbsp; | &nbsp;&nbsp;.&nbsp; |  &nbsp;&nbsp;2&nbsp; | &nbsp;&nbsp; Wire brown 30/0.25mm strands, length 150mm - not shown |
 | &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;1&nbsp; | &nbsp;&nbsp;1&nbsp; |  &nbsp;&nbsp;2&nbsp; | &nbsp;&nbsp; Wire green & yellow 30/0.25mm strands, length 150mm - not shown |
-|  |  |  |  | | **3D Printed parts** |
-| &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;4&nbsp; | &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;4&nbsp; | &nbsp;&nbsp;&nbsp;foot.stl |
-| &nbsp;&nbsp;1&nbsp; | &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;1&nbsp; | &nbsp;&nbsp;&nbsp;socket_box.stl |
+| &nbsp;&nbsp;2&nbsp; | &nbsp;&nbsp;16&nbsp; | &nbsp;&nbsp;14&nbsp; | &nbsp;&nbsp;18&nbsp; | &nbsp;&nbsp;50&nbsp; | &nbsp;&nbsp;Total vitamins count |
+|  |  |  |  | | **3D printed parts** |
+| &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;4&nbsp; | &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;.&nbsp; |  &nbsp;&nbsp;4&nbsp; | &nbsp;&nbsp;foot.stl |
+| &nbsp;&nbsp;1&nbsp; | &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;.&nbsp; |  &nbsp;&nbsp;1&nbsp; | &nbsp;&nbsp;socket_box.stl |
+| &nbsp;&nbsp;1&nbsp; | &nbsp;&nbsp;4&nbsp; | &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;.&nbsp; | &nbsp;&nbsp;5&nbsp; | &nbsp;&nbsp;Total 3D printed parts count |
 
+<span></span>
 [Top](#TOP)
 
 ---
@@ -58,14 +64,14 @@ Earth leakage can be measured Canadian CSA style by disconnected the neutral lin
 ## Base Assembly
 ### Vitamins
 |Qty|Description|
-|--:|:----------|
+|---:|:----------|
 |2| Heatfit insert M3|
 
 
 ### 3D Printed parts
 
 | 1 x socket_box.stl |
-|--|
+|---|
 | ![socket_box.stl](stls/socket_box.png) 
 
 
@@ -78,6 +84,7 @@ Earth leakage can be measured Canadian CSA style by disconnected the neutral lin
 
 ![base_assembled](assemblies/base_assembled.png)
 
+<span></span>
 [Top](#TOP)
 
 ---
@@ -85,16 +92,16 @@ Earth leakage can be measured Canadian CSA style by disconnected the neutral lin
 ## Feet Assembly
 ### Vitamins
 |Qty|Description|
-|--:|:----------|
-|8| Washer  M3 x 7mm x 0.5mm|
-|4| Screw M3 dome x 10mm|
+|---:|:----------|
 |4| Nut M3 x 2.4mm nyloc|
+|4| Screw M3 dome x 10mm|
+|8| Washer  M3 x 7mm x 0.5mm|
 
 
 ### 3D Printed parts
 
 | 4 x foot.stl |
-|--|
+|---|
 | ![foot.stl](stls/foot.png) 
 
 
@@ -102,7 +109,7 @@ Earth leakage can be measured Canadian CSA style by disconnected the neutral lin
 ### Sub-assemblies
 
 | 1 x base_assembly |
-|--|
+|---|
 | ![base_assembled](assemblies/base_assembled_tn.png) 
 
 
@@ -114,6 +121,7 @@ Earth leakage can be measured Canadian CSA style by disconnected the neutral lin
 
 ![feet_assembled](assemblies/feet_assembled.png)
 
+<span></span>
 [Top](#TOP)
 
 ---
@@ -121,21 +129,21 @@ Earth leakage can be measured Canadian CSA style by disconnected the neutral lin
 ## Mains In Assembly
 ### Vitamins
 |Qty|Description|
-|--:|:----------|
-|1| Wire green & yellow 30/0.25mm strands, length 150mm - not shown|
-|1| Wire blue 30/0.25mm strands, length 150mm - not shown|
-|2| Wire brown 30/0.25mm strands, length 150mm - not shown|
+|---:|:----------|
 |3| Heatshrink sleeving ID 3.2mm x 15mm - not shown|
 |1| IEC inlet for ATX|
+|2| Nut M3 x 2.4mm nyloc|
 |2| Screw M3 cs cap x 12mm|
 |2| Washer  M3 x 7mm x 0.5mm|
-|2| Nut M3 x 2.4mm nyloc|
+|1| Wire blue 30/0.25mm strands, length 150mm - not shown|
+|2| Wire brown 30/0.25mm strands, length 150mm - not shown|
+|1| Wire green & yellow 30/0.25mm strands, length 150mm - not shown|
 
 
 ### Sub-assemblies
 
 | 1 x feet_assembly |
-|--|
+|---|
 | ![feet_assembled](assemblies/feet_assembled_tn.png) 
 
 
@@ -153,6 +161,7 @@ Earth leakage can be measured Canadian CSA style by disconnected the neutral lin
 
 ![mains_in_assembled](assemblies/mains_in_assembled.png)
 
+<span></span>
 [Top](#TOP)
 
 ---
@@ -160,22 +169,22 @@ Earth leakage can be measured Canadian CSA style by disconnected the neutral lin
 ## Main Assembly
 ### Vitamins
 |Qty|Description|
-|--:|:----------|
-|1| Wire green & yellow 30/0.25mm strands, length 150mm - not shown|
-|1| Wire blue 30/0.25mm strands, length 150mm - not shown|
-|5| Heatshrink sleeving ID 3.2mm x 15mm - not shown|
-|3| Ferrule for 1.5mm^2 wire - not shown|
-|1| Mains socket 13A|
-|2| Screw M3 cs cap x 20mm|
+|---:|:----------|
 |2| 4mm shielded jack socket blue|
 |1| 4mm shielded jack socket brown|
 |2| 4mm shielded jack socket green|
+|3| Ferrule for 1.5mm^2 wire - not shown|
+|5| Heatshrink sleeving ID 3.2mm x 15mm - not shown|
+|1| Mains socket 13A|
+|2| Screw M3 cs cap x 20mm|
+|1| Wire blue 30/0.25mm strands, length 150mm - not shown|
+|1| Wire green & yellow 30/0.25mm strands, length 150mm - not shown|
 
 
 ### Sub-assemblies
 
 | 1 x mains_in_assembly |
-|--|
+|---|
 | ![mains_in_assembled](assemblies/mains_in_assembled_tn.png) 
 
 
@@ -196,4 +205,5 @@ Earth leakage can be measured Canadian CSA style by disconnected the neutral lin
 
 ![main_assembled](assemblies/main_assembled.png)
 
+<span></span>
 [Top](#TOP)

examples/MainsBreakOutBox/scad/bob_main.scad

@@ -31,11 +31,19 @@
 //! while its earth is disconnected. Don't be tempted to float the earth of an oscilloscope this way, use a mains isolation transformer to power the DUT instead.
 //! Earth leakage can be measured Canadian CSA style by disconnected the neutral link from the left socket and linking the central neutral to the live.
 //
-$extrusion_width = 0.5;
+$extrusion_width = 0.4;
+$layer_height = 0.2;
 $pp1_colour = "dimgrey";
 $pp2_colour = [0.9, 0.9, 0.9];
 
-include <NopSCADlib/lib.scad>
+include <NopSCADlib/core.scad>
+include <NopSCADlib/vitamins/iecs.scad>
+include <NopSCADlib/vitamins/mains_sockets.scad>
+include <NopSCADlib/vitamins/tubings.scad>
+
+use <NopSCADlib/vitamins/insert.scad>
+use <NopSCADlib/vitamins/wire.scad>
+use <NopSCADlib/vitamins/jack.scad>
 use <NopSCADlib/printed/foot.scad>
 
 echo(extrusion_width = extrusion_width, layer_height = layer_height);
@@ -45,7 +53,7 @@ iec = IEC_inlet_atx;
 socket = Contactum;
 
 
-foot = [20, 8, 3, 1, M3_dome_screw, 10];
+foot = Foot(d = 20, h = 8, t = 3, r = 1, screw = M3_dome_screw);
 
 module foot_stl() foot(foot);
 
@@ -166,7 +174,7 @@ module socket_box_stl() {
 //
 module base_assembly()
 assembly("base") {
-    color(pp1_colour) render() /*clip(ymax = 0)*/ socket_box_stl();
+    stl_colour(pp1_colour) render() /*clip(ymax = 0)*/ socket_box_stl();
 
     mains_socket_hole_positions(socket)
         translate_z(height)

examples/MainsBreakOutBox/stls/deps/all.txt

@@ -0,0 +1,5 @@
+socket_box.stl
+foot.stl
+foot.stl
+foot.stl
+foot.stl