AS (Active Scan)

This command applies to the XBee 3 802.15.4 RF Module.

Sends a Beacon Request to a Broadcast address (0xFFFF) and Broadcast PAN (0xFFFF) on every channel in the scan channel mask—SC (Scan Channels). Active Scan can only be performed locally and returns an ERROR if attempted remotely.

The AS command cannot be issued from within MicroPython or over BLE.

A PanDescriptor is created and returned for every Beacon received from the scan. Each PanDescriptor contains the following information:

CoordAddress (SH + SL parameters)<CR>

Note If MY on the coordinator is set less than 0xFFFF, the MY value is displayed.

CoordPanID (ID parameter)<CR>

CoordAddrMode <CR>

0x02 = 16-bit Short Address

0x03 = 64-bit Long Address

Channel (CH parameter) <CR>

SecurityUse<CR>

ACLEntry<CR>

SecurityFailure<CR>

SuperFrameSpec<CR> (2 bytes):

bit 15 - Association Permitted (MSB)

bit 14 - PAN Coordinator

bit 13 - Reserved

bit 12 - Battery Life Extension

bits 8-11 - Final CAP Slot

bits 4-7 - Superframe Order

bits 0-3 - Beacon Order

GtsPermit<CR>

RSSI<CR> (- RSSI is returned as -dBm)

TimeStamp<CR> (3 bytes)

<CR> (A carriage return indicates the end of the PanDescriptor)

The Active Scan returns one PanDescriptor response per discovered network. Each PanDescriptor has a trailing carriage return <CR> to indicate the end of the frame. The sequence of PanDescriptors has a final trailing carriage return (three <CR> in sequence indicate the end of the active scan).

If using API Mode, no <CR>’s are returned and a separate response frame is generated for each PanDescriptor. For more information, see Operate in API mode. If no PANs are discovered during the scan, only one carriage return is printed.

The AS command cannot be issued from within MicroPython or over BLE.

Before a device is associated to a network (AI != 0), it will continuously perform an active scan in the background, searching for a valid network to join. While this is occurring, you cannot manually perform an active scan using the AS command. You can bypass this restriction by setting DJ to 1. This will disable joining and halt the background active scans.

Parameter range

N/A

Default

N/A