View source for S23: Meh-sla Automotive

== Project Title ==
¯\_(ツ)_/¯  Meh-Sla Automotive ¯\_(ツ)_/¯

<BR/>

== Abstract ==
The ultimate goal of the project is to design an autonomous car which navigate from its current location to a destination. Along it's way it needs to avoid the obstacles and follow the waypoints. To achieve this we are using four SJ2 boards which communicates with each other via CAN bus along with required sensors and a mobile app which communicates with one of the SJ2 boards via Bluetooth.
Through our experience, we knew that we wouldn't be the Worst-Sla.  We say that we are Meh-Sla even though we know we are the Best-Sla.

=== Introduction ===

The project was divided into 5 modules:

'''1) Sensor and bridge controller: '''
* Interfaced with 4 ultrasonic sensors for obstacle detection.
* Interfaced with a Bluetooth module for the controller to mobile app communication.

'''2) Motor controller: ''' 
* Interfaced with vehicle motor to control its speed and steering.
* Interfaced with RPM sensors to get feedback about the vehicle's speed.

'''3) Geographical controller: '''
* Interfaced with a magnetometer to get the current heading of the vehicle.
* Interfaced with a GPS module to get the current location information.

'''4) Driver and LCD controller: ''' 
* Process information from the sensor and geological board, and send speed and steering to the motor board based on obstacle avoidance and path determination algorithm.
* Interfaced with an LCD module to display the vehicle status.

'''5) Mobile App: ''' 
* Communicates over Bluetooth.
* Sends destination location or start/stop signal to the car.
* Receives sensor and other navigation status and displays it.

=== Team Members & Responsibilities ===
[[File: Mehsla Group enhanced.png|500px]]

[https://gitlab.com/karthigaiamutha.ezhilarasu/meh-sla-automotive Gitlab Project Link]
<BR/>


''''' [https://www.linkedin.com/in/anthonyzunino/ Tony Zunino] '''''
* Team Lead
* Motor Board

''''' [https://www.linkedin.com/in/sindhuja-ravi/ Sindhuja Ravi] '''''
* Geo Board
* Android App

''''' [https://www.linkedin.com/in/stephen-oneto-7836641b9/ Stephen Oneto] '''''
* Driver and LCD Board

[[File:Mehsla_Amutha.jpg|350px]]

''''' [https://www.linkedin.com/in/amutha-ezhil/ Karthigai Amutha Ezhilarasu] '''''
* Sensor Board
* Geo Board

[[File:Mehsla_Phil.jpg|350px]]

''''' [https://www.linkedin.com/in/phil-bloxom/ Phil Bloxom] '''''
* Hardware Design
* Software Testing

<HR>
<BR/>

== Schedule ==

{| class="wikitable" 
|-
! Week #
! Start Date
! End Date
! Task
! Status
|-
| 1
| 2/12/2023
| 2/18/2023
|
*<span>Read previous projects, gather information and discuss among group members</span>
|
*<font color = "green">Completed
|-
| 2
| 2/19/2023
| 2/25/2023
|
*<span>Brainstorm on the requirements for the project</span>
*<span>Create a high-level block diagram of the project</span>
|
*<font color = "green">Completed
*<font color = "green">Completed
|-
| 3
| 26/2/2023
| 3/4/2023
|
*<span>Order the RC Car</span>
*<span>Order all the sensors</span>
|
*<font color = "green">Completed
*<font color = "green">Completed
|-
| 4
| 3/5/2023
| 3/11/2023
|
*<span>Learning to use CAN BUSMASTER</span>
*<span>Test all the parts received and order any missing or damaged parts<span> 
*<span>Test RC Car is functional<span> 
| 
*<font color = "green">Completed
*<font color = "green">Completed
*<font color = "green">Completed
|-
| 5
| 3/12/2023
| 3/18/2023
|
*<span>Establish CAN transmit and receive functionality, start formatting DBC messages</span>
*<span>DBC file discussed and implemented</span>
| 
*<font color = "green">Completed
*<font color = "green">Completed
|-
| 6
| 3/19/2023
| 3/25/2023
|
*<span>Discuss modules needed for PCB, any feature requests</span>
*<span>Purchase PCBs</span>
| 
*<font color = "green">Completed
*<font color = "green">Completed
|-
| 7
| 3/26/2023
| 4/1/2023
|
*<span>Finalize preparations and research during Spring Break</span>
*<span>Start working on way point algorithm</span>
*<span>Start working on obstacle avoidance algorithm</span>
| 
*<font color = "green">Completed
*<font color = "green">Completed
*<font color = "green">Completed
|-
| 8
| 4/2/2023
| 4/8/2023
|
*<span>Work on the power supplies for boards</span>
*<span>Interface Bluetooth for bridge controller</span>
*<span>Integrate the GEO sensor and controller</span>
*<span>Interface with RC car and start working on DRIVER and MOTOR nodes</span>
*<span>Write a basic implementation of the sensor controller</span>
| 
*<font color = "green">Completed
*<font color = "green">Completed
*<font color = "green">Completed
*<font color = "green">Completed
*<font color = "green">Completed
|-
| 9
| 4/9/2023
| 4/15/2023
|
*<span>Integrate compass</span>
*<span>Install RPM Sensor</span>
*<span>Start Mobile Application development</span>
*<span>Finalize power supply choice and how it integrates with PCB</span>
*<span>Finish PCB designs for each subsystem</span>
*<span>Begin design of entire RC car assembly</span>
*<span>First outdoor tests commence</span>
| 
*<font color = "green">Completed
*<font color = "green">Completed
*<font color = "green">Completed
*<font color = "green">Completed
*<font color = "green">Completed
*<font color = "green">Completed
*<font color = "green">Completed
|-
| 10
| 4/16/2023
| 4/22/2023
|
*<span>Finish 1st vehicle prototype</span>
*<span>Complete basic mobile application</span>
*<span>Interface motor and steering together</span>
*<span>Begin implementation of RPM sensor for PID control</span>
*<span>Connect all boards to PCB and begin implementation</span>
*<span>Write motor test routines to define in mobile application</span>
*<span>Continue outdoor test</span>
| 
*<font color = "green">Completed
*<font color = "green">Completed
*<font color = "green">Completed
*<font color = "green">Completed
*<font color = "green">Completed
*<font color = "green">Completed
*<font color = "green">Completed
|-
| 11
| 4/23/2023
| 4/29/2023
|
*<span>Populate PCB and prepare for installation</span>
*<span>Finalize GPS module + create unit_tests</span>
*<span>First final draft MR for motor_board branch</span>
*<span>First final draft MR for bridge_controller branch</span>
*<span>First final draft MR for sensor_board branch</span>
*<span>First final draft MR for geo_board branch</span>
*<span>Continue outdoor tests</span>
| 
*<font color = "green">Completed
*<font color = "green">Completed
*<font color = "green">Completed
*<font color = "green">Completed
*<font color = "green">Completed
*<font color = "green">Completed
*<font color = "green">Completed
|-
| 12
| 4/30/2023
| 5/6/2023
|
*<span>Finish mobile application</span>
*<span>Begin working on wiki</span>
*<span>Begin PID control for motor on hill</span>
*<span>Integrate initial mobile application features</span>
*<span>First North Garage tests commence</span>
| 
*<font color = "green">Completed
*<font color = "green">Completed
*<font color = "green">Completed
*<font color = "green">Completed
*<font color = "green">Completed
|-
| 13
| 5/7/2023
| 5/13/2023
| 
*<span>Fix bugs with altogether integration</span>
*<span>Finalize PID control</span>
*<span>Clean up code for branches --> update master branches</span>
*<span>More North Garage tests</span>
| 
*<font color = "green">Completed
*<font color = "green">Completed
*<font color = "green">Completed
*<font color = "green">Completed
|-
| 14
| 5/14/2023
| 5/19/2023
|
*<span>Add RC Car designs (pirate ship flag, argh!)</span>
*<span>Begin working on wiki report</span>
*<span>More North Garage tests</span>
| 
*<font color = "green">Completed
*<font color = "green">Completed
*<font color = "green">Completed
|-
| 15
| 5/20/2023
| 5/26/2023
|
*<span>Final code cleanup</span>
*<span>Finalize wiki report</span>
*<span>Final North Garage tests</span>
| 
*<font color = "green">Completed
*<font color = "orange">In-Progress
*<font color = "green">Completed
|}

<HR>
<BR/>

== Parts List & Cost ==
{| class="wikitable"
|-
! scope="col"| Item#
! scope="col"| Part Desciption
! scope="col"| Vendor
! scope="col"| Qty
! scope="col"| Cost
|-
! scope="row"| 1
| RC Car 
| Traxxas
| 1
| $250.00
|-
! scope="row"| 2
| SJ2 board
| From Preet [https://www.amazon.com/Generic-SJTwo-SJ2-SJSU/dp/B08G9LRPZ8/ref=cm_cr_arp_d_product_top?ie=UTF8]
| 4
| $50.00
|-
! scope="row"| 3
| CAN Transceivers (SN65HVD230)
| Waveshare [https://www.amazon.com/SN65HVD230-CAN-Board-Communication-Development/dp/B00KM6XMXO/ref=sr_1_1?keywords=can+transceiver&qid=1647819477&sprefix=can+trans%2Caps%2C160&sr=8-1]
| 4
| Free Samples
|-
! scope="row"| 4
| RC Car RPM
| Traxxas [https://traxxas.com/products/parts/telemetry/6520]
| 1
| $8.23
|-
! scope="row"| 5
| Adafruit Bluetooth BLE Friend
| Adafruit [https://www.adafruit.com/product/2479]
| 1
| $17.5
|-
! scope="row"| 6
| GPS Module
| Adafruit [https://www.adafruit.com/product/746?gclid=CjwKCAjwpayjBhAnEiwA-7enazk8KmpYiwnhEzP2uykQ93Z5EKR6gtdrp0jrYIYFH0SZjvMAqxvP1RoCFE0QAvD_BwE]
| 1
| $29.95
|-
! scope="row"| 7
| Compass Module
| Adafruit [https://www.adafruit.com/product/4413?gclid=CjwKCAjwpayjBhAnEiwA-7enayVZ1oqspn3Z_ZNsNPUi7wO4tqkm28mrj1AW6-68-PmlMGMcyf00gBoC_CMQAvD_BwE]
| 1
| $12.50
|-
! scope="row"| 8
| Ultrasonic Sensors
| Adafruit [https://www.adafruit.com/product/3942?gclid=CjwKCAjwpayjBhAnEiwA-7ena7wWWGZ4oOdD47zUosxMfmyN1_zYjr9wfXLT0fL8WkaCHCQXFI7NmBoCf70QAvD_BwE]
| 4
| $3.95
|-
! scope="row"|9
| LCD Screen
|  Amazon [https://www.amazon.com/SunFounder-Serial-Module-Arduino-Mega2560/dp/B01GPUMP9C/ref=asc_df_B01GPUMP9C/?tag=&linkCode=df0&hvadid=309777534894&hvpos=&hvnetw=g&hvrand=1354203368978991859&hvpone=&hvptwo=&hvqmt=&hvdev=c&hvdvcmdl=&hvlocint=&hvlocphy=9031937&hvtargid=pla-572925702212&ref=&adgrpid=58425267301&th=1]
| 1
| $12.89
|-
|}

<HR>
<BR/>

== System Hardware Design  ==


''' Block Diagram '''

[[File:Block_diagram_improved_resolution.jpg|600px]]

<br>

''' Layout Diagram '''

[[File:Board Layout Diagram.png]]

<br>

''' Layout Description '''

[[File:Mehsla_Top_view.jpg]]

The system implemented four SJTwo boards, positioned with their tops facing upwards and protruding from beneath the PCB. This arrangement allowed for convenient utilization of the onboard LEDs and easy access to the Reset buttons on each board. Although this design choice sacrificed compactness, it provided early access to the LEDs during development. Furthermore, this configuration facilitated division of the PCB into four quadrants for the rest of the design. 

[[File:Mehsla_Power_bus_lines.jpg]]

To power the entire system, a portable 20,000mAh power bank was employed, connecting to the PCB via a micro USB connector. From the connector, a 5V and GND bus was integrated into the center of the PCB using bus wire. This power distribution arrangement ensured consistent voltage supply to the four SJTwo boards and other peripherals. By delivering power through a unified 5V line, all voltage references remained relative to each other. Moreover, this design reduced clutter by offering multiple points for connecting 5V and GND, facilitated by the bus running the length of the PCB.

[[File:Mehsla_Can_section.jpg|400px]]

To optimize PCB space, the four CAN transceivers were positioned upright in a 2x2 formation between two SJTwo boards. This configuration allowed for the creation of nearby CANH and CANL buses, ensuring easy accessibility for the PCAN dongle. The CAN transceivers were powered by a 3.3V bus created by connecting all the 3.3V SJTwo outputs, thus maintaining consistent voltage levels.

[[File:Mehsla_LCD_Front_Sensors.jpg]]

The four ultrasonic sensors were mounted on daughter boards, offering flexibility for precise directional adjustment without impacting the rest of the system. Three sensors were placed in the front of the car for the right, front, and left directions, while one sensor was positioned at the rear. The LCD screen was strategically placed behind the front sensors to prevent interference and any potential movement in case of dislodgment.

[[File:Mehsla_Compass_pole.jpg]]

To minimize interference from other components, the compass was mounted on a pole. A lightweight PVC pipe was chosen to allow for wire routing inside it, resulting in a cleaner overall appearance.

The GPS and Bluetooth modules were positioned next to the respective controlling SJTwo board. The motor's battery, ESC, and RPM sensor were all mounted on the vehicle's chassis.

[[File:Mehsla_gps_led.jpg|250px]]

Each board featured a red LED to indicate CAN MIA (Missing in Action). The two front yellow LEDs served as obstacle avoidance indicators: when an object was detected on the right or left side, the corresponding LED would light up, and if an obstacle was detected in the front, both LEDs would illuminate. If neither LED was lit, the car would operate based on path determination rather than obstacle avoidance. The green LED under the PCB indicated power supply, while the blue LED at the back would blink during GPS pairing and remain steadily lit once the GPS successfully locked onto a signal.

<HR>
<BR/>

== CAN Communication ==
We selected our message IDs using a mutually agreed upon priority scheme. Messages responsible for controlling the car were given high priority IDs, while sensor and GEO messages were assigned the next level of priority. Debug and status messages received the lowest priority IDs.

=== Hardware Design ===


[[File:Mehsla_Can_Module.png|200px]][[File:Mehsla_CAN_Bus.png|500px]]


We opted for the Waveshare CAN transceiver in our design due to its exceptional reliability, integrated 120-ohm resistor(we removed them off two boards), vertical mounting capability, and dual CANH/L connectors. The four CAN transceivers were strategically positioned upright in a 2x2 arrangement between two SJTwo boards. This layout facilitated the creation of closely located 5-pin CANH and CANL buses, ensuring effortless access for the PCAN dongle. Powering the CAN transceivers was achieved through a 3.3V bus formed by connecting all the 3.3V SJTwo outputs, guaranteeing consistent voltage levels throughout the system.

=== DBC File ===
[https://gitlab.com/karthigaiamutha.ezhilarasu/meh-sla-automotive/-/blob/dbc/dbc/project.dbc Gitlab link to DBC file]
<pre>
VERSION ""

NS_ :
	BA_
	BA_DEF_
	BA_DEF_DEF_
	BA_DEF_DEF_REL_
	BA_DEF_REL_
	BA_DEF_SGTYPE_
	BA_REL_
	BA_SGTYPE_
	BO_TX_BU_
	BU_BO_REL_
	BU_EV_REL_
	BU_SG_REL_
	CAT_
	CAT_DEF_
	CM_
	ENVVAR_DATA_
	EV_DATA_
	FILTER
	NS_DESC_
	SGTYPE_
	SGTYPE_VAL_
	SG_MUL_VAL_
	SIGTYPE_VALTYPE_
	SIG_GROUP_
	SIG_TYPE_REF_
	SIG_VALTYPE_
	VAL_
	VAL_TABLE_

BS_:

BU_: DBG DRIVER MOTOR SENSOR GEO

BO_ 100 DRIVER_HEARTBEAT: 1 DRIVER
 SG_ DRIVER_HEARTBEAT_cmd : 0|8@1+ (1,0) [0|0] "" SENSOR,MOTOR

BO_ 101 MOTOR_SPEED: 1 DRIVER
 SG_ DC_MOTOR_DRIVE_SPEED_sig : 0|8@1+ (0.1,-10) [-10|10] "kph" SENSOR,MOTOR

BO_ 102 MOTOR_ANGLE: 1 DRIVER
 SG_ SERVO_STEER_ANGLE_sig : 0|8@1+ (1,-45) [-45|45] "degrees" SENSOR,MOTOR


BO_ 200 SENSOR_SONARS: 4 SENSOR
 SG_ SENSOR_SONARS_left : 0|8@1+ (1,0) [0|158] "inch" DRIVER
 SG_ SENSOR_SONARS_right : 8|8@1+ (1,0) [0|158] "inch" DRIVER
 SG_ SENSOR_SONARS_front : 16|8@1+ (1,0) [0|158] "inch" DRIVER
 SG_ SENSOR_SONARS_rear : 24|8@1+ (1,0) [0|158] "inch" DRIVER

BO_ 202 GPS_DESTINATION_LOCATION: 8 SENSOR
 SG_ GPS_DEST_LAT_SCALED_1000000 : 0|32@1- (1,0) [0|0] "Degrees" GEO
 SG_ GPS_DEST_LONG_SCALED_1000000 : 32|32@1- (1,0) [0|0] "Degrees" GEO

BO_ 203 GEO_STATUS: 8 GEO
 SG_ GEO_STATUS_COMPASS_HEADING : 0|12@1+ (1,0) [0|359] "Degrees" DRIVER,SENSOR
 SG_ GEO_STATUS_COMPASS_BEARING: 12|12@1+ (1,0) [0|359] "Degrees" DRIVER,SENSOR
 SG_ GEO_STATUS_DISTANCE_TO_DESTINATION : 24|16@1+ (0.01,0) [0|0] "Meters" DRIVER,SENSOR

BO_ 204 GPS_CURRENT_INFO: 8 GEO
 SG_ GPS_CURRENT_LAT_SCALED_1000000 : 0|32@1- (1,0) [0|0] "degrees" DRIVER,SENSOR
 SG_ GPS_CURRENT_LONG_SCALED_1000000 : 32|32@1- (1,0) [0|0] "degrees" DRIVER,SENSOR
 
BO_ 205 GPS_CURRENT_DESTINATIONS_DATA: 8 GEO
 SG_ CURRENT_DEST_LAT_SCALED_1000000 : 0|32@1- (1,0) [0|0] "Degrees" DRIVER
 SG_ CURRENT_DEST_LONG_SCALED_1000000 : 32|32@1- (1,0) [0|0] "Degrees" DRIVER

BO_ 206 BRIDGE_APP_COMMANDS: 1 SENSOR
 SG_ APP_COMMAND : 0|2@1+ (1,0) [0|0] "" MOTOR

BO_ 300 MOTOR_STATUS: 3 MOTOR
 SG_ MOTOR_STATUS_wheel_error : 0|1@1+ (1,0) [0|0] "" DRIVER,IO,SENSOR
 SG_ MOTOR_STATUS_speed_kph : 8|16@1+ (0.001,0) [0|0] "kph" DRIVER,IO,SENSOR
 
BO_ 401 MOTOR_DEBUG: 1 MOTOR
 SG_ IO_DEBUG_test_unsigned : 0|8@1+ (1,0) [0|256] "sec" DBG

BO_ 402 COMPASS_RAW_DEBUG: 6 GEO
 SG_ COMPASS_RAW_X : 0|15@1- (1,0) [0|0] "" DBG
 SG_ COMPASS_RAW_Y : 16|15@1- (1,0) [0|0] "" DBG
 SG_ COMPASS_RAW_Z : 32|15@1- (1,0) [0|0] "" DBG

BO_ 403 SENSOR_BEFORE_AVERAGE_DEBUG: 4 SENSOR
 SG_ SENSOR_BEFORE_AVG_left : 0|8@1+ (1,0) [0|0] "inch" DBG
 SG_ SENSOR_BEFORE_AVG_right : 8|8@1+ (1,0) [0|0] "inch" DBG
 SG_ SENSOR_BEFORE_AVG_front : 16|8@1+ (1,0) [0|0] "inch" DBG
 SG_ SENSOR_BEFORE_AVG_rear : 24|8@1+ (1,0) [0|0] "inch" DBG

CM_ BU_ DBG "The debugging node for testing dbc with the car";
CM_ BU_ DRIVER "The driver controller driving the car";
CM_ BU_ MOTOR "The motor controller of the car";
CM_ BU_ SENSOR "The sensor controller of the car";
CM_ BU_ GEO "The geological Controller of the car";
CM_ BO_ 100 "Sync message used to synchronize the controllers";
CM_ SG_ 100 DRIVER_HEARTBEAT_cmd "Heartbeat command from the driver";
CM_ SG_ 101 DC_MOTOR_DRIVE_SPEED_sig "The speed in kph to set the motor speed. TODO: choose kph/mph";
CM_ SG_ 102 SERVO_STEER_ANGLE_sig "The direction in degrees to set the RC car servo direction.";

BA_DEF_ "BusType" STRING ;
BA_DEF_ BO_ "GenMsgCycleTime" INT 0 0;
BA_DEF_ SG_ "FieldType" STRING ;

BA_DEF_DEF_ "BusType" "CAN";
BA_DEF_DEF_ "FieldType" "";
BA_DEF_DEF_ "GenMsgCycleTime" 0;

BA_ "GenMsgCycleTime" BO_ 100 1000;
BA_ "GenMsgCycleTime" BO_ 200 50;
BA_ "FieldType" SG_ 100 DRIVER_HEARTBEAT_cmd "DRIVER_HEARTBEAT_cmd";

VAL_ 100 DRIVER_HEARTBEAT_cmd 2 "DRIVER_HEARTBEAT_cmd_REBOOT" 1 "DRIVER_HEARTBEAT_cmd_SYNC" 0 "DRIVER_HEARTBEAT_cmd_NOOP" ;


</pre>


<HR>
<BR/>

== Sensor and Bridge Controller ==
* [https://gitlab.com/karthigaiamutha.ezhilarasu/meh-sla-automotive/-/tree/bridge_board_bluetooth Bridge Controller Gitlab link]

=== Hardware Design ===

{|
|[[File:Bridge_controller_connection.jpg|600px|center|thumb|Bridge controller connections]]
|}

==== Ultrasonic Sensors ====

We used HC-SR04 ultrasonic sensors for obstacle detection. It could provide a range from 2 cm to 400 cm non-contact measurement. The ranging accuracy is approximately 3mm and the effectual angle is less than 15°. It needs to be powered by a 5V power supply. We are using 4 HC-SR04 sensors in the RC car(front, rear, left, and right). 

===== HC-SR04 specifications =====
*Operating voltage: +5V
*Theoretical  Measuring Distance: 2cm to 450cm
*Practical Measuring Distance: 2cm to 80cm
*Accuracy: 3mm
*Measuring angle covered: <15°
*Operating Current: <15mA
*Operating Frequency: 40Hz

The pinout and the timing diagram of the HC-SR04 sensor are shown in the following figures. The module includes an ultrasonic transmitter, a receiver, and a control circuit. The basic principle of work: When the trigger pin is set HIGH for at least 10us, the module automatically sends a 40 kHz ultrasonic wave from the Ultrasonic transmitter. This wave travels in the air and when it gets obstructed by any material it gets reflected back toward the sensor. This reflected wave is observed by the Ultrasonic receiver module. Once the wave is returned the Echo pin goes high for a particular amount of time which will be equal to the time taken for the wave to return back to the sensor. The amount of time during which the Echo pin stays high is measured by the SJ2 board as it gives the information about the time taken for the wave to return back to the Sensor. Using this information the distance is measured as explained in the above heading. From that duration, the distance at which the object is present can be measured using the formula, Distance = Speed × Time.

{| 
|[[File:Sensor_pinout.jpg|400px|left|thumb|HC-SR04 Pinout]] || [[File:Sensor_timing_diagram.jpg|400px|left|thumb|HC-SR04 Timing Diagram]] ||
[[File:Sensor_working.png|400px|left|thumb|HC-SR04 Working Principle]]
|
|}

==== Bluetooth Module ====

For the communication between the mobile and the RC Car, we are using Adafruit Bluefruit LE UART Friend - BLE module. This module communicates with the SJ2 board through UART at a baud rate of 9600. It also has the capability of working in two modes (data mode and command mode). We can toggle between the two modes using the MOD pin through a GPIO signal or manually using the onboard switch. It supports AT command set, which can be used to control the device's behavior. In data mode, the data written to the UART in the form of a string will be sent through Bluetooth.

{|
|[[File:Adafruit_bluetooth_module_edited.jpg|300px|center|thumb|Magnetometer Orientation]]
|}

===== Adafruit Bluefruit specifications =====
*ARM Cortex M0 core running at 16MHz
*256KB flash memory
*32KB SRAM
*Transport: UART @ 9600 baud with HW flow control (CTS+RTS required)
*5V-safe inputs
*On-board 3.3V voltage regulation
*Bootloader with support for safe OTA firmware updates
*Easy AT command set to get up and running quickly

=== Software Design ===

==== Ultrasonic Sensors ====
We read about the signal interference of adjacent sensors from many of the past projects. So we decided to avoid that interference by triggering two non-adjacent sensors at a time. The FRONT_REAR sensor pair is triggered first. Once both of the sensors compute the distance from the obstacle, then the next pair, RIGHT_LEFT is triggered. For the ultrasonic sensors, we used a separate task instead of the periodic callbacks since this task sleeps on a semaphore which might affect the other functions in the periodic callback function.

'''''SONAR task'''''

 void sonar_task(void *p) {
  sonar__init();
  front_rear_echo_received = xSemaphoreCreateBinary();
  left_right_echo_received = xSemaphoreCreateBinary();
  lpc_peripheral__enable_interrupt(LPC_PERIPHERAL__GPIO, sonar__interrupt_dispatcher, "sonar_timing_handler");
  NVIC_EnableIRQ(GPIO_IRQn);
  while (1) {
    sonar__send_trigger_for_10us(FRONT_REAR);
    if (xSemaphoreTake(front_rear_echo_received, 100)) {
      sonar_pair_info[0].distance_from_obstacle_sonar1 = sonar__compute_obstacle_distance_single_sensor(FRONT_SONAR);
      sonar_pair_info[0].distance_from_obstacle_sonar2 = sonar__compute_obstacle_distance_single_sensor(REAR_SONAR);
    }
    vTaskDelay(10);
    sonar__send_trigger_for_10us(LEFT_RIGHT);
    if (xSemaphoreTake(left_right_echo_received, 100)) {
      sonar_pair_info[1].distance_from_obstacle_sonar1 = sonar__compute_obstacle_distance_single_sensor(LEFT_SONAR);
      sonar_pair_info[1].distance_from_obstacle_sonar2 = sonar__compute_obstacle_distance_single_sensor(RIGHT_SONAR);
    }
    sonar__averaging_sensor_values();
  }
 }

==== Bluetooth Module ====
Bluetooth module is used to send the debug information such as sensor values, current heading, bearing, distance to the destination, and current GPS location to the mobile app. Also, it receives the destination coordinates and start/stop signal from the mobile app. To differentiate between the coordinates and the start/stop signal we used the first char as '@' or '#'. If the starting char is '@', the message contains the destination coordinate. Similarly, "#0' represents the stop signal, and '#1' represents the start signal. 


''''' Bluetooth initialization '''''

 void bt_module__init(void) {
  line_buffer__init(&line_buffer, line, sizeof(line));
  gpio__construct_with_function(GPIO__PORT_4, 28, GPIO__FUNCTION_2);
  gpio__construct_with_function(GPIO__PORT_4, 29, GPIO__FUNCTION_2);
  uart__init(bt_module_uart_port, clock__get_peripheral_clock_hz(), 9600);
  QueueHandle_t rxq = xQueueCreate(500, sizeof(char));
  QueueHandle_t txq = xQueueCreate(500, sizeof(char));
  uart__enable_queues(bt_module_uart_port, txq, rxq);
  bt_pin__mod = gpio__construct_as_output(GPIO__PORT_0, 15);
  bt_pin__cts = gpio__construct_as_output(GPIO__PORT_0, 18);
  bt_pin__rts = gpio__construct_as_input(GPIO__PORT_2, 9);
  gpio__reset(bt_pin__cts);
  bt_set_mode(bt_data_mode);
 }

''''' Bluetooth data handler '''''

 static void bt_data_handler__parse_data(char *data) {
  switch (data[0]) {
  case '@':
    bt_data_handler__parse_coordinates(data + 1);
    break;
  case '#':
    bt_data_handler__parse_start_or_stop(data + 1);
    break;
  default:
    break;
  }
 }

=== Technical Challenges  ===

==== Sensor module ====

*''' Issue:''' Sometimes the front sensor was detecting some obstacles even though there was nothing in front.
*''' Solution:''' We included a delay of 10ms in between triggering the first and second pair of sensors.

*''' Issue:''' We see some noise in the sensor measurement which makes the car's steering very wobbly.
*''' Solution:''' We included a sensor value averaging logic which will return the average of the last 5 readings instead of a single value

==== Bluetooth module ====

*''' Issue:''' We faced a weird problem in the geo node when computing the distance between the origin and destination. It gave us bizarre values. First, we thought the problem was with the Geo node distance computation formula. But when we trace back the issue, it was with the line buffer initialization in the sensor board. We mistakenly initialized the line buffer with a size of 20 instead of 200. This truncates the coordinates of the destination received (sometimes sets longitude = 0) from the mobile which in turn, affects the distance computation at the Geo node.
*''' Solution:''' We initialized the line buffer with a bigger size.


<HR>
<BR/>

== Motor Controller ==

* [https://gitlab.com/karthigaiamutha.ezhilarasu/meh-sla-automotive/-/tree/motor_board?ref_type=heads Motor Controller Gitlab link]

=== Hardware Design ===
{| 
|[[File:traxxasRemotePWM.jpeg|300px|center|thumb|Traxxas Antenna PWM Connections]] || [[File:TraxxasAntennaDevice.jpg|300px|center|thumb|Traxxas TQ Top Qualifier Module]]
|
|}

===== PCB Design =====
Phil to talk about PCB design and choices for layout

===== Battery Management =====

The system was equipped with a dual-battery configuration, comprising one battery exclusively for the motor and another dedicated to powering the SJTwo boards and peripherals. This deliberate arrangement ensured uninterrupted power supply to the controller boards, enabling them to function optimally under all circumstances. The primary power source consisted of a portable 20,000 mAh battery, delivering a consistent 5V output to energize the entire system.

=== Software Design ===
<List the code modules that are being called periodically.>

===== RPM Module =====
Tony will write about how the RPM module was implemented using triggers.

 void sonar_task(void *p) {
   Test
 }

===== Motor Module =====
Tony will write about the motor and how forward/reverse works

 static float test_task(float lol) {
   Just wanted to see if this is cool;
 }

===== Steering Module =====
Tony will write about the motor and how forward/reverse works

 static float test_task(float lol) {
   Preet is cool;
   if(Phil_is_reading) Phil is cooler;
   else Tony is the coolest
 }


=== Technical Challenges ===

< List of problems and their detailed resolutions>

<HR>
<BR/>

== Geological Controller ==

* [https://gitlab.com/karthigaiamutha.ezhilarasu/meh-sla-automotive/-/tree/geo_board_algorithm?ref_type=heads Geological Controller Gitlab link]

=== Hardware Design ===

==== Compass ====

The compass we used is from Adafruit, [https://www.adafruit.com/product/4413?gclid=CjwKCAjwpayjBhAnEiwA-7enayVZ1oqspn3Z_ZNsNPUi7wO4tqkm28mrj1AW6-68-PmlMGMcyf00gBoC_CMQAvD_BwE LSM303AGR breakout]. It has both a magnetometer and an accelerometer. But, We didn't use the accelerometer which is also needed to properly calibrate the compass because the compass couldn't be aligned exactly parallel to the ground when mounting on a car(instead we used a simple trick - see technical challenges for a detailed description). The compass communicates with the SJ2 board via I2C. It operates on 3.3V. It is a triple-axis accelerometer/magnetometer compass module. The magnetometer is mounted on the car with the Z axis pointing away from the ground and X and Y axis pointing as shown in the image below (we can also switch the x and y, but the formula remains the same). The x and y values shown in the formula correspond to the raw x and y values of the magnetometer. The compass should be placed as much as away from all the electronics in the car. We used a PVC pipe to place the compass in an elevated position. Even after the elevated positioning, we faced interference that makes it necessary to calibrate the compass. For the compass calibration, we used a third-party calibration tool. [https://sites.google.com/view/sailboatinstruments1 Magneto]. 
{|
|[[File:Magnetometer.jpg|300px|center|thumb|LSM303AGR]] ||
|[[File:Magnetometer_position.png|500px|center|thumb|Magnetometer Orientation]]
|}

We wrote a simple Python script to visualize how the calibration affects the compass output. The outputs of the Python script show how the compass raw data gets affected after mounting on the car and after calibration. 

{|
|[[File:Magneto.jpg|300px|center|thumb|Magneto Calibration tool]]||
|[[File:Magnetometer_raw_before_mounting_edited.jpg|300px|center|thumb|Compass raw data before mounting on the car]] ||
|[[File:Magnetometer_raw_after_mounting_edited.jpg|265px|center|thumb|Compass raw data after mounting on the car - before calibration]] ||
|[[File:Magnetometer_raw_after_calibraton.jpg|275px|center|thumb|Compass raw data after mounting on the car - after calibration]]
|}

==== GPS ====

The GPS module we used is [https://www.adafruit.com/product/746?gclid=CjwKCAjwpayjBhAnEiwA-7ena258wLD55o05YFhGdJvbVAbcfqocBw6_NO-c0Ovl14zDI_V7lc5mZxoCcZAQAvD_BwE MTK3339-based breakout] from Adafruit. It is interfaced with the SJ2 board through UART. It will output NMEA strings at a default baud rate of 9600. We parsed the latitude and longitude from the GPGGA data and used them to compute the bearing and distance to the destination. In addition to the onboard LED on the GPS breakout board, we also included an external LED for the FIX indication of the GPS module. The onboard FIX LED will blink every second until it gets a FIX. Once it gets a FIX, it will blink once every 15sec. But our external LED will use the inverted logic(Turn OFF once every 15 sec).In addition to that to minimize the time required to get the FIX we also included a coin battery to the GPS module.

{|
|[[File:Gps.jpg|300px|center|thumb|GPS module]]
|}

=== Software Design ===

The Geological Board receives the coordinates of the destination to be reached, from the CAN bus which is sent from the sensor board.

==== Waypoint Algorithm ====
{|
|[[File:Waypoint_mehsla.png|600px|center|thumb|Waypoints we chose]]
|}

=== Technical Challenges ===

*''' Issue:''' The compass behaves perfectly when we test it separately. But once we mount it on the car we receive bizarre values. This is because we didn't calibrate the compass to nullify the hard and soft iron distortion which arises from other components mounted on the car.
*''' Solution:''' We did the calibration using a third-party tool.

*''' Issue:''' After calibration, we noticed that there is an offset of 70 degrees between the original north and the north pointed by our compass. This may be because the compass was not perfectly aligned parallel to the earth's surface.
*''' Solution:''' To solve this issue, we should also include the accelerometer reading from the compass. But instead, we simply added an offset manually in the code. This is because the offset is linear.

*''' Issue:''' After fixing the above two problems, we noticed that the compass values are flipped (for example, it shows 5 degrees when the actual degree is 355 degrees).
*''' Solution:''' We made a mistake in the conversion of raw value to degree conversion(flipped x and y). Once we fix this, the values seem fine.

*''' Issue:''' During our initial GPS testing, we noticed that the GPS returns strings that contain only commas and no valid data. This is because the GPS was still getting to try valid data from at least 3 satellites(not yet get a FIX). This was quite confusing at first since we are not aware that the GPS module has less chance of getting a FIX when working indoors.
*''' Solution:''' Do the GPS testing outdoors. If you are doing it indoors, use an external antenna and attach it near the window where there is visibility for a clear sky.
<HR>
<BR/>

== Driver/LCD Controller ==
* [https://gitlab.com/karthigaiamutha.ezhilarasu/meh-sla-automotive/-/tree/driver_board Driver and LCD Controller Gitlab link]

<Picture of LCD>
<Picture of Block Diagram>

=== Hardware Design ===

=== Software Design ===
<List the code modules that are being called periodically.>

=== Technical Challenges ===

< List of problems and their detailed resolutions>

<HR>
<BR/>



== Mobile Application ==
<Picture and link to Gitlab>

=== Hardware Design ===

=== Software Design ===
<List the code modules that are being called periodically.>

=== Technical Challenges ===

< List of problems and their detailed resolutions>


<BR/>
<HR>
<HR>
<BR/>
== Conclusion ==
<Organized summary of the project>

<What did you learn?>

=== Project Video ===

=== Project Source Code ===

=== Advise for Future Students ===
* Plan out the project before you start working on it
** Make SW and HW Block Diagrams
* Review the wiki pages for all of the previous groups
** Focus on Advice and Challenges Sections
* Don't write bugs in your code
** The time spent fixing bugs could be used for implementing extra features
* Plan to meet in a group for 4-5 hours every weekend for system integration
** This should NOT be the only time spent on the project! Everyone should be working throughout the week individually.
* Don't over engineer your code
* Be the Best-sla that you can be!

=== Acknowledgement ===

Without Preet this project would not have existed.

=== References ===