User`s guide

124NetBotz Appliance User’s Guide
Picture Alert Parameter Definitions
HTTP posts and FTP data files generated by NetBotz devices for alert notifications that include pictures
include additional parameters for encoding the pictures.
If the picture alert notification is an HTTP post, the encoding of the post is multipart/form-data (as
defined by RFC 2388), as opposed to application/x-www-form-urlencoded. The multipart/form-data
encoding for HTTP posts is typically defined on Web pages by setting the ENCTYPE attribute of the
<FORM> tag to
“multipart/form-data”. This encoding results in the format of the data portion of the post
being MIME-encoded, as opposed to the more typical
attribute1=value1&attribute2=value2&attribute3=value3 encoding seen with the default
application/x-www-form-urlencoded posts. The benefit of the encoding is that binary files, such as
those containing the picture images captured in conjunction with the alert, can be delivered along with
the textual attributes of the alert.
The additional parameters for the picture alert notifications include:
Periodic Sensor Data Parameter Definitions
The NetBotz device can be configured to periodically deliver its sensor data and notification attributes to
a Web server through an HTTP post or to use FTP to deliver the sensor data to a server in a data file. The
parameters provided in sensor notifications include the Common Parameters plus the additional
parameters described below:
Parameter Name Parameter Definition
NUMBEROFPICS The integer representing the number of picture files included with the alert. The
attributes of the pictures are encoded with an index n, where n is from 0 to the
number of pictures minus one.
MSECPERPIC The integer representation of the number of milliseconds between each of the
pictures captured for the alert. This attribute is only defined if more than one picture
was delivered.
ALERTPPIC_n The binary encoding of the nth picture attached to the alert. The filename of the
attribute will be campic<n+1>.jpg or campic<n+1>.png, depending on the
Content-Type of the picture. The Content-Type can be image/jpeg or image/png.
The image length is currently limited to 64K, but may be increased in future
products.
ALERTPICTIME_n The UTC time on the NetBotz device (number of seconds since 12:00am GMT 1/1/
1970), represented as a decimal number (i.e. 9812384523), of when the picture was
captured.
Parameter Name Parameter Definition
SECONDSUNTILNEXTPOST The number of seconds before the NetBotz device plans to
generate its next sensor data notification. This can be
potentially used to detect device failure (due to the
absence of the planned sensor notification).