DeautherX

Serial Commands

You can use my deautherX web tools for serial commands.

HELP

help

Prints a list of all available commands.

SCAN

scan [<all/aps/stations/wifi>] [-t <time>] [-c <continue-time>] [-ch <channel>]

Starts a scan with the given parameters.

Modes (optional, default = all):

• all (-a)
• access points (-ap)
• stations (-st)
• wifi (-w)

Note: The mode must be the first parameter!

Time [-t] (optional, default = 15s): Specifies how long to scan for stations (client devices) in seconds.

Continue [-c] (optional): Specifies how many seconds until the next scan.

Channel [-ch] (optional): Scans only on a specific channel instead of automatically cycling through them.

To scan indefinitely, set the time to 0, e.g., scan stations -t 0.

The difference between the stations and wifi modes is that stations will only scan on channels used by at least one access point. The wifi scan mode does not require an initial access point scan and is recommended for using the deauth detection and packet monitor features.

SHOW

show [<all/aps/stations/names/ssids>]

show selected [<all/aps/stations/names/ssids>]

Prints the scan results (access points and stations), saved device names, and saved SSIDs.

Selected (optional, default = false): Only the selected targets are printed.

Types (optional, default = all):

• all (-a)
• access points (-ap)
• stations (-st)
• names (-b)
• SSIDs (-ss)

SELECT/DESELECT

select [<all/aps/stations/names>] [<id>]

deselect [<all/aps/stations/names>] [<id>]

(De)Selects a specific or all access points, stations, and device names.

Types (optional, default = all):

• all (-a)
• access points (-ap)
• stations (-st)
• names (-b)

ID (optional): The ID of the AP/station/device you want to select.

ADD SSID

add ssid <ssid> [-wpa2] [-cl <clones>] [-f]

Adds the specified SSID with the given parameters to the list.

SSID: The SSID you want to add to the list.

-wpa2 (optional, default = false): Specifies if the SSID should be an open or WPA2 encrypted network.

Clones [-cl] (optional, default = 0): Specifies how many SSIDs you want to add with that name.

Force [-f] (optional, default = false): Forces the addition of the SSID, even if the list is full.

add ssid -ap <id> [-cl <clones>] [-f]

Copies the SSID from a scanned access point and adds it to the list.

Clones [-cl] (optional, default = 0): Specifies how many SSIDs you want to add with that name.

Force [-f] (optional, default = false): Forces the addition of the SSID, even if the list is full.

add ssid -s [-f]

Copies SSIDs from selected access points into the list.

Force [-f] (optional, default = false): Forces the addition of the SSID and overwrites old SSIDs.

ADD NAME

add name <name> -ap <id> [-s] [-f]

add name <name> -st <id> [-s] [-f]

add name <name> -m <mac> [-ch <channel>] [-b <bssid>] [-s] [-f]

Saves a device with the given name and parameters.

Name [-n]: The name you want to give the device (max. 16 characters).

AP [-ap]: Access point you want to save.

Station [-st]: Station you want to save.

MAC [-m]: MAC address of the device.

Channel [-ch] (optional, default = current channel): The channel the device is on.

BSSID [-b] (optional, default = NULL): The MAC address of the access point to which it is connected.

Select [-s] (optional, default = false): Select the device after adding it.

Force [-f] (optional, default = false): Forces the addition of a name, even if the list is full.

REPLACE NAME

replace name <id> [-n <name>] [-m <mac>] [-ch <channel>] [-b <bssid>] [-s]

Removes the name with the given ID and creates a new one with the specified parameters.

SET NAME

set name <id> <newname>

Changes the name of a saved device.

ID: The ID of the saved name you want to change.

New Name: The new name you want to assign to that device.

RANDOM

enable random <interval> -cl <clones>

Enables random SSID mode.

Interval: The time in milliseconds between sending probe requests.

Clones [-cl]: The number of SSIDs to be sent with the same name.

DISABLE RANDOM

disable random

Disables random SSID mode.

REMOVE

remove <all/aps/stations/names/ssids>

remove name <id>

remove ssid <id>

Removes the specified items from the list.

Types (optional, default = all):

• all (-a): Removes all items.
• access points (-ap): Removes access points.
• stations (-st): Removes stations.
• names (-b): Removes saved device names.
• SSIDs (-ss): Removes saved SSIDs.

ID (optional): The ID of the specific item you want to remove.

REMOVE CLONES

remove clones

Removes all cloned SSIDs from the list.

DEAUTH

deauth [-t <time>] [-m <mode>]

Starts a deauthentication attack on the selected stations and/or access points.

Time [-t] (optional, default = 0): The time in seconds for which the attack will run. Setting it to 0 means the attack will continue indefinitely.

Mode [-m] (optional, default = 0): The mode of the deauthentication attack. Modes are:

• 0: Attack both stations and access points.
• 1: Attack only stations.
• 2: Attack only access points.

ENABLE AP

enable ap <ssid> -p <password> [-ch <channel>] [-h]

Enables the access point with the specified SSID and optional parameters.

SSID: The SSID of the access point you want to create.

Password [-p] (optional): The password for the WPA2-encrypted network. If not provided, the network will be open.

Channel [-ch] (optional, default = 1): The WiFi channel the AP will use.

Hidden [-h] (optional, default = false): If enabled, the SSID will not be broadcasted.

DISABLE AP

disable ap

Disables the currently active access point.

PACKET MONITOR

enable monitor <channel> [-p]

Enables packet monitoring mode on the specified WiFi channel.

Channel: The WiFi channel to monitor.

Print [-p] (optional): Prints the captured packets to the serial monitor.

DISABLE MONITOR

disable monitor

Disables packet monitoring mode.

DEAUTH DETECTION

enable detection [-s]

Enables deauthentication detection mode.

Select [-s] (optional): Only detect deauthentication packets targeting selected stations or access points.

DISABLE DETECTION

disable detection

Disables deauthentication detection mode.

CHANNEL HOP

enable hop <delay>

Enables channel hopping mode with the specified delay between channels.

Delay: The time in milliseconds between channel switches.

DISABLE HOP

disable hop

Disables channel hopping mode.

GET CHANNEL

get channel

Prints the currently active WiFi channel.

SET CHANNEL

set channel <channel>

Sets the current WiFi channel.

Channel: The WiFi channel to set.

SAVE

save

Saves all settings to flash memory.

RESET

reset

Resets the device to its default settings.

EXIT

exit

Exits the program or closes the connection.