MAC Debug Commands

connectorctl -s local-firehose macdebug viewdebuglogs

This command displays the mac debug logs on the Cisco Spaces: Connector configured using the connectorctl -s local-firehose macdebug enable command

connectorctl -s local-firehose macdebug viewdebuglogs -m macaddress

Syntax Description

Keywords and Variables Description
-m macaddress

MAC address of the Radio Frequency Identification (RFID) tag or the Bluetooth Low Energy (BLE) tag that should be debugged.

Examples

The following is a sample output of the command:
[spacesadmin@connector ~]$ connectorctl -s local-firehose macdebug viewdebuglogs -m 00:0c:cc:45:f0:b3

Executing command:macdebug
Command execution status:Success
-----------------------
2023-10-05 02:42:03,434 [pool-21-thread-1] INFO  com.cisco.dnaspaces.firehose.Firehose - MAC_DEBUG: 00:0c:cc:45:f0:b3, Incoming data from Connector, type: TAG_RSSI, message: tenantId: "11564"
macAddress: "00:0c:cc:45:f0:b3"
controllerIpAddress: "10.22.244.173"
messageId: 15
measurementNotification {
  tenantId: "11564"
  tenantId: "11564"
  macAddress: "00:0c:cc:45:f0:b3"
  controllerIpAddress: "10.22.244.173"
  deviceCategory {
    deviceClass: TAGS_2
  }
  transmitPower {
    value: 19
  }
  apRssiMeasurements {
    entries {
      apMacAddress: "68:7d:b4:5f:26:c0"
      rssi: -42
      timestamp: 50185
    }
    entries {
      apMacAddress: "ec:f4:0c:0e:9e:e0"
      rssi: -47
      timestamp: 54185
    }
    entries {
      apMacAddress: "10:f9:20:fe:5e:a0"
      rssi: -50
      timestamp: 50185
    }
    entries {
      apMacAddress: "0c:d0:f8:95:f3:80"
      rssi: -51
      timestamp: 49185
    }
    maxEntry {
      apMacAddress: "68:7d:b4:5f:26:c0"
      rssi: -42
      timestamp: 50185
    }
  }
  ccxTagPayloadList {
    timestamp: 49185
    sequenceNumber: 2426
    data: "\000\023\v\006\002\000\002\0003\002\a\n\000f\000\000\001\275\003\005\001A\302@\000\004\a\000\f\314\000\000\017\000"
  }
  serviceDescriptor {
    serviceId: RSSI
    serviceMask: 2
  }
}
sourceTimestamp: 1696473723296

Command History

Release 3

This command is introduced.

connectorctl -s local-firehose macdebug disable

This command disables the debug mode that you enabled earlier for a MAC address using the connectorctl local-firehose macdebug enable command.

connectorctl -s local-firehose macdebug disable -m macaddress

Syntax Description

Keywords and Variables Description
-m macaddress

MAC address of the Radio Frequency Identification (RFID) tag or the Bluetooth Low Energy (BLE) tag that you want to debug.

Examples

The following is a sample output of the command:
[spacesadmin@connector ~]$ connectorctl -s local-firehose macdebug disable -m 00:0c:cc:45:f0:b3

Executing command:macdebug
Command execution status:Success
-----------------------
debug level cleared successfully for mac address: 00:0c:cc:45:f0:b3
==========================================================================================================================================================

Command History

Release 3

This command is introduced.

connectorctl -s local-firehose macdebug enable

This command enables debug mode for a particular MAC address. You can then view the debug logs generated for the MAC address using the connectorctl -s local-firehose macdebug viewdebuglogs command.

connectorctl -s local-firehose macdebug enable -m macaddress -l level -d duration

Syntax Description

Keywords and Variables Description
-mmacaddress

MAC address of the Radio Frequency Identification (RFID) tag or the Bluetooth Low Energy (BLE) tag that you want to debug.
-llevel

Debug level. Values can be any of the following.

  • MESSAGE: Prints debug messages in human-readable format.

  • BYTE: Prints debug messages in byte code.
-dduration

Debug time in minutes.

Examples

The following is a sample output of the command:
[spacesadmin@connector ~]$ connectorctl -s local-firehose macdebug enable -m 00:0c:cc:45:f0:b3 -l MESSAGE -d 15
Executing command:macdebug
Command execution status:Success
-----------------------
debug level set successfully for mac address: 00:0c:cc:45:f0:b3, level: MESSAGE, duration: 15


===========================================================================================================================================================

Command History

Release 3

This command is introduced.

connectorctl -s location macdebug viewdebuglogs

This command displays the mac debug logs for the location service running on the Cisco Spaces: Connector configured using the connectorctl -s location macdebug enable command

connectorctl -s location macdebug viewdebuglogs -m macaddress

Syntax Description

Keywords and Variables Description
-m macaddress

MAC address of the Radio Frequency Identification (RFID) tag or the Bluetooth Low Energy (BLE) tag that should be debugged.

Examples

The following is a sample output of the command::
[spacesadmin@connector ~]$ connectorctl -s location macdebug viewdebuglogs -m 34:e1:2d:23:0a:7d
Executing command:macdebug
Command execution status:Success
-----------------------
2023-12-06 07:28:35,801 [qtp2036843608-15] INFO  com.cisco.cmx.auth.AuthFilter - Successfully authorized request
2023-12-06 07:28:36,516 [nioEventLoopGroup-8-1] INFO  com.cisco.cmx.nmsp.protomapping.MappingEngine - 
{"tenantId":"10137","macAddress":"34:e1:2d:23:0a:7d","controllerIpAddress":"10.22.243.31","messageId":15,"measurementNotification":
{"tenantId":"10137","macAddress":"34:e1:2d:23:0a:7d","controllerIpAddress":"10.22.243.31","timestamp":"0","deviceCategory":
{"deviceClass":"STATIONS","blockSize":0},"apRssiMeasurements":
{"entries":[{"apMacAddress":"04:eb:40:9f:b0:20","ifSlotId":1,"bandId":1,"antennaId":1,"rssi":-87,"timestamp":1355},
{"apMacAddress":"04:eb:40:9f:b0:20","ifSlotId":1,"bandId":1,"antennaId":0,"rssi":-87,"timestamp":1355},
{"apMacAddress":"04:eb:40:9f:ad:80","ifSlotId":1,"bandId":1,"antennaId":1,"rssi":-86,"timestamp":1346},
{"apMacAddress":"04:eb:40:9f:ad:80","ifSlotId":1,"bandId":1,"antennaId":0,"rssi":-86,"timestamp":1346},
{"apMacAddress":"04:eb:40:9f:ab:20","ifSlotId":1,"bandId":1,"antennaId":1,"rssi":-86,"timestamp":1423},
{"apMacAddress":"04:eb:40:9f:ab:20","ifSlotId":1,"bandId":1,"antennaId":0,"rssi":-86,"timestamp":1423},
{"apMacAddress":"04:eb:40:9f:a7:e0","ifSlotId":1,"bandId":1,"antennaId":1,"rssi":-82,"timestamp":1456},
{"apMacAddress":"04:eb:40:9f:a7:e0","ifSlotId":1,"bandId":1,"antennaId":0,"rssi":-82,"timestamp":1456},
{"apMacAddress":"04:eb:40:9f:ad:c0","ifSlotId":1,"bandId":1,"antennaId":1,"rssi":-80,"timestamp":1348},
{"apMacAddress":"04:eb:40:9f:ad:c0","ifSlotId":1,"bandId":1,"antennaId":0,"rssi":-80,"timestamp":1348}],"maxEntry":
{"apMacAddress":"04:eb:40:9f:ad:c0","ifSlotId":1,"bandId":1,"antennaId":1,"rssi":-80,"timestamp":1348}},"ccxTagPayloadList":[],"directedStatsList":[],"serviceDescriptor":
{"serviceId":"RSSI","serviceMask":1},"isMacHashed":false},"sourceTimestamp":"1701847716265","ingestTimestamp":"0"}

Command History

Release 3

This command is introduced.

connectorctl -s location macdebug disable

This command disables the debug mode for location service that you enabled earlier for a MAC address using the connectorctl location macdebug enable command.

connectorctl -s location macdebug disable -m macaddress

Syntax Description

Keywords and Variables Description
-m macaddress

MAC address of the Radio Frequency Identification (RFID) tag or the Bluetooth Low Energy (BLE) tag that you want to debug.

Examples

The following is a sample output of the command::
[spacesadmin@connector ~]$ connectorctl -s location macdebug disable -m 34:e1:2d:23:0a:7d

Executing command:macdebug
Command execution status:Success
-----------------------
debug level cleared successfully for mac address: 34:e1:2d:23:0a:7d

==========================================================================================================================================================

Command History

Release 3

This command is introduced.

connectorctl -s location macdebug enable

This command enables debug mode for location service for a particular MAC address. You can then view the debug logs generated for the MAC address using the connectorctl -s location macdebug viewdebuglogs command.

connectorctl -s location macdebug enable -m macaddress -l level -d duration

Syntax Description

Keywords and Variables Description
-m macaddress

MAC address of the Radio Frequency Identification (RFID) tag or the Bluetooth Low Energy (BLE) tag that you want to debug.
-l level

Debug level. Values can be any of the following.

  • MESSAGE: Prints debug messages in human-readable format.

  • BYTE: Prints debug messages in byte code.
-d duration

Debugging time in minutes.

Examples

The following is a sample output of the command::
[spacesadmin@connector ~]$ connectorctl -s location macdebug enable -m 34:e1:2d:23:0a:7d -l MESSAGE -d 5 
Executing command:macdebug
Command execution status:Success
-----------------------
debug level set successfully for mac address: 34:e1:2d:23:0a:7d, level: MESSAGE, duration: 5


===========================================================================================================================================================

Command History

Release 3

This command is introduced.