knowledgebase, wiring photos, and printing instructions

Wakoma · Mar 25, 2024 · 9fed45a · 9fed45a
1 parent 405e6fb
commit 9fed45a
Show file tree

Hide file tree

Showing 42 changed files with 134 additions and 17 deletions.
diff --git a/buildconf.yaml b/buildconf.yaml
@@ -1,3 +1,4 @@
+AutoCompleteSubNav: true
 CustomCategories:
   mech:
     DisplayName: Mechanical Components
@@ -8,9 +9,19 @@ CustomCategories:
   printed:
     DisplayName: 3D printed parts
     Reuse: false
+  consumable:
+    Reuse: false
+    DisplayName: Comsumables
 DefaultCategory: mech
 HoverColor: '#555555'
+License: CERN-OHL-S-2.0
+Navigation:
+  - Link: config.md
+    Title: Your Nimble Configuration
+  - Link: troubleshooting.md
+    Title: Troubleshooting
+  - Link: knowledgebase.md
+    Title: Knowledge Base
 PageBOMTitle: '## For this page you will need'
 PrimaryColor: '#2d3b46'
 SecondaryColor: '#cccccc'
-License: CERN-OHL-S-2.0
diff --git a/case.md b/case.md
@@ -0,0 +1,10 @@
+# Prepare the case
+
+>!! **TODO**
+>!!
+>!! * We need photos!
+>!! * What STL is printed?
+>!! * Write instructions
+
+{{BOM}}
+
diff --git a/config.md b/config.md
@@ -14,6 +14,6 @@ Your shelves from bottom to to are:
 * [Patch panel](patch_panel.md){step} - To expose ports the back plane
 * [omni-charge shelf](omnicharge_shelf.md){step} - For a portable power supply
 
-Once you have assembled each shelf, you will [construct the rack](construction.md){step}, before finally [wiring up the system](wiring.md){step}.
+Once you have assembled each shelf, you will [construct the rack](construction.md){step} and [prepare the case](case.md){step} before finally [wiring up the system](wiring.md){step}.
 
 Make sure you have [all the parts you need]{bom}, before you start assembly.
diff --git a/construction.md b/construction.md
@@ -1,10 +1,15 @@
 # Construct the and populate the rack
 
+>!! **TODO**
+>!!
+>!! * All written instructions after step 1.
+>!! * include adding final screws
+
 {{BOM}}
 
 ## Attach the legs to the bottom{pagestep}
 
-* Get the [bottom]{qty:1, cat:printed} and the four [rack legs]{qty:4, cat:printed} that you printed earlier.
+* Get the [bottom](fromstep){qty:1, cat:printed} and the four [rack legs](fromstep){qty:4, cat:printed} that you printed earlier.
 * Get an [3mm Allen Key]{qty:1, cat:tool} ready
 * Use four [M4x10mm countersunk screws]{qty:4} to attach a leg to each corner of the bottom.
 
@@ -13,7 +18,7 @@
 
 ## Add the shelves {pagestep}
 
-
+Each draw uses [M4x10mm cap screws]{qty:2, cat:mech}
 ![](images/RackAssembly3.jpg)
 ![](images/RackAssembly4.jpg)
 ![](images/RackAssembly5.jpg)

diff --git a/images/IMG_20210417_110410253_Large.jpg b/images/IMG_20210417_110410253_Large.jpg
diff --git a/images/IMG_20210417_110531564_Large.jpg b/images/IMG_20210417_110531564_Large.jpg
diff --git a/images/IMG_20210417_110619183_Large.jpg b/images/IMG_20210417_110619183_Large.jpg
diff --git a/images/IMG_20210417_111337228_Large.jpg b/images/IMG_20210417_111337228_Large.jpg
diff --git a/images/IMG_20210417_111453851_Large.jpg b/images/IMG_20210417_111453851_Large.jpg
diff --git a/images/IMG_20210417_111502417_Large.jpg b/images/IMG_20210417_111502417_Large.jpg
diff --git a/images/IMG_20210417_111844190_Large.jpg b/images/IMG_20210417_111844190_Large.jpg
diff --git a/images/IMG_20210417_111942498_Large.jpg b/images/IMG_20210417_111942498_Large.jpg
diff --git a/images/IMG_20210417_112008300_Large.jpg b/images/IMG_20210417_112008300_Large.jpg
diff --git a/images/IMG_20210417_112159879_Large.jpg b/images/IMG_20210417_112159879_Large.jpg
diff --git a/images/IMG_20210417_112238402_Large.jpg b/images/IMG_20210417_112238402_Large.jpg
diff --git a/images/IMG_20210417_112949209_Large.jpg b/images/IMG_20210417_112949209_Large.jpg
diff --git a/images/IMG_20210417_112957441_Large.jpg b/images/IMG_20210417_112957441_Large.jpg
diff --git a/images/IMG_20210417_113223617_Large.jpg b/images/IMG_20210417_113223617_Large.jpg
diff --git a/images/IMG_20210417_113351262_Large.jpg b/images/IMG_20210417_113351262_Large.jpg
diff --git a/images/IMG_20210417_113458418_Large.jpg b/images/IMG_20210417_113458418_Large.jpg
diff --git a/images/IMG_20210417_114225291_Large.jpg b/images/IMG_20210417_114225291_Large.jpg
diff --git a/images/IMG_20210417_114229677_Large.jpg b/images/IMG_20210417_114229677_Large.jpg
diff --git a/images/IMG_20210417_114241237_Large.jpg b/images/IMG_20210417_114241237_Large.jpg
diff --git a/images/IMG_20210417_114253028_Large.jpg b/images/IMG_20210417_114253028_Large.jpg
diff --git a/images/IMG_20210417_114307153_Large.jpg b/images/IMG_20210417_114307153_Large.jpg
diff --git a/images/IMG_20210417_114314604_Large.jpg b/images/IMG_20210417_114314604_Large.jpg
diff --git a/images/IMG_20210417_114705899_Large.jpg b/images/IMG_20210417_114705899_Large.jpg
diff --git a/index.md b/index.md
@@ -29,5 +29,3 @@ To customise your Nimble you can go to [our GitHub](https://github.com/Wakoma/ni
 ## Building your Nimble
 
 In the next pages we will build [your nimble](config.md){step}.
-
-If you get stuck check our [troubleshooting and support](troubleshooting.md){step} pages.
diff --git a/knowledgebase.md b/knowledgebase.md
@@ -0,0 +1,5 @@
+# Nimble Knowledge Base
+
+The following pages may help you understand your Nimble.
+
+{{listpages, tag:info}}
diff --git a/models/RPi_4B_Shelf_v1.3.stl b/models/RPi_4B_Shelf_v1.3.stl
diff --git a/models/bottom_v1.3.stl b/models/bottom_v1.3.stl
diff --git a/netgate_shelf.md b/netgate_shelf.md
@@ -4,7 +4,7 @@
 
 ## Prepare the tray {pagestep}
 
-* Take the [Netgate Shelf]{qty:1, cat:printed} you printed earlier and a [2.5mm Allen Key]{qty:1, cat:tool}.
+* Take the [Netgate Shelf](fromstep){qty:1, cat:printed} you printed earlier and a [2.5mm Allen Key]{qty:1, cat:tool}.
 * Lightly screw a [M3x12mm cap screw][M3x12mm cap screws]{qty:2} into the top hole of each of the two rear posts.
 * Make sure each screw is inserted less than half way.
 

diff --git a/nuctall_shelf.md b/nuctall_shelf.md
@@ -4,7 +4,7 @@
 
 ## Position the computer{pagestep}
 
-* Take the [NUC Shelf]{qty:1, cat:printed} you printed earlier
+* Take the [NUC Shelf](fromstep){qty:1, cat:printed} you printed earlier
 * Position the [NUC computer]{qty:1, cat:net} on the shelf so that front of the computer sits just behind where the shelf narrows
 
 ![](images/NUC_shelf1.jpg)

diff --git a/omnicharge_shelf.md b/omnicharge_shelf.md
@@ -7,15 +7,15 @@
 
 >i Note that this shelf forms the top of the rack, so looks a bit different.
 
-* Take the [Omni Shelf]{qty:1, cat:printed} you printed earlier.
+* Take the [Omni Shelf](fromstep){qty:1, cat:printed} you printed earlier.
 * Position the [Omni 20C+]{qty:1, cat:net} so that the front of the device is not blocked
 
 ![](images/OmniShelfAssembly1.jpg)
 ![](images/OmniShelfAssembly2.jpg)
 
 ## Secure the OmniCharge{pagestep}
 
-* Take the [Omni Shelf Lid]{qty:1, cat:printed} you printed earlier and place it over the Omni, aligning the three countersunk holes with the holes on the shelf.
+* Take the [Omni Shelf Lid](fromstep){qty:1, cat:printed} you printed earlier and place it over the Omni, aligning the three countersunk holes with the holes on the shelf.
 * Use three [M4x10mm countersunk screws]{qty:3} and an [3mm Allen Key]{qty:1, cat:tool} to secure the computer in place
 
 ![](images/OmniShelfAssembly3.jpg)

diff --git a/patch_panel.md b/patch_panel.md
@@ -13,7 +13,7 @@
 
 ## Attach the Ethernet Keystones{pagestep}
 
-* Take the [Patch pannel]{qty:1, cat:printed} you printed earlier and three [ethernet keystones][Ethernet Keystones]{qty:3, cat:net}
+* Take the [Patch panel](fromstep){qty:1, cat:printed} you printed earlier and three [ethernet keystones][Ethernet Keystones]{qty:3, cat:net}
 * These will be clipped into the three left hand panels
 
 ![](images/Patch1.jpg)

diff --git a/pi_shelf.md b/pi_shelf.md
@@ -4,7 +4,7 @@
 
 ## Position the Raspberry Pi {pagestep}
 
-* Take the [Raspberry Pi Shelf]{qty:1, cat:printed} you printed earlier
+* Take the [Raspberry Pi Shelf](fromstep){qty:1, cat:printed} you printed earlier
 
 ![](images/PiShelfAssembly1.jpg)
 

diff --git a/poe-explanation.md b/poe-explanation.md
@@ -0,0 +1,11 @@
+---
+Tags: info
+---
+
+# Power over Ethernet
+
+Many of the devices in your Nimble are powered directly through the Ethernet cable.
+
+Power over Ethernet allows both data and power to be transmitted between devices using only a single cable. This really cuts down on excess cables.
+
+There is far more information on Power over Ethernet at [wikipedia](https://en.wikipedia.org/wiki/Power_over_Ethernet)
diff --git a/printing.md b/printing.md
@@ -1,5 +1,30 @@
 # 3D Printing
 
+>!! **TODO**
+>!!
+>!! * Add all the correct STLs
+
 {{BOM}}
 
-[3d printer](3dprinter.md){qty:1, cat: tool}
+You will need a [3d printer](3dprinter.md){qty:1, cat: tool} and about 1kg of [PLA filament]{qty:1kg, cat:consumable}.
+
+Using the slicer that comes with your printer, print the following parts. No parts require support. A brim is advised for all parts.
+
+|Name| STL file| Qty |
+|---|---|---|
+| [bottom]{output, qty:1}|[bottom_v1.3.stl](models/bottom_v1.3.stl){previewpage}|1
+| [rack legs]{output, qty:4}||1
+| [Netgate Shelf]{output, qty:4}||1
+| [NUC Shelf]{output, qty:4}||1
+| [Omni Shelf]{output, qty:4}||1
+| [Omni Shelf Lid]{output, qty:4}||1
+| [Patch panel]{output, qty:4}||1
+| [SSD shelf]{output, qty:4}||1
+| [UniFi Switch Shelf]{output, qty:4}||1
+| [USB Power Shelf]{output, qty:4}||1
+| [Raspberry Pi Shelf]{output,qty:1}| [RPi_4B_Shelf_v1.3.stl](models/RPi_4B_Shelf_v1.3.stl){previewpage}|1
+
+
+You can [download all of the STLs as a single zipfile](all-stls.zip){zip, pattern:"*.stl"}
+
+Remove the brim with a [utility knife]{qty:1, cat:tool}
diff --git a/ssd_shelf.md b/ssd_shelf.md
@@ -5,7 +5,7 @@
 
 ## Position the drives {pagestep}
 
-* Take the [SSD shelf]{qty:1, cat:printed} you printed earlier
+* Take the [SSD shelf](fromstep){qty:1, cat:printed} you printed earlier
 * Position two [2.5 inch SSD drives]{qty:2, cat:net} on the shelf so that the conectores are visible at the rear
 
 ![](images/SSDShelfAssembly1.jpg)

diff --git a/switch_shelf.md b/switch_shelf.md
@@ -4,7 +4,7 @@
 
 ## Prepare the tray {pagestep}
 
-* Take the [UniFi Switch Shelf]{qty:1, cat:printed} you printed earlier and UniFi Switch Mounting Bracket (This should come with the switch)
+* Take the [UniFi Switch Shelf](fromstep){qty:1, cat:printed} you printed earlier and UniFi Switch Mounting Bracket (This should come with the switch)
 * Place the bracket on the tray so that the extended flat raised section faced the front of the tray
 
 ![](images/UniFi_Flex_Switch1.jpg)

diff --git a/usb_shelf.md b/usb_shelf.md
@@ -5,7 +5,7 @@
 
 ## Prepare the tray {pagestep}
 
-* Take the [USB Power Shelf]{qty:1, cat:printed} you printed earlier and a [2.5mm Allen Key]{qty:1, cat:tool}.
+* Take the [USB Power Shelf](fromstep){qty:1, cat:printed} you printed earlier and a [2.5mm Allen Key]{qty:1, cat:tool}.
 * Lightly screw a [M3x12mm cap screw][M3x12mm cap screws]{qty:4} into the top hole of each of the 4 side-posts.
 * Make sure each screw is inserted less than half way.
 

diff --git a/wiring.md b/wiring.md
@@ -1,3 +1,55 @@
 # Wiring and power on!
 
-Edit me
+>!! **TODO**
+>!!
+>!! * Write the instructions
+>!! * Be clear what passes through where
+>!! * Annotate images to be clear what we are looking at
+
+{{BOM}}
+
+![](images/IMG_20210417_110410253_Large.jpg)
+
+![](images/IMG_20210417_110531564_Large.jpg)
+![](images/IMG_20210417_110619183_Large.jpg)
+
+![](images/IMG_20210417_111337228_Large.jpg)
+
+![](images/IMG_20210417_111453851_Large.jpg)
+![](images/IMG_20210417_111502417_Large.jpg)
+
+
+![](images/IMG_20210417_111844190_Large.jpg)
+
+![](images/IMG_20210417_111942498_Large.jpg)
+
+![](images/IMG_20210417_112008300_Large.jpg)
+
+![](images/IMG_20210417_112159879_Large.jpg)
+
+![](images/IMG_20210417_112238402_Large.jpg)
+
+![](images/IMG_20210417_112949209_Large.jpg)
+
+![](images/IMG_20210417_112957441_Large.jpg)
+
+![](images/IMG_20210417_113223617_Large.jpg)
+
+![](images/IMG_20210417_113351262_Large.jpg)
+
+![](images/IMG_20210417_113458418_Large.jpg)
+
+![](images/IMG_20210417_114225291_Large.jpg)
+
+![](images/IMG_20210417_114229677_Large.jpg)
+
+![](images/IMG_20210417_114241237_Large.jpg)
+
+![](images/IMG_20210417_114253028_Large.jpg)
+
+![](images/IMG_20210417_114307153_Large.jpg)
+
+![](images/IMG_20210417_114314604_Large.jpg)
+
+![](images/IMG_20210417_114705899_Large.jpg)
+
Original file line number	Diff line number	Diff line change
Expand Up		@@ -29,5 +29,3 @@ To customise your Nimble you can go to [our GitHub](https://github.com/Wakoma/ni
		## Building your Nimble

		In the next pages we will build [your nimble](config.md){step}.

		If you get stuck check our [troubleshooting and support](troubleshooting.md){step} pages.