# LISA Touch 轮询模式示例

## 功能说明

本示例演示如何使用 LISA Touch 驱动的轮询模式读取触摸屏坐标。

在轮询模式下，主循环定期调用 `lisa_touch_read_event()` 读取触摸数据，不依赖 GPIO 中断，通过持续轮询检测触摸事件。实现简单，适合对实时性要求不高的应用。

## 硬件连接

- **PA22**: I2C SDA 引脚
- **PA23**: I2C SCL 引脚
- **PA25**: Touch 复位引脚（RST）
- **PA24**: Touch 中断引脚（INT，轮询模式下不使用）

## 示例步骤

1. 获取 Touch、I2C 和 GPIO 设备
2. 配置 I2C 和 GPIO 引脚复用（通过 pinmux 重定向）
3. 配置 Touch 总线接口
4. 设置轮询模式（`LISA_TOUCH_INT_MODE_POLLING`）
5. 启用 Touch 设备
6. 循环读取触摸事件并显示坐标（50ms 采样间隔）

## 编译运行

```bash
./build.sh -C -DBOARD=arcs_evb
```

## 预期输出

**终端输出：**

```
=== LISA Touch Polling Mode Example ===
I2C pins configured (SDA: PA22, SCL: PA23)
GPIO pins configured (RST: PA25, INT: PA24)
touch_cst328 device ready
i2c0 device ready
gpioa device ready
Touch bus attached successfully
Touch polling mode enabled
Touch device enabled
Touch capabilities: max_x=240, max_y=320, max_points=1

=== Polling Mode Active ===
Start reading touch events (polling every 50ms)...
Press the touch screen to see coordinates

[Polling] Touch: x= 120, y= 160, type=PRESS
[Polling] Touch: x= 125, y= 165, type=PRESS
[Polling] Touch: type=RELEASE
...
```

## 核心 API

| API | 说明 |
|-----|------|
| `lisa_device_get()` | 获取 Touch、I2C 和 GPIO 设备 |
| `lisa_touch_attach_bus()` | 配置 Touch 总线接口（I2C、GPIO） |
| `lisa_touch_set_int_mode()` | 设置轮询模式 |
| `lisa_touch_enable()` | 启用 Touch 设备 |
| `lisa_touch_read_event()` | 读取触摸事件（坐标、状态） |

## 关键代码

### 设置轮询模式

```c
lisa_touch_set_int_mode(touch_dev, LISA_TOUCH_INT_MODE_POLLING);
```

此函数会禁用 GPIO 中断（如果之前已启用），确保设备处于轮询模式。

### 读取触摸事件

```c
lisa_touch_event_t event;
int ret = lisa_touch_read_event(touch_dev, &event);

if (ret == 0) {
    if (event.type == LISA_TOUCH_EVENT_PRESS && event.point_count > 0) {
        printf("[Polling] Touch: x=%4d, y=%4d, type=PRESS\n",
               event.points[0].x, event.points[0].y);
    } else if (event.type == LISA_TOUCH_EVENT_RELEASE) {
        printf("[Polling] Touch: type=RELEASE\n");
    }
}
```

### 调整轮询间隔

```c
vTaskDelay(pdMS_TO_TICKS(50));  /* 50ms采样间隔 */
```

可以根据应用需求调整：
- **更快的响应**：减小延迟（如 20ms），但会增加 CPU 占用
- **更低的功耗**：增大延迟（如 100ms），但响应会变慢

## 配置说明

在 `prj.conf` 中启用相关驱动：

```ini
CONFIG_LISA_DEVICE=y
CONFIG_LISA_TOUCH_DEVICE=y
CONFIG_LISA_TOUCH_ARCS_CST328=y    # 启用 CST328 芯片
CONFIG_LISA_I2C=y
CONFIG_LISA_I2C0=y
CONFIG_LISA_GPIO_DEVICE=y
CONFIG_LISA_GPIOA=y
```

## 轮询模式说明

轮询模式的工作原理：

- **实现方式**：主循环定期调用 `lisa_touch_read_event()` 读取触摸数据
- **无需中断**：不依赖 GPIO 中断，适合没有中断引脚或中断资源紧张的场景
- **可控采样率**：可以灵活调整轮询间隔（本示例为 50ms）
- **线程安全**：驱动内部使用互斥锁保护，确保多线程环境下的数据一致性

## 注意事项

1. **轮询间隔**：间隔太短会导致 CPU 占用高、功耗大；间隔太长会导致响应延迟大，可能丢失快速触摸。建议范围：20ms ~ 100ms

2. **线程安全**：驱动内部使用互斥锁保护，可以在多线程环境中安全使用

3. **引脚配置**：示例中通过 pinmux 重定向自定义引脚配置，会覆盖 `boards/arcs_evb/pinmux.c` 中的默认实现

4. **I2C 配置**：I2C 总线在 `attach_bus` 时自动配置（标准速度 100kHz）

5. **性能考虑**：如果对实时性和功耗有要求，建议使用中断模式