latest changes
|
|
@ -0,0 +1,61 @@
|
|||
name: release docs
|
||||
|
||||
on:
|
||||
push:
|
||||
tags:
|
||||
- hatch-v*
|
||||
- hatchling-v*
|
||||
|
||||
jobs:
|
||||
build:
|
||||
runs-on: ubuntu-latest
|
||||
|
||||
steps:
|
||||
- uses: actions/checkout@v3
|
||||
|
||||
- name: Set up Python
|
||||
uses: actions/setup-python@v4
|
||||
|
||||
- name: Ensure latest pip
|
||||
run: python -m pip install --upgrade pip
|
||||
|
||||
- name: Install env
|
||||
run: pip install -e .
|
||||
|
||||
- name: Configure Git for GitHub Actions bot
|
||||
run: |
|
||||
git config --local user.name 'github-actions[bot]'
|
||||
git config --local user.email 'github-actions[bot]@users.noreply.github.com'
|
||||
- name: Build documentation
|
||||
run: hatch run docs:build
|
||||
env:
|
||||
GH_TOKEN_MKDOCS_MATERIAL_INSIDERS: ${{ secrets.GH_TOKEN_MKDOCS_MATERIAL_INSIDERS }}
|
||||
|
||||
- name: Create archive
|
||||
run: git archive -o site.zip gh-pages
|
||||
|
||||
- uses: actions/upload-artifact@v3
|
||||
with:
|
||||
name: documentation
|
||||
path: site.zip
|
||||
|
||||
publish:
|
||||
runs-on: ubuntu-latest
|
||||
needs:
|
||||
- build
|
||||
|
||||
steps:
|
||||
- uses: actions/download-artifact@v3
|
||||
with:
|
||||
name: documentation
|
||||
|
||||
- name: Unpack archive
|
||||
run: python -m zipfile -e site.zip site
|
||||
|
||||
- uses: peaceiris/actions-gh-pages@v3
|
||||
with:
|
||||
github_token: ${{ secrets.GITHUB_TOKEN }}
|
||||
publish_dir: site
|
||||
commit_message: ${{ github.event.head_commit.message }}
|
||||
enable_jekyll: false
|
||||
allow_empty_commit: false
|
||||
|
|
@ -206,6 +206,7 @@ Inspect the case parts and panels for any damage or imperfections that may have
|
|||
|
||||
To secure the PlanktoScope on slippery grounds using the adhesive pads, follow these steps. Gather all the necessary materials. You will need:
|
||||
|
||||
- Time: 1 min
|
||||
- 👁 and Take the Part I
|
||||
- 🟠 Take the four adhesive pads present in the bag A.
|
||||
- 🟣 Locate the four pockets that will receive the four adhesive pads.
|
||||
|
|
@ -230,6 +231,8 @@ To secure the PlanktoScope on slippery grounds using the adhesive pads, follow t
|
|||
|
||||
Now it's time to assemble the ground plate for the Raspberry Pi as the PlanktoScope main processing unit.
|
||||
|
||||
- Time: 5 min
|
||||
|
||||
---
|
||||
|
||||
|
||||
|
|
@ -283,6 +286,8 @@ Keep going for each of the **four holes**.
|
|||
|
||||
|
||||
|
||||
- Time: 2 min
|
||||
|
||||
Locate the **Raspberry Pi 4 Model B** packaging.
|
||||
|
||||
!!! warning
|
||||
|
|
@ -343,6 +348,8 @@ Push the **micro SD card** in the **Raspberry Pi** port to a point of resistance
|
|||
|
||||
## Chapter 6: Mount the **Raspberry Pi** on the **Part A**
|
||||
|
||||
- Time: 1 min
|
||||
|
||||
|
||||
|
||||
- ✅ Make sure to position the Raspberry Pi properly on the four standoffs screwed on the Part A.
|
||||
|
|
@ -384,6 +391,8 @@ Screw by hand a Standoff M2.5 - 16mm on the **Raspberry Pi**.
|
|||
|
||||
## Chapter 7: Attach the **Ribbon Cable** to the **Raspberry Pi**
|
||||
|
||||
- Time: 2 min
|
||||
|
||||
|
||||
|
||||
Locate the **Raspberry Pi Camera HQ** packaging.
|
||||
|
|
@ -451,6 +460,8 @@ Insert the **Ribbon Cable** you just detached from the **Raspberry Pi Camera** i
|
|||
|
||||
|
||||
|
||||
- Time: 2 min
|
||||
|
||||
Locate the **PlanktoScope HAT** present in **bag I**.
|
||||
|
||||
---
|
||||
|
|
@ -516,6 +527,7 @@ Screw the four **A4** screws through the **PlanktoScope HAT** onto the **Standof
|
|||
|
||||
|
||||
|
||||
- Time: 2 min
|
||||
- Locate the **DC Power Jack** from the **Bag K**.
|
||||
- Remove the **Lock Ring** from the **DC Power Jack**
|
||||
|
||||
|
|
@ -554,6 +566,8 @@ Screw the four **A4** screws through the **PlanktoScope HAT** onto the **Standof
|
|||
|
||||
|
||||
|
||||
- Time: 2 min
|
||||
|
||||
---
|
||||
|
||||
|
||||
|
|
|
|||
|
|
@ -60,7 +60,7 @@ Rubio Monocoat Plus is also environmentally friendly, with a low VOC (volatile o
|
|||
|
||||
We use Rubio Monocoat Plus as a finishing product for Valchromat.
|
||||
|
||||
### Workflow
|
||||
### CNC workflow
|
||||
|
||||
Here is a step-by-step guide on how to configure the feed rate and the diameter of the end mill of a CNC milling machine for the production of a workpiece, using the specified tools and configuration:
|
||||
|
||||
|
|
@ -92,6 +92,74 @@ By following these steps, you can properly configure the feed rate and the diame
|
|||
|
||||
|
||||
|
||||
### Finnish of the case parts
|
||||
|
||||
#### Requirements for case parts
|
||||
|
||||
##### Case tools
|
||||
|
||||
- Hammer
|
||||
- Air Compressor
|
||||
- Rubber gloves
|
||||
- Paper carpet pad
|
||||
- Clean piece of cotton fabric
|
||||
- Support material for drying the parts
|
||||
|
||||
##### Case part parts
|
||||
|
||||
- all case parts
|
||||
- Rubio Monocoat Oil Plus 2C
|
||||
- Rubio Monocoat Accelerator Component B
|
||||
- Magnets
|
||||
- Square nuts
|
||||
|
||||
#### Clean
|
||||
|
||||
|
||||
|
||||
#### Stir
|
||||
|
||||
|
||||
|
||||
|
||||
#### Apply
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
#### Dry
|
||||
|
||||
|
||||
|
||||
#### Inserting the screws
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
#### Inserting the magnets
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
#### Package Housing part
|
||||
|
||||
|
||||
|
||||
|
||||
## PlanktoScope Hat
|
||||
|
||||
Welcome to the PCB production manual for the PlanktoScope Hat!
|
||||
|
|
@ -252,22 +320,22 @@ To ensure the quality of the produced PCB, request data validation from the cust
|
|||
|
||||
### Assembly of the Thru-Hole components
|
||||
|
||||
#### Requirements
|
||||
#### Thru-Hole Requirements
|
||||
|
||||
##### Tools
|
||||
|
||||
|
||||
##### Thru-Hole tools
|
||||
|
||||
- [professional Soldering iron](https://en.wikipedia.org/wiki/Soldering_station)
|
||||
- [solder](https://en.wikipedia.org/wiki/Solder) with flux
|
||||
- [Helping hand](<https://en.wikipedia.org/wiki/Helping_hand_(tool)>)
|
||||
- [Helping hand](<https://en.wikipedia.org/wiki/Helping_hand_(tool)>) or [Breadboard](https://en.wikipedia.org/wiki/Breadboard)
|
||||
|
||||
##### Parts
|
||||
##### Thru-Hole parts
|
||||
|
||||
| Files | Description |
|
||||
| -------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------- |
|
||||
| [Planktoscope-Hat-throughhole.csv](https://code.curious.bio/curious.bio/planktoscope/raw/branch/din_spec_3105_1/hardware/hat/Planktoscope-Hat-throughhole.csv) | The list of used SMD components |
|
||||
|
||||
#### Step by step guide
|
||||
|
||||
!!! warning
|
||||
|
||||
When you solder this for the first time, take special care not to damage the board.
|
||||
|
|
@ -275,3 +343,241 @@ To ensure the quality of the produced PCB, request data validation from the cust
|
|||
!!! info
|
||||
|
||||
To learn how to solder we recommend you the awesome [Comic "Soldering is easy" by Mitch Altmal, Andie Nordgren and Jeff Keyzer](https://mightyohm.com/soldercomic/)
|
||||
|
||||
#### Soldering of the stepper motor driver
|
||||
|
||||
|
||||
|
||||
Unpack the motor driver and the connector strips and take the breadboard aside.
|
||||
|
||||
---
|
||||
|
||||
|
||||
|
||||
Plug the connectors with the appropriate distance to the breadboard.
|
||||
|
||||
!!! Info
|
||||
|
||||
The breadboard supports you during soldering to ensure the spacing and angle of the connectors, alternatively you can also use a third hand.
|
||||
|
||||
---
|
||||
|
||||
|
||||
|
||||
Now position the motor driver on the connector strips of the beadboard.
|
||||
|
||||
!!! Warning
|
||||
|
||||
Make sure that the larger chip labeled trimatik is positioned on the bottom of the board and the four smaller chips are positioned on the top of the board as shown in the picture.
|
||||
|
||||
---
|
||||
|
||||
|
||||
|
||||
Now solder all pins of the connector strip.
|
||||
|
||||
!!! Info
|
||||
|
||||
Soldering is sometimes like eating with chopsticks 🥢. It takes a bit of practice, but with time you learn how to hold the workpiece in place with one free finger and apply the solder with another, and then use the other hand to move the soldering iron to the workpiece and solder it.
|
||||
|
||||
!!! Tip
|
||||
|
||||
You can also solder one pin on one side and then the opposite one to fix your workpiece, this ensures that nothing accidentally moves.
|
||||
|
||||
---
|
||||
|
||||
#### Soldering of the motor driver sockets
|
||||
|
||||
|
||||
|
||||
Now take the PlanktoScope Hat board and the female connector of the stepper motor driver and position them as shown in the picture.
|
||||
|
||||
---
|
||||
|
||||
|
||||
|
||||
Now put the previously soldered motor driver on the socket connector to fix it for the soldering process. Turn the board as shown in the picture and place it carefully.
|
||||
|
||||
---
|
||||
|
||||
|
||||
|
||||
Now solder all pins of the connector strip.
|
||||
|
||||
!!! Info
|
||||
|
||||
Soldering is sometimes like eating with chopsticks 🥢. It takes a bit of practice, but with time you learn how to hold the workpiece in place with one free finger and apply the solder with another, and then use the other hand to move the soldering iron to the workpiece and solder it.
|
||||
|
||||
!!! Tip
|
||||
|
||||
You can also solder one pin on one side and then the opposite one to fix your workpiece, this ensures that nothing accidentally moves.
|
||||
|
||||
---
|
||||
|
||||
|
||||
|
||||
Repeat the procedure with the second motor driver. The end result should look like this.
|
||||
|
||||
---
|
||||
|
||||
#### Soldering the connection sockets
|
||||
|
||||
|
||||
|
||||
Now solder the motor driver sockets, inserting the connector into the holes as shown.
|
||||
|
||||
---
|
||||
|
||||
|
||||
|
||||
Turn the board over and hold the loose connector while soldering it. Repeat the procedure with the second motor connector.
|
||||
|
||||
!!! Info
|
||||
|
||||
Soldering is sometimes like eating with chopsticks 🥢. It takes a bit of practice, but with time you learn how to hold the workpiece in place with one free finger and apply the solder with another, and then use the other hand to move the soldering iron to the workpiece and solder it.
|
||||
|
||||
---
|
||||
|
||||
|
||||
|
||||
Repeat the procedure with the power connector. The end result should look like this.
|
||||
|
||||
---
|
||||
|
||||
|
||||
|
||||
Repeat the procedure with the led connector. The end result should look like this.
|
||||
|
||||
---
|
||||
|
||||
#### Soldering the Raspberry Pi connector
|
||||
|
||||
|
||||
|
||||
Now solder the Raspberry Pi header connector with all 20 pins.
|
||||
|
||||
!!! Warning
|
||||
|
||||
Be extremely careful when soldering the connections, make sure you don't accidentally bridge several contacts because you used too much solder or have cold solder joints because you had too little solder or too little heat.
|
||||
|
||||
---
|
||||
|
||||
#### Install and solder the cooling fan
|
||||
|
||||
<!--  -->
|
||||
|
||||
Install the fan with the four screws and nuts.
|
||||
|
||||
!!! Warning
|
||||
|
||||
Pay attention to the running direction with the arrow marking on the side of the fan. The fan should blow on the cooler of the Raspberry Pi.
|
||||
|
||||
---
|
||||
|
||||
<!--  -->
|
||||
|
||||
Cut off the excess cable of the fan and leave about 6 cm.
|
||||
|
||||
---
|
||||
|
||||
|
||||
|
||||
Feed the fan cable through the hole provided, check if you can reach the contacts on the board without any problems and trim it further if necessary and enisolate the ends.
|
||||
|
||||
---
|
||||
|
||||
|
||||
|
||||
Solder the fan cables according to the marking and color codes ⚫ GND, 🔴 VCC, 🟡 RPM, 🔵 PWM.
|
||||
|
||||
!!! note
|
||||
|
||||
If your fan doesn't have a 🔵 PWM connector, then that's not a problem, you can just leave it out.
|
||||
|
||||
---
|
||||
|
||||
#### Solder the display connector
|
||||
|
||||
|
||||
|
||||
Insert the pin headers into the holes provided, hold them in place, carefully turn the board over and solder the connector.
|
||||
|
||||
!!! note
|
||||
|
||||
If you do not use an OLED display, you do not need to solder the connector.
|
||||
|
||||
---
|
||||
|
||||
#### Solder the configuration option jumpers
|
||||
|
||||
<!--  -->
|
||||
|
||||
Insert the pin headers into the holes provided, hold them in place, carefully turn the board over and solder the connector.
|
||||
|
||||
!!! note
|
||||
|
||||
If you do not use an OLED display, you do not need to solder the connector.
|
||||
|
||||
---
|
||||
|
||||
#### You have finished soldering the components
|
||||
|
||||
|
||||
|
||||
The assembly of the thru-hole components for the planktoscope hat is now complete. The end result should look like this.
|
||||
|
||||
---
|
||||
|
||||
## PlanktoScope Hard case
|
||||
|
||||
### Hard case Requirements
|
||||
|
||||
#### Hard case tools
|
||||
|
||||
- double sided adhesive tape
|
||||
|
||||
#### Hard case parts
|
||||
|
||||
- Hard case
|
||||
|
||||
|
||||
|
||||
### Foam preparation
|
||||
|
||||
|
||||
|
||||
Cut the foam block at the outer edge by gently tearing it apart with your fingers.
|
||||
|
||||
!!! Warning
|
||||
|
||||
Be careful the foam tears easily and can not be repaired.
|
||||
|
||||
!!! Tip
|
||||
|
||||
You can try in the middle of the foam block to see how the material can be cut through before you peel off with the edge.
|
||||
|
||||
---
|
||||
|
||||
|
||||
|
||||
Now lay a layer of two-sided adhesive tape on the upper inside edge of the case, with which we can later attach the show fabric.
|
||||
|
||||
---
|
||||
|
||||
|
||||
|
||||
Now insert the foam edge in to the case and glue it to the outer wall.
|
||||
|
||||
!!! Note
|
||||
|
||||
Before you fix the foam, position it completely and check that it is placed flush with the edge of the case.
|
||||
|
||||
---
|
||||
|
||||
## Kit composition
|
||||
|
||||
<!--  -->
|
||||
|
||||
Now divide all the components for a kit and pack it in the hard case.
|
||||
|
||||
---
|
||||
|
|
|
|||
|
After Width: | Height: | Size: 5.4 MiB |
|
After Width: | Height: | Size: 962 KiB |
|
After Width: | Height: | Size: 4.9 MiB |
|
After Width: | Height: | Size: 790 KiB |
|
After Width: | Height: | Size: 3.5 MiB |
|
After Width: | Height: | Size: 365 KiB |
|
After Width: | Height: | Size: 360 KiB |
|
After Width: | Height: | Size: 393 KiB |
|
After Width: | Height: | Size: 313 KiB |
|
After Width: | Height: | Size: 288 KiB |
|
After Width: | Height: | Size: 531 KiB |
|
After Width: | Height: | Size: 480 KiB |
|
After Width: | Height: | Size: 353 KiB |
|
After Width: | Height: | Size: 560 KiB |
|
After Width: | Height: | Size: 519 KiB |
|
After Width: | Height: | Size: 400 KiB |
|
After Width: | Height: | Size: 302 KiB |
|
After Width: | Height: | Size: 158 KiB |
|
After Width: | Height: | Size: 398 KiB |
|
After Width: | Height: | Size: 336 KiB |
|
After Width: | Height: | Size: 302 KiB |
|
After Width: | Height: | Size: 314 KiB |
|
After Width: | Height: | Size: 407 KiB |
|
After Width: | Height: | Size: 449 KiB |
|
After Width: | Height: | Size: 363 KiB |
|
After Width: | Height: | Size: 652 KiB |
|
After Width: | Height: | Size: 535 KiB |
|
After Width: | Height: | Size: 4.5 MiB |
|
After Width: | Height: | Size: 632 KiB |
|
After Width: | Height: | Size: 736 KiB |
|
After Width: | Height: | Size: 514 KiB |
|
After Width: | Height: | Size: 469 KiB |
|
After Width: | Height: | Size: 642 KiB |
|
After Width: | Height: | Size: 380 KiB |
|
After Width: | Height: | Size: 352 KiB |
|
After Width: | Height: | Size: 165 KiB |
|
After Width: | Height: | Size: 464 KiB |
|
After Width: | Height: | Size: 222 KiB |
|
After Width: | Height: | Size: 119 KiB |
|
After Width: | Height: | Size: 188 KiB |
|
After Width: | Height: | Size: 615 KiB |
|
After Width: | Height: | Size: 273 KiB |
|
After Width: | Height: | Size: 214 KiB |
|
After Width: | Height: | Size: 432 KiB |
|
After Width: | Height: | Size: 323 KiB |
|
After Width: | Height: | Size: 414 KiB |
|
After Width: | Height: | Size: 270 KiB |
|
After Width: | Height: | Size: 284 KiB |
|
After Width: | Height: | Size: 345 KiB |
|
After Width: | Height: | Size: 403 KiB |
|
After Width: | Height: | Size: 177 KiB |
|
Before Width: | Height: | Size: 91 KiB After Width: | Height: | Size: 91 KiB |
|
Before Width: | Height: | Size: 41 KiB After Width: | Height: | Size: 41 KiB |
|
Before Width: | Height: | Size: 67 KiB After Width: | Height: | Size: 67 KiB |
|
Before Width: | Height: | Size: 126 KiB After Width: | Height: | Size: 126 KiB |
|
Before Width: | Height: | Size: 94 KiB After Width: | Height: | Size: 94 KiB |
|
Before Width: | Height: | Size: 1.7 MiB After Width: | Height: | Size: 1.7 MiB |
|
Before Width: | Height: | Size: 124 KiB After Width: | Height: | Size: 124 KiB |
|
Before Width: | Height: | Size: 610 KiB After Width: | Height: | Size: 610 KiB |
|
Before Width: | Height: | Size: 124 KiB After Width: | Height: | Size: 124 KiB |
|
Before Width: | Height: | Size: 1.6 MiB After Width: | Height: | Size: 1.6 MiB |
|
Before Width: | Height: | Size: 1.8 MiB After Width: | Height: | Size: 1.8 MiB |
|
Before Width: | Height: | Size: 94 KiB After Width: | Height: | Size: 94 KiB |
|
Before Width: | Height: | Size: 1.6 MiB After Width: | Height: | Size: 1.6 MiB |
|
Before Width: | Height: | Size: 1.4 MiB After Width: | Height: | Size: 1.4 MiB |
|
Before Width: | Height: | Size: 2.0 MiB After Width: | Height: | Size: 2.0 MiB |
|
Before Width: | Height: | Size: 160 KiB After Width: | Height: | Size: 160 KiB |
|
Before Width: | Height: | Size: 1.4 MiB After Width: | Height: | Size: 1.4 MiB |
|
Before Width: | Height: | Size: 1.7 MiB After Width: | Height: | Size: 1.7 MiB |
|
Before Width: | Height: | Size: 1.4 MiB After Width: | Height: | Size: 1.4 MiB |
|
Before Width: | Height: | Size: 152 KiB After Width: | Height: | Size: 152 KiB |
|
Before Width: | Height: | Size: 2.0 MiB After Width: | Height: | Size: 2.0 MiB |
|
Before Width: | Height: | Size: 1.4 MiB After Width: | Height: | Size: 1.4 MiB |
|
Before Width: | Height: | Size: 1.8 MiB After Width: | Height: | Size: 1.8 MiB |
|
Before Width: | Height: | Size: 1.3 MiB After Width: | Height: | Size: 1.3 MiB |
|
Before Width: | Height: | Size: 1.0 MiB After Width: | Height: | Size: 1.0 MiB |
|
Before Width: | Height: | Size: 2.2 MiB After Width: | Height: | Size: 2.2 MiB |
|
Before Width: | Height: | Size: 1.2 MiB After Width: | Height: | Size: 1.2 MiB |
|
Before Width: | Height: | Size: 1014 KiB After Width: | Height: | Size: 1014 KiB |
|
Before Width: | Height: | Size: 199 KiB After Width: | Height: | Size: 199 KiB |
|
Before Width: | Height: | Size: 202 KiB After Width: | Height: | Size: 202 KiB |
|
Before Width: | Height: | Size: 1.2 MiB After Width: | Height: | Size: 1.2 MiB |
|
Before Width: | Height: | Size: 28 KiB After Width: | Height: | Size: 28 KiB |
|
Before Width: | Height: | Size: 1.5 MiB After Width: | Height: | Size: 1.5 MiB |
|
Before Width: | Height: | Size: 1.2 MiB After Width: | Height: | Size: 1.2 MiB |
|
Before Width: | Height: | Size: 274 KiB After Width: | Height: | Size: 274 KiB |
|
Before Width: | Height: | Size: 253 KiB After Width: | Height: | Size: 253 KiB |
|
Before Width: | Height: | Size: 210 KiB After Width: | Height: | Size: 210 KiB |
|
Before Width: | Height: | Size: 84 KiB After Width: | Height: | Size: 84 KiB |
|
Before Width: | Height: | Size: 88 KiB After Width: | Height: | Size: 88 KiB |
|
Before Width: | Height: | Size: 83 KiB After Width: | Height: | Size: 83 KiB |
|
Before Width: | Height: | Size: 101 KiB After Width: | Height: | Size: 101 KiB |
|
Before Width: | Height: | Size: 99 KiB After Width: | Height: | Size: 99 KiB |
|
Before Width: | Height: | Size: 67 KiB After Width: | Height: | Size: 67 KiB |
|
Before Width: | Height: | Size: 220 KiB After Width: | Height: | Size: 220 KiB |
|
Before Width: | Height: | Size: 233 KiB After Width: | Height: | Size: 233 KiB |