Skip to main content

AT Command

Specific Steps

  1. Connect the interface expansion board to a PC using the provided Type C data cable.

  2. Open the web tool and navigate to the logs.

  3. Select the serial port for the kit and click "Connect."

  4. Enter the AT command in the pop-up log box.

AT Commands

changes take effect after reboot. Only English input and lowercase letters are supported.

View configuration file:


View all AT commands:


View key configuration:


Configure talk key:

  • Example: Define talk key as GPIO 27

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

Configure WIFI reset key:

  • Example: Define WIFI reset key as GPIO 29 and GPIO 30

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

Reboot configuration (changes take effect after reboot):


Configure role:

  • If not configured, the default role ID is 1.

  • Example: Define GPIO 22 as the key for role 1

    at+keys=role_idx,<index>,<GPIO> // at+keys=role_idx,1,22
  • Example: Remove key definition for role 1

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

Configure switch role key:

  • Example: Configure GPIO 27 to switch to the previous role

    at+keys=role_prev,<GPIO>  // at+keys=role_prev,27
  • Example: Configure GPIO 28 to switch to the next role

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

Modify MQTT configuration:

  • Example: Modify the broker to

    at+config=mqtt,broker,<broker> // at+config=mqtt,broker,
  • Example: Modify the port to 1883

    at+config=mqtt,port,<port> // at+config=mqtt,port,1883
  • Modify both the broker and port simultaneously

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

Modify WIFI configuration:

  • Example: Modify the SSID to "test-wifi"

    at+config=wifi,ssid,<ssid> // at+config=wifi,ssid,test-wifi
  • Example: Modify the password to "123456"

    at+config=wifi,password,<password> // at+config=wifi,password,123456
  • Modify both the SSID and password simultaneously

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

Configure Sound Thresholds

  • Command: at+config=common,voice_start_threshold,<value>

    • Description: Configure the start threshold, with a range of 50dB-80dB.

    • Example: Modify the sound trigger threshold to 60dB

  • Command: at+config=common,voice_end_threshold,<value>

    • Description: Configure the end threshold, default is the start threshold - 5.

    • Example: Modify the sound end threshold to 55dB


Modify the timeout for waiting the server response

  • Example: Modify timeout to 50 seconds

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

Reset WIFI and enter pairing mode:


Switch recording mode

at+command=record,click // click the recording button to enter the recording, and it will automatically end after the recording is completed
at+command=record,press // press the recording button to enter recording, release the button to end recording
at+command=record,continuous // click the recording button to enter continuous conversation mode

Start a conversation (According to the recording mode above):

at+command=dialogue,start // enter conversation
at+command=dialogue,stop // exit conversation

Open tip audio configuration

at+command=open_tip_type,open // open tip audio enable
at+command=open_tip_type,close // open tip audio disable

Voltage alarm configuration

at+config=common,voltage_alarm,<value> // setting voltage alarm, default 3.7

Voice Config

at+voice=test // enter voicetest mode, which can print volume logs during recording
at+voice=autoconfig // enter the volume threshold automatic configuration mode, which can automatically configure the volume threshold after 5 seconds
at+voice=normal // exit voicetest or volume threshold automatic configuration mode

Configure Earlight Brightness

// Sets the maximum brightness of the earlight, with values ranging from 0 to 255
  • Example: Set earlight brightness to 100


Volume Config

at+config=common,volume,<value> // Set the volume level, default to 100, with a range of values ranging from 0 to 100
at+command=volume_control_type,knob // Set to control volume through a knob
at+command=volume_control_type,at // Set to control volume through at command or mqtt command
  • Example: Changing the volume level to 100


Recording start prompt sound configuration

at+config=common,record_begin_audio_type,<value> // 0-disable,1-enable

Dialogue end judgment duration configuration

at+config=common,no_sound_duration,<millis> // Unit:ms

Power reporting cycle configuration

at+config=common,send_battery_msg_time,<seconds> // Unit:s

Configure whether the cactus twists while speaking

at+command=io_output,true // Twisting
at+command=io_output,false // Not twisting

Wake up mode configuration (currently only supported in the Octopus MiniPro version)

at+command=wake_up_mode,open // turn on the wake up mode
at+command=wake_up_mode,close // turn off the wake up mode

Standby mode (Applicable to Magic Box and Cactus Firmware Version and Above)

at+command=standby_mode,open // turn on the standby mode
at+command=standby_mode,close // turn off the standby mode
at+config=common,standby_time,<seconds> // Unit:s