diff --git a/docs/kit/arduino.md b/docs/kit/arduino.md index f6138c93..de5db94c 100644 --- a/docs/kit/arduino.md +++ b/docs/kit/arduino.md @@ -15,7 +15,7 @@ isn't working. This isn't a guaranteed fix, but may solve some problems. ## GPIO Pins -The Arduino allows you to connect your kit to your own electronics. It has fourteen digital I/O pins, and six analogue input pins. The analogue pins can read an analogue signal from 0 to 5V. The board also has a couple of ground pins, as well as some pins fixed at 3.3V and 5V output. +The Arduino allows you to connect your kit to your own electronics. It has fourteen digital I/O pins, and six analogue input pins. The analogue pins can read an analogue signal from 0 to 5V and the digital pins can receive or send digital signals at 0V & 5V. The board also has a couple of ground pins, as well as some pins fixed at 3.3V and 5V output to supply power to your sensors. ![Pin Map](../assets/img/kit/arduino_pinout.png) diff --git a/docs/kit/pi.md b/docs/kit/pi.md index 4beea224..02081a1c 100644 --- a/docs/kit/pi.md +++ b/docs/kit/pi.md @@ -5,7 +5,7 @@ ![Raspberry Pi 3B+](../assets/img/kit/pi.jpg){ width="50%" } -The brain of your robot is a Raspberry Pi 3 / 3B+. This handles the running of your python code, recognition of markers and sends control commands to the other boards. +The brain of your robot is a Raspberry Pi 3B+. This handles the running of your python code, recognition of markers and sends control commands to the other boards. ## Power Hat @@ -31,6 +31,6 @@ All LEDs will turn on at boot. After the Pi detects a USB stick, the LEDs work a Your robot is running a customised version of the [Raspberry Pi OS](https://www.raspberrypi.com/software/) operating system. -When a USB stick is inserted, the SourceBots software will look for a file named `main.py`, and then execute it. +When a USB stick is inserted, the SourceBots software will look for a file named `robot.py`, and then execute it. The output of your code is written to a file named `log.txt` on the USB stick. diff --git a/docs/kit/power-board.md b/docs/kit/power-board.md index 1dc5602b..e78282fb 100644 --- a/docs/kit/power-board.md +++ b/docs/kit/power-board.md @@ -22,9 +22,9 @@ They should be used to connect to the motor board power input, though can also be used to power other devices. These are enabled when your robot code is started and can also be turned on or off from your code. -There are two 5V connectors that can be used to connect low-current devices that take 5V inputs, such as the Raspberry Pi and the servo shield. +There are two 5V connectors that can be used to connect low-current devices that take 5V inputs, such as the Raspberry Pi. -There is also a Micro USB B connector which should be used to connect the Raspberry Pi for control of the power board. +There is also a Micro USB B connector which should be connected to the Raspberry Pi for control of the power board. Finally, there are connectors for external Start and On|Off switches. You may connect any latching switch for the On|Off switch, or a push-to-make button for the Start button. @@ -37,11 +37,11 @@ Finally, there are connectors for external Start and On|Off switches. You may co | PWR\|FLAT | Green when powered
Flashing red and green when the battery is low | Green | | 5V | Green when 5V is being supplied | Green | | H0–1, L0–3 | Green when the corresponding output is on [^1]
Red when the output's current limit is reached | Off | -| RUN\|ERROR | Orange on power-up, or USB reset
Flashing green when ready to run
Solid green when running or booting | Orange | +| RUN\|ERROR | Orange on power-up, or USB disconnection
Flashing green when ready to run
Solid green when running or booting | Orange | [^1]: The outputs only turn on when your program runs (specifically, when the `Robot` object is created). -On power-up, the Power Board will emit some beeps, which are related to the version of the firmware it has installed. +On power-up and when waiting for the start button, the Power Board will beep once. If the Power Board starts beeping (and all the outputs turn off) then this means that the whole board's current limit has been triggered. diff --git a/docs/kit/servo-board.md b/docs/kit/servo-board.md index 659da571..58d33b82 100644 --- a/docs/kit/servo-board.md +++ b/docs/kit/servo-board.md @@ -22,7 +22,10 @@ brown wire) at the bottom of the board. For the servo board to operate correctly, you must connect it to the 12V power rail from the power board. A green LED will light next to the -servo board 12V connector when it is correctly powered. +servo board 12V connector when it is correctly powered and the 8 outputs +on the left-side of the board can be used. + +To use the 4 auxillary outputs on the right-side of the board, 5V needs to be connected to the auxillary input. ## Case Dimensions