Page 8 of 60
3.
Object Identifiers
All configurable options on IQeye cameras can be controlled using Object Identifiers. (
“
OIDs
”
)
3.1.
OID description
OIDs are SNMP-like Object IDentifiers that allow host based applications and on-camera web pages to get
and set values on the camera. An object is a single piece of information that can be displayed and possibly
changed, i.e. a flag setting, a string, a counter variable, etc.
An OID is represented by a dot separated numerical value. For example, the OID 2.4 corresponds to the name
of the camera. OIDs are used in all built-in web pages and can also be used by host application programs to
configure the camera.
3.2.
Reading OIDs
The simplest way to get specific information from the camera is to issue an http request to read an OID value.
For example, issuing the following http request:
http://<camera_ip>/get.oid?2.4
will return a page that has the value of OID 2.4 (the camera name) as the page contents.
3.3.
Setting OIDs
When setting OID values the OID format contains additional information used to specify how the OID value
is to be written. The format of the OID command is:
set
.
oid
?
Oid
{
type
}{
style
}n.n.n ={
value
}
Where the following parameters must be defined:
type
The type of field that is being set. Use the value “T” for text entry fields.
style
Where the variable should be written. Specify “N” for writing to the camera’s
non-volatile memory, “R” for setting the run-time value only or “B” for both run-
time and non-volatile memory.
value
The value to assign to the specified OID.
For example, to change the camera name to
“
IQcam
”
in the running system configuration use the http request:
http://<camera_ip>/set.oid?OidTR2.4=”IQcam”
Note:
The syntax of the set.oid URL is case sensitive.
If this request completes successfully the camera name will be changed to the string
“
IQcam
”
in the run-time
system. The permanent value stored in non-volatile memory will not be changed.
