Skip to main content

AT 指令

通过 AT 指令，您可以直接通过输入指令的方式修改设备的配置

具体步骤​

  1. 通过套件附带的 Type C 数据线，将接口扩展板和 PC 电脑连接

  2. 打开 网页工具 中的日志

  3. 选择套件的串口，点击连接（如果找不到设备，需要安装驱动，具体请点击：固件升级和问题诊断）

  4. 在弹出的日志框中输入 AT 指令

AT 指令​

修改配置后需要重启设备才能生效, 仅支持英文输入法且为小写字母 ​

查看配置文件​

at+config=?

查看支持的全部 AT 指令​

at+command=?

查看按键配置 (仅支持八爪鱼)​

at+keys=?

配置对话按键 (仅支持八爪鱼)​

  • 例：对话按键定义为 GPIO 27

    at+keys=talk,<GPIO> // at+keys=talk,27

配置重置 WIFI 按键 (仅支持八爪鱼)​

  • 例：将 WIFI 重置按键定义为 GPIO 29 和 GPIO 30

    at+keys=wifi_rst,<GPIO>;<GPIO> // at+keys=wifi_rst,29;30

重启设备​

at+reboot

配置角色 (仅支持八爪鱼)​

  • 如果没有配置过，则角色 id 默认为 1

  • 例：将角色 1 的按键定义为 GPIO 22

    at+keys=role_idx,<index>,<GPIO> // at+keys=role_idx,1,22

  • 例：删除角色 1 的按键定义

    at+keys=role_idx,<index>,<GPIO> // at+keys=role_idx,1,0

配置切换角色按键 (仅支持八爪鱼)​

  • 例：配置 GPIO 27 为切换上一个角色

    at+keys=role_prev,<GPIO>  // at+keys=role_prev,27

  • 例：配置 GPIO 28 为切换下一个角色

    at+keys=role_next,<GPIO>  // at+keys=role_next,28

修改配置中的 MQTT​

  • 例：修改 Broker 为 192.168.52.1

    at+config=mqtt,broker,<broker> // at+config=mqtt,broker,192.168.52.1

  • 例： 修改 Port 为1883

    at+config=mqtt,port,<port> // at+config=mqtt,port,1883

  • 同时修改 Broker 和 Port

    at+config=mqtt,broker,<broker>;port,<port> // at+config=mqtt,broker,192.168.52.1;port,1883

修改配置中的 WIFI​

  • 例： 修改 SSID 为 test-wifi

    at+config=wifi,ssid,<ssid> // at+config=wifi, ssid, test-wifi

  • 例： 修改密码为 123456

    at+config=wifi,password,<password> // at+config=wifi,password,123456

  • 同时修改 SSID 和密码

    at+config=wifi,ssid,<ssid>;password,<password> // at+config=wifi,ssid,test-wifi;password,123456

配置声音阈值​

  • at+config=common,voice_start_threshold,<value>：配置开始阈值，取值范围 50dB-80dB

    例：修改声音触发阈值为 60dB

    at+config=common,voice_start_threshold,60

  • at+config=common,voice_end_threshold,<value>：配置结束阈值，默认为 开始阈值 - 5

    例：修改声音结束阈值为 55dB

    at+config=common,voice_end_threshold,55

修改设备等待服务器回复的超时时长​

  • 例：修改超时为50秒

    at+config=common,timeout,<seconds> // at+config=common,timeout,50

重置 WIFI 并进入配网模式​

at+command=wifi,reset

切换录音模式​

at+command=record,click //点击录音按键进入录音，录音完成后自动结束
at+command=record,press //按下录音按键进入录音，松开按键结束录音
at+command=record,continuous //点击录音按键进入连续对话模式

开始对话（根据上面的录音模式）​

at+command=dialogue,start //进入对话
at+command=dialogue,stop //退出对话

开机提示音配置​

at+command=open_tip_type,open //打开开机提示音
at+command=open_tip_type,close //关闭开机提示音

电压预警配置​

at+config=common,voltage_alarm,<value> //配置预警电压，默认3.7

声音配置​

at+voice=test // 进入voicetest模式，该模式录音时可打印音量大小日志
at+voice=autoconfig // 进入音量阈值自动配置模式，进入该模式后可在5s后自动配置音量阈值
at+voice=normal // 退出voicetest或音量阈值自动配置模式

配置耳灯亮度​

at+config=common,led_brightness,<value> // 设置耳灯的最大亮度，取值范围由小到大 0-255

  • 例：修改耳灯亮度为 100

    at+config=common,led_brightness,100

音量配置​

at+config=common,volume,<value> // 设置音量大小，默认100，取值范围 0-100
at+command=volume_control_type,knob // 设置为通过旋钮控制音量
at+command=volume_control_type,config // 设置为通过at指令或者mqtt指令控制音量

  • 例：修改音量大小为 100

    at+config=common,volume,100

录音开始提示音配置​

at+config=common,record_begin_audio_type,<value> // 0-禁用，1-启用

对话结束判断时长配置​

at+config=common,no_sound_duration,<millis> // 单位：ms

电量上报周期配置​

at+config=common,send_battery_msg_time,<seconds> // 单位：s

配置仙人掌在说话时，是否扭动​

at+command=io_output,true // 扭动
at+command=io_output,false // 不扭动

唤醒词模式配置​

at+command=wake_up_mode,open //启用
at+command=wake_up_mode,close //禁用

待机模式（适用于固件版本为 24.20.4.31 及以上的魔匣和仙人掌）​

at+command=standby_mode,open //启用
at+command=standby_mode,close //禁用
at+config=common,standby_time,<seconds> //单位：s

配置语音识别（目前仅 magicbox-pro 可用）​

at+command=asr_mode,open //打开
at+command=asr_mode,close //关闭