# 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-06-11 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # CodexPad-S10 [English](README.md) ## 概述 **CodexPad-S10​** 是 CodexPad 系列中专为创客与嵌入式开发者设计的低功耗蓝牙手柄。与市面上依赖操作系统蓝牙协议栈的通用手柄不同，本产品**专为无操作系统的硬件平台打造**，无需系统层支持，即可直接与裸机运行的低功耗蓝牙硬件平台（如 **ESP32** 系列、**ESP32-S** 系列、**ESP32-C** 系列、**STM32** 系列、**nRF** 系列、 **micro:bit**、**树莓派**系列等）进行对等通信，为机器人、物联网设备、自定义控制面板等提供了即插即用的远程物理输入解决方案。 我们为适配的硬件平台提供了简洁的通信协议、轻量级驱动库与丰富示例，让开发者能快速将手柄集成到固件中，专注于核心功能的实现。 --- ## 产品外观图 ![codexpad_s10](assets/image/zh-CN/codexpad_s10.jpg) --- ## 产品部件示意图 ![产品部件示意图](assets/image/zh-CN/functional_illustration.jpg) --- ## 按键示意图 ![按键示意图](assets/image/zh-CN/button_illustration.jpg) --- ## 输入设备规格 - 按键数量：17 - 摇杆数量：2 - 摇杆类型：双轴模拟摇杆 - 摇杆分辨率：8位（0 ~ 255） --- ## 电气特性 - 充电电压/电流：​5V/500mA (USB Type-C) - 电池容量：400mAh - 充电时间：约1.5小时 - 续航时间：典型使用下约8小时 --- ## 连接性与协议 - 蓝牙版本：Bluetooth Low Energy 5.3 - 传输距离：50m (开阔环境) - 发射功率：**-16 dBm** 到 **+6 dBm** （可调） - 通信协议：开放的、专为嵌入式优化的轻量级二进制协议 - 支持角色：BLE外设设备（从机） --- ## 开机与关机 - **开机**：短按（单击）手柄中央的**单元键（Home键）**，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) 在与CodexPad连接时，可能需要使用到设备的**唯一**标识：**Bluetooth Device Address**。它如同设备的“身份证号”，由12位十六进制字符组成，以冒号分隔，格式为`XX:XX:XX:XX:XX:XX`（其中`X`为 0-9 或 A-F），例如：`E4:66:E5:A2:24:5D`。 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号灯灭的状态）并存放在阴凉干燥处。切勿在满电或空电状态下长期存放。 --- ## 连接使用指南 | 硬件平台特征 | 典型代表平台 | 文档 | 核心特点 | | :--- | :--- | :--- | :--- | | 主控自带BLE功能或者有BLE协处理器，同时软件可以自己调用底层BLE API进行设备连接 | | [CodexPad连接使用指南：使用硬件平台内置BLE](../../../codex_pad_guide/blob/main/connection_guide_native_ble.zh-CN.md#codexpad连接使用指南使用硬件平台内置ble) | 无需外接模块，提供了库和示例，直接编程使用 | | 主控（如 STM32/Arduino）没有蓝牙，需要外接蓝牙转串口模块（插在 TX/RX 引脚上） | | [CodexPad连接使用指南：使用BLE转串口模块](../../../codex_pad_guide/blob/main/connection_guide_ble_uart.zh-CN.md#codexpad连接使用指南使用ble转串口模块) | **透传模式**，数据通过串口转发 | | 主控（如 STM32/Arduino）没有蓝牙，需要在I2C总线上外接CodexPad专用接收器（开发中） | 任意支持I2C的硬件平台 | [CodexPad连接使用指南：使用专用的BLE转I2C接收器](../../../codex_pad_guide/blob/main/connection_guide_i2c_receiver.zh-CN.md#codexpad连接使用指南使用专用的ble转i2c接收器) | | --- ## 综合应用 ### 基础示例 基础示例演示了如何通过手柄单独控制某一类外设，覆盖直流电机、编码电机和舵机的控制演示。每个示例都针对特定的硬件方案设计，您可以根据自己使用的开发板和驱动模块，点击下方链接查看对应的详细说明： | 硬件方案（点击查看示例说明） | | :--- | | [MAKER-ESP32 开发板（板载电机驱动）](https://gitee.com/nulllab_1/docs_examples_gamepad_peripheral_control/blob/main/examples_description_maker_esp32_base.zh-CN.md#codexpad-s10手柄控制示例maker-esp32开发板基础示例说明) | | [MAKER-ESP32-PRO 开发板（板载电机驱动）](https://gitee.com/nulllab_1/docs_examples_gamepad_peripheral_control/blob/main/examples_description_maker_esp32_pro_base.zh-CN.md#codexpad-s10手柄控制示例maker-esp32-pro开发板基础示例说明) | | [AI-VOX3 开发板 + MD40 驱动模块](https://gitee.com/nulllab_1/docs_examples_gamepad_peripheral_control/blob/main/examples_description_ai_vox3_base.zh-CN.md#codexpad-s10手柄控制示例ai-vox3开发板基础示例说明) | | [BLE-UNO 开发板 + MotorDriverBoard V5.2 驱动板](https://gitee.com/nulllab_1/docs_examples_gamepad_peripheral_control/blob/main/examples_description_ble_uno_base.zh-CN.md#codexpad-s10手柄控制示例ble-uno开发板基础示例说明) | ### 麦克纳姆轮小车示例 麦克纳姆轮小车示例演示如何使用手柄遥控麦克纳姆轮小车，包含全向移动、速度调节、云台俯仰和夹子开合等完整功能。**目前仅限 BLE-UNO 平台**。 | 硬件方案（点击查看示例说明） | | :--- | | [BLE-UNO 开发板 + MotorDriverBoard V5.2 驱动板](https://gitee.com/nulllab_1/docs_examples_gamepad_peripheral_control/blob/main/examples_description_ble_uno_car.zh-CN.md#codexpad-s10手柄控制示例ble-uno开发板驱动麦克纳姆轮小车示例说明) | --- ## 注意事项 [注意事项](../../../codex_pad_guide/blob/main/notice.zh-CN.md#注意事项)