power troubleshooting

user-guide/30-Advanced/06-local-access-point.md

@@ -19,21 +19,21 @@ 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).
     2. After the SD card has been written to, remove the SD card from your computer, and immediately insert it back in. A `boot` (or `bootfs`) device should be present now that is your SD card. If asked to reformat the SD card, select NO.
     3. <ButtonDownloadLocalAccessPointFile/>
     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. <ButtonDownloadLocalAccessPointFile/>
     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://<your_leaders_hostname>.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

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 [email protected]

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.