The external gateway queries the current status of a user from the Public Spot with a "Status" request. A "Status" request contains the attribute COMMAND="RADIUS_Status".
The XML interface can process the following XML elements for a request:
- SUB_USER_NAME
- User name
- SUB_MAC_ADDR
- MAC address of the user device. Possible formats include:
- 00164115208c
- 00:16:41:15:20:8c
- 00-16-41-15-20-8c
The XML interface then sends the gateway a "Status" response, which can contain the following XML elements:
- SUB_USER_NAME
- User name
- SUB_MAC_ADDR
- MAC address of the user device. Possible formats include:
- 00164115208c
- 00:16:41:15:20:8c
- 00-16-41-15-20-8c
- SUB_STATUS
- The current user status. The following values are possible:
- RADIUS_STATUS_DONE: Status request successful
- RADIUS_STATUS_REJECT: Status request rejected, e.g. unknown user or MAC address
- SESSION_TXBYTES
- Current sent data volume
- SESSION_RXBYTES
- Current received data volume
- SESSION_TXPACKETS
- Number of data packets sent so far
- SESSION_RXPACKETS
- Number of data packets received so far
- SESSION_STATE
- Current status of the session
- SESSION_ACTUAL_TIME
- Current time
Some examples of XML files are given below:
- Status request
-
The external gateway sends the command for a status request to the Public Spot:
<?xml version="1.0" encoding="ISO-8859-1"?> <PUBLICSPOTXMLINTERFACE> <ACCESS_CUBE COMMAND="RADIUS_STATUS"> <SUB_USER_NAME>user2350</SUB_USER_NAME> <SUB_MAC_ADDR>00164115208c</SUB_MAC_ADDR> </ACCESS_CUBE> </PUBLICSPOTXMLINTERFACE>
- Status response:
-
The XML interface sends a status message to the external gateway:
<?xml version="1.0" encoding="ISO-8859-1" ?> <PUBLICSPOTXMLINTERFACE> <ACCESS_CUBE ID="WLC_PM" IP="192.168.100.2" COMMAND="USER_STATUS"> <SUB_STATUS>RADIUS_STATUS_DONE</SUB_STATUS> <SUB_MAC_ADDR>00:16:41:15:20:8b</SUB_MAC_ADDR> <SUB_USER_NAME>user2350</SUB_USER_NAME> <SESSION_ID>2</SESSION_ID> <SESSION_TXBYTES>0</SESSION_TXBYTES> <SESSION_RXBYTES>0</SESSION_RXBYTES> <SESSION_TXPACKETS>0</SESSION_TXPACKETS> <SESSION_RXPACKETS>0</SESSION_RXPACKETS> <SESSION_STATE>Authenticated</SESSION_STATE> <SESSION_ACTUAL_TIME>0</SESSION_ACTUAL_TIME> </ACCESS_CUBE> </PUBLICSPOTXMLINTERFACE>