From 3a834bcdb1d12bc31e82f0f4875150170f62b9ac Mon Sep 17 00:00:00 2001 From: CamDavidsonPilon Date: Wed, 1 Nov 2023 13:06:14 -0400 Subject: [PATCH] power troubleshooting --- .../30-Advanced/06-local-access-point.md | 14 +++++++------- .../Power troubleshooting.md | 19 +++++++++++++++++++ .../Stirring troubleshooting.md | 2 +- 3 files changed, 27 insertions(+), 8 deletions(-) create mode 100644 user-guide/50-Troubleshooting/Power troubleshooting.md diff --git a/user-guide/30-Advanced/06-local-access-point.md b/user-guide/30-Advanced/06-local-access-point.md index 5e4660ac1..f5ec22dd9 100644 --- a/user-guide/30-Advanced/06-local-access-point.md +++ b/user-guide/30-Advanced/06-local-access-point.md @@ -19,12 +19,12 @@ For some use cases, you may want to create a local WiFi network just for your Pi The Pioreactor comes with the ability to create its own local access point, which other Pioreactors can connect to. See image below: -![Using the leader Pioreactor to create a local access point](/img/user-guide/local_access_point.png) +![Using the Pioreactor to create a local access point](/img/user-guide/local_access_point.png) ## Starting a local access point -The leader Pioreactor has the necessary software to create the local access point. To start the access point: +The Pioreactor has the necessary software to create the local access point. To start the access point: - If starting with a new Pioreactor, during software set up: 1. Leave the "Configure wireless LAN" unchecked. Continue with the instructions at [Setting up your Raspberry Pi](/user-guide/software-set-up#setting-up-your-raspberry-pi). @@ -32,8 +32,8 @@ The leader Pioreactor has the necessary software to create the local access poin 3. 3. Drag/move the downloaded `local_access_point` file to the SD card directory. 4. Eject the SD card safely, and continue with instructions at [Setting up your Raspberry Pi](/user-guide/software-set-up#setting-up-your-raspberry-pi). - - If starting from an existing Pioreactor leader: - 1. with the power off remove the SD card from the leader and insert it into a computer. + - If starting from an existing Pioreactor: + 1. with the power off remove the SD card from the Pioreactor and insert it into a computer. 2. 3. Drag/move the downloaded `local_access_point` file to your SD card (called `boot` or `bootfs`). 4. Eject the SD card safely, and put back into the Pioreactor. @@ -46,9 +46,9 @@ After plugging in the Pioreactor, the local access point will start and you shou Once connected, the usual urls should work: http://pioreactor.local will bring up the Pioreactor interface (having trouble? Try `http://.local`. Still not working? Try `http://10.42.0.1`) -### Connecting workers to your local access point +### Connecting more Pioreactors to your local access point -Worker Pioreactors will need to be reconfigured to connect to this new access point. During worker set up in the Raspberry Pi Imager, using the ssid credentials: `pioreactor` and password `raspberry` in the wireless LAN section. +Other Pioreactors will need to be reconfigured to connect to this new access point. During set up in the Raspberry Pi Imager, using the ssid credentials: `pioreactor` and password `raspberry` in the wireless LAN section. **You shouldn't add the `local_access_point` file to these other Pioreactors - you only need to do that once**. :::note Since this network may not be connected to the internet, so you won't be able to upgrade any software on the Pioreactors. @@ -59,7 +59,7 @@ Since this network may not be connected to the internet, so you won't be able to If you are hosting the local access point on a Raspberry Pi that has an ethernet port (B models), you can plug this into a router that has access to the internet to provide internet to your entire cluster. -![Using the leader Pioreactor to create a local access point, and the leader is connected to a router](/img/user-guide/lap_with_internet.png) +![Using the Pioreactor to create a local access point, and the is connected to a router](/img/user-guide/lap_with_internet.png) ## Turning off a local access point diff --git a/user-guide/50-Troubleshooting/Power troubleshooting.md b/user-guide/50-Troubleshooting/Power troubleshooting.md new file mode 100644 index 000000000..3131bbdae --- /dev/null +++ b/user-guide/50-Troubleshooting/Power troubleshooting.md @@ -0,0 +1,19 @@ +--- +title: Power troubleshooting +slug: /troubleshooting-power +--- + +#### Brown-outs + +If you find that your Pioreactor is halting jobs (eg: the UI says _lost_ and stirring/motors have stopped), or you find that your Pioreactor is restarting itself often, this could be due to _brown-outs_. + +Brown-outs are when your power supply is momentarily reduced to the point that the Raspberry Pi shuts down. When the power comes back up, the Raspberry Pi will start up again. This is most likely caused by: + + +1. An inadequate power supply unit (PSU). You need to use a proper PSU (5V, at least 2.5 Amps), and certainly not a phone charger. We like the Raspberry Pi's official PSU. +2. If you are running a lot of power: high temperature, stirring, pumping often, additional LEDs (or some combination) and you are experiencing brown-outs, we suggest adding an [external power supply for the PWM outputs](https://docs.pioreactor.com/user-guide/external-power). + + +#### Pioreactor restarts when a PWM output is turned on + +If your Pioreactor restarts with a pump, stirring fan, etc. turns out, it's possible there is a short in the connectors. Email us at help@pioreactor.com diff --git a/user-guide/50-Troubleshooting/Stirring troubleshooting.md b/user-guide/50-Troubleshooting/Stirring troubleshooting.md index 6800933d4..fdcb3235d 100644 --- a/user-guide/50-Troubleshooting/Stirring troubleshooting.md +++ b/user-guide/50-Troubleshooting/Stirring troubleshooting.md @@ -52,6 +52,6 @@ Detach the top faceplate. Under the faceplate, slightly unscrew each of the four 4. Try another stir bar design, like a cross shape. -### Raspberry Pi shuts off or restarts when stirring is turned on from the UI +### Raspberry Pi shuts off or restarts when stirring is turned on This is likely caused by a short circuit in the fan's cable assembly. Remove the fan's power cable, and remove the plastic housing by applying pressure on the exposed metal tabs and gently pulling the wires out. Check for any stray wire strands and remove them. Carefully put the plastic housing back on until it clicks (red wire should be positioned closer to the GPIO pins), and try again.