Skip to content

Commit 9ef47f0

Browse files
committed
kys
1 parent c895bd5 commit 9ef47f0

File tree

2 files changed

+17
-4
lines changed

2 files changed

+17
-4
lines changed

docs/_sections/_guide-primaries/getting-started/bluepad.md

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -18,8 +18,10 @@ It is highly recommended that you map autonomous sensors modes (line, color, dis
1818

1919
See [BluePad32's official docs](https://bluepad32.readthedocs.io/en/latest/FAQ/#:~:text=true%3B%0A%7D-,Using%20allowlist%20commands%20from%20the%20USB%20console,%C2%B6,-Note) if you'd like to see other features.
2020

21-
2221
First you will need to find out what your controller's Bluetooth address is.
22+
{: .highlight}
23+
Note that your controller will likely have the address already labeled on it for ease of use, so you can easily jump to Step 4
24+
{: .callout-blue}
2325
1. Plug in your ESP32 and flash it with the starter code
2426
1. Open the serial monitor
2527
1. You should see your controller address as a string of octets (something like `98:B6:E1:7C:C3:95`) in the serial monitor while trying to connect your controller (press and hold power button on controller until lights slowly and then rapidly move to put it in pairing mode):

docs/_sections/_guide-primaries/sensors-and-actuators/line-sensors.md

Lines changed: 14 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -9,16 +9,29 @@ nav_order: 4
99
# Line Sensor
1010
A necessary component for any challenge that requires your robot to follow a line. This one is the QTR-8A Reflectance Sensor Array and uses IR transmitters and receivers on it to detect lines.
1111

12+
## Workshop Slides
13+
<iframe src="https://docs.google.com/presentation/d/1Hs6NceBqnyrwj3lxO_192RLk6LQGkcfpnS2Lv2SEOHE/embed?start=false"
14+
frameborder="0"
15+
width="960"
16+
height="569"
17+
allowfullscreen="true"
18+
mozallowfullscreen="true"
19+
webkitallowfullscreen="true">
20+
</iframe>
21+
1222
## How it Works
1323
The line sensor is made up of an array of 8 IR LED/phototransistor pairs, each take an analog reflectance reading by timing how long it takes the output voltage to decay due to the phototransistor. By pointing the line sensor IR LEDs/phototransistors at the line, the robot is able to tell where the dark line of tape is by reading the output voltage of each phototransistor
1424

1525
This side of the sensor will be facing the floor to detect the line:
1626
<img src="{{ '/_assets/images/line_sensor_diodes.png' | prepend: site.baseurl }}" alt="line_sensor_diodes.png">
1727

1828
{: .highlight}
19-
You do NOT have to use all 8 of the LED/phototransistor pairs — You can leave the ones you do not want to use disconnected from the ESP32.
29+
Keep in mind that the QTR line sensor has two 5V pins that are connected to each other! They are identical in function besides being in a different location
2030
{: .callout-blue}
2131

32+
TODO decide if we want to make them use the LEDON pin
33+
TODO add backside pinout with labels
34+
2235
<img src="{{ '/_assets/images/line_sensor_wire_diagram.png' | prepend: site.baseurl }}" alt="line_sensor_wire_diagram.png">
2336

2437
| Line Sensor Pin | ESP32 Pin |
@@ -39,7 +52,6 @@ The following program will allow you to continuously read the sensor data from 2
3952
After the calibration process, you should see the values in the terminal change as you shift the sensors over the black tape.
4053

4154
```cpp
42-
4355
#include "sdkconfig.h"
4456
#include <Arduino.h>
4557

@@ -67,7 +79,6 @@ void loop() {
6779
Console.printf("S1: %d S2: %d\n", sensors[0], sensors[1]);
6880
delay(250);
6981
}
70-
7182
```
7283

7384
TIP: Always calibrate your line sensor to ensure consistent and accurate results.

0 commit comments

Comments
 (0)