# codex_pad_s10

**Repository Path**: CodexPad/codex_pad_s10

## Basic Information

- **Project Name**: codex_pad_s10
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-20
- **Last Updated**: 2026-03-24

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# CodexPad-S10

[English](README.md)

## 概述

**CodexPad-S10​** 是 CodexPad 系列中专为创客与嵌入式开发者设计的低功耗蓝牙手柄。与市面上依赖操作系统蓝牙协议栈的通用手柄不同，本产品**专为无操作系统的硬件平台打造**，无需系统层支持，即可直接与裸机运行的低功耗蓝牙硬件平台（如 **ESP32** 系列、**ESP32-S** 系列、**ESP32-C** 系列、**STM32** 系列、**nRF** 系列、 **micro:bit**、**树莓派**系列等）进行对等通信，为机器人、物联网设备、自定义控制面板等提供了即插即用的远程物理输入解决方案。

我们为适配的硬件平台提供了简洁的通信协议、轻量级驱动库与丰富示例，让开发者能快速将手柄集成到固件中，专注于核心功能的实现。

---

## 产品外观图

> TODO

---

## 产品部件示意图

> TODO

---

## 输入设备规格

- 按键数量：17
- 摇杆数量：2
- 摇杆类型：双轴模拟摇杆
- 摇杆分辨率：8位（0 ~ 255）

---

## 电气特性

- 充电电压/电流：​5V/500mA (USB Type-C)
- 工作电压：​3.7V (锂电池)
- 电池容量：400mAh
- 充电时间：约1.5小时
- 续航时间：典型使用下约8小时

---

## 连接性与协议

- 蓝牙版本：Bluetooth Low Energy 5.3
- 传输距离：50m (开阔环境)
- 发射功率：**-16 dBm** 到 **+6 dBm** （可调）
- 通信协议：开放的、专为嵌入式优化的轻量级二进制协议
- 支持角色：BLE外设设备（从机）

---

## 开机与关机

- **开机**：短按（单击）手柄中央的**单元键**，1号蓝色指示灯开始慢闪，设备启动。

- **关机**：在开机状态下，**长按单元键3秒**，1号蓝色指示灯熄灭，设备关机。

> **💡 提示**：如果按“开机”操作后，手柄**没有任何指示灯响应**，或**指示灯亮起后迅速熄灭**，这通常是因为电池电量已耗尽，无法支持开机或稳定运行。请先使用USB Type-C线为手柄充电，再尝试开机。

---

## 指示灯状态说明

- **1号指示灯（蓝色）**：工作状态指示灯

    | 指示灯（1号）状态 | 设备状态含义 |
    | :--- | :--- |
    | 慢闪​（约1秒亮/灭） | 已开机，正在广播信号，可被连接 |
    | 常亮 | 已开机，已成功连接到主机设备 |
    | 熄灭 | 已关机 |

- **2、3、4号指示灯（绿色）**：电量和充电状态指示灯

  **这三个指示灯共同构成一个三格电量条，用于直观显示剩余电量或充电状态**。

  - *当设备开机且**未充电**时，显示当前电量：*

      | 指示灯状态 (2/3/4号) | 电量 |
      | :--- | :--- |
      | 三灯常亮（满格亮） | 高电量 |
      | 2、3号灯亮，4号灯灭（两格亮） | 中等电量 |
      | 仅2号灯亮，3、4号灯灭（一格亮） | 低电量（*建议充电，可能因低至最低保护电压而自动关机*） |

  - *当设备**连接充电器**时，显示充电状态：*

      | 指示灯状态 (2/3/4号) | 充电状态含义 |
      | :--- | :--- |
      | 三灯依次循环点亮（流水灯效果） | 正在充电中 |
      | 三灯常亮 | 充电已完成 |

---

## 自动关机说明

为节省电量，手柄在以下两种情况下会自动关机：

1. **低电量自动关机**：当电池电量耗尽至最低保护电压时，手柄会自动关机，此时所有指示灯均会熄灭。这是对电池的一种保护机制。**请及时充电**，充电后即可正常开机。

2. **广播超时自动关机**：手柄开机后，若持续处于 **“慢速闪烁”**（广播等待连接）状态 **超过1分钟** 仍未有任何设备与之连接，为节约电量，手柄将自动关机。

> **💡 提示**：若您遇到开机后设备快速自动关闭的情况，请先检查电量指示灯状态，或尝试在开机后尽快完成蓝牙连接。

---

## 获取Bluetooth Device Address(BD_ADDR)

Bluetooth Device Address(BD_ADDR)印于**手柄背部中央**的标签上，请自行查看和记录。

---

## 充电与电池保养注意事项

为延长手柄内置锂电池的使用寿命，建议遵循以下充电和保养习惯：

- **避免过充，及时断开**：锂电池无需“充满12小时”激活。当手柄背部2-4号绿色指示灯**常亮**（表示已充满）后，建议及时断开充电器。避免长时间（如整夜或数日）连接充电器，长期处于100%满电状态会加速电池老化。

- **随用随充，避免过放**：无需等到电量完全耗尽再充电。当电量指示灯显示**低电量**（仅2号灯亮）时，即可进行充电。频繁的深度放电（用到自动关机）对电池寿命损害较大。

- **使用合适的充电器**：请使用符合标准的5V/1A（或5V/500mA）USB充电器或电脑USB口进行充电。**避免使用快充头**，过高电流可能导致电池发热，影响寿命和安全性。

- **在适宜环境下充电**：尽量在室温（0°C ~ 35°C）环境下进行充电。极端高温（如夏季车内）或低温会严重影响充电效率并损害电池健康。

- **长期存放建议**：如果计划长时间（超过一个月）不使用手柄，请将电量充至**中等电量**（约50%-60%，即2、3号灯亮，4号灯灭的状态）并存放在阴凉干燥处。切勿在满电或空电状态下长期存放。

---

## 进一步了解与开发

本指南涵盖了 CodexPad-C10 的基本介绍和使用。关于更详细的**连接方式说明**、**完整的开发平台与库支持**以及**重要的通信协议信息**，请参阅 CodexPad 系列通用指南:

[CodexPad系列通用指南](../../../codex_pad_series_general_guide/blob/main/README_CN.md#codexpad-系列通用指南)