diff --git a/README.md b/README.md new file mode 100644 index 0000000..a50e345 --- /dev/null +++ b/README.md @@ -0,0 +1,120 @@ +![](logo-ucsdjsoeece-white.png) +--- +## Tutorial Parking Assistant Device +Last update: 11/20/2024 + +Authors: + - Clevant Yang + - Danny Wu + - Aria Mottaghi +--- + + +## Introduction + +TODO + +### Learning Objectives + +- Background Information +- Tools Needed +- Get Started +- References + +## Background Information + +We are developing a device to assist drivers with parking, specifically in compact spots. This will be done with a LiDAR sensor that will map a 2D birds eye view of obstacles in front and to the side of the car. This map will then be displayed on a screen for the driver to see and make judgements accordingly while parking. The device will also detect empty parking spots to then measure the width and judge whether or not it is too compact to park in. + +## Tools Needed +- PC with Windows 10 or later to upload code to ESP32, other platforms are not tested +- Arduino IDE 2.x, download it [here][Arduino IDE Link] +- Visual Studio Code, download it [here][VSCode Link] +- youyeetoo FHL-LD20 8 Meters 360 deg Lidar Sensor, you can find it [here][Lidar Link] +- ESP32-S3 Dev Module for wireless transfer data, we are using ESP-WROOM-32, you can find it [here][ESP32 Link] +- A ESP32 screen, we are using [this screen][Screen Link] +- A suction cup to stable lidar on car, we are using [this one][Suction Cup Link] +- Cables and Wires, be aware the screen is using USB-C, ESP32 is using Micro-USB + +## Getting Started + +#### Arduino IDE +First thing first. There are some changes and library needed. Open Arduino IDE, go to File->prefrences->Additional boards manager URLs, add this link, like this +>https://dl.espressif.com/dl/package_esp32_index.json + + +There are some libraries are needed. Inside Arduino IDE->Library Manager + +#### Lidar +TODO + +#### ESP32 +The lidar doesn't have a wifi, and we need to display sensor data coming from outside of the car. We need wireless transfer. So we will be using **ESP-NOW**. ESP-NOW is a wireless communication protocol defined by Espressif, which enables the direct, quick and low-power control of smart devices, without the need of a router. +#### Screen +The lidar will be sending 47-bytes hexadecimal data string, they are distance and angle of objects that your lidar detected. They can be represented in Polar coordinate, however, the screen use Cartesian coordinate, so we need to transform distances and angles to x and y axis. + +### Required Downloads and Installations + +List any required downloads and installations here. +Make sure to include tutorials on how to install them. +You can either make your own tutorials or include a link to them. + + +### Required Tools and Equipment + +List any tools and equipment you need here. +(Ex, computer, soldering station, etc.) + +## Part 01: Name + +### Introduction + +Briefly introduce what you are teaching in this section. + +### Objective + +- List the learning objectives of this section + +### Background Information + +Give a brief explanation of the technical skills learned/needed +in this challenge. There is no need to go into detail as a +separation document should be prepared to explain more in depth +about the technical skills + +### Components + +- List the components needed in this challenge + +### Instructional + +Teach the contents of this section + +## Example + +### Introduction + +Introduce the example that you are showing here. + +### Example + +Present the example here. Include visuals to help better understanding + +### Analysis + +Explain how the example used your tutorial topic. Give in-depth analysis of each part and show your understanding of the tutorial topic + +## Additional Resources + +### Useful links + +List any sources you used, documentation, helpful examples, similar projects etc. + + + +[Lidar Link]: https://www.amazon.com/youyeetoo-FHL-LD20-Raspberry-Triangulated-Start-Stop/dp/B0C3CX17FN +[ESP32 Link]: https://www.amazon.com/dp/B08D5ZD528?ref=ppx_yo2ov_dt_b_fed_asin_title&th=1 +[Screen Link]: https://www.amazon.com/dp/B0D7HN3XQ5?ref=ppx_yo2ov_dt_b_fed_asin_title +[Suction Cup Link]: https://www.amazon.com/ThtRht-Suction-Windshield-Camcorder-Recorder/dp/B0CPLV4B9F +[ESP-NOW Link]: https://www.espressif.com/en/solutions/low-power-solutions/esp-now +[Arduino IDE Link]: https://www.arduino.cc/en/software +[VSCode Link]: https://code.visualstudio.com/ diff --git a/TEMPLATE.md b/TEMPLATE.md deleted file mode 100644 index 298d19c..0000000 --- a/TEMPLATE.md +++ /dev/null @@ -1,107 +0,0 @@ ---- -title: My Super Awesome Tutorial -date: 1970-01-01 -authors: - - name: John Doe - - name: Mary Jane ---- - -![relevant graphic or workshop logo](image/path) - -## Introduction - -Write a short section on what the tutorial is aiming to accomplish. -What is the motivation behind the tutorial? -What do you want readers to gain from the tutorial? - -### Learning Objectives - -- Bullet list of skills/concepts to be covered - -Any additional notes from the developers can be included here. - -### Background Information - -Describe your topic here. What does it do? Why do you use it? -Are there other similar things to use? What are the pros and cons? -Explain important concepts that are necessary to understand. -Include (and cite if needed) any visuals that will help the audience understand. - -## Getting Started - -For any software prerequisites, write a simple excerpt on each -technology the participant will be expecting to download and install. -Aim to demystify the technologies being used and explain any design -decisions that were taken. Walk through the installation processes -in detail. Be aware of any operating system differences. -For hardware prerequisites, list all the necessary components that -the participant will receive. A table showing component names and -quantities should suffice. Link any reference sheets or guides that -the participant may need. -The following are stylistic examples of possible prerequisites, -customize these for each workshop. - -### Required Downloads and Installations - -List any required downloads and installations here. -Make sure to include tutorials on how to install them. -You can either make your own tutorials or include a link to them. - -### Required Components - -List your required hardware components and the quantities here. - -| Component Name | Quanitity | -| -------------- | --------- | -| | | -| | | - -### Required Tools and Equipment - -List any tools and equipment you need here. -(Ex, computer, soldering station, etc.) - -## Part 01: Name - -### Introduction - -Briefly introduce what you are teaching in this section. - -### Objective - -- List the learning objectives of this section - -### Background Information - -Give a brief explanation of the technical skills learned/needed -in this challenge. There is no need to go into detail as a -separation document should be prepared to explain more in depth -about the technical skills - -### Components - -- List the components needed in this challenge - -### Instructional - -Teach the contents of this section - -## Example - -### Introduction - -Introduce the example that you are showing here. - -### Example - -Present the example here. Include visuals to help better understanding - -### Analysis - -Explain how the example used your tutorial topic. Give in-depth analysis of each part and show your understanding of the tutorial topic - -## Additional Resources - -### Useful links - -List any sources you used, documentation, helpful examples, similar projects etc. diff --git a/Tutorial.md b/Tutorial.md new file mode 100644 index 0000000..448d66f --- /dev/null +++ b/Tutorial.md @@ -0,0 +1,144 @@ +![](logo-ucsdjsoeece-white.png) +--- +## Tutorial Parking Assistant Device +Last update: 11/27/2024 + +Authors: + - Clevant Yang + - Danny Wu + - Aria Mottaghi +--- + + +## Introduction + +TODO + +### Learning Objectives + +- Background Information +- Tools Needed +- Get Started +- References + +## Background Information + +We are developing a device to assist drivers with parking, specifically in compact spots. This will be done with a LiDAR sensor that will map a 2D birds eye view of obstacles in front and to the side of the car. This map will then be displayed on a screen for the driver to see and make judgements accordingly while parking. The device will also detect empty parking spots to then measure the width and judge whether or not it is too compact to park in. + +## Tools Needed +- PC with Windows 10 or later to upload code to ESP32, other platforms are not tested +- ~~Arduino IDE 2.x, download it [here][Arduino IDE Link]~~ +- Visual Studio Code, download it [here][VSCode Link] +- Circuit Python, you can follow this instruction [here][Circuit Python Link], which is the same instruction for your VU Meter +- youyeetoo FHL-LD20 8 Meters 360 deg Lidar Sensor, you can find it [here][Lidar Link] +- ESP32-S3 for wireless transfer data, we are using ESP-WROOM-32, you can find it [here][ESP32 Link] +- ESP Dev Board you built from ECE 196 earlier +- ~~A ESP32 screen, we are using [this screen][Screen Link]~~ +- An OLED screen, we are using [this screen][OLED Screen Link] +- A suction cup to stable lidar on car, we are using [this one][Suction Cup Link] +- A breadboard +- Cables and Wires, be aware the screen is using USB-C, ESP32 is using Micro-USB + +## Things to Note +Due to people are changing the ways to use their library or even change the syntax, **USE THE EXACT VERSION OF LIBRARY IN ARDUINO IDE AS WE DO**, library differences cause error such as too many arguments of a function or missing function prototype or blablabla and it's very hard to debug and extremely annoying. + +Since the writer was annoyed by different tutorials using different version of library, different configuration, different IDE, different...This tutorial doesn't plan to throw a bunch of documentations and libraries on you without explaining what's the meaning of each line of code. I will explain what the code means to my greatest effort, giving you an overview to how the ESP32 wireless, display, and lidar work. I then will reference documentations and libraries I use for your interest if you want to look for more. + +## Getting Started + +#### Circuit Python +I assume you haved built the VU Meter using Circuit Python as [this instruction][Circuit Python Link], so you should have it installed and set up for the ESP32 you built earlier in class. You know how to let "CIRCUITPY" drive appear on your computer. Go to the drive, you can see there is a "lib" folder, this is the folder storing all the libraries we will use for Circuit Python. + +To let the screen work, we need some libraries. Download Circuit Python libraries [here][Library Link], under "Bundle for Version 9.x", there should be a download link looks something like "adafruit-circuitpython-bundle-9.x-mpy-20241127.zip". Download it to somewhere you know on your computer. Find "adafruit_ssd1306.mpy", "adafruit_displayio_ssd1306.mpy", "adafruit_framebuf.mpy", + +Unzip "adafruit-circuitpython-bundle-9.x-mpy-xxxxxxxx.zip", open the folder , there should be some folders and files, one of them is "lib" folder. This folder as its name suggests contains all the Circuit Python libraries, but we are not using all of them. Open the folder + +#### Arduino IDE +First thing first. There are some changes and library needed. Open Arduino IDE, go to File->prefrences->Additional boards manager URLs, add this link, like this +>https://dl.espressif.com/dl/package_esp32_index.json + + +There are some libraries are needed. Inside Arduino IDE->Library Manager + +#### Lidar +TODO + +#### ESP32 +The lidar doesn't have a wifi, and we need to display sensor data coming from outside of the car. We need wireless transfer. So we will be using **ESP-NOW**. ESP-NOW is a wireless communication protocol defined by Espressif, which enables the direct, quick and low-power control of smart devices, without the need of a router. +#### Screen +The lidar will be sending 47-bytes hexadecimal data string, they are distance and angle of objects that your lidar detected. They can be represented in Polar coordinate, however, the screen use Cartesian coordinate, so we need to transform distances and angles to x and y axis. +#### ESP-IDF +menuconfig: Check Support for external, SPI-connected RAM, select Octal Mode PSRAM, this is because the screen has large PSRAM, writing to PSRAM will prevent it from rebooting. Flash size 8MB +#### CircuitPython +Library needed: adafruit_ssd1306.mpy, adafruit_framebuf.mpy. + + +### Required Downloads and Installations + +List any required downloads and installations here. +Make sure to include tutorials on how to install them. +You can either make your own tutorials or include a link to them. + + +### Required Tools and Equipment + +List any tools and equipment you need here. +(Ex, computer, soldering station, etc.) + +## Part 01: Name + +### Introduction + +Briefly introduce what you are teaching in this section. + +### Objective + +- List the learning objectives of this section + +### Background Information + +Give a brief explanation of the technical skills learned/needed +in this challenge. There is no need to go into detail as a +separation document should be prepared to explain more in depth +about the technical skills + +### Components + +- List the components needed in this challenge + +### Instructional + +Teach the contents of this section + +## Example + +### Introduction + +Introduce the example that you are showing here. + +### Example + +Present the example here. Include visuals to help better understanding + +### Analysis + +Explain how the example used your tutorial topic. Give in-depth analysis of each part and show your understanding of the tutorial topic + +## Additional Resources + +### Useful links + +List any sources you used, documentation, helpful examples, similar projects etc. + + + +[Lidar Link]: https://www.amazon.com/youyeetoo-FHL-LD20-Raspberry-Triangulated-Start-Stop/dp/B0C3CX17FN +[ESP32 Link]: https://www.amazon.com/dp/B08D5ZD528?ref=ppx_yo2ov_dt_b_fed_asin_title&th=1 +[Screen Link]: https://www.amazon.com/dp/B0D7HN3XQ5?ref=ppx_yo2ov_dt_b_fed_asin_title +[Suction Cup Link]: https://www.amazon.com/ThtRht-Suction-Windshield-Camcorder-Recorder/dp/B0CPLV4B9F +[ESP-NOW Link]: https://www.espressif.com/en/solutions/low-power-solutions/esp-now +[Arduino IDE Link]: https://www.arduino.cc/en/software +[VSCode Link]: https://code.visualstudio.com/ +[Circuit Python Link]: https://ece-196.github.io/docs/assignments/vu-meter/firmware/ +[OLED Screen Link]: https://www.amazon.com/Teyleten-Robot-Display-SSD1309-Interface/dp/B09LND6QJ1?crid=2NS440QNA8L2N&dib=eyJ2IjoiMSJ9.l7V7zqGnfz5tpb12Y4vhPfd6kcDo9Gy_9YxzPdgyHeA-stbcUC53jzvRBqjo9Q9JBe1BkHeOFJ04y90IgaGZ3agsD5l1un_QmPUPOsPJj8ZE-nJoF3GeJ2r58FPdj7uPpWhgW64wHKHulnyFKdYspzRMkfGyqlLCzbuZkltIeoFwT9sNAwJNMJET8-38BXq6n1nJkHzrwQzCMwJJcBCXR966NtDY9C7Sn5hIxQ45Z1M.BqTYKnKZpQOdVkGlEjtYdvPTKl41DxKrgW7eLwadZLw&dib_tag=se&keywords=2.42+inch+display&qid=1731571123&sprefix=2.42+inch+displa%2Caps%2C156&sr=8-1#cr-media-gallery-popover_1732676448576 +[Library Link]: https://circuitpython.org/libraries \ No newline at end of file