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,at // 设置为通过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 // 不扭动

唤醒词模式配置(目前仅八爪鱼MiniPro版本支持)

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

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

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