Skip to content

Commit a137c12

Browse files
committed
ported a bunch of faq from google doc. added build folder to gitignore. split faq into logistics and technical sections
1 parent cc7ef68 commit a137c12

File tree

9 files changed

+75
-1
lines changed

9 files changed

+75
-1
lines changed

.gitignore

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,2 +1,3 @@
11
# Ignore build and task configuration files
22
.vscode/
3+
build/
258 KB
Loading
285 KB
Loading
232 KB
Loading
86.6 KB
Loading
135 KB
Loading
63.4 KB
Loading

docs/_sections/_guide-FAQ/forms.md renamed to docs/_sections/_guide-FAQ/competition_logistics.md

Lines changed: 9 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,9 @@ title: Competition Logistics
44
nav_include: true
55
nav_order: 1
66
---
7-
# Competition Logistics
7+
8+
# Competition Logistics FAQ
9+
810
## Where/when can I work on my robot?
911
Teams can work on their robot any time, but the robot and parts bag must be stored in the RAS office. So as long as a RAS leader (like your team mentor) is available to unlock the office, you can work on your robot.
1012

@@ -16,3 +18,9 @@ The night before competition day we will host an all-nighter in the EER to work
1618

1719
## What kind of additional materials can we buy?
1820
Puchasing other materials is not necessary and the components in the bag will be adequate to complete all the challenges. If you choose to purchase extra metarials though, teams can buy anything that will help them with their robot like springs, rods, and electrical components as long as the total cost is less than $25. Wood, filament, or acrylic from the TIW are not included in the $25.
21+
22+
TODO address given materials not being enough to finish mechanical challenge as of 1/15/2025
23+
24+
## Do you have x item?
25+
26+
TODO make list of things
Lines changed: 65 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,65 @@
1+
---
2+
layout: default
3+
title: Technical
4+
nav_include: true
5+
nav_order: 1
6+
---
7+
8+
# Technical FAQ
9+
10+
## Why does my build fail?
11+
12+
## What is the difference between cloning using HTTPS and SSH?
13+
HTTPS (Hypertext Transfer Protocol Secure) and SSH (Secure Shell) are both data transfer protocols used in networking
14+
15+
The main reason why you should use SSH over HTTPS is that you can push code to your repositories without having to input credentials each time (HTTPS requires credentials each push, which is annoying).
16+
TODO elaborate more
17+
18+
## How do I navigate the bash terminal for Robotathon?
19+
20+
## How do I find out what my controller’s Bluetooth address is?
21+
1. Plug in your ESP32 and flash it with the starter code in your forked repository if you haven't already
22+
1. Open the serial monitor
23+
1. You should see this in the serial monitor while trying to connect your controller:
24+
<img src="{{ '/_assets/images/controller_address.png' | prepend: site.baseurl }}" alt="controller_address :(">
25+
The string of octets (something like “98:B6:E1:7C:C3:95”) is your controller’s Bluetooth address
26+
27+
## How do I connect my controller?
28+
1. Make sure you have added your controller’s Bluetooth address to the ESP32 ([How do I do that?](TODO WRITE THIS))
29+
1. Power and flash ESP32 with starter code
30+
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
31+
1. Controller should connect automatically
32+
33+
## I've tried to add my controller's Bluetooth address, but my controller still isn't connecting!
34+
There is a maximum storage of 4 Bluetooth addresses in the allow-list. Simply remove an existing one and replace it with your controller’s Bluetooth address.
35+
<img src="{{ '/_assets/images/allowlist_list.png' | prepend: site.baseurl }}" alt="allowlist_list :(">
36+
<img src="{{ '/_assets/images/allowlist_remove.png' | prepend: site.baseurl }}" alt="allowlist_remove :(">
37+
<img src="{{ '/_assets/images/allowlist_add.png' | prepend: site.baseurl }}" alt="allowlist_add :(">
38+
39+
If this fails, then try [hard resetting your ESP32’s flash memory](https://randomnerdtutorials.com/esp32-erase-flash-memory/)
40+
41+
42+
## I tried doing the above, but my controller isn’t connecting! How do I troubleshoot?(See the [official docs](https://bluepad32.readthedocs.io/en/latest/FAQ/#:~:text=true)%3B%0A%7D-,Using%20allowlist%20commands%20from%20the%20USB%20console,%C2%B6,-Note)
43+
44+
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.
45+
46+
Try manually adding your controller's Bluetooth address through the serial terminal
47+
48+
## I can’t flash my ESP32 because of a “fatal error”! What should I do?
49+
<img src="{{ '/_assets/images/fatal_error.png' | prepend: site.baseurl }}" alt="fatal_error.png :(">
50+
51+
It sounds silly, but first check if your ESP32 is plugged in.
52+
53+
Otherwise, this is usually caused by one of the other terminals in VS Code occupying the serial port.
54+
55+
<img src="{{ '/_assets/images/trash_terminal.png' | prepend: site.baseurl }}" alt="trash_terminal.png :(">
56+
Delete all the terminals by clicking the trash icon for all of them and then try clicking the flash button again.
57+
58+
If that fails, close VS Code and reopen it.
59+
60+
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).
61+
62+
## How to calibrate the QTR line sensor?
63+
64+
<!-- ## Why doesn’t anything show up when I try printing to the serial monitor? -->
65+
<!-- idk if this is actually na issue?? -->

0 commit comments

Comments
 (0)