Bairan.Zhang/AI_Printer
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat(platform): integrate st7789 boot test display and board gpio mapping

Browse Source
This commit is contained in:
admin
2026-02-26 16:06:28 +08:00
parent dde759d0a4
commit e7aa0e75bf
8 changed files with 860 additions and 13 deletions
Download Patch File Download Diff File Expand all files Collapse all files

18
README.md
View File

@@ -98,6 +98,24 @@ In `menuconfig -> TQ Controller Config`:
- `TQ_VOICE_OPUS_BITRATE_KBPS`
- `TQ_VOICE_I2C_*` / `TQ_VOICE_I2S_*`
- `TQ_VOICE_CODEC_*`
- Board GPIO map fields:
- `TQ_POWER_*`, `TQ_LED_*`, `TQ_SCREEN_*`, `TQ_PRINT_*`, `TQ_SPI_*`
- `TQ_KEY_PRINT_BOOST_ENABLE_ON_BOOT` / `TQ_KEY_PRINT_BOOST_ACTIVE_HIGH`
- ST7789 screen fields:
- `TQ_SCREEN_ENABLE`
- `TQ_SCREEN_TEST_PATTERN_ON_BOOT`
- `TQ_SCREEN_PIXEL_CLOCK_HZ`
- `TQ_SCREEN_SPI_MODE`
- `TQ_SCREEN_H_RES` / `TQ_SCREEN_V_RES`
- `TQ_SCREEN_DRAW_LINES`
- `TQ_SCREEN_COLOR_ORDER_BGR`
- `TQ_SCREEN_BACKLIGHT_ACTIVE_HIGH`
- `TQ_SCREEN_MIRROR_*` / `TQ_SCREEN_SWAP_XY`
- `TQ_SCREEN_X_GAP` / `TQ_SCREEN_Y_GAP`
- `TQ_SCREEN_RESET_PIN`
Board pin assignment reference:
- [`docs/gpio-map.md`](docs/gpio-map.md)
When `TQ_API_KEY` is not empty, each request must include:

2
components/platform/CMakeLists.txt
View File

@@ -3,6 +3,7 @@ idf_component_register(
"src/platform_bootstrap.c"
"src/wifi_manager.c"
"src/ble_printer_client.c"
"src/display_st7789.c"
"src/voice_audio.c"
"src/runtime_policy.c"
"src/runtime_diagnostics.c"
@@ -18,6 +19,7 @@ idf_component_register(
esp_event
nvs_flash
mbedtls
esp_lcd
esp_codec_dev
esp_audio_codec
driver

5
components/platform/include/platform.h
View File

@@ -37,6 +37,11 @@ bool ble_printer_client_is_connected(void);
void ble_printer_client_get_link_state(ble_link_state_t *out_state);
esp_err_t ble_printer_client_write(const uint8_t *data, size_t len);
// ---------- display_st7789 ----------
esp_err_t platform_display_init(void);
esp_err_t platform_display_show_test_pattern(void);
void platform_display_deinit(void);
// ---------- voice_audio ----------
typedef struct {
uint32_t sample_rate;

317
components/platform/src/display_st7789.c Normal file
View File

@@ -0,0 +1,317 @@
#include "platform.h"
#include <stddef.h>
#include <stdint.h>
#include <stdlib.h>
#include "driver/gpio.h"
#include "driver/spi_master.h"
#include "esp_check.h"
#include "esp_heap_caps.h"
#include "esp_lcd_panel_io.h"
#include "esp_lcd_panel_ops.h"
#include "esp_lcd_panel_vendor.h"
#include "esp_log.h"
#include "sdkconfig.h"
static const char *TAG = "display_st7789";
#define ST7789_SPI_HOST SPI2_HOST
#define ST7789_COLOR_BYTES_PER_PIXEL 2
#ifndef CONFIG_TQ_SCREEN_SPI_MODE
#define CONFIG_TQ_SCREEN_SPI_MODE 0
#endif
#ifndef CONFIG_TQ_SCREEN_BACKLIGHT_ACTIVE_HIGH
#define CONFIG_TQ_SCREEN_BACKLIGHT_ACTIVE_HIGH 1
#endif
#if CONFIG_TQ_SCREEN_BACKLIGHT_ACTIVE_HIGH
#define ST7789_BACKLIGHT_ON_LEVEL 1
#define ST7789_BACKLIGHT_OFF_LEVEL 0
#else
#define ST7789_BACKLIGHT_ON_LEVEL 0
#define ST7789_BACKLIGHT_OFF_LEVEL 1
#endif
typedef struct {
esp_lcd_panel_io_handle_t io_handle;
esp_lcd_panel_handle_t panel_handle;
bool bus_owned;
bool initialized;
} st7789_display_state_t;
static st7789_display_state_t s_display;
#if CONFIG_TQ_SCREEN_COLOR_ORDER_BGR
#define ST7789_COLOR_ORDER LCD_RGB_ELEMENT_ORDER_BGR
#else
#define ST7789_COLOR_ORDER LCD_RGB_ELEMENT_ORDER_RGB
#endif
#if CONFIG_TQ_SCREEN_SWAP_XY
#define ST7789_SWAP_XY true
#else
#define ST7789_SWAP_XY false
#endif
#if CONFIG_TQ_SCREEN_MIRROR_X
#define ST7789_MIRROR_X true
#else
#define ST7789_MIRROR_X false
#endif
#if CONFIG_TQ_SCREEN_MIRROR_Y
#define ST7789_MIRROR_Y true
#else
#define ST7789_MIRROR_Y false
#endif
static uint16_t rgb565(uint8_t r, uint8_t g, uint8_t b) {
return (uint16_t)(((uint16_t)(r & 0xF8) << 8) |
((uint16_t)(g & 0xFC) << 3) |
((uint16_t)(b & 0xF8) >> 3));
}
static uint16_t test_pattern_color(int x, int y, int h_res, int v_res) {
int top = v_res / 3;
int middle = (v_res * 2) / 3;
if (y < top) {
uint8_t r = (uint8_t)((x * 255) / (h_res - 1));
uint8_t g = (uint8_t)(255 - r);
return rgb565(r, g, 48);
}
if (y < middle) {
uint8_t gray = (uint8_t)(((y - top) * 255) / ((middle - top) > 1 ? (middle - top - 1) : 1));
return rgb565(gray, gray, gray);
}
bool checker = (((x / 16) + (y / 16)) & 1) != 0;
return checker ? rgb565(250, 250, 250) : rgb565(8, 8, 8);
}
static void fill_test_pattern_chunk(uint16_t *buf,
int y_start,
int lines,
int h_res,
int v_res) {
for (int row = 0; row < lines; ++row) {
int y = y_start + row;
for (int x = 0; x < h_res; ++x) {
uint16_t color = test_pattern_color(x, y, h_res, v_res);
if (x == 0 || y == 0 || x == (h_res - 1) || y == (v_res - 1)) {
color = rgb565(255, 0, 0);
} else if (x == (h_res / 2) || y == (v_res / 2)) {
color = rgb565(255, 255, 255);
}
buf[row * h_res + x] = color;
}
}
}
void platform_display_deinit(void) {
#if CONFIG_TQ_SCREEN_ENABLE
if (CONFIG_TQ_SCREEN_BACKLIGHT_PIN >= 0) {
(void)gpio_set_level(CONFIG_TQ_SCREEN_BACKLIGHT_PIN, ST7789_BACKLIGHT_OFF_LEVEL);
}
if (s_display.panel_handle != NULL) {
(void)esp_lcd_panel_del(s_display.panel_handle);
s_display.panel_handle = NULL;
}
if (s_display.io_handle != NULL) {
(void)esp_lcd_panel_io_del(s_display.io_handle);
s_display.io_handle = NULL;
}
if (s_display.bus_owned) {
(void)spi_bus_free(ST7789_SPI_HOST);
s_display.bus_owned = false;
}
s_display.initialized = false;
#endif
}
esp_err_t platform_display_init(void) {
#if !CONFIG_TQ_SCREEN_ENABLE
return ESP_ERR_NOT_SUPPORTED;
#else
if (s_display.initialized) {
return ESP_OK;
}
if (CONFIG_TQ_SCREEN_BACKLIGHT_PIN >= 0) {
ESP_RETURN_ON_ERROR(gpio_set_level(CONFIG_TQ_SCREEN_BACKLIGHT_PIN, ST7789_BACKLIGHT_OFF_LEVEL),
TAG,
"set backlight off failed");
}
const size_t max_transfer_size = (size_t)CONFIG_TQ_SCREEN_H_RES *
(size_t)CONFIG_TQ_SCREEN_DRAW_LINES *
ST7789_COLOR_BYTES_PER_PIXEL + 8;
spi_bus_config_t bus_cfg = {
.sclk_io_num = CONFIG_TQ_SPI_SHARED_CLK_PIN,
.mosi_io_num = CONFIG_TQ_SPI_SHARED_MOSI_PIN,
.miso_io_num = -1,
.quadwp_io_num = -1,
.quadhd_io_num = -1,
.max_transfer_sz = (int)max_transfer_size,
};
esp_err_t err = spi_bus_initialize(ST7789_SPI_HOST, &bus_cfg, SPI_DMA_CH_AUTO);
if (err == ESP_OK) {
s_display.bus_owned = true;
} else if (err == ESP_ERR_INVALID_STATE) {
s_display.bus_owned = false;
ESP_LOGW(TAG, "SPI host already initialized, reuse host=%d", ST7789_SPI_HOST);
} else {
return err;
}
esp_lcd_panel_io_spi_config_t io_cfg = {
.cs_gpio_num = CONFIG_TQ_SCREEN_CS_PIN,
.dc_gpio_num = CONFIG_TQ_SCREEN_DC_PIN,
.spi_mode = CONFIG_TQ_SCREEN_SPI_MODE,
.pclk_hz = CONFIG_TQ_SCREEN_PIXEL_CLOCK_HZ,
.trans_queue_depth = 1,
.lcd_cmd_bits = 8,
.lcd_param_bits = 8,
};
err = esp_lcd_new_panel_io_spi((esp_lcd_spi_bus_handle_t)ST7789_SPI_HOST, &io_cfg, &s_display.io_handle);
if (err != ESP_OK) {
platform_display_deinit();
return err;
}
esp_lcd_panel_dev_config_t panel_cfg = {
.reset_gpio_num = CONFIG_TQ_SCREEN_RESET_PIN,
.rgb_ele_order = ST7789_COLOR_ORDER,
.bits_per_pixel = 16,
};
err = esp_lcd_new_panel_st7789(s_display.io_handle, &panel_cfg, &s_display.panel_handle);
if (err != ESP_OK) {
platform_display_deinit();
return err;
}
err = esp_lcd_panel_reset(s_display.panel_handle);
if (err != ESP_OK) {
ESP_LOGE(TAG, "panel reset failed: %s", esp_err_to_name(err));
platform_display_deinit();
return err;
}
err = esp_lcd_panel_init(s_display.panel_handle);
if (err != ESP_OK) {
ESP_LOGE(TAG, "panel init failed: %s", esp_err_to_name(err));
platform_display_deinit();
return err;
}
err = esp_lcd_panel_swap_xy(s_display.panel_handle, ST7789_SWAP_XY);
if (err != ESP_OK) {
ESP_LOGE(TAG, "swap xy failed: %s", esp_err_to_name(err));
platform_display_deinit();
return err;
}
err = esp_lcd_panel_mirror(s_display.panel_handle, ST7789_MIRROR_X, ST7789_MIRROR_Y);
if (err != ESP_OK) {
ESP_LOGE(TAG, "mirror failed: %s", esp_err_to_name(err));
platform_display_deinit();
return err;
}
err = esp_lcd_panel_set_gap(s_display.panel_handle, CONFIG_TQ_SCREEN_X_GAP, CONFIG_TQ_SCREEN_Y_GAP);
if (err != ESP_OK) {
ESP_LOGE(TAG, "set gap failed: %s", esp_err_to_name(err));
platform_display_deinit();
return err;
}
err = esp_lcd_panel_invert_color(s_display.panel_handle, false);
if (err != ESP_OK) {
ESP_LOGE(TAG, "invert control failed: %s", esp_err_to_name(err));
platform_display_deinit();
return err;
}
err = esp_lcd_panel_disp_on_off(s_display.panel_handle, true);
if (err != ESP_OK) {
ESP_LOGE(TAG, "display on failed: %s", esp_err_to_name(err));
platform_display_deinit();
return err;
}
if (CONFIG_TQ_SCREEN_BACKLIGHT_PIN >= 0) {
err = gpio_set_level(CONFIG_TQ_SCREEN_BACKLIGHT_PIN, ST7789_BACKLIGHT_ON_LEVEL);
if (err != ESP_OK) {
ESP_LOGE(TAG, "set backlight on failed: %s", esp_err_to_name(err));
platform_display_deinit();
return err;
}
}
s_display.initialized = true;
ESP_LOGI(TAG,
"st7789 ready: spi_host=%d sclk=%d mosi=%d dc=%d cs=%d rst=%d bk=%d bk_on=%d spi_mode=%d size=%dx%d pclk=%u",
ST7789_SPI_HOST,
CONFIG_TQ_SPI_SHARED_CLK_PIN,
CONFIG_TQ_SPI_SHARED_MOSI_PIN,
CONFIG_TQ_SCREEN_DC_PIN,
CONFIG_TQ_SCREEN_CS_PIN,
CONFIG_TQ_SCREEN_RESET_PIN,
CONFIG_TQ_SCREEN_BACKLIGHT_PIN,
ST7789_BACKLIGHT_ON_LEVEL,
CONFIG_TQ_SCREEN_SPI_MODE,
CONFIG_TQ_SCREEN_H_RES,
CONFIG_TQ_SCREEN_V_RES,
(unsigned)CONFIG_TQ_SCREEN_PIXEL_CLOCK_HZ);
return ESP_OK;
#endif
}
esp_err_t platform_display_show_test_pattern(void) {
#if !CONFIG_TQ_SCREEN_ENABLE
return ESP_ERR_NOT_SUPPORTED;
#else
ESP_RETURN_ON_ERROR(platform_display_init(), TAG, "display init failed");
const int h_res = CONFIG_TQ_SCREEN_H_RES;
const int v_res = CONFIG_TQ_SCREEN_V_RES;
const int draw_lines = CONFIG_TQ_SCREEN_DRAW_LINES > 0 ? CONFIG_TQ_SCREEN_DRAW_LINES : 1;
const size_t buf_pixels = (size_t)h_res * (size_t)draw_lines;
const size_t buf_size = buf_pixels * ST7789_COLOR_BYTES_PER_PIXEL;
uint16_t *draw_buf = (uint16_t *)heap_caps_malloc(buf_size, MALLOC_CAP_DMA | MALLOC_CAP_8BIT);
if (draw_buf == NULL) {
draw_buf = (uint16_t *)heap_caps_malloc(buf_size, MALLOC_CAP_8BIT);
}
ESP_RETURN_ON_FALSE(draw_buf != NULL, ESP_ERR_NO_MEM, TAG, "alloc draw buffer failed");
ESP_LOGI(TAG, "draw test pattern start");
esp_err_t err = ESP_OK;
for (int y = 0; y < v_res && err == ESP_OK; y += draw_lines) {
int chunk_lines = draw_lines;
if (y + chunk_lines > v_res) {
chunk_lines = v_res - y;
}
fill_test_pattern_chunk(draw_buf, y, chunk_lines, h_res, v_res);
err = esp_lcd_panel_draw_bitmap(s_display.panel_handle, 0, y, h_res, y + chunk_lines, draw_buf);
if (err != ESP_OK) {
break;
}
// Wait for queued color transfer to finish before reusing draw_buf.
err = esp_lcd_panel_io_tx_param(s_display.io_handle, -1, NULL, 0);
}
heap_caps_free(draw_buf);
if (err == ESP_OK) {
ESP_LOGI(TAG, "draw test pattern done");
}
return err;
#endif
}

190
components/platform/src/platform_bootstrap.c
View File

@@ -2,14 +2,43 @@
#include <stdbool.h>
#include "driver/gpio.h"
#include "esp_heap_caps.h"
#include "esp_log.h"
#include "mbedtls/platform.h"
#include "nvs_flash.h"
#include "sdkconfig.h"
static bool s_initialized;
static bool s_board_gpio_initialized;
static const char *TAG = "platform_bootstrap";
#ifndef CONFIG_TQ_KEY_PRINT_BOOST_ENABLE_ON_BOOT
#define CONFIG_TQ_KEY_PRINT_BOOST_ENABLE_ON_BOOT 1
#endif
#ifndef CONFIG_TQ_KEY_PRINT_BOOST_ACTIVE_HIGH
#define CONFIG_TQ_KEY_PRINT_BOOST_ACTIVE_HIGH 1
#endif
#ifndef CONFIG_TQ_SCREEN_BACKLIGHT_ACTIVE_HIGH
#define CONFIG_TQ_SCREEN_BACKLIGHT_ACTIVE_HIGH 1
#endif
#if CONFIG_TQ_KEY_PRINT_BOOST_ENABLE_ON_BOOT
#if CONFIG_TQ_KEY_PRINT_BOOST_ACTIVE_HIGH
#define KEY_PRINT_BOOST_LEVEL 1
#else
#define KEY_PRINT_BOOST_LEVEL 0
#endif
#endif
#if CONFIG_TQ_SCREEN_BACKLIGHT_ACTIVE_HIGH
#define BOOT_SCREEN_BACKLIGHT_ON_LEVEL 1
#else
#define BOOT_SCREEN_BACKLIGHT_ON_LEVEL 0
#endif
static void *tls_calloc_prefer_psram(size_t n, size_t size) {
void *ptr = heap_caps_calloc(n, size, MALLOC_CAP_SPIRAM | MALLOC_CAP_8BIT);
if (ptr == NULL) {
@@ -22,11 +51,157 @@ static void tls_free(void *ptr) {
heap_caps_free(ptr);
}
static esp_err_t board_gpio_config_output(int gpio_num, int level, const char *name) {
if (gpio_num < 0) {
return ESP_OK;
}
gpio_config_t cfg = {
.pin_bit_mask = 1ULL << gpio_num,
.mode = GPIO_MODE_OUTPUT,
.pull_up_en = GPIO_PULLUP_DISABLE,
.pull_down_en = GPIO_PULLDOWN_DISABLE,
.intr_type = GPIO_INTR_DISABLE,
};
esp_err_t err = gpio_config(&cfg);
if (err != ESP_OK) {
ESP_LOGE(TAG, "gpio_config output failed: %s pin=%d err=%s", name, gpio_num, esp_err_to_name(err));
return err;
}
err = gpio_set_level(gpio_num, level);
if (err != ESP_OK) {
ESP_LOGE(TAG, "gpio_set_level failed: %s pin=%d level=%d err=%s", name, gpio_num, level, esp_err_to_name(err));
return err;
}
return ESP_OK;
}
static esp_err_t board_gpio_config_input(int gpio_num, bool pull_up, const char *name) {
if (gpio_num < 0) {
return ESP_OK;
}
gpio_config_t cfg = {
.pin_bit_mask = 1ULL << gpio_num,
.mode = GPIO_MODE_INPUT,
.pull_up_en = pull_up ? GPIO_PULLUP_ENABLE : GPIO_PULLUP_DISABLE,
.pull_down_en = GPIO_PULLDOWN_DISABLE,
.intr_type = GPIO_INTR_DISABLE,
};
esp_err_t err = gpio_config(&cfg);
if (err != ESP_OK) {
ESP_LOGE(TAG, "gpio_config input failed: %s pin=%d err=%s", name, gpio_num, esp_err_to_name(err));
return err;
}
return ESP_OK;
}
static esp_err_t platform_board_gpio_init(void) {
if (s_board_gpio_initialized) {
return ESP_OK;
}
// Must be asserted early to keep the board powered.
esp_err_t err = board_gpio_config_output(CONFIG_TQ_POWER_HOLD_PIN, 1, "power_hold");
if (err != ESP_OK) {
return err;
}
// Default UI GPIO states.
err = board_gpio_config_output(CONFIG_TQ_LED_R_PIN, 0, "led_r");
if (err != ESP_OK) {
return err;
}
err = board_gpio_config_output(CONFIG_TQ_LED_G_PIN, 0, "led_g");
if (err != ESP_OK) {
return err;
}
err = board_gpio_config_output(CONFIG_TQ_SCREEN_CS_PIN, 1, "screen_cs");
if (err != ESP_OK) {
return err;
}
err = board_gpio_config_output(CONFIG_TQ_SCREEN_DC_PIN, 0, "screen_dc");
if (err != ESP_OK) {
return err;
}
err = board_gpio_config_output(CONFIG_TQ_SCREEN_BACKLIGHT_PIN,
BOOT_SCREEN_BACKLIGHT_ON_LEVEL,
"screen_backlight");
if (err != ESP_OK) {
return err;
}
// Key/power/sensor GPIO input defaults.
err = board_gpio_config_input(CONFIG_TQ_POWER_KEY_PIN, true, "power_key");
if (err != ESP_OK) {
return err;
}
#if CONFIG_TQ_KEY_PRINT_BOOST_ENABLE_ON_BOOT
err = board_gpio_config_output(CONFIG_TQ_KEY_PRINT_PIN, KEY_PRINT_BOOST_LEVEL, "key_print_boost");
if (err != ESP_OK) {
return err;
}
#else
err = board_gpio_config_input(CONFIG_TQ_KEY_PRINT_PIN, true, "key_print");
if (err != ESP_OK) {
return err;
}
#endif
err = board_gpio_config_input(CONFIG_TQ_MIC_KEY_PIN, true, "mic_key");
if (err != ESP_OK) {
return err;
}
err = board_gpio_config_input(CONFIG_TQ_PRINT_PAPER_PIN, true, "print_paper");
if (err != ESP_OK) {
return err;
}
err = board_gpio_config_input(CONFIG_TQ_BATTERY_ADC_PIN, false, "battery_adc");
if (err != ESP_OK) {
return err;
}
err = board_gpio_config_input(CONFIG_TQ_NTC_ADC_PIN, false, "ntc_adc");
if (err != ESP_OK) {
return err;
}
ESP_LOGI(TAG,
"board gpio mapped: hold=%d pwr_key=%d key_print=%d boost_mode=%d led_r=%d led_g=%d spi(mosi=%d,miso=%d,clk=%d) screen(dc=%d,cs=%d,bk=%d) i2c(sda=%d,scl=%d) i2s(mclk=%d,bclk=%d,ws=%d,di=%d,do=%d) pa=%d",
CONFIG_TQ_POWER_HOLD_PIN,
CONFIG_TQ_POWER_KEY_PIN,
CONFIG_TQ_KEY_PRINT_PIN,
#if CONFIG_TQ_KEY_PRINT_BOOST_ENABLE_ON_BOOT
1,
#else
0,
#endif
CONFIG_TQ_LED_R_PIN,
CONFIG_TQ_LED_G_PIN,
CONFIG_TQ_SPI_SHARED_MOSI_PIN,
CONFIG_TQ_PRINTER_MISO_PIN,
CONFIG_TQ_SPI_SHARED_CLK_PIN,
CONFIG_TQ_SCREEN_DC_PIN,
CONFIG_TQ_SCREEN_CS_PIN,
CONFIG_TQ_SCREEN_BACKLIGHT_PIN,
CONFIG_TQ_VOICE_I2C_SDA_PIN,
CONFIG_TQ_VOICE_I2C_SCL_PIN,
CONFIG_TQ_VOICE_I2S_MCLK_PIN,
CONFIG_TQ_VOICE_I2S_BCLK_PIN,
CONFIG_TQ_VOICE_I2S_WS_PIN,
CONFIG_TQ_VOICE_I2S_DIN_PIN,
CONFIG_TQ_VOICE_I2S_DOUT_PIN,
CONFIG_TQ_VOICE_CODEC_PA_PIN);
s_board_gpio_initialized = true;
return ESP_OK;
}
esp_err_t platform_bootstrap_init(void) {
if (s_initialized) {
return ESP_OK;
}
ESP_ERROR_CHECK(platform_board_gpio_init());
esp_err_t err = nvs_flash_init();
if (err == ESP_ERR_NVS_NO_FREE_PAGES || err == ESP_ERR_NVS_NEW_VERSION_FOUND) {
ESP_ERROR_CHECK(nvs_flash_erase());
@@ -49,6 +224,21 @@ esp_err_t platform_bootstrap_init(void) {
}
#endif
#if CONFIG_TQ_SCREEN_ENABLE
err = platform_display_init();
if (err != ESP_OK) {
ESP_LOGW(TAG, "st7789 init failed: %s", esp_err_to_name(err));
}
#if CONFIG_TQ_SCREEN_TEST_PATTERN_ON_BOOT
else {
err = platform_display_show_test_pattern();
if (err != ESP_OK) {
ESP_LOGW(TAG, "st7789 test pattern failed: %s", esp_err_to_name(err));
}
}
#endif
#endif
s_initialized = true;
return ESP_OK;
}

65
docs/gpio-map.md Normal file
View File

@@ -0,0 +1,65 @@
# ESP32-S3 GPIO Mapping
本文件记录当前板级 GPIO 分配，来源于硬件对接表（2026-02-26）。
## GPIO Table
| Board Pin | GPIO | Signal | Direction | Notes |
| --- | --- | --- | --- | --- |
| 1 | GND | GND | - | Ground |
| 2 | 3V3 | 3V3 | - | 3.3V Power |
| 3 | EN/RST | EN | Input | Chip enable/reset |
| 4 | IO4 | PRINT_STB5_6 | Output | Printer strobe 5/6 |
| 5 | IO5 | PRINT_STB3_4 | Output | Printer strobe 3/4 |
| 6 | IO6 | ES8311_I2C_SDA | Bidirectional | Voice codec I2C SDA |
| 7 | IO7 | ES8311_I2C_SCL | Output | Voice codec I2C SCL |
| 8 | IO15 | BATTERY_ADC | Input | Battery voltage ADC detect |
| 9 | IO16 | PRINT_STB1_2 | Output | Printer strobe 1/2 |
| 10 | IO17 | PRINT_PAPER | Input | Paper detect |
| 11 | IO18 | NTC_ADC | Input | NTC ADC |
| 12 | IO8 | PRINT_OUTA_P | Output | Printer OUTA+ |
| 13 | IO19 | PRINT_OUTA_N | Output | Printer OUTA- |
| 14 | IO20 | ES8311_PA | Output | PA control |
| 15 | IO3 | PRINT_OUTB_P | Output | Printer OUTB+ |
| 16 | IO46 | PRINT_OUTB_N | Output | Printer OUTB- |
| 17 | IO9 | SPI_SHARED_MOSI | Output | Printer/Screen shared MOSI |
| 18 | IO10 | PRINTER_MISO | Input | Printer MISO |
| 19 | IO11 | SPI_SHARED_CLK | Output | Printer/Screen shared CLK |
| 20 | IO12 | SCREEN_DC | Output | ST7789 DC |
| 21 | IO13 | SCREEN_CS1 | Output | ST7789 CS |
| 22 | IO14 | MIC_KEY | Input | Mic key (can ADC-mux 2 keys if needed) |
| 23 | IO21 | LED_G | Output | Green LED |
| 24 | IO47 | POWER_KEY | Input | Hold low for 2s to request power-off logic |
| 25 | IO48 | SCREEN_BACKLIGHT | Output | High level turns backlight on |
| 26 | IO45 | PRINT_LAT | Output | Printer LAT |
| 27 | IO0 | KEY_PRINT / BOOST_CTRL | Input/Output | Print confirm key or 7.2V boost control |
| 28 | IO35 | N/A | - | Not available |
| 29 | IO36 | N/A | - | Not available |
| 30 | IO37 | N/A | - | Not available |
| 31 | IO38 | I2S_MCLK | Output | Voice I2S MCLK |
| 32 | IO39 | I2S_BCLK | Output | Voice I2S BCLK |
| 33 | IO40 | I2S_DI | Input | Voice I2S data in |
| 34 | IO41 | I2S_WS | Output | Voice I2S WS |
| 35 | IO42 | I2S_DO | Output | Voice I2S data out |
| 36 | TXD0 | UART0_TX | Output | Serial log/program |
| 37 | RXD0 | UART0_RX | Input | Serial log/program |
| 38 | IO2 | LED_R | Output | Red LED |
| 39 | IO1 | POWER_HOLD | Output | Must drive high at boot to keep board powered |
| 40 | GND | GND | - | Ground |
| 41 | GND | GND | - | Ground |
## Firmware Mapping Notes
- `main/Kconfig.projbuild` contains board pin configs prefixed with `TQ_*`.
- `components/platform/src/platform_bootstrap.c` initializes critical GPIO on startup:
- `POWER_HOLD` asserted high early.
- `SCREEN_DC/SCREEN_CS/SCREEN_BACKLIGHT` default states.
- `KEY_PRINT` defaults to boost-enable output mode (`CONFIG_TQ_KEY_PRINT_BOOST_ENABLE_ON_BOOT=y`).
- key/sensor inputs (`POWER_KEY`, `MIC_KEY`, `PRINT_PAPER`, ADC inputs) default directions.
- `components/platform/src/display_st7789.c` provides ST7789 driver integration:
- SPI bus (`MOSI=IO9`, `CLK=IO11`) + `esp_lcd_new_panel_st7789`.
- Optional boot test pattern via `CONFIG_TQ_SCREEN_TEST_PATTERN_ON_BOOT`.
- Voice codec and I2S pin defaults are aligned to this table:
- I2C: `SDA=6`, `SCL=7`
- I2S: `MCLK=38`, `BCLK=39`, `WS=41`, `DIN=40`, `DOUT=42`
- PA: `IO20`

227
main/Kconfig.projbuild
View File

@@ -181,12 +181,12 @@ config TQ_VOICE_I2C_PORT
config TQ_VOICE_I2C_SDA_PIN
int "Voice I2C SDA GPIO"
range 0 48
default 4
default 6
config TQ_VOICE_I2C_SCL_PIN
int "Voice I2C SCL GPIO"
range 0 48
default 5
default 7
config TQ_VOICE_CODEC_ADDR
int "ES8311 I2C address"
@@ -201,12 +201,12 @@ config TQ_VOICE_I2S_PORT
config TQ_VOICE_I2S_MCLK_PIN
int "Voice I2S MCLK GPIO"
range -1 48
default 39
default 38
config TQ_VOICE_I2S_BCLK_PIN
int "Voice I2S BCLK GPIO"
range 0 48
default 40
default 39
config TQ_VOICE_I2S_WS_PIN
int "Voice I2S WS GPIO"
@@ -216,18 +216,233 @@ config TQ_VOICE_I2S_WS_PIN
config TQ_VOICE_I2S_DOUT_PIN
int "Voice I2S DOUT GPIO"
range 0 48
default 38
default 42
config TQ_VOICE_I2S_DIN_PIN
int "Voice I2S DIN GPIO"
range 0 48
default 42
default 40
config TQ_VOICE_CODEC_PA_PIN
int "ES8311 PA control GPIO"
range -1 48
default 20
menu "Board GPIO Mapping (ESP32-S3)"
config TQ_POWER_HOLD_PIN
int "Power hold GPIO (drive high to keep power)"
range -1 48
default 1
config TQ_POWER_KEY_PIN
int "Power key GPIO"
range -1 48
default 47
config TQ_LED_R_PIN
int "LED_R GPIO"
range -1 48
default 2
config TQ_LED_G_PIN
int "LED_G GPIO"
range -1 48
default 21
config TQ_KEY_PRINT_PIN
int "Print confirm key / 7.2V boost control GPIO"
range -1 48
default 0
config TQ_KEY_PRINT_BOOST_ENABLE_ON_BOOT
bool "Use KEY_PRINT pin as 7.2V boost enable on boot"
default y
config TQ_KEY_PRINT_BOOST_ACTIVE_HIGH
bool "KEY_PRINT boost enable level is high"
default y
depends on TQ_KEY_PRINT_BOOST_ENABLE_ON_BOOT
config TQ_MIC_KEY_PIN
int "Mic key GPIO"
range -1 48
default 14
config TQ_BATTERY_ADC_PIN
int "Battery ADC detect GPIO"
range -1 48
default 15
config TQ_NTC_ADC_PIN
int "NTC ADC GPIO"
range -1 48
default 18
config TQ_PRINT_STB_56_PIN
int "Printer STB5_6 GPIO"
range -1 48
default 4
config TQ_PRINT_STB_34_PIN
int "Printer STB3_4 GPIO"
range -1 48
default 5
config TQ_PRINT_STB_12_PIN
int "Printer STB1_2 GPIO"
range -1 48
default 16
config TQ_PRINT_PAPER_PIN
int "Printer paper detect GPIO"
range -1 48
default 17
config TQ_PRINT_OUTA_P_PIN
int "Printer OUTA+ GPIO"
range -1 48
default 8
config TQ_PRINT_OUTA_N_PIN
int "Printer OUTA- GPIO"
range -1 48
default 19
config TQ_PRINT_OUTB_P_PIN
int "Printer OUTB+ GPIO"
range -1 48
default 3
config TQ_PRINT_OUTB_N_PIN
int "Printer OUTB- GPIO"
range -1 48
default 46
config TQ_PRINT_LAT_PIN
int "Printer LAT GPIO"
range -1 48
default 45
config TQ_SPI_SHARED_MOSI_PIN
int "Printer/Screen shared MOSI GPIO"
range -1 48
default 9
config TQ_PRINTER_MISO_PIN
int "Printer MISO GPIO"
range -1 48
default 10
config TQ_SPI_SHARED_CLK_PIN
int "Printer/Screen shared CLK GPIO"
range -1 48
default 11
config TQ_SCREEN_DC_PIN
int "Screen DC GPIO"
range -1 48
default 12
config TQ_SCREEN_CS_PIN
int "Screen CS GPIO"
range -1 48
default 13
config TQ_SCREEN_BACKLIGHT_PIN
int "Screen backlight GPIO (active high)"
range -1 48
default 48
endmenu
menu "ST7789 Screen"
config TQ_SCREEN_ENABLE
bool "Enable ST7789 screen driver"
default y
depends on SOC_GPSPI_SUPPORTED
config TQ_SCREEN_TEST_PATTERN_ON_BOOT
bool "Show ST7789 test pattern at boot"
default y
depends on TQ_SCREEN_ENABLE
config TQ_SCREEN_PIXEL_CLOCK_HZ
int "ST7789 SPI pixel clock (Hz)"
range 1000000 80000000
default 10000000
depends on TQ_SCREEN_ENABLE
config TQ_SCREEN_H_RES
int "ST7789 horizontal resolution"
range 64 480
default 240
depends on TQ_SCREEN_ENABLE
config TQ_SCREEN_V_RES
int "ST7789 vertical resolution"
range 64 480
default 240
depends on TQ_SCREEN_ENABLE
config TQ_SCREEN_DRAW_LINES
int "ST7789 draw chunk lines"
range 1 120
default 20
depends on TQ_SCREEN_ENABLE
config TQ_SCREEN_SPI_MODE
int "ST7789 SPI mode (0-3)"
range 0 3
default 0
depends on TQ_SCREEN_ENABLE
config TQ_SCREEN_COLOR_ORDER_BGR
bool "ST7789 color order is BGR"
default y
depends on TQ_SCREEN_ENABLE
config TQ_SCREEN_BACKLIGHT_ACTIVE_HIGH
bool "ST7789 backlight active-high"
default y
depends on TQ_SCREEN_ENABLE
config TQ_SCREEN_MIRROR_X
bool "ST7789 mirror X axis"
default n
depends on TQ_SCREEN_ENABLE
config TQ_SCREEN_MIRROR_Y
bool "ST7789 mirror Y axis"
default n
depends on TQ_SCREEN_ENABLE
config TQ_SCREEN_SWAP_XY
bool "ST7789 swap X/Y axis"
default n
depends on TQ_SCREEN_ENABLE
config TQ_SCREEN_X_GAP
int "ST7789 X gap"
range 0 480
default 0
depends on TQ_SCREEN_ENABLE
config TQ_SCREEN_Y_GAP
int "ST7789 Y gap"
range 0 480
default 0
depends on TQ_SCREEN_ENABLE
config TQ_SCREEN_RESET_PIN
int "ST7789 reset GPIO (-1 if not connected)"
range -1 48
default -1
depends on TQ_SCREEN_ENABLE
endmenu
config TQ_VOICE_CODEC_PA_PIN_REVERSED
bool "ES8311 PA enable level is active-low"
default n

49
sdkconfig.defaults
View File

@@ -52,15 +52,50 @@ CONFIG_TQ_VOICE_OPUS_FRAME_MS=100
CONFIG_TQ_VOICE_OPUS_BITRATE_KBPS=32
CONFIG_TQ_VOICE_HEARTBEAT_SEC=50
CONFIG_TQ_VOICE_I2C_PORT=1
CONFIG_TQ_VOICE_I2C_SDA_PIN=4
CONFIG_TQ_VOICE_I2C_SCL_PIN=5
CONFIG_TQ_VOICE_I2C_SDA_PIN=6
CONFIG_TQ_VOICE_I2C_SCL_PIN=7
CONFIG_TQ_VOICE_CODEC_ADDR=48
CONFIG_TQ_VOICE_I2S_PORT=0
CONFIG_TQ_VOICE_I2S_MCLK_PIN=39
CONFIG_TQ_VOICE_I2S_BCLK_PIN=40
CONFIG_TQ_VOICE_I2S_MCLK_PIN=38
CONFIG_TQ_VOICE_I2S_BCLK_PIN=39
CONFIG_TQ_VOICE_I2S_WS_PIN=41
CONFIG_TQ_VOICE_I2S_DOUT_PIN=38
CONFIG_TQ_VOICE_I2S_DIN_PIN=42
CONFIG_TQ_VOICE_CODEC_PA_PIN=48
CONFIG_TQ_VOICE_I2S_DOUT_PIN=42
CONFIG_TQ_VOICE_I2S_DIN_PIN=40
CONFIG_TQ_VOICE_CODEC_PA_PIN=20
CONFIG_TQ_VOICE_CODEC_OUT_VOL=70
CONFIG_TQ_VOICE_CODEC_MIC_GAIN_DB=24
CONFIG_TQ_POWER_HOLD_PIN=1
CONFIG_TQ_POWER_KEY_PIN=47
CONFIG_TQ_LED_R_PIN=2
CONFIG_TQ_LED_G_PIN=21
CONFIG_TQ_KEY_PRINT_PIN=0
CONFIG_TQ_KEY_PRINT_BOOST_ENABLE_ON_BOOT=y
CONFIG_TQ_KEY_PRINT_BOOST_ACTIVE_HIGH=y
CONFIG_TQ_MIC_KEY_PIN=14
CONFIG_TQ_BATTERY_ADC_PIN=15
CONFIG_TQ_NTC_ADC_PIN=18
CONFIG_TQ_PRINT_STB_56_PIN=4
CONFIG_TQ_PRINT_STB_34_PIN=5
CONFIG_TQ_PRINT_STB_12_PIN=16
CONFIG_TQ_PRINT_PAPER_PIN=17
CONFIG_TQ_PRINT_OUTA_P_PIN=8
CONFIG_TQ_PRINT_OUTA_N_PIN=19
CONFIG_TQ_PRINT_OUTB_P_PIN=3
CONFIG_TQ_PRINT_OUTB_N_PIN=46
CONFIG_TQ_PRINT_LAT_PIN=45
CONFIG_TQ_SPI_SHARED_MOSI_PIN=9
CONFIG_TQ_PRINTER_MISO_PIN=10
CONFIG_TQ_SPI_SHARED_CLK_PIN=11
CONFIG_TQ_SCREEN_DC_PIN=12
CONFIG_TQ_SCREEN_CS_PIN=13
CONFIG_TQ_SCREEN_BACKLIGHT_PIN=48
CONFIG_TQ_SCREEN_ENABLE=y
CONFIG_TQ_SCREEN_TEST_PATTERN_ON_BOOT=y
CONFIG_TQ_SCREEN_PIXEL_CLOCK_HZ=10000000
CONFIG_TQ_SCREEN_H_RES=240
CONFIG_TQ_SCREEN_V_RES=240
CONFIG_TQ_SCREEN_DRAW_LINES=20
CONFIG_TQ_SCREEN_SPI_MODE=0
CONFIG_TQ_SCREEN_COLOR_ORDER_BGR=y
CONFIG_TQ_SCREEN_BACKLIGHT_ACTIVE_HIGH=y
CONFIG_TQ_SCREEN_RESET_PIN=-1