Merge branch 'task/update_readme_for_ulp_riscv_examples' into 'master'

docs(ulp_riscv): Updated ulp_riscv example README files to update GPIO configuration

See merge request espressif/esp-idf!26782
This commit is contained in:
Sudeep Mohanty 2023-11-01 20:32:50 +08:00
commit 9e6e0a5677
2 changed files with 40 additions and 1 deletions

View File

@ -7,13 +7,28 @@ This example demonstrates how to use the RTC I2C peripheral from the ULP RISC-V
The ULP program is based on the BMP180 Temperature and Pressure sensor (https://cz.mouser.com/datasheet/2/783/BST-BMP180-DS000-1509579.pdf) which has an I2C interface. The main CPU initializes the RTC I2C peripheral, the BMP180 sensor and loads the ULP program. It then goes into deep sleep.
The ULP program periodically measures the temperature and pressure values from the BMP180 sensor and wakesup the main CPU when the values are above a certain thershold.
The ULP program periodically measures the temperature and pressure values from the BMP180 sensor and wakes up the main CPU when the values are above a certain threshold.
## How to use example
### Hardware Required
* A development board with a SOC which has a RISC-V ULP coprocessor (e.g., ESP32-S2 Saola)
* A BMP180 sensor module
* A USB cable for power supply and programming
#### Pin Assignment:
**Note:** The following pin assignments are used by default.
| | SDA | SCL |
| --------------------------- | ------| ------|
| ESP32-S2/S3 RTC I2C Master | GPIO3 | GPIO2 |
| BMP180 Sensor | SDA | SCL |
**Note:** The SDA line can only be configured to use either GPIO1 or GPIO3 and the SCL line can only be configured to use either GPIO0 or GPIO2.
**Note:** This example enables the internal pull-up resistors for the SDA/SCL lines by default.
## Example output
Below is the output from this example.

View File

@ -17,6 +17,30 @@ The ULP Program scans all touch pad sensors periodically. When the ULP program f
* A development board with ESP32-S2 or ESP32-S3
The following capacitive touch pads are supported on ESP32-S2/S3:
```
----------------------------------------------------------
| Touch Pad | GPIO Pin |
|------------|-------------------------------------------|
| T0 | Internal channel, not connected to a GPIO |
| T1 | GPIO1 |
| T2 | GPIO2 |
| T3 | GPIO3 |
| T4 | GPIO4 |
| T5 | GPIO5 |
| T6 | GPIO6 |
| T7 | GPIO7 |
| T8 | GPIO8 |
| T9 | GPIO9 |
| T10 | GPIO10 |
| T11 | GPIO11 |
| T12 | GPIO12 |
| T13 | GPIO13 |
| T14 | GPIO14 |
----------------------------------------------------------
```
### Build and Flash
Build the project and flash it to the board, then run monitor tool to view serial output: