pCOWeb
+030220966 – rel. 1.1 – 12.12.2017
35
6.2
THE
pCOWeb
SNMP TREE
The format of the CAREL
pCOWeb
OID (object identifier) is:
1.3.6.1.4.1.9839(CAREL).A.B[.C.D]
where:
A=1:
pCOWeb
properties
A.B
1.1.0
Agent release (read-only), 4 for firmware A2.0.x – B2.0.x
1.2.0
Agent code (read-only), 2 (“pCOWeb”)
A.B.C.D
1.3.1.1.0
ALARM FIRED string (read / write)
1.3.1.2.0
ALARM REENTERED string (read / write)
A=2:
pCO
properties
A.B.C.D
2.0.10.1.0 communication status with pCO (read-only)
0=pCO offline
1=communication attempt 2=pCO online
2.0.11.1.0 No. of communication attempts with pCO (read-only)
0 when ok or, during offline, each 5 attempts
2.1.t.i.0 pCO variables (read / write)
t: type of variable (1: Digital
2: Analog
3: Integer)
i: variable index
NOTE 1
SNMP requires the use of the final zero when referring to scalar objects, that is, not tables or lists. All
pCOWeb
objects are scalar.
NOTE 2
Reading
the
pCO
variables with indices that are not managed by the BIOS version used returns meaningless values
NOTE 3
When a value is undefined, i.e. the summary web page shows “U”, SNMP browser returns “-858993460”.
NOTE 4
A variable is always read/write, however the value will be retained only if featured in the
pCO
application program.
Example:
1.3.6.1.4.1.9839.2.1.2.45.0
type
2
pCO
variable (analog) with index
45
.
Here how the variable OID looks like
6.3
MIB FILE
The objects contained in an SNMP Agent are normally described using a document called the MIB FILE, the format of which is codified by SNMP.
The document must be written using the syntax specified by SNMP and must be uploaded to the NMS supervisor when this queries the Agent or receives the
TRAP message: if the NMS contains the MIB file, it can use this an “interpreter” that, as well as containing the list of all objects available on the Agent,
describes the properties, for example the description, the writability, the type, etc.…
As the MIB file contains the physical meaning of each object, it can only be created once the
pCO
application has been defined. For this reason, upon request
CAREL only provides the MIB FILES for the standard CAREL
pCO
applications, which can however be used to as the basis for creating a MIB file for custom
applications; once created, numerous sites are available on the web for validating the MIB FILES.
One recommended site is:
http://www.simpleweb.org/ietf/mibs/validate/
.
