Skip to content
CC2 Device Documentation

WiFi, Scan, ALP & CCX Config

Controls WiFi connection timeouts, periodic scanning with UDP reporting, ALP (Airista Location Protocol) presence, and raw Cisco CCX packet transmission for testing.

Key path: devcfg.wifi, devcfg.wifiscan, devcfg.wifialp, devcfg.wificcx

{
  "devcfg": {
    "wifi": {
      "connect_timeout_seconds": 12,
      "connect_retry_seconds": 180,
    },
    "wifiscan": {
      "durationMS": 3000,
      "intervalS": 30,
      "topN": 3,
      "pushIP": "192.168.1.100",
      "pushPort": 8552,
    },
    "wifialp": {
      "enable": true,
      "pushIP": "192.168.1.200",
      "pushPort": 8552,
      "intervalS": 30,
    },
    "wificcx": {
      "intervalMS": 300,
      "enable": false,
      "state": "off",
    },
  },
}

WiFi connection

Section titled “WiFi connection”

connect_timeout_seconds

Section titled “connect_timeout_seconds”

Time (in seconds) the device waits for a WiFi connection attempt to succeed before timing out.

Configuration variables

  • Type: integer
  • Default: 12
{
  "devcfg": {
    "wifi": {
      "connect_timeout_seconds": 15,
    },
  },
}

connect_retry_seconds

Section titled “connect_retry_seconds”

Time (in seconds) to wait after a failed connection before retrying.

Configuration variables

  • Type: integer
  • Default: 180
{
  "devcfg": {
    "wifi": {
      "connect_retry_seconds": 300,
    },
  },
}

devcfg.wifi.mac is not operational and may cause WiFi stack errors if set. It is reserved for future use.

WiFi scanning

Section titled “WiFi scanning”

Periodic WiFi scanning can send results to a remote server via UDP (ALP/ELP protocol). If pushIP is not set, scan results are only reported in devdata (if polling is active).

durationMS

Section titled “durationMS”

Duration of each scan cycle in milliseconds.

Configuration variables

  • Type: integer
  • Default: 3000
{
  "devcfg": {
    "wifiscan": {
      "durationMS": 5000,
    },
  },
}

intervalS

Section titled “intervalS”

Interval in seconds between automatic scans. Set to 0 to disable automatic scanning.

Configuration variables

  • Type: integer
  • Default: 30
{
  "devcfg": {
    "wifiscan": {
      "intervalS": 60,
    },
  },
}

topN

Section titled “topN”

Maximum number of access points to include in scan results.

Configuration variables

  • Type: integer
  • Default: 3
{
  "devcfg": {
    "wifiscan": {
      "topN": 5,
    },
  },
}

pushIP

Section titled “pushIP”

IP address or DNS name of the server that receives scan result UDP packets. Leave empty to disable push.

Configuration variables

  • Type: string
  • Default: "" (no push)
{
  "devcfg": {
    "wifiscan": {
      "pushIP": "192.168.1.100",
    },
  },
}

pushPort

Section titled “pushPort”

Destination UDP port for scan result packets.

Configuration variables

  • Type: integer
  • Default: 8552
{
  "devcfg": {
    "wifiscan": {
      "pushPort": 9999,
    },
  },
}

WiFi ALP (Airista location protocol)

Section titled “WiFi ALP (Airista location protocol)”

The ALP device sends periodic HELLO_REQUEST packets and parses HELLO_RESPONSE commands for location and downlink message checking.

enable

Section titled “enable”

Enables or disables the ALP service.

Configuration variables

  • Type: boolean
  • Default: false
{
  "devcfg": {
    "wifialp": {
      "enable": true,
    },
  },
}

pushIP

Section titled “pushIP”

IP address or DNS name of the ALP server.

Configuration variables

  • Type: string
  • Default: ""
{
  "devcfg": {
    "wifialp": {
      "pushIP": "192.168.1.200",
    },
  },
}

pushPort

Section titled “pushPort”

UDP port for ALP communication.

Configuration variables

  • Type: integer
  • Default: 8552
{
  "devcfg": {
    "wifialp": {
      "pushPort": 8552,
    },
  },
}

intervalS

Section titled “intervalS”

Interval in seconds between ALP HELLO_REQUEST packets.

Configuration variables

  • Type: integer
  • Default: 30
{
  "devcfg": {
    "wifialp": {
      "intervalS": 45,
    },
  },
}

WiFi CCX (Cisco compatible extensions)

Section titled “WiFi CCX (Cisco compatible extensions)”

Sends raw WiFi management or data packets, e.g. for Cisco CCX or EBP blink location. Requires the nrf70 firmware to be updated to the SYSTEM+RAW binary (wifi_update.bin). Not yet completed.

enable

Section titled “enable”

Enables or disables CCX packet transmission.

Configuration variables

  • Type: boolean
  • Default: false
{
  "devcfg": {
    "wificcx": {
      "enable": true,
    },
  },
}

intervalMS

Section titled “intervalMS”

Interval in milliseconds between CCX packets.

Configuration variables

  • Type: integer
  • Default: 300
{
  "devcfg": {
    "wificcx": {
      "intervalMS": 500,
    },
  },
}

state

Section titled “state”

Controls the CCX transmission state.

Configuration variables

  • Type: string
  • Default: "off"
  • Allowed values: "off" (disabled), "on" (enabled)
{
  "devcfg": {
    "wificcx": {
      "state": "on",
    },
  },
}
Section titled “Related”