moved bluetooth connection faq stuff to dedicated bluetooth page. added power file in main guide. moved reading datasheets to resources

Author: tguyenn

docs/_assets/images/add_bluetooth.png

@@ -26,4 +26,6 @@ TODO address given materials not being enough to finish mechanical challenge as
 TODO make list of things 
 
 ## Where can we store our robot in the RAS office?
-TODO
+TODO
+
+## What can we keep after the competition?

docs/_sections/_guide-FAQ/competition_logistics.md

@@ -25,18 +25,12 @@ There is a maximum storage of 4 Bluetooth addresses in the allow-list. Simply re
 <img src="{{ '/_assets/images/allowlist_remove.png' | prepend: site.baseurl }}" alt="allowlist_remove :(">
 <img src="{{ '/_assets/images/allowlist_add.png' | prepend: site.baseurl }}" alt="allowlist_add :(">
 
+If this fails, then try [hard resetting your ESP32’s flash memory](https://randomnerdtutorials.com/esp32-erase-flash-memory/) and try again!
 
-## I tried doing the above, but my controller isn’t connecting! How do I troubleshoot?
-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)
 
-This is probably an issue with BluePad32’s whitelisted connections. You will not be able to connect your controller to the ESP32 without adding your controller’s Bluetooth address to the whitelist.
-
-Try manually adding your controller's Bluetooth address through the serial terminal
-
-If this fails, then try [hard resetting your ESP32’s flash memory](https://randomnerdtutorials.com/esp32-erase-flash-memory/)
 
 ## Why bother with the whitelisted Bluetooth connections for the controller?
-In previous years, connecting the controller when many robots were powered on in close proximity was a nightmare because connecting to the wrong robot was unfortunately inevitable.
+Connecting the controller without a specific address when many robots are powered on in close proximity is a nightmare.
 
 ## I can’t flash my ESP32 because of a “fatal error”! What should I do?
 <img src="{{ '/_assets/images/fatal_error.png' | prepend: site.baseurl }}" alt="fatal_error.png :(">
@@ -52,16 +46,13 @@ If that fails, close VS Code and reopen it.
 
 If *that* fails, then check if there are any other applications on your computer that are occupying the COM port (extreme solution is to restart computer).
 
-## How to calibrate the QTR line sensor?
-TODO actualy make sure u incorporate this in the main guide portion lol
-
 ## How does the ESP-IDF build system work?
 This information is not required for the competition, but it can be good to know if you'd like to continue IoT develpoment with Espressif MCU's.
 
 Here is a link to their official documentation: [https://docs.espressif.com/projects/esp-idf/en/latest/esp32/api-guides/build-system.html#component-requirements](https://docs.espressif.com/projects/esp-idf/en/latest/esp32/api-guides/build-system.html#component-requirements)
 
 ## What is ESP-IDF?
-ESP-IDF (**Esp**ressif **I**oT **D**evelopment **F**ramework) is the official development framework for building applications for Espressif's ESP32 microcontroller series.
+ESP-IDF (**Esp**ressif **I**oT **D**evelopment **F**ramework) is the official development framework for Espressif's ESP32 microcontroller series.
 
 For Robotathon, you will use the VS Code ESP-IDF extension to develop your robot's software.
 

docs/_sections/_guide-FAQ/technical.md

@@ -8,26 +8,37 @@ nav_order: 6
 
 # Bluetooth Controller
 
-The purpose of the remote controller is to allow manual control of your robot for triggering your autonomous modes, moving between challenges, and firing your launching mechanism.
+You will be connecting a game controller to your ESP32 for controlling your robot (i.e. triggering autonomous modes, moving between challenges, and firing your launching mechanism)
 
-That being said, you will not be allowed to manually drive your robot through the challenges, as that defeats the purpose of having the sensors
+That being said, you will not be allowed to manually drive your robot through the challenges, as that defeats the purpose of having the sensors.
 
-It is highly recommended that you program specific functions of the sensors (line, color, distance) to specific buttons on the remote controller so that you have more control over your robot's behavior (i.e. press A -> color sensing mode).
+It is highly recommended that you program specific functions of the sensors (line, color, distance) to specific buttons on the remote controller so that you have more control over your robot's behavior (i.e. press A -> color autonomy mode, press B -> exit to normal drive mode).
 
+## Connecting the Controller
 
+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.
 
-## How do I find out what my controller’s Bluetooth address is?
-1. Plug in your ESP32 and flash it with the starter code in your forked repository if you haven't already
+
+First you will need to find out what your controller's Bluetooth address is.
+1. Plug in your ESP32 and flash it with the starter code
 1. Open the serial monitor
-1. You should see this in the serial monitor while trying to connect your controller:
+1. You should see this in the serial monitor while trying to connect your controller (press and hold power button on controller until lights slowly and then rapidly move):
 <img src="{{ '/_assets/images/controller_address.png' | prepend: site.baseurl }}" alt="controller_address :(">
-The string of octets (something like “98:B6:E1:7C:C3:95”) is your controller’s Bluetooth address
+The string of octets (something like `98:B6:E1:7C:C3:95`) is your controller’s Bluetooth address
+
+1. Try adding your controller's Bluetooth address through the serial terminal:
+<img src="{{ '/_assets/images/add_bluetooth.png' | prepend: site.baseurl }}" alt="add_bluetooth.png :(">
+
+1. Controller should connect automatically, and the controller data should begin streaming in the serial monitor
+
+## Using the Controller
+
+- BP32.update()
+- for loop in loop()
+    - todo: actually figure out how the iterator works and make it something more standard to be understandable by anyone
+
+- accessing controller data
 
-## How do I connect my controller?
-1. Make sure you have added your controller’s Bluetooth address to the ESP32 ([How do I do that?](TODO WRITE THIS))
-1. Power and flash ESP32 with starter code
-1. Press and hold the home button on your controller (big H button in the middle) until the lights turn on and then speed up
-1. Controller should connect automatically
 
 
 

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

@@ -8,6 +8,8 @@ parent: Getting Started
 nav_order: 3
 ---
 
+# Environment Setup
+
 The exact process to arrive at this goal depends on what OS your computer is running (Windows, macOS, etc.), so this article will be split into Windows and MacOS setup. If you happen to use another OS, then talk to a mentor for help.
 
 The end goal of this section is to flash your ESP32 with an LED blink program. It will take you from having nothing installed to the full coding environment you'll need for the competition!  

docs/_sections/_guide-primaries/getting-started/environment-setup/environment-setup.md

@@ -7,7 +7,7 @@ grand_parent: Getting Started
 nav_order: 1
 ---
 
-## macOS Setup
+# macOS Setup
 https://docs.espressif.com/projects/vscode-esp-idf-extension/en/latest/installation.html
 
 

docs/_sections/_guide-primaries/getting-started/environment-setup/mac-setup.md

@@ -7,7 +7,7 @@ grand_parent: Getting Started
 nav_order: 1
 ---
 
-## Windows Setup
+# Windows Setup
 
 {: .highlight}
 It is highly recommended to follow each component installation in order!

docs/_sections/_guide-primaries/getting-started/environment-setup/windows-setup.md

@@ -92,6 +92,9 @@ It is your job to go into the file and delete **all** the special markers along
 
 For example, let's say we had some C++ file that had a merge conflict:
 
+
+TODO make this code something more like robotathon code?? (oh no oh no namespaces oh no)
+
 ```cpp
 #include <iostream>
 
@@ -106,7 +109,7 @@ int main() {
 }
 ```
 
-You would have to modify the content accordingly to look something like this:
+You could modify the content accordingly to look something like this:
 ```cpp
 #include <iostream>
 

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

@@ -3,7 +3,7 @@ layout: default
 title: Actuators
 nav_include: true
 parent: Sensors and Actuators
-nav_order: 4
+nav_order: 5
 ---
 
 # Actuators

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

@@ -3,7 +3,7 @@ layout: default
 title: Color Sensor
 nav_include: true
 parent: Sensors and Actuators
-nav_order: 1
+nav_order: 2
 ---
 
 # Color Sensor