[What you want] ESP32S3 full functional development board

# ESP-POCKET2 Development Board ##### Personal Link: * 🎈 **[ GitHub personal homepage ](https://github.com/HwzLoveDz)(the software part of this design is here)** * 🍤 **[ Gitee personal homepage](https://gitee.com/mondraker)（updates content in GitHub simultaneously）** * 📺 **[updates content in GitHub simultaneously](https://space.bilibili.com/240319986)（the video of this design is here）** * 🎫 **[Online BOM](https://easyeda.online)（developed by a friend, the same as ibom, but online and can also be browsed on mobile phones）** >Except for the device links directly posted in this article, the rest can be easily found and purchased on TB and Lichuang Mall. There is a BOM at the end of the article. If you have any questions, come and bombard me in the group >* ①Group-735791683🧨 *** >**I know you don’t like to read long articles, so this article only focuses on introducing the functions. For example, the software functions will not be repeated here. You can go to GitHub to get the source code (the software’s md file will also take time to be slowly improved, and the content will include the related All hardware driver parts, transplanted LVGL framework, etc., the current comprehensive source code is only ESP-IDF, and Arduino only has routines for each device)** > ## Overview #### She looks like this *  *  *  *  *  *  **OK, if she successfully caught your attention, then continue reading.** #### Write in Front * **I have been writing this document for a long time. Since I have been so busy recently, I just stayed up late today to finish it for him.** * **The screen board will continue to be optimized, adding functions such as audio coding and decoding (currently the screen board only has a screen, and there are no problems in using it, just that there are no additional components). The audio-related software and hardware will be open sourced in about October.** * **The software part is thrown into GitHub open source over a period of time, and it should write a markdown collation and comprehensive [demonstration video of hardware and software](https://www.bilibili.com/video/BV1KV4y1a7ZG)** * **The design took half a year from initial data review to completion. The original intention is to make a more versatile and handy development board for my own personal learning, and to fully demonstrate my learning process to help everyone shorten the time to get started and lower the threshold.** * **It is inevitable that there will be small mistakes in the process due to lack of personal energy. Please actively criticize, correct and ask questions so that I can continue to improve this document.** * **This project will also participate in the 2023 Spark Plan. Please don’t be stingy with your likes and collections! It’s not easy to make, very difficult…** #### Design Brief * **Why should I do it :** >**The original intention was to use her to systematically learn esp32s3. Before becoming him, I had never been exposed to esp32s3, and I didn’t know lvgl at all. I had only briefly come into contact with espidf. After completing this design, I not only completed the software learning tasks, but also became completely familiar with the programming ideas and directory structure of lvgl. I can write cmake, how to transplant the arduino library to idf, how to write my own components, etc., and also improved the hardware. The design capabilities and overall project design capabilities have been very rewarding. It took three months to complete the hardware intermittently, and two months to use the software from scratch. I hope everyone can gain as much as me from using this board.** * **What are his highlights :** >**Some wonderful little features, such as the power management module, can provide comprehensive power information, including but not limited to adjustable voltage and current, multi-channel ADC voltage and current reading, power coulomb meter, USB current limit, adjustable battery Charging voltage, all-round battery protection, long press power on and off, etc. USB host and device modes can be switched at will, and port A in host mode has an independently controllable power supply. A TI's DRV2605 ERM (eccentric rotor) & LRA (linear resonance) vibration motor driver chip has multiple built-in vibration effect libraries, including hundreds of effects, and can easily achieve mobile phone-like human-computer interaction vibration and tactile sensation. Full-featured and full-GPIO lead-out, you can easily connect custom module modules, with high degree of freedom and comprehensive functions, eliminating the pain of testing and learning. A complete set of materials, software and hardware are all open source, and your learning process is open to the public.** * **What you will experience and gain by using it :** >**You will step into the use of LVGL (control settings, learning its file structure, UI design, official interface design software source code transplantation, image processing, etc.); the use of esp32s3 (hardware functions, module features, WiFi & Bluetooth, etc.); espidf Use (freertos tasks, cmake writing, writing your own components, porting Arduino libraries to become components, co-writing of c/c++) and many more. You can learn to make something by drawing a module, connect the battery and take it with you to play with. , I feel excited just thinking about it...** ## Design Overview #### Design Block Diagram  #### Component Introduction * Motherboard front  * Back of motherboard  | Label | Type | Components | Describe | |:----:|:-------------:|:-------------:|:-----:| |1| MCU | ESP32S3 module | It is recommended to use ESP32-S3-WROOM-01 (N16R8), because it comes with its own antenna, so you don’t have to hold an antenna outside to adjust it before you have a casing. | |2| PMIC | AXP202 module | Use the module directly to reduce problems that occur during welding (this is already open sourced on my homepage) | |3| LED | Side mounted LED | Connect the IO0 pin of the power chip to control the power chip to switch it on and off in the program. It can also be used as a system status reminder light. | |4| LED | Side mounted LED | Connect the CHGLED pin of the power chip, and you can control the power chip in the program to automatically control the switch and flash by the charging detection function (default) or manually control the switch and flash. | |5| Button | Side Buttons | Connect the PWRON pin of the power chip, and you can control the power on and off by long pressing, short press, long press to trigger interrupts, etc. (the duration of the power on and off button, etc. can be set in the program) | |6| Connector | TYPE-C 16P | USB-POWER input interface is connected to the ACIN pin of the power chip to provide sufficient power to the device. The rated input is 5V2A. | |7| Connector | Pitch: 1.25mm 1x2P horizontal connection base | Connect the BACKUP pin of the power chip. This socket is used to connect the backup RTC battery. The power chip supports charging it (RTC battery charging voltage, current, etc. can be set in the program) | |8| Connector | TYPE-C 16P | USB-DEVICE input interface, the power part is connected to the VBUS pin of the power chip to provide current-limiting power to the device (the current-limiting current can be set in the program. If you do not care about the impact on USB communication, you can set it to USB pass-through mode. At this time Same as the USB-POWER interface). The signal part is connected to the MCU (IO19/IO20) through the CH442E chip. The default mode is DEVICE mode when powered on, which can be used for USB downloads, simulated U disks, etc.| |9| Connector | TYPE-A 4P | USB-HOST output interface, the power part is boosted by the IPSOUT pin of the power chip to provide sufficient power to external devices. The maximum output tested is 5V1A (can be controlled by the EXTEN pin of the power chip in the program control power switch). The signal part is connected to the MCU (IO19/IO20) through the CH442E chip. This mode is switched when IO38 is high, which can be used to read external input and output devices, keyboard and mouse, 4G, GNSS, etc. | |10| Card slot | TF card slot | Shares the SPI protocol with the screen, SD_CS is IO14 | |11| Connector | 16P/0.5mm flip-top bottom connection cable holder | The expansion board is connected to a cable holder to connect external modules and lead out I2C, SPI protocols and two power supplies. | |12| Connector | 2.54mm pin header | The expansion board connection pin header is used to connect external modules, breadboard testing, etc., and leads to the remaining pins | |13| USB mode switch | CH442E | Switch the USB working mode of the device through IO38. When powering on, the default IO38 is low level and the device is in DEVICE mode. | |14| Connector | Pitch: 1.25mm 1x2P horizontal connection base | Connect to the VBAT pin of the power chip. This socket is used to connect the main lithium battery and can conduct all-round monitoring of the battery (battery current voltage and current, charging voltage and current, charge and discharge coulomb meter, low voltage alarm, etc. can be set in the program ) | |15| Motor driver chip | DRV2605 | Can drive LRA linear vibration motor and ERM eccentric rotor vibration motor (this road uses LDO3 driver, current limit 200mA) | |16| Linear vibration motor | iphone 6S | You can also use other companies’ linear vibration motors on the iPhone 6S. You can just change the packaging yourself. The reason why I use this is because there is really no place to use the garbage that TB picked up in the past. | |17| RTC | BM8563 | High-precision and low-power clock chip, please see the device manual for other introductions | |18| Connector | 2.54mm horizontal pin header | Two by two, eight in total, used for JTAG debugging and TTL downloading. There are only signal lines and no power supply. The power supply needs to go through the power management module to ensure normal communication between the MCU and it. Therefore, additional power must be supplied from the USB-POWER port during debugging. | |19| IMU module or other module | JY901B module | It depends on your own needs here. What I use here is the ten-axis serial port module of Witte Intelligent. Related sensor products have a minimum price of 20 to 30 yuan, with the same pin definitions, such as punctual atomic ones, etc. | * Screen expansion board front  * Back of screen expansion board  | Label | Type | Components | Describe | |:----:|:-------------:|:-------------:|:-----:| |1| Pin | Jump hat | Used to connect IO3 to LCD_RST or release it | |2| Connector | 40P/0.5mm drawer type top connection cable holder | Screen cable holder | |3| Connector | 6P/0.5mm flip-top bottom connection cable holder | Touchpad cable holder | |4| Connector | 16P/0.5mm flip-top bottom connection cable holder | Motherboard connection cable holder | |5| Pin | Jump hat | Used to connect IO21 to TP_RST or release it | >Note: The screen is an expansion module. You can design an expansion board with similar functions by yourself. I am using the screen in the picture below, and the price is reasonable (the screen seller will give you two cable holders for the screen, which is very considerate, but You'd better remind him). The screen supports multiple protocols. The one I use here is the 4-wire SPI protocol. Of course, this screen board will be optimized and added with other functions in the future.  Purchase link  ## Function Introduction * **In addition to all the routines that the ordinary esp32s3 development board can do, due to the linear motor driver, the chip has a rich library of vibration effects built into it. You can achieve a mobile phone-like interactive tactile experience by simply calling functions. I also wrote Comprehensive test routines for experiencing screen touch and vibration feedback. For example, it can be used as a somatosensory remote control, game console, etc.**  * **Regarding lvgl, in addition to the routines of all basic controls and official test routines, I also transplanted the lvgl routines of Baiwen.com (2048, calculator, sketchpad, etc.). It also provides routines to tell you how to transplant the code from the official graphical design software squareline and let it run on esp32.** * **Regarding the power management chip, I used the AXP202 module in my own open source project. Although I explained in detail how to use it, many friends still don’t know how to integrate it into their own projects, so the schematic diagram of this development board is also Gave everyone a reference. Therefore, in the process of learning the development board, you can also become familiar with the use of the power management module.**  * **The USB part uses a WCH high-speed differential analog switch to switch between host and device modes. Since the power management chip can independently set the USB input current limit, a current limit chip is saved. When esp32s3 controls the analog switch to connect the USB pin path to port A as shown below, the device is in host mode at this time. The exten pin of the power management module controls the power enable of port A. The voltage from the Ipsout pin of the power module is boosted to 5V by a SY7088 chip to meet the power supply needs of the external slave device. The measured 5V1A operation has no problem ( The picture below shows connecting Quectel BG96- 4G&GNSS module through USB virtual serial port for AT command testing)**  **When esp32s3 controls the analog switch so that the USB pin path is connected to the following port C, the device is in device mode. In the current mode, esp32s3 can be used as a device to connect to the computer for USB downloads, or as a simulated U disk, etc. This function can be used to develop applications such as wireless storage devices, Wi-Fi network cards, LTE MiFi, multimedia devices, virtual keyboards and mice, etc.**  * **The TF card and the screen share the SPI signal line and are switched through the CS pin (which may cause the screen to freeze when reading and writing TF. The reason for this design is because as a development board, it was originally designed to add as many functions as possible, and the remaining The pins need to be used as I2S)**  * **The RTC chip uses BM8563, which has a small package and accurate travel time. LDO1 of AXP202 is an RTC power supply, which is always on and can provide uninterrupted power supply for the RTC chip. Its BACKUP pin can be connected to a button battery as a backup RTC power supply.**  ## Interface Extension #### Interface Description: * **Because we hope to be compatible with more screen types and expand more modules, the screen is not directly attached to the back of the main control board, but an independent expansion board comes out, and the main control board only leads to the interface.** * **The cables on the motherboard only lead to the SPI interface, I2C interface and part of the power supply. If you need to test the MCU/RGB/QSPI and other interface screens, you need to use the reserved 2.54mm pin holes.** * **In order to match the special distance between the upper and lower boards, extended pin headers and short female headers are used. The advantage is that modules can be installed on both the upper and lower boards. You can also use the extended pin headers to lead out tests or expand other functions, killing two birds with one stone (when using TI development boards) got an inspiration). The pin header needs to be adjusted after purchase, as shown in the following picture of the dimensions of the two ends of the black spacer:**   * **Pin header and female link**  * **Expansion board mounting header**  * **Install the pin header on the front of the motherboard (the long end of the pin header)**  * **Install the pin header on the back of the motherboard (the short end of the pin header, note that the black spacer is on this side)**  * **When assembling the mainboard and the expansion board (the left is the mainboard, the right is the expansion board, the pin header is not pressed in, it is just a demonstration, so that the upper and lower lengths can just fit)**  #### Extended Definition: * **The pin definition of 2.54mm pin header is as follows:**  * **The pin definitions of 16pin 0.5mm fpc clamshell header are as follows:**  * **The debug interface 2.54mm pin pin definition is as follows (back of motherboard):**  * **Custom serial port module (GPS, nine-axis, etc.) pad definition is as follows (back of motherboard):**  * **The custom serial port module (GPS, nine-axis, etc.) expansion pad is defined as follows (front of motherboard):**  ## Reproduction and Debugging #### Welding * **Since there are components on both sides, the side with more components is welded first, that is, the side with esp32s3 (front side)** * **Just use medium-temperature tin for front soldering. Apart from placing the components, which is a bit fiddly for your eyes, there is no other difficulty. After placing them, you can directly teppanyaki or use an air gun. Apply more soldering oil to the cable holder and drag it with a soldering iron over 300 degrees.** * **When welding the back, be sure to fix the circuit board and lift off the front components. If you can't control the temperature with an air gun, use low-temperature tin to avoid blowing and displacing the front device (if you can control it, just keep it the same as the front)** #### Assemble * **The side with the power module is facing down, the side with the vibration motor is attached to the battery, the screen panel is installed facing up, and it is fixed with copper pillars around it. The thickness of the middle layer is 0.8mm.** * **The main board is on the top and the screen board is on the bottom.**  * **The left is the screen board, the right is the main board, and the battery can be installed in the middle.**  * **Battery link**  * **Motherboard cable link**  * **Link to the motherboard cable holder (for screen cable holders, the merchant who sells the screen will give you two as a gift, which is very considerate, but you’d better remind him)**  #### Notice * **⚠️After welding, be sure to use a multimeter to check whether each power supply is short-circuited to the ground. Be sure to check xdm! ! ! Betting on dogs until you lose everything.** * **⚠️Be sure not to connect the battery during the first test! ! ! be safe.** #### Debug Download * **After using the USB_power port to supply power, axp202 will start directly without pressing the button to turn it on. At this time, test whether the voltage of each channel is normal.** * **There are two ways to download.** >* **The first type** >USB direct download and debugging method: unplug the USB_power port for power supply, and connect the USB_device port and the PC with a USB data cable.  >* **The second kind** >In USB to ttl&jtag download and debugging mode, use the downloader to connect to the debug port on the mainboard according to the pin number. Then, use the USB_power port to power the device. If the device is connected to the USB_device port and is in device mode, the port will be hijacked, resulting in repeated reconnection of the device.  * **At this time, the computer will display that a USB device is connected. Use arduino or espidf to select the download method to compile and burn the program.** * **After success, debugging information will be obtained in the serial monitor, indicating that the copy is successful. If it shows that i2c communication is not normal, check the wiring method of the microcontroller and power module, etc.** ## Precautions for Use * **If you have any questions, please read the document carefully first. If it is not solved, ask in the group and explain the reason in detail. You will definitely answer it.** * **The power supply chip has a default voltage when it is turned on. If the power is turned off after successful power-on and voltage adjustment, the default customized voltage will be restored. Please note that if there are devices lower than 3.3v in the circuit when the external experimental module is connected, be sure to pay attention to the initial voltage value.** * **When there is no casing, be careful when debugging and arranging the cables to avoid being scratched.** * **Pay attention to electrical safety and don’t damage your computer.** ## Outlook * **Audio screen board** >On the basis of the current screen, the audio input and output part is added, and later can be used for learning voice interaction, AI voice docking, etc. * **Shell** >Used to protect the board, I can paint when I have free time. ## Physical Display * **Front**  * **Reverse side**  ## Related Documents ##### Specifications * [ESP32-S3 Technical Specification](https://www.espressif.com/sites/default/files/documentation/esp32-s3_datasheet_cn.pdf) (PDF) * [ESP32-S3-WROOM-1 1U Technical Specification](https://www.espressif.com/sites/default/files/documentation/esp32-s3-wroom-1_wroom-1u_datasheet_cn.pdf)(PDF) ##### Hardware Design Reference * [AXP202 power management module open source documentation](https://oshwhub.com/mondraker/axp202-zeng-ge-yan-zheng) * [ESP-box development board official documentation](https://github.com/espressif/esp-box) * [ESP32-S3-USB-OTG development board official documentation](https://docs.espressif.com/projects/espressif-esp-dev-kits/zh_CN/latest/esp32s3/esp32-s3-usb-otg/user_guide.html) * [ESP32-S3-LCD-EV-Board Development Board Official Documentation](https://docs.espressif.com/projects/espressif-esp-dev-kits/zh_CN/latest/esp32s3/esp32-s3-lcd-ev-board/user_guide.html#id22) * [Espressif Development Board Preview](https://www.espressif.com.cn/zh-hans/products/devkits) * [LilyGO T-Watch official documentation](https://github.com/Xinyuan-LilyGO/TTGO_TWatch_Library) ##### Software Reference * [AXP202 Driver](https://github.com/lewisxhe/AXP202X_Library) * [Baiwen.com LVGL component routine](https://gitee.com/weidongshan/lv_lib_100ask) *** >**It was written in a hurry and many places were not taken care of. If you encounter any problems during the reproduction process, just ask in the group. I will continue to update here little by little.** ***