Getting Started with ESP Project Development

When developing ESP projects, a common approach is to review example projects and ESP-IDF documentation, choose the example closest to your target application, and extend it step by step.

This guide introduces the background knowledge you need for ESP project development:

• General Knowledge
• ESP Learning Resources

General Knowledge

Before developing ESP projects, you need to master some key general knowledge and skills to ensure the smooth progress of the project:

• Git: Git is an open-source distributed version control system used to track code changes and collaborative development. Using Git in your project can help you manage your code effectively, control versions, and collaborate with team members. Learning how to use Git for code submission, branch management, merging, etc., is a basic requirement for developing ESP projects.

  • Common Git Commands Explained
  • Official Git Documentation
  • Common Git Commands

• FreeRTOS: FreeRTOS is an open-source real-time operating system widely used in embedded systems and microcontroller projects. ESP series chips all support FreeRTOS and often use it to implement multitasking and real-time scheduling. Understanding the concepts of FreeRTOS task scheduling, message queues, semaphores, etc., is essential knowledge for developing ESP projects.

  • Common FreeRTOS API Explained
  • FreeRTOS Official Website
  • FreeRTOS Official Getting Started Guide
  • How to use FreeRTOS in the ESP-IDF environment

• C/C++: C and C++ are the main programming languages for ESP series chip development. ESP-IDF is basically developed using C/C++, so mastering them is very important for understanding low-level drivers, task scheduling, memory management, and high-performance application development. Developers should understand concepts such as variable types, pointers, memory management, functions, classes, templates, etc., and master debugging skills.

• Linux (optional): ESP project development often takes place on the Linux operating system, as Linux provides a wealth of tools and command line environments suitable for embedded development. Developers should understand the basic commands and usage of Linux, such as file operations, directory management, process management, etc., in order to debug and configure during the development process.

  • Common Linux File and Directory Management Commands

  - ls: Lists the files and folders in the current directory.
  - cd <directory>: Switches to the specified directory.
  - pwd: Displays the path of the current working directory.
  - cp <source> <destination>: Copy files or directories.
  - rm <file_name>: Delete a file.
  - mkdir <directory>: Create a new directory.
  - rmdir <directory>: Delete an empty directory.
  - cat <file_name>: Display the content of a file.
  

ESP Learning Resources

ESP Products

• Understand the features, functions, and application scenarios of ESP series chips, refer to: Hardware selection
• Gain a deeper understanding of chip characteristics, interfaces, and security features by actually using ESP development boards for basic experiments and hardware operations.

Development Tools and Environment Configuration

• Learn about setting up and configuring the development environment, complete the installation of ESP-IDF, toolchain configuration, and development environment setup.
• Familiarize yourself with ESP-IDF tools, including build, flash, debug, and serial monitor commands.
• Understand the hardware and software requirements for flashing firmware on each ESP chip.

API Learning and Practice

• Understand the functions and interface definitions of system, peripheral, network, and protocol stack APIs through the use of ESP-IDF API.
• Combine the guide to the usage of ESP-IDF API, learn about the typical use cases, configuration methods, and best practices of the API.
• Find solutions based on ESP-IDF, application examples, components, and drivers in the ESP IoT Solution library. Most documents provide both Chinese and English versions.
• Learn related knowledge and practical skills by participating in online courses and video tutorials on ESP chip and ESP-IDF development.

ESP-IDF Framework

• Understand the functional differences and upgrade strategies of different versions through the introduction and management of ESP-IDF versions.
• Understand the componentized design, build system, and inter-module relationships through the composition and architecture of the ESP-IDF framework.
• Learn component management and usage, master the methods of introducing, configuring, and reusing components.
• Understand the Flash space management method of ESP-IDF, refer to the partition table.

Community and Forums

• Join the official ESP32 forum, CSDN forum, or other developer communities. Exchange experiences with other developers, seek help, and share projects and solutions.
• Submit bugs or feature requests through the Issues section on GitHub. Before submitting new Issues, check the existing Issues.

Reference Books

• Read books related to embedded systems, C language, and ESP chip development to expand your breadth and depth of knowledge. Refer to: ESP32 book list.

---

Continuous practice and project development are the most important parts of the learning process. Developers can gradually master ESP chip embedded project development skills through continuous practice and practical application.