42.2. UPNPS configuration

Add the resource to the Abilis system with the following command.

[11:09:16] ABILIS_CPX:a res:upnps

RES:UPNP ALREADY EXISTS

The UPNPS resource may already exist in the system, but may not yet be active: set it active with the command:

[11:09:21] ABILIS_CPX:s act res:upnps

COMMAND EXECUTED

On a working Abilis, a system restart is needed to make the resource running.

Use the below command to display the parameters of the resource:

[14:53:51] ABILIS_CPX:d p upnps

RES:UPnPS --------------------------------------------------------------------
Run    Run    DESCR:Universal_Plug_and_Play_Server
       LOG:NO         ACT:NO   sesnum:5     udp-locport:1900  tcp-locport:1900
       MAX-AGE:1800   TOS:0-N
       IPSRC:*                  IPSRCLIST:#
       WDIR:C:\APP\UPNP\

[14:58:56] ABILIS_CPX:s p upnps act:yes

COMMAND EXECUTED

[14:59:00] ABILIS_CPX:init res:upnps

COMMAND EXECUTED

[14:59:18] ABILIS_CPX:d p upnps

RES:UPnPS ---------------------------------------------------------------------
Run    DESCR:Universal_Plug_and_Play_Server
       LOG:NO         ACT:YES   sesnum:5     udp-locport:1900  tcp-locport:1900
       MAX-AGE:1800   TOS:0-N
       IPSRC:*                  IPSRCLIST:#
       WDIR:C:\APP\UPNP\

Below are descriptions of the most important parameters:

LOG

State changes log and alarm generation [NO, D (=Debug Log), S (=System Log), A (=Alarm view), L (=Local audible alarm), T (=SNMP traps), ALL] [+E (=Extended Log of state changes)].

ACT

Operation activation [NO, YES].

sesnum

Number of sessions that the UPNP server module can support at once [1..255].

udp-locport

Local UDP port of UPNP server [1900]. Read Only.

tcp-locport

Local TCP port of UPNP server [1900]. Read Only.

MAX-AGE

Number of seconds the server' advertisement is valid [60..36000 sec].

TOS

TOS or DS field:

  • p-t: PRECEDENCE-TOS, 'p' [0..7], 't' [N, D, T, R, C];

  • bbbbbb: DS value bit by bit, 'b' [0, 1];

IPSRCLIST

Incoming requests: list of further accepted source IP addresses [#, IP/IR/RU/MR listname].

IPSRC

Incoming requests: accepted source IP address [*, 1-126.x.x.x, 127.0.0.1, 128-223.x.x.x].

WDIR

UPNP server working directory. Full path with drive letter ['C'..'Z'] terminated by '\'. Max 128 chars. Spaces require double quotes (E.g. "C:\My dir\").

The following command allows the administrator to change the configuration of the resource:

s p upnps name:value...