added mainboard-pins.md, wire connection for servo, advanced tutorials date venue

Author: DicaprioCheung

README.md

@@ -10,6 +10,20 @@ Here is a brief overview of our schedule:
 
 <figure><img src="images/2024-schedule.png" alt=""><figcaption><p>2024 schedule</p></figcaption></figure>
 
+## New Update!!!
+
+Advanced Tutorial details for Trainees who could join the next phase:
+(if you submitted most of the stuff and attended all tutorials, you are likely to join the next phase)
+
+Advanced Tutorial 1: Image Processing
+- 19 Oct 2024 (Sat) 14:00 - 17:00 Room 2302(Lift 17/18) (Remarks: 1 hour after COMP 2012 midterm)
+- 21 Oct 2024 (Mon) 19:00 - 22:00 Room 2303(Lift 17/18)
+
+Advanced Tutorial 2: CAN and RM Motor Control
+- 23 Oct 2024 (Wed) 19:00 - 22:00 Room 2405(Lift 17/18)
+- 24 Oct 2024 (Thur) 19:00 - 22:00 Room 5619(Lift 31/32)
+---
+
 [Homework arrangement](homework-demo-arrangements.md)
 
 * [Tutorial 0: self-learning basic C](tutorial-0-self-learn-basic-c/README.md)
@@ -20,6 +34,6 @@ Here is a brief overview of our schedule:
 
 [Lists of Links](SUMMARY.md)
 
-Advanced tutorials will be held later in the next phase and their dates are still TBD. There are also advanced notes for your own reading. Feel free to reach out to any team members if you have any questions about anything related to the tutorials or the team in general.
+Advanced tutorials will be held later in the next phase. There are also advanced notes for your own reading. Feel free to reach out to any team members if you have any questions about anything related to the tutorials or the team in general.
 
 Please also make sure to join our [Discord](https://discord.gg/PNnQdjzt58) server for more important announcements.

SUMMARY.md

@@ -57,9 +57,10 @@
 
 ## [TUTORIAL 3: Advanced IO](tutorial-3-advanced-io/README.md)
 
-* [01) PWM and Servo motor](tutorial-3-advanced-io/01-pwm-and-servo.md)
-* [02) Classwork](tutorial-3-advanced-io/02-classwork.md)
-* [03) Homework](tutorial-3-advanced-io/03-homework.md)
+* [01) Mainboard Pins](01-mainboard-pins.md)
+* [02) PWM and Servo motor](tutorial-3-advanced-io/02-pwm-and-servo.md)
+* [03) Classwork](tutorial-3-advanced-io/03-classwork.md)
+* [04) Homework](tutorial-3-advanced-io/04-homework.md)
 
 ## [TUTORIAL 4: UART](tutorial-4-uart/README.md)
 

tutorial-3-advanced-io/01-mainboard-pins.md

@@ -0,0 +1,134 @@
+# Mainboard PINS
+[Back to Main](README.md) | 
+
+> Let's plug the wires ourselves
+
+<details>
+
+<summary>Authors</summary>
+
+Dicaprio Cheung
+
+</details>
+
+# Mainboard pins
+
+This is a summary of all different pins of our mainboard.
+
+There is a 24V power input for us to connect to the battery. If your laptop is not strong enough to power the servo motor/other stuff, you need to connect to the battery.
+
+There is also a fuse to prevent burning. (although i never see the fuse on the mainboard burn before... it is always the mainboard burn first...)
+
+![](images/mainboard_full.png)
+
+## SWD
+
+This is the port where we used to flash code
+
+![](images/SWD_pins.png)
+
+You can connect the SWD to the corresponding pins of ST Link.
+
+> keep in mind that there are 2 layers of pins in ST Link. Please plug in the correct layer
+
+![](images/stlink-v2.png)
+
+## 5V GPIO pins
+
+This is a normal 5V GPIO pin. 
+
+![](images/GPIO_pins.png)
+
+We usually plug
+- limit switches
+- line following sensor
+- small servo motor
+- IR sensor
+- Ultrasonic sensor
+- etc.
+
+in these ports
+
+## 24V GPIO pins
+
+This is a special GPIO pin that outputs 24V when connected to the 24 V battery
+
+![](images/Pneumatic_pins.png)
+
+We usually plug 24V Pneumatic Solenoid Valve to it. (Then, the pneumatic valve connect to the pneumatic cylinder we demo-ed in Tutorial 2)
+
+![A picture of Pneumatic Valve](../tutorial-2-basic-io/image/Festo_Pneumatic_valve.png)
+
+> There are some old mainboard (Green, Reset button NOT next to other buttons) that uses 12V battery instead. So, they can only connect 12V Pneumatic Solenoid Valve
+
+
+## UART pins
+
+> will be taught in Tutorial 4
+
+This is a UART pin.
+
+![](images/UART_pins.png)
+
+We usually plug
+- Bluetooth
+- TTL
+- TOF sensor 
+- etc.
+
+in these ports
+
+## CAN pins
+
+> will be taught in Advanced Tutorial 2
+
+This is a CAN port.
+
+![](images/CAN_pins.png)
+
+We usually plug
+- ESC(Electronic Speed Controller) of Motors
+- Other CAN ports of other boards
+- etc.
+
+in these ports
+
+# Different connector heads of ports
+
+Since Hardware department is experimenting with new connectors of the ports, there are many different connector heads
+
+## Molex Connector
+
+Molex Connector is the traditional one that we used in the previous years. It is black in color and we solder it on all SWD ports.
+
+The most common one is the 4 pin one but there are 2, 3, 5, 6 pin versions of them.
+
+![](images/molex.png)
+
+## XA Connector
+
+XA Connector is the rarest one because it is only soldered on the boards made in Spring 2024. It is in brownish-white color or we call it rice color in chinese.
+
+The most common one is the 4 pin one but there are 2, 3, 5, 6 pin versions of them.
+
+![](images/XA1.jpg) 
+![](images/XA2.jpeg)
+
+
+## XH Connector
+
+XH Connector is the newest one and is soldered on most of the new mainboards you are using. It is white in color and is soldered on all ports except SWD.
+
+The most common one is the 4 pin one but there are 2, 3, 5, 6 pin versions of them.
+
+![](images/XH.jpg)
+
+## Rainbow wires
+
+When we are lazy, we will just use rainbow wires to connect things. You can tear a few wires out to use it when you need.
+
+> DO NOT CONNECT VOLTAGE AND GROUND TOGETHER OR YOU WILL BURN YOUR BOARD!!!
+
+![](images/rainbow-wires.jpg)
+
+[Continue to next page](./02-pwm-and-servo.md)

tutorial-3-advanced-io/02-classwork.md

@@ -11,7 +11,7 @@ Find 3 possible combinations of prescaler value and auto-reload values for contr
 
 > Hint: *** Remember they are `uint16_t` . So, they can only be 0 to 65535***
 
-[Back to notes](01-pwm-and-servo.md#timer)
+[Back to notes](02-pwm-and-servo.md#timer)
 
 ## Classwork 2
 
@@ -21,7 +21,7 @@ Calculate the CCR value for moving the servo to -90, 0, and 90 degree. (1 ms, 1.
 
 > Yes, this is another MATH question.
 
-[Back to notes](01-pwm-and-servo.md#channel)
+[Back to notes](02-pwm-and-servo.md#channel)
 
 ## Classwork 3
 
@@ -33,4 +33,4 @@ Try to control servo motor to turn to -90 degrees-> 0 degrees -> 90 degrees (wit
 
 > Note: We are using TIM5 and channel 1
 
-[Back to notes](01-pwm-and-servo.md#start-coding!!!)
+[Back to notes](02-pwm-and-servo.md#start-coding!!!)

tutorial-3-advanced-io/01-pwm-and-servo.md renamed to tutorial-3-advanced-io/04-pwm-and-servo.md

@@ -1,5 +1,5 @@
 # PWM and Servo motor
-[Back to Main](README.md)
+[Back to Main](README.md) | [Previous Page](01-mainboard-pins.md)
 
 > the tutorial with the most math
 
@@ -76,7 +76,7 @@ We will connect the timer to the servo motor. So, the Timer frequency = your des
 
 ### Classwork 1
 
-> [Classwork 1](02-classwork.md#classwork-1)
+> [Classwork 1](03-classwork.md#classwork-1)
 
 
 ## Channel
@@ -106,7 +106,7 @@ The ARR (auto reload register) from the previous paragraph is used as a downscal
 
 ### Classwork 2
 
-> [Classwork 2](02-classwork.md#classwork-2)
+> [Classwork 2](03-classwork.md#classwork-2)
 
 ### Deep thinking: How to choose PSC and ARR?
 
@@ -139,6 +139,14 @@ There are 4 steps in setting up the PWM output channel and the pin to use.
 
 ![](https://i.imgur.com/MzvaMDI.png)
 
+5. Connect the servo motor to the correct pins of your mainboard
+
+- Orange PWM wire of servo connect to the pin you chose (PC7(TIM3\_CH2) for the example above)
+- Red 5V wire of servo connect to Vcc(Voltage) of GPIO port
+- Brown GND wire of servo connect to GND(Ground) of GPIO port
+
+![](images/Servo-wires.png)![](images/GPIO_pins.png)
+
 ### Start Coding!!!
 
 There are 4 steps in coding:
@@ -213,4 +221,4 @@ while (1) {
 
 ### Classwork 3
 
-> [Classwork 3](02-classwork.md#classwork-3)
+> [Classwork 3](03-classwork.md#classwork-3)

tutorial-3-advanced-io/README.md

@@ -14,6 +14,8 @@ Homeworks: show your working mainboard + servo to our seniors in Hall 9 Lab afte
 |Venue|Room 6580 (Lift 27/28)|Room 4582 (Lift 27/28)|Room 6580 (Lift 27/28)|
 |Tutorial 3 Homework Deadline|14 Oct(Mon) 18:00|16 Oct(Wed) 18:00|17 Oct(Thur) 18:00|
 
+> Unlike other homework, we will NOT accept late Tutorial 3 Homework. We will NOT accept any classworks after Tutorial 4
+
 ### Tutorial 3 targets
 
 * configure a PWM signal for a servo
@@ -22,6 +24,7 @@ Homeworks: show your working mainboard + servo to our seniors in Hall 9 Lab afte
 
 ## Tutorial 3 Links
 
-* [PWM and Servo motor](01-pwm-and-servo.md)
-* [Classwork](02-classwork.md)
-* [Homework](03-homework.md)
+* [Mainboard Pins](01-mainboard-pins.md)
+* [PWM and Servo motor](02-pwm-and-servo.md)
+* [Classwork](03-classwork.md)
+* [Homework](04-homework.md)