跳到主要内容

内部寄存器

本文档描述了系统中所有特殊功能寄存器的地址、名称和具体用途。

零、比较寄存器 (0x00)​

地址寄存器名用途说明备注
0x00SYS_REG_COMPARE比较功能专用寄存器用于条件比较指令的操作数

说明​

  • 寄存器 R00（地址 0x00）专门用于比较功能
  • 与比较转移指令（如 XYZ、DYZ、SDZ、XDZ、BDZ）配合使用
  • 比较指令使用 R00 作为主要比较操作数
  • 比较结果决定程序是否跳转

一、系统状态寄存器 (0x23-0x27)​

地址寄存器名用途说明备注
0x23SYS_REG_TIMER_TIME_OUT定时器超时状态非阻塞定时器状态标志
0x24SYS_REG_ADS1115_CHANNELSADS1115通道配置配置需要读取的ADC通道
0x25SYS_REG_D_IO_STATE数字I/O状态当前数字输入输出端口状态
0x26SYS_REG_D_OUT数字输出端口设置数字输出引脚电平
0x27SYS_REG_D_IN数字输入端口读取数字输入引脚电平

二、显示/绘图寄存器 (0x28-0x29)​

地址寄存器名用途说明备注
0x28SYS_REG_DRAWING_COLOR绘图前景色画线、画矩形等绘图操作的颜色
0x29SYS_REG_BACKGROUND_COLOR绘图背景色填充操作的背景颜色

三、PWM控制寄存器 (0x2A-0x2D)​

地址寄存器名用途说明备注
0x2ASYS_REG_PWM_DC_CH0内置PWM通道0占空比MCU内部PWM输出，0-100%
0x2BSYS_REG_PWM_DC_CH1内置PWM通道1占空比MCU内部PWM输出，0-100%
0x2CSYS_REG_PWM_DC_CH2内置PWM通道2占空比MCU内部PWM输出，0-100%
0x2DSYS_REG_PWM_DC_CH3内置PWM通道3占空比MCU内部PWM输出，0-100%

四、环境传感器寄存器 (0x2E-0x30) — BME280​

地址寄存器名用途说明数据格式
0x2ESYS_REG_TEMPUERATURE温度值（BME280）温度×100，例：25.36℃ → 2536
0x2FSYS_REG_HUMIDITY湿度值（BME280）湿度×100，例：65.50% → 6550
0x30SYS_REG_ALTITUDE海拔高度（BME280）单位：米

五、颜色传感器寄存器 (0x31-0x33) — TCS3472​

地址寄存器名用途说明备注
0x31SYS_REG_COLOR_R颜色传感器红色分量TCS3472识别的R值 (0-65535)
0x32SYS_REG_COLOR_G颜色传感器绿色分量TCS3472识别的G值 (0-65535)
0x33SYS_REG_COLOR_B颜色传感器蓝色分量TCS3472识别的B值 (0-65535)

六、外设开关寄存器 (0x34)​

地址寄存器名用途说明位定义
0x34SYS_REG_SWITCH外设使能开关见下方开关位定义表

外设开关位定义​

位常量名值对应外设
bit0SYS_PER_SWITCH_ADS11150x001ADS1115 ADC
bit1SYS_PER_SWITCH_BME2800x002BME280 温湿度
bit2SYS_PER_SWITCH_DS13070x004DS1307 RTC时钟
bit3SYS_PER_SWITCH_TCS34720x008TCS3472 颜色传感器
bit4SYS_PER_SWITCH_PCA96850x010PCA9685 PWM驱动
bit6SYS_PER_SWITCH_WS2812B0x040WS2812B LED
bit7SYS_PER_SWITCH_LCD16020x080LCD1602 液晶屏
bit8SYS_PER_SWITCH_SSD13060x100SSD1306 OLED
bit9SYS_PER_SWITCH_HUSKY_LENS0x200HuskyLens AI视觉
bit11SYS_PER_SWITCH_MELODY0x800蜂鸣器旋律

七、超声波传感器寄存器 (0x35-0x37)​

地址寄存器名用途说明备注
0x35SYS_REG_ULTRASONIC0超声波传感器0距离单位：毫米
0x36SYS_REG_ULTRASONIC1超声波传感器1距离单位：毫米
0x37SYS_REG_ULTRASONIC2超声波传感器2距离单位：毫米

八、RTC时钟寄存器 (0x38-0x3E) — DS1307​

地址寄存器名用途说明数据范围
0x38SYS_REG_YEARRTC年份例：26 表示2026年
0x39SYS_REG_MONTHRTC月份1-12
0x3ASYS_REG_DATERTC日期1-31
0x3BSYS_REG_DAYRTC星期1-7
0x3CSYS_REG_HOURRTC小时0-23
0x3DSYS_REG_MINUTERTC分钟0-59
0x3ESYS_REG_SECONDRTC秒0-59

九、按钮状态寄存器 (0x3F)​

地址寄存器名用途说明位定义
0x3FSYS_REG_BUTTON_STATE板载按钮状态见下方按钮位定义表

按钮位定义​

位常量名值对应按钮
bit0BUTTON_BIT_UP0x01上键
bit1BUTTON_BIT_BACK0x02后退键
bit2BUTTON_BIT_LEFT0x04左键
bit3BUTTON_BIT_RIGHT0x08右键
bit4BUTTON_BIT_DOWN0x10下键
bit5BUTTON_BIT_ENTER0x20确认键
bit6BUTTON_BIT_FUNC0x40功能键
bit7BUTTON_USE_IN_PROGRAM0x80程序中使用按钮标志
bit8-11_key_back_burst-后退键突发状态
bit12flag_combo_keys-组合键标志

十、ADS1115 ADC数据寄存器 (0x40-0x4F)​

地址寄存器名用途说明备注
0x40SYS_REG_ADS1115_0ADS1115通道0原始值16位ADC值 (0-65535)
0x41SYS_REG_ADS1115_1ADS1115通道1原始值16位ADC值
0x42SYS_REG_ADS1115_2ADS1115通道2原始值16位ADC值
0x43SYS_REG_ADS1115_3ADS1115通道3原始值16位ADC值
0x44SYS_REG_ADS1115_4ADS1115通道4原始值16位ADC值
0x45SYS_REG_ADS1115_5ADS1115通道5原始值16位ADC值
0x46SYS_REG_ADS1115_6ADS1115通道6原始值16位ADC值
0x47SYS_REG_ADS1115_7ADS1115通道7原始值16位ADC值
0x48SYS_REG_ADS1115_8ADS1115通道8原始值16位ADC值
0x49SYS_REG_ADS1115_9ADS1115通道9原始值16位ADC值
0x4ASYS_REG_ADS1115_10ADS1115通道10原始值16位ADC值
0x4BSYS_REG_ADS1115_11ADS1115通道11原始值16位ADC值
0x4CSYS_REG_ADS1115_12ADS1115通道12原始值16位ADC值
0x4DSYS_REG_ADS1115_13ADS1115通道13原始值16位ADC值
0x4ESYS_REG_ADS1115_14ADS1115通道14原始值16位ADC值
0x4FSYS_REG_ADS1115_15ADS1115通道15原始值16位ADC值

十一、PCA9685 PWM寄存器 (0x50-0x7F)​

PCA9685 设备0 (I2C地址 0x40) — 0x50-0x5F​

地址寄存器名用途说明备注
0x50SYS_REG_PCA9685_DEV0_CH0设备0通道0 PWM值0-4095
0x51SYS_REG_PCA9685_DEV0_CH1设备0通道1 PWM值0-4095
............
0x5FSYS_REG_PCA9685_DEV0_CH15设备0通道15 PWM值0-4095

PCA9685 设备1 (I2C地址 0x41) — 0x60-0x6F​

地址寄存器名用途说明备注
0x60SYS_REG_PCA9685_DEV1_CH0设备1通道0 PWM值0-4095
............
0x6FSYS_REG_PCA9685_DEV1_CH15设备1通道15 PWM值0-4095

PCA9685 设备2 (I2C地址 0x42) — 0x70-0x7F​

地址寄存器名用途说明备注
0x70SYS_REG_PCA9685_DEV2_CH0设备2通道0 PWM值0-4095
............
0x7FSYS_REG_PCA9685_DEV2_CH15设备2通道15 PWM值0-4095

十二、HuskyLens AI视觉寄存器 (0xCC-0xEC)​

地址寄存器名用途说明备注
0xCCSYS_REG_HUSKY_LENS_BASE+0目标0类型0=人脸, 2=物体追踪, 4=颜色
0xCDSYS_REG_HUSKY_LENS_BASE+1目标0 X坐标0-320
0xCESYS_REG_HUSKY_LENS_BASE+2目标0 Y坐标0-240
0xCFSYS_REG_HUSKY_LENS_BASE+3目标1类型同上
0xD0SYS_REG_HUSKY_LENS_BASE+4目标1 X坐标同上
0xD1SYS_REG_HUSKY_LENS_BASE+5目标1 Y坐标同上
.........每个目标占用3个寄存器
0xECSYS_REG_HUSKY_LENS_BLOCK_CNT识别到的目标总数0-16

每个目标占用3个寄存器：​

  • base + i*3 → 目标类型
  • base + i*3 + 1 → X坐标
  • base + i*3 + 2 → Y坐标

十三、系统控制寄存器 (0x80-0xC7)​

地址寄存器名用途说明备注
0x80SYS_REG_SAVE_LOAD_FLAG程序保存/加载控制见下方标志位定义
0x81SYS_REG_DISP_MODE显示模式控制OLED显示内容切换
0x82SYS_REG_CURRENT_PC当前程序计数器当前执行到的程序行号
0x83SYS_REG_RUN_STATUS运行状态系统当前运行状态码
0x84-0x8BSYS_REG_FILENAME_CURRENT当前程序文件名16字节ASCII字符串
0x8C-0x93SYS_REG_FILENAME_0程序槽0文件名16字节ASCII字符串
0x94-0x9BSYS_REG_FILENAME_1程序槽1文件名16字节ASCII字符串
0x9C-0xA3SYS_REG_FILENAME_2程序槽2文件名16字节ASCII字符串
0xA4-0xABSYS_REG_FILENAME_3程序槽3文件名16字节ASCII字符串
0xAC-0xB3SYS_REG_FILENAME_4程序槽4文件名16字节ASCII字符串
0xB4-0xBBSYS_REG_FILENAME_5程序槽5文件名16字节ASCII字符串
0xBC-0xC3SYS_REG_FILENAME_6程序槽6文件名16字节ASCII字符串
0xC4-0xCBSYS_REG_FILENAME_7程序槽7文件名16字节ASCII字符串

SYS_REG_SAVE_LOAD_FLAG 标志位定义​

位掩码用途
bit0-7FILE_SECTOR_ID_MASK (0xFF)扇区ID
bit8-9FILE_SAVE_MASK (0x300)保存标志 (右移8位读取)
bit9-10FILE_LOAD_MASK (0x600)加载标志 (右移9位读取)
bit10-11FILE_NAME_LIST_MASK (0xC00)文件名列表标志 (右移10位读取)

寄存器地址速查表​

地址范围功能分类说明
0x00比较寄存器条件比较专用
0x01-0x22用户通用寄存器程序可自由使用
0x23-0x27系统状态定时器、I/O
0x28-0x29显示控制绘图颜色
0x2A-0x2DPWM控制内置PWM占空比
0x2E-0x30环境传感器温度/湿度/海拔
0x31-0x33颜色传感器RGB值
0x34外设开关使能/禁用外设
0x35-0x37超声波距离测量
0x38-0x3ERTC时钟日期时间
0x3F按钮状态板载按键
0x40-0x4FADC数据ADS1115 16通道
0x50-0x7FPWM输出PCA9685 三设备
0x80-0xC7系统控制保存/加载/显示
0xCC-0xECAI视觉HuskyLens识别结果