板载 RGB#

board_rgb#

点击下载 : Click!

下载官方 RGB 组件#

可以在工程中看到已经导入的组件, 如下图

添加组件#

在 main.c 中使用#

可看到板载 RGB 以红光闪烁

1
#include <stdio.h>
2
#include <string.h>
3
#include <math.h>
4
#include "freertos/FreeRTOS.h"
5
#include "freertos/task.h"
6
#include "driver/gpio.h"
7
#include "esp_log.h"
8
#include "esp_err.h"
9
#include "board_rgb.h"
10

11
static const char *TAG = "main";
12

13
static void hsv_to_rgb(float h, float s, float v,
14
                       uint8_t *r, uint8_t *g, uint8_t *b)
15
{
16
    float c = v * s;
17
    float x = c * (1 - fabsf(fmodf(h / 60.0f, 2) - 1));
18
    float m = v - c;
19

20
    float rf = 0, gf = 0, bf = 0;
21

22
    if (h < 60) {
23
        rf = c; gf = x; bf = 0;
24
    } else if (h < 120) {
25
        rf = x; gf = c; bf = 0;
26
    } else if (h < 180) {
27
        rf = 0; gf = c; bf = x;
28
    } else if (h < 240) {
29
        rf = 0; gf = x; bf = c;
30
    } else if (h < 300) {
31
        rf = x; gf = 0; bf = c;
32
    } else {
33
        rf = c; gf = 0; bf = x;
34
    }
35

36
    *r = (uint8_t)((rf + m) * 255);
37
    *g = (uint8_t)((gf + m) * 255);
38
    *b = (uint8_t)((bf + m) * 255);
39

40
}
41

42
void app_main(void)
43
{
44
    board_rgb_t rgb = {0};
45

46
    ESP_ERROR_CHECK(board_rgb_init(&rgb, 48)); // 我的 RGB LED 连接到 GPIO 48
47

48
    ESP_LOGI(TAG, "Start rainbow RGB effect");
49

50
    float hue = 0.0f;
51
    uint8_t r, g, b;
52

53
    while (1) {
54
        hsv_to_rgb(hue, 1.0f, 0.3f, &r, &g, &b); // 0.3 比较柔和，不刺眼
55
        ESP_ERROR_CHECK(board_rgb_set(&rgb, r, g, b));
56

57
        hue += 2.0f;          // 调整这个值控制“转得快不快”
58
        if (hue >= 360.0f) {
59
            hue = 0.0f;
60
        }
61

62
        vTaskDelay(pdMS_TO_TICKS(20)); // 越小越顺
63
    }
64

65
}

GPIO 初始化重写#

gpio_setup#

点击下载 : Click!

添加组件#

见 ESP32S3 + 组件添加教程

在 main.c 中使用#

1
#include <stdio.h>
2
#include <string.h>
3
#include "freertos/FreeRTOS.h"
4
#include "freertos/task.h"
5
#include "driver/gpio.h"
6
#include "esp_log.h"
7
#include "esp_err.h"
8
#include "gpio_setup.h"
9

10
void app_main(void)
11
{
12
    static const gpio_config_item_t gpio_init_table[] = {
13
        {
14
            .gpio_num = GPIO_NUM_48,
15
            .mode = GPIO_MODE_OUTPUT,
16
            .pull_up_en = false,
17
            .pull_down_en = false,
18
            .level = 0,
19
            .intr_type = GPIO_INTR_DISABLE,
20
        },
21
        {
22
            .gpio_num = GPIO_NUM_0,
23
            .mode = GPIO_MODE_INPUT,
24
            .pull_up_en = true,
25
            .pull_down_en = false,
26
            .level = 0,
27
            .intr_type = GPIO_INTR_DISABLE,
28
        },
29
    };
30

31
    gpio_setup_init(
32
        gpio_init_table,
33
        sizeof(gpio_init_table) / sizeof(gpio_init_table[0])
34
    );
35
}

u8g2库点亮 OLED#

修改 `main\idf_component.yml`#

NOTE
不能用 tab 来缩进, 不然会报错

1
dependencies:
2
  ## Required IDF version
3
  idf:
4
    version: '>=4.1.0'
5
 u8g2:
6
   git: https://github.com/olikraus/u8g2.git
7
 u8g2-hal-esp-idf:
8
   git: https://github.com/mkfrey/u8g2-hal-esp-idf.git

编译结束后可在 managed_components 中看到下载好的组件

在 main.c 中使用#

1
#include <stdio.h>
2
#include <string.h>
3
#include <math.h>
4
#include "freertos/FreeRTOS.h"
5
#include "freertos/task.h"
6
#include "driver/gpio.h"
7
#include "esp_log.h"
8
#include "esp_err.h"
9
#include "u8g2.h"
10
#include "u8g2_esp32_hal.h"
11

12
#define PIN_SDA   GPIO_NUM_4
13
#define PIN_SCL   GPIO_NUM_5
14
#define OLED_I2C_ADDRESS 0x3C
15

16
u8g2_t u8g2;
17

18
void init_display(void)
19
{
20
    u8g2_esp32_hal_t u8g2_esp32_hal = U8G2_ESP32_HAL_DEFAULT;
21
    u8g2_esp32_hal.bus.i2c.sda = PIN_SDA;
22
    u8g2_esp32_hal.bus.i2c.scl = PIN_SCL;
23
    u8g2_esp32_hal_init(u8g2_esp32_hal);
24

25
    u8g2_Setup_ssd1306_i2c_128x64_noname_f(
26
        &u8g2, U8G2_R0,
27
        u8g2_esp32_i2c_byte_cb,
28
        u8g2_esp32_gpio_and_delay_cb); // init u8g2 structure
29

30
    u8x8_SetI2CAddress(&u8g2.u8x8, OLED_I2C_ADDRESS * 2);
31

32
    u8g2_InitDisplay(&u8g2);
33
    u8g2_SetPowerSave(&u8g2, 0);
34
    u8g2_ClearBuffer(&u8g2);
35

36
    u8g2_SetFont(&u8g2, u8g2_font_ncenB10_tr);
37
}
38

39
// 绘制函数示例
40
void draw_content(void) {
41
    u8g2_FirstPage(&u8g2);
42
    do {
43
        u8g2_DrawStr(&u8g2, 0, 15, "S3 OLED Demo!");
44
        u8g2_DrawStr(&u8g2, 0, 30, "Adrian!");
45
    } while (u8g2_NextPage(&u8g2));
46
}
47

48
void app_main(void)
49
{
50
    init_display();
51

52
    while(1) {
53
       draw_content();
54
       vTaskDelay(pdMS_TO_TICKS(5));
55
    }
56
}

OLED 0.96寸函数封装#

oled_iic_0.96#

点击下载 : Click!

添加组件#

见 ESP32S3 + 组件添加教程

在 main.c 中使用#

1
#include "u8g2.h"
2
#include "u8g2_esp32_hal.h"
3

4
#define PIN_SDA   GPIO_NUM_4
5
#define PIN_SCL   GPIO_NUM_5
6
#define OLED_I2C_ADDRESS 0x3C
7

8
u8g2_t u8g2;
9

10
void init_display(void)
11
{
12
  //设置一下使用的引脚
13
    u8g2_esp32_hal_t u8g2_esp32_hal = U8G2_ESP32_HAL_DEFAULT;
14
    u8g2_esp32_hal.bus.i2c.sda = PIN_SDA;
15
    u8g2_esp32_hal.bus.i2c.scl = PIN_SCL;
16
    u8g2_esp32_hal_init(u8g2_esp32_hal);
17

18
    // 针对不同的屏幕使用不同的初始化函数
19
    u8g2_Setup_ssd1306_i2c_128x64_noname_f(
20
        &u8g2, U8G2_R0,
21
        u8g2_esp32_i2c_byte_cb,
22
        u8g2_esp32_gpio_and_delay_cb); // init u8g2 structure
23

24
    // 0x3c -> 0x78 (I2C 地址乘以 2)
25
    u8x8_SetI2CAddress(&u8g2.u8x8, OLED_I2C_ADDRESS * 2); // **已修正：确保乘以 2**
26

27
    u8g2_InitDisplay(&u8g2);     // send init sequence to the display
28
    u8g2_SetPowerSave(&u8g2, 0); // wake up display
29
    u8g2_ClearBuffer(&u8g2);
30

31
    // 建议设置一个默认字体
32
    u8g2_SetFont(&u8g2, u8g2_font_ncenB10_tr);
33
}
34

35
// 绘制函数示例
36
void draw_content(void) {
37
    u8g2_FirstPage(&u8g2);
38
    do {
39
        u8g2_DrawStr(&u8g2, 0, 15, "S3 OLED Demo!");
40
        u8g2_DrawStr(&u8g2, 0, 30, "Adrian!");
41
    } while (u8g2_NextPage(&u8g2));
42
}
43

44
void app_main(void)
45
{
46
    init_display();
47

48
    while(1) {
49
       draw_content();
50
       vTaskDelay(pdMS_TO_TICKS(5));
51
    }
52
}

1
#include "oled_iic_0.96.h"
2

3
void app_main(void)
4
{
5
    oled_iic_096_init(4, 5, 0x3C, NULL);
6
    //oled_iic_096_demo("Adrian");
7
    u8g2_t *u8g2 = oled_iic_096_get_u8g2();
8

9
    while(1)
10
    {
11
        u8g2_ClearBuffer(u8g2);
12
        u8g2_DrawStr(u8g2, 38, 18, "Adrian");
13
        u8g2_SendBuffer(u8g2);
14
    }
15

16
}

HCSR04 超声波传感器#

hscr04#

点击下载 : Click!

添加组件#

见 ESP32S3 + 组件添加教程

在 main.c 中使用#

1
#include "hcsr04.h"
2
#include "oled_iic_0.96.h"
3

4
void app_main(void)
5
{
6
     hcsr04_config_t cfg = {
7
        .trig_gpio = 18,
8
        .echo_gpio = 17,
9
        .sound_speed_m_s = 343.0f,
10
        .timeout_us = 10000,
11
    };
12
    ESP_ERROR_CHECK(hcsr04_init(&cfg));
13

14
    while(1)
15
    {
16
        u8g2_ClearBuffer(u8g2);
17
        int16_t mm = 0;
18
        esp_err_t err = hcsr04_read_mm(&mm);
19

20
        char line1[32];
21
        char line2[32];
22

23
        if (err == ESP_OK)
24
        {
25
            float cm = mm / 10.0f;
26
            snprintf(line1, sizeof(line1), "mm: %d", (int)mm);
27
            snprintf(line2, sizeof(line2), "cm: %.1f", cm);
28
            u8g2_DrawStr(u8g2, 30, 35, line1);
29
            u8g2_DrawStr(u8g2, 30, 51, line2);
30
        }
31
        else
32
        {
33
            snprintf(line1, sizeof(line1), "Read failed");
34
            snprintf(line2, sizeof(line2), "%s", esp_err_to_name(err));
35
            u8g2_DrawStr(u8g2, 30, 35, line1);
36
            u8g2_DrawStr(u8g2, 30, 51, line2);
37
        }
38
    }
39
}

板载 RGB#

board_rgb#

下载官方 RGB 组件#

添加组件#

在 main.c 中使用#

GPIO 初始化重写#

gpio_setup#

添加组件#

在 main.c 中使用#

u8g2库 点亮 OLED#

修改 main\idf_component.yml#

在 main.c 中使用#

OLED 0.96寸 函数封装#

oled_iic_0.96#

添加组件#

在 main.c 中使用#

HCSR04 超声波传感器#

hscr04#

添加组件#

在 main.c 中使用#

u8g2库点亮 OLED#

修改 `main\idf_component.yml`#

OLED 0.96寸函数封装#