Setting alarm action for vn-e4, Api for acquiring/changing parameters of vn-e4, Alarm setting – JVC 4ch Network Encoder VN-E4 User Manual

Page 29

Advertising
background image

29

5. API for Acquiring/Changing Parameters of VN-E4 _

5.4. Alarm Setting

Interpretation

Acquire the alarm action of the specified alarm number. Up to 10 alarm actions can be specified, and therefore
the number of alarm(number) can also be set between the range of 1 to 10. Note that alarm numbers are
different from the alarm input pin numbers. A separate API (/api/param?application.event(Number).status) is
used to acquire the on/off status of the alarm action.
When sending via mail is specified, mailto, mail address, none and the character string to be sent will be
returned. When spaces are included in the character string, the character string with spaces will be returned.
Segments are indicated by /. none is an auxiliary item intended for future extensions.

Example of Response

application.event(1).action=mailto/[email protected]/none/

Message&200 OK

When sending via FTP is specified, ftpto, FTP number, and the attached object number will be returned. The
FTP number is fixed as ftp01 at all times. An object number may be specified between object01 to object04.

Example of Response

application.event(1).action=ftpto/ftp01/object01&200 OK

When sending via TCP is specified, tcpto, IP address, port number and the character string to be sent will be
returned. Segments are indicated by /.

Example of Response

application.event(1).action=tcpto/10.0.0.100/20000/Message&200 OK

When sending via UDP is specified, udpto, IP address, port number and the character string to be sent will be
returned. Segments are indicated by /.

Example of Response

application.event(1).action=udpto/10.0.0.100/20000/Message&200 OK

When alarm output is specified, pinout, distinction between make/break (m1 or b1) and the time (millisecond)
will be returned. Segments are indicated by /.

Example of Response

application.event(1).action=pinout/m1/1500&200 OK

Allowed users

admin, operator

Setting Alarm Action for VN-E4

Format

/api/param?application.event(Number).action=Data

Example

When setting action of Alarm No. 1

/api/param?application.event(1).action=mailto/[email protected]/

none/Message

Example of Response

application.event(1).action&200 OK

Interpretation

Set the alarm action of the specified alarm number. Up to 10 alarm actions can be specified, and therefore the
number of alarm(number) can also be set between the range of 1 to 10. Note that alarm numbers are different
from the alarm input pin numbers. A separate API (/api/param?application.event(Number).status=off) is used
to set the alarm action to off.
The action will be activated by setting the alarm trigger. The API for setting the alarm trigger is /api/
param?application.event(Number).trigger.
Specify mailto, mail address, none and the character string to be sent when sending via mail. Segments are
indicated by /. The maximum number of characters for the mail address is 60. none is reserved for future
extensions. The upper limit of the character string to be sent is 40 bytes. Specify using the 3 characters %20
when inserting a space in the character string. For example, to send the character string "This is alarm.",
specify as "This%20is%20alarm.".

Setting Example

/api/param?application.event(1).action=mailto/[email protected]/

none/Alarm%20ON

The character string "Alarm from VN-E4: No. 1" will be stored in the title field of the mail. The last number
denotes the event number.
Specify ftpto, FTP number and the object when sending via FTP. The FTP number is fixed as ftp01 at all times.
An object can be specified between object01 to object08, which denotes the type of JPEG to be sent. Details of
object are described in another page, AAcquiring JPEG Parameters Added to FTP from VN-E4B. Ensure to set

the FTP server (/api/param?application.ftp.host, etc.) before setting to FTP transmission. Only one alarm
action can be set to FTP. After one alarm aciotn is set to FTP, no other actions can be set to FTP.

Setting Example

/api/param?application.event(1).action=ftpto/ftp01/object01

Specify tcpto, IP address, port number and the character string to be sent when sending via TCP. Segments are
indicated by /. The upper limit of the character string to be sent is 40 bytes. Specify using the 3 characters %20
when inserting a space in the character string. For example, to send the character string "This is alarm.",
specify as "This%20is%20alarm.".

Advertising