From b9473ff6b3c10d075a53da770f6453f441ee6a55 Mon Sep 17 00:00:00 2001 From: Will Barber Date: Mon, 10 Jul 2023 22:51:26 +0100 Subject: [PATCH 1/5] Arduino ammendments --- docs/kit/arduino.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) 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) From 62e4f4caa0c825534fde0d87a7361f96afe33df5 Mon Sep 17 00:00:00 2001 From: Will Barber Date: Mon, 10 Jul 2023 23:04:49 +0100 Subject: [PATCH 2/5] power board ammendments --- docs/kit/power-board.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/kit/power-board.md b/docs/kit/power-board.md index 1dc5602b..9d5c6160 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 while waiting for the start button, the Power Board will emit a beep. 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. From cfbf791a5321519ae56e472fb684190107c00645 Mon Sep 17 00:00:00 2001 From: Will Barber Date: Mon, 10 Jul 2023 23:08:08 +0100 Subject: [PATCH 3/5] Pi ammendments The LED order on the hat still needs correcting --- docs/kit/pi.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) 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. From 85090f83065bbec7a282c78610a0503471b25bee Mon Sep 17 00:00:00 2001 From: Will Barber Date: Mon, 10 Jul 2023 23:13:28 +0100 Subject: [PATCH 4/5] Servo board ammendments --- docs/kit/servo-board.md | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) 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 From 8389c8d2884a0a054442004249e42f60addd3fa7 Mon Sep 17 00:00:00 2001 From: Will Barber Date: Wed, 12 Jul 2023 20:22:28 +0100 Subject: [PATCH 5/5] Improve wording --- docs/kit/power-board.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/kit/power-board.md b/docs/kit/power-board.md index 9d5c6160..e78282fb 100644 --- a/docs/kit/power-board.md +++ b/docs/kit/power-board.md @@ -41,7 +41,7 @@ Finally, there are connectors for external Start and On|Off switches. You may co [^1]: The outputs only turn on when your program runs (specifically, when the `Robot` object is created). -On power-up and while waiting for the start button, the Power Board will emit a beep. +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.