Skip to content

Commit

Permalink
updates
Browse files Browse the repository at this point in the history
  • Loading branch information
CamDavidsonPilon committed Jan 26, 2024
1 parent ebd9818 commit 1b2b236
Show file tree
Hide file tree
Showing 3 changed files with 13 additions and 6 deletions.
9 changes: 4 additions & 5 deletions user-guide/01-getting-started/01c-software-set-up.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -75,9 +75,9 @@ What is an image file? It's a file that contains all the required software prein
6. Click **Save** to save and exit the dialog box.

7. Click "Yes" to begin writing. A prompt *may* appear asking for permission to write, accept it. Writing will take up to 5 minutes. Perfect time for a tea break.
7. Once writing is complete, remove the microSD card, and place it (exposed copper side up) into the Raspberry Pi. **Your Raspberry Pi's power should be unplugged before inserting the microSD card**. The microSD slot is located on the PWM side of the Pioreactor, in the gap between the Raspberry Pi and the bottom faceplate. Reference the picture for the orientation.
7. Once writing is complete, remove the microSD card, and place it into the Raspberry Pi. **Your Raspberry Pi's power should be unplugged before inserting the microSD card**. The microSD slot is located on the PWM side of the Pioreactor. Example for a Raspberry Pi A model:

![Insert the microSD card](/img/user-guide/place-micro-sd-card.JPG)
![Insert the microSD card into a Raspberry Pi A model](/img/user-guide/place-micro-sd-card.JPG)

8. Plug power into your Raspberry Pi. LEDs onboard the Raspberry Pi may start to light up momentarily. After **a few minutes**, your Pioreactor HAT will briefly blink a blue LED, telling us it is ready.

Expand Down Expand Up @@ -112,7 +112,7 @@ Below is a screenshot of example settings, your settings might be slightly diffe
<img src="/img/user-guide/rpi-imager-settings-worker.png" width="625" alt="Screenshot of what your settings should look like" style={{margin: "auto", display:"block"}} />


2. After the image is written to the microSD card, place the microSD card into the Raspberry Pi and power it on. The Pioreactor's blue LED won't blink, as it's not 100% ready yet.
2. After the image is written to the microSD card, place the microSD card into the Raspberry Pi and power it on. The Pioreactor's blue LED will light up and stay on, indicating that it's ready to be connected. Move onto the next step.

3. After a few minutes, connect the new Pioreactor worker to your cluster using the UI. See next steps.

Expand All @@ -126,8 +126,7 @@ Provide the chosen hostname of the new worker Pioreactor:

![Add new pioreactor modal](/img/user-guide/add_new_pioreactor_modal.png)


After a minute, the new Pioreactor should appear on the _Pioreactors_ and _Experiment Overview_ page. Refresh the page if it does not show up. Your new Pioreactor will also blink its blue LED.
After a minute, the worker's blue LED will turn off, and the new Pioreactor should appear on the _Pioreactors_ and _Experiment Overview_ page. Refresh the page if it does not show up. Your new worker Pioreactor will also blink its blue LED telling you it's online.


#### From the command line _(Alternative)_
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -24,9 +24,9 @@ common: # Optional: jobs that are common for all Pioreactors
actions:
- type: <string> # Type of action: "start", "pause", "resume", "stop", "update", or "log"
hours_elapsed: <float> # When the action is scheduled (in hours after experiment start)
if: <string> # optional
options: # Optional: parameters for the action. If type=log, message= is required here.
<option_name>: <value>
<option_name>: <value>
arguments: <list> # Optional: arguments for the action

pioreactors: # Optional: jobs that are specific to some Pioreactors
Expand All @@ -37,7 +37,9 @@ pioreactors: # Optional: jobs that are specific to some Pioreactors
actions:
- type: <string> # Type of action: "start", "pause", "resume", "stop", or "update"
hours_elapsed: <float> # When the action is scheduled (in hours after experiment start)
if: <string> # Optional, can be an expression
options: # Optional: parameters for the action
<option_name>: <value> # value can be an expression, but use ${{ }}
<option_name>: <value>
```
Expand Down
6 changes: 6 additions & 0 deletions user-guide/50-Troubleshooting/04-error-codes.md
Original file line number Diff line number Diff line change
Expand Up @@ -17,3 +17,9 @@ When a Pioreactor successfully boots, the onboard blue LED will flash quickly fo
| 8 | Webserver offline |



-----

### The blue LED is constantly on?

If your blue LED is constantly on, it suggests either an hardware error, or that your Pioreactor is missing it's config.ini. Try a reboot, and if it persists, SSH in and check for the file `~/.pioreactor/config.ini`. If that file is missing, it's either a worker that hasn't been connected to a cluster, or some part of the installation has gone wrong.

0 comments on commit 1b2b236

Please sign in to comment.