2.2 WANCommonInterfaceConfig Extensions

  • Article

The WANCommonInterfaceConfig service is specified in [UPNPWCIC]. Its service description is extended as follows, in the UPnP Template Language.

  
 <actionList>
 <action>
     <name>X_GetICSStatistics</name>
       <argumentList>
         <argument>
           <name>TotalBytesSent</name>
           <direction>out</direction>
           <relatedStateVariable>TotalBytesSent</relatedStateVariable>
         </argument>
         <argument>
           <name>TotalBytesReceived</name>
           <direction>out</direction>
           <relatedStateVariable>TotalBytesReceived</relatedStateVariable>
         </argument>
         <argument>
           <name>TotalPacketsSent</name>
           <direction>out</direction>
           <relatedStateVariable>TotalPacketsSent</relatedStateVariable>
         </argument>
         <argument>
           <name>TotalPacketsReceived</name>
           <direction>out</direction>
           <relatedStateVariable>TotalPacketsReceived</relatedStateVariable>
         </argument>
         <argument>
           <name>Layer1DownstreamMaxBitRate</name>
           <direction>out</direction>
           <relatedStateVariable>Layer1DownstreamMaxBitRate</relatedStateVariable>
         </argument>
         <argument>
           <name>Uptime</name>
           <direction>out</direction>
           <relatedStateVariable>X_Uptime</relatedStateVariable>
         </argument>
       </argumentList>
     </action>
 </actionList>
 <serviceStateTable>
     <stateVariable sendEvents="no">
       <name>X_PersonalFirewallEnabled</name>
       <dataType>boolean</dataType>
     </stateVariable>
     <stateVariable sendEvents="no">
       <name>X_Uptime</name>
       <dataType>ui4</dataType>
     </stateVariable>
 </serviceStateTable>

The following action is defined in the service description above:

X_GetICSStatistics: Provides the ability to retrieve uptime information for an Internet gateway device. This action uses the following errors:

 Value

 Meaning

402

Invalid Args, as defined in [UPNPWCIC] section 2.4.1.4.

501

Action Failed, as defined in [UPNPWCIC] section 2.4.1.4.

The following state variables are defined in the service description above:

X_Uptime: The number of seconds since the IGD has started. This is the same value as the Uptime variable in the WANIPConnection or WANPPPConnection service.

X_PersonalFirewallEnabled: If the WAN interface on the Internet gateway device is protected by a firewall, this SHOULD<1> be set to TRUE; otherwise FALSE.