Espressif IoT Device Drivers, Documentations And Solutions.

release/v1.1 based on ESP-IDF v4.0.1

• components:

  • Small drivers of different devices like button and LED
  • Drivers of sensors
  • Drivers of different I2C devices
  • Friendly APIs of WiFi and OTA

• documents:

  • Documentations of some important features
  • Instruction of some different solutions

• examples:

  • Example project using this framework

• tools:

  • Different tools and scripts
  • Unit-test project

• ESP32 AWS IoT Example

  • Note：This example has been abandoned, please refer esp-aws-iot.

• ESP32 Pedestrian Flow Monitoring introduction

  • The example demonstrates how to use ESP32 to calculate pedestrian flow in the Wi-Fi sniffer mode.
  • Keywords: WiFi sniffer OneNet MQTT

• ESP32 Empty Project

  • It provides a framework for users to develop any projects.

• Ethernet-WiFi data transmission

  • An example that enables Ethernet-to-WiFi data forwarding function.
  • Keywords: Ethernet WiFi

• ESP32 OLED screen panel

  • The example demonstrates how to use ESP32 to drive a OLED screen and to read sensor in low power mode.
  • Keywords: SSD1306 Deep-sleep BH1750

• ESP32 LittlevGL GUI Example

  • The example demonstrates how to use LittlevGL embedded GUI library on ESP32.
  • Keywords: LittlevGL LVGL embedded GUI
  • Note：This example will be abandoned in future, please refer lvgl/lv_port_esp32.

• ESP32 uGFX GUI Example

  • The example demonstrates how to use uGFX embedded GUI library on ESP32.
  • Keywords: uGFX embedded GUI

• ESP32 Smart Device to Cloud Framework

  • Note：This example has been abandoned,please refer esp32-alink-demo.

• ESP32 Lowpower EVB Example

  • An example to show how to use ESP32 lowpower framework to build applications with ESP32 lowpower evaluating board.
  • Keywords: ESP32_Lowpower_EVB ULP Deepsleep Lowpower

• ESP32 Touch Sensor Example

  • An example for the ESP32 touch sensor development kit, ESP32-Sense, which is used to evaluate and develop ESP32 touch sensor system.
  • Keywords: TouchSensor ESP32-Sense

• ESP32 ULP Co-processor Detect Brownout Example

  • An example of using SAR_ADC to read voltage of VDD33 pin with the ESP32 ULP co-processor and determine if a brownout happened.
  • Keywords: ULP Deep-sleep Brownout Assembly

• ESP32 ULP Co-processor Reads Hall Sensor Example

  • It provides an example of the ESP32 ULP co-processor reading the on-chip Hall sensor in low-power mode.
  • Keywords: ULP Deep-sleep Built-in-Sensor HallSensor Assembly

• ESP32 ULP Co-processor Operates RTC GPIO Example

  • An example of operating RTC GPIO with the ESP32 ULP co-processor.
  • Keywords: ULP Deep-sleep RTC-GPIO Assembly

• ESP32 ULP Co-processor Send RTC Interrupt

  • An example of ESP32 ULP co-processor sending RTC interrupt.
  • Keywords: ULP RTC-Interrupt Assembly

• ESP32 ULP Co-processor Reads Temperature Sensor Example

  • An example of the ESP32 ULP co-processor reading the on-chip temperature sensor in low-power mode.
  • Keywords: ULP Deep-sleep Built-in-Sensor TemperatureSensor Assembly

• ESP32 ULP Co-processor Watering Example

  • An example of implementing the ESP32 ULP co-processor in a watering device.
  • Keywords: ULP Deep-sleep SAR-ADC RTC-GPIO Assembly

• ESP32 ULP Co-processor SAR-ADC Example

  • An example of using SAR_ADC to read NTC thermistor voltage and calculate temperature in ULP mode.
  • Keywords: ULP Deep-sleep SAR-ADC Assembly

• ESP32 ULP Co-processor BitBang I2C Example

  • An example of using RTC-GPIO bitbanged I2C to read BH1750 light sensor in ULP mode.
  • Keywords: ULP Deep-sleep RTC-GPIO BITBANG I2C Assembly

• ESP32 ULP Co-processor BitBang SPI Example

  • An example of using RTC-GPIO bitbanged SPI to read MS5611 sensor in ULP mode.
  • Keywords: ULP Deep-sleep RTC-GPIO BITBANG SPI Assembly

• DAC Audio- Driver and example of using DAC Audio.
  • Note：This example has been removed to esp-idf/examples/peripherals/i2s_adc_dac
• ULP Monitor- Provides some APIs for running simple ulp program in deep sleep.
• TouchPad- Driver and example of using different types of touch pad.
• Infrared- Driver and framework of using infrared remote control.
  • Note：This example has been removed to esp-idf/examples/peripherals/rmt/ir_protocols

• Lowpower_framework - Development framework for lowpower applications.

• ADC - Driver and example of ADC
  • Note：This example has been abandoned,please refer esp-idf/examples/peripherals/adc
• Button - Driver and example of using buttons and keys.
• Debugs - Provides different commands for debugging via UART.
• LED - Driver and example of using LED, which provides such APIs as to blink with different frequency.
• Light - Driver and example of using PWM to drive a light, which provides such APIs as to control several channels of LED.
• OTA - Driver and example of upgrading firmware from the given URL.
  • Note: This example will be abandoned in future, please refer esp-idf/examples/system/ota
• Param - Driver and example of saving and loading data via NVS flash.
• Power Meter - Driver and example of a single-phase energy meter such as BL0937 or HLW8012.
• Relay - Driver and example of a relay with different driving modes.
• Weekly timer - Driver and example of a weekly timer to trigger events at some certain moment in each week.

• LittlevGL - Driver of using LittlevGL embedded GUI library.
• uGFX - Driver and example of using uGFX embedded GUI library.

• APDS9960 - Driver and example of reading APDS9960, which is an ambient light photo Sensor.
• BH1750 - Driver and example of reading BH1750 light sensor (GY-30 module).
• BME280 - Driver and example of reading BME280, which is an pressure and temperature Sensor.
• FT5X06 - Driver and example of reading FT5X06, which is a touch Sensor.
• HDC2010 - Driver and example of reading HDC2010, which is a low power temperature and humidity sensor.
• HTS221 - Driver and example of reading HTS221 temperature and humidity sensor.
• LIS2DH12 - Driver and example of reading LIS2DH12, which is a 3-axis accelerometer.
• MVH3004D - Driver and example of reading MVH3004D temperature and humidity sensor.
• VEML6040 - Driver and example of reading VEML6040, which is a RGBW color sensor.

• AT24C02 - Driver and example of driving AT24C02, which is an eeprom storage.
• CH450 - Driver and example of driving CH450, which is a 7-segment LED driver.
• HT16C21 - Driver and example of driving HT16C21, which is a LED driver.
• IS31FL3XXX - Driver and example of driving is31fl3xxx series chips, which are light effect LED driver chips.
• MCP23017 - Driver and example of using mcp23017, which is a 16-bit I/O expander.
• SSD1306 - Driver and example of using ssd1306, which is a 132 x 64 dot matrix OLED/PLED segment driver chip.

• ILI9806 - Driver and example of driving ILI9806 LCD.
• NT35510 - Driver and example of driving NT35510 LCD.

• Servo - Driver and example of driving servo motors.
• A4988 - Driver and example of driving A4988, which is a stepper motor driver.

• MQTT - Driver and example of using MQTT client, which is a light-weight IoT protocol.
  • Note: This example has been abandoned, please refer: esp-idf/examples/protocols/mqtt
• TCP - API and example of using TCP server and client in C++.
• UDP - API and example of using UDP in C++.
• Alink - API and example of connecting and communicating with Alink cloud service.
  • Note: This example has been abandoned, please refer: esp32-alink

• E-ink display - API and example of driving and controlling SPI E-ink screen.
• LCD screen - API and example of driving and controlling SPI LCD.
• XPT2046 Touch screen - API and example of driving and controlling SPI Touch Screen.

• ESP-TOUCH for smart-config - Abstract APIs and example of configuring devices via esp-touch.
• Blufi abstract APIs - Abstract APIs and example of configuring devices via blufi.
• WiFi connection abstract APIs - Abstract APIs and example of WiFi station connecting to router.

• Deep-sleep low power solutions [中文]
  • Current Consumption Test for ESP32 in Deep sleep[中文]
  • ESP32 Low-Power Management Overview[中文]
  • ESP32 ULP Co-processor and Assembly Environment Setup[中文]
• Light-sleep low power solutions overview [中文]
  • ESP32 DFS test manual
  • ESP32 Light-sleep features
  • ESP32 Light-sleep test manua[中文]
• Touch Sensor Application Note [中文]
  • ESP-Tuning Tool User Guide [中文]
• Security and Factory Flow [中文]
  • ESP32 secure and encrypt[中文]
  • Download Tool GUI Instruction

To use uint-test, follow these steps:

• Change to the directory of unit-test-app

  cd YOUR_IOT_SOLUTION_PATH/tools/unit-test-app
  

• Use the default sdkconfig and compile unit-test-app by make IOT_TEST_ALL=1 -j8

  make defconfig
  make IOT_TEST_ALL=1
  

• Flash the images by make flash

  make IOT_TEST_ALL=1 flash
  

• Reset the chip and see the uart log using an uart tool such as minicom

• All kinds of components will be shown by uart

  Here's the test menu, pick your combo:
  (1)     "Sensor BH1750 test" [bh1750][iot][sensor]
  (2)     "Button test" [button][iot]
  (3)     "Button cpp test" [button_cpp][iot]
  (4)     "Dac audio test" [dac_audio][iot][audio]
  (5)     "Debug cmd test" [debug][iot]
  (6)     "Deep sleep gpio test" [deep_sleep][rtc_gpio][current][iot]
  (7)     "Deep sleep touch test" [deep_sleep][touch][current][iot]
   ......
  

• You need to send the index of the unit you want to test by uart. Test code of the unit you select will be run

• ESP32_ULP_EB_V1 Evaluation Board [中文]
• ESP32-Sense kit Board [中文]
  • ESP32 Touch Sensor development kit[中文]
• ESP-Prog board [中文]
  • Firmware download and JTAG debug tool[中文]

1. Install ESP-IDF v4.0.1 Step By Step

Current branch based on ESP-IDF v4.0.1

2. Get ESP-IoT-Solution

   git clone --recursive https://github.com/espressif/esp-iot-solution

3. Initialize the Submodules

   git submodule update --init --recursive

4. Set up the Environment Variables

   export IOT_SOLUTION_PATH=~/esp/esp-iot-solution

• We can regard IoT solution project as a platform that contains different device drivers and features

• Add-on project: If you want to use those drivers and build your project base on the framework, you need to include the IoT components into your project's CMakeLists.txt.

  cmake_minimum_required(VERSION 3.5)
  
  include($ENV{IOT_SOLUTION_PATH}/component.cmake)
  include($ENV{IDF_PATH}/tools/cmake/project.cmake)
  
  project(empty-project)
  

• Stand-alone component: if you just want to pick one of the component and put it into your existing project, you just need to copy the single component to your project components directory. But you can also append the component list in your project's CMakeLists.txt like this:

  set(EXTRA_COMPONENT_DIRS "${EXTRA_COMPONENT_DIRS} ${IOT_SOLUTION_PATH}/components/{component_you_choose}")
  

• We can regard IoT solution project as a platform that contains different device drivers and features

• Add-on project: If you want to use those drivers and build your project base on the framework, you need to include the IoT components into your project's Makefile.

  include $(IOT_SOLUTION_PATH)/component.mk
  include $(IDF_PATH)/make/project.mk
  

• Stand-alone component: if you just want to pick one of the component and put it into your existing project, you just need to copy the single component to your project components directory. But you can also append the component list in your project Makefile like this:

  EXTRA_COMPONENT_DIRS += $(IOT_SOLUTION_PATH)/components/{component_you_choose}