Axis Network IO Read

Read a virtual IO port on an Axis device (or one that otherwise supports VAPIX).

Overview

The Axis Network IO Read node reads data from an Axis device over the network. This node makes it easy to build common use cases such as reading sensor data, triggering alarms, etc.

Inputs & Outputs

  • Inputs : 1, Media Format : Raw Video
  • Outputs : 1, Media Format: Raw Video
  • Output Metadata : Axis IO Port Status

Properties

PropertyDescriptionTypeDefaultRequired
vapix_virtual_io_portComma separated Digital IO port numbers to read. Refer to your device's documentation for supported IO port listing.stringnullYes
metadata_nameCustomizable name for the values read from the specified ports. This will be accessible in downstream metadata, with 'delta' and 'state' fields. Alphanumeric characters and underscores only.stringnullNo
ip_addressIP address of the VAPIX device.stringnullYes
vapix_usernameVAPIX authentication usernamestringnullYes
vapix_passwordVAPIX authentication passwordstringnullYes
use_httpsWhether to use a secure HTTPS connection for the VAPIX request.boolfalseNo
insecureWhether the TLS certificate used for the HTTPS connection should be verified. Conditional on use_https being true.boolfalseNo
reconfigure_portsIf true, reconfigure the specified Digital IO ports to be Inputs.boolfalseNo
input_typeInput type. Options: Active Closed (closed); Active Open (open).enumclosedYes
debugDebugboolfalseNo

Note: Virtual IO port and Digital IO port are not network ports. They refer to digital IO interfaces on the Axis device.

Output Metadata

The fields below are declared by this node's metadata schema; the JSON values are representative examples.

PathTypeDescription
nodes.<node_id>.all_pin_deltabooleanWhen all pins have a change in state
nodes.<node_id>.all_pin_statebooleanBoolean indicating whether all configured input pins are active.
nodes.<node_id>.any_pin_deltabooleanWhen any pin has a change in state
nodes.<node_id>.any_pin_statebooleanBoolean indicating whether any configured input pin is active.
nodes.<node_id>.pins.<pin_number>.deltaintegerWhen the specified pin has a change in state
nodes.<node_id>.pins.<pin_number>.stateintegerCurrent numeric state reported for this input pin.
nodes.<node_id>.typestringIdentifies the node type that produced this metadata.

JSON example

{
  "nodes": {
    "axis_network_io_read1": {
      "all_pin_delta": false,
      "all_pin_state": false,
      "any_pin_delta": false,
      "any_pin_state": false,
      "pins": {
        "pin_number": {
          "delta": 0,
          "state": 0
        }
      },
      "type": "axis_network_io_read"
    }
  }
}

Did this page help you?