Analog I/O

Analog inputs allow the PLC to read variable values from sensors, such as temperature, pressure, or flow, by converting physical measurements into electrical signals, typically in the form of voltage (e.g., 0-10V) or current (e.g., 4-20mA). Conversely, analog outputs enable the PLC to control devices like motors, valves, or actuators by sending continuous electrical signals to adjust their operation with precision. These I/O channels are crucial for processes that require more than simple on/off control, providing fine-tuned adjustments to optimize performance in dynamic environments. Analog I/O API provides interface for controlling all analog inputs and outputs on your controller.

API Reference

List All Analog Inputs

get

Responses

200

Successful Response

application/json

devstringRequired

circuitstringRequired

modestring · enumOptionalDefault: VoltagePossible values:

get

/controller/ai

HTTPcURLJavaScriptPython

GET /controller/ai HTTP/1.1
Host: localhost:8080
Accept: */*

200

Successful Response

[
  {
    "dev": "text",
    "circuit": "text",
    "modes": {
      "ANY_ADDITIONAL_PROPERTY": {
        "value": 1,
        "unit": "text",
        "range": []
      }
    },
    "mode": "Voltage"
  }
]

Get Analog Input

get

Path parameters

circuitstringRequired

Responses

200

Successful Response

application/json

devstringRequired

circuitstringRequired

modestring · enumOptionalDefault: VoltagePossible values:

422

Validation Error

application/json

get

/controller/ai/{circuit}

HTTPcURLJavaScriptPython

GET /controller/ai/{circuit} HTTP/1.1
Host: localhost:8080
Accept: */*

{
  "dev": "text",
  "circuit": "text",
  "modes": {
    "ANY_ADDITIONAL_PROPERTY": {
      "value": 1,
      "unit": "text",
      "range": []
    }
  },
  "mode": "Voltage"
}

Set Analog Input

post

Path parameters

circuitstringRequired

Body

application/json

modestring · enumOptionalDefault: VoltagePossible values:

Responses

200

Successful Response

application/json

devstringRequired

circuitstringRequired

modestring · enumOptionalDefault: VoltagePossible values:

422

Validation Error

application/json

post

/controller/ai/{circuit}

HTTPcURLJavaScriptPython

POST /controller/ai/{circuit} HTTP/1.1
Host: localhost:8080
Content-Type: application/json
Accept: */*
Content-Length: 18

{
  "mode": "Voltage"
}

{
  "dev": "text",
  "circuit": "text",
  "modes": {
    "ANY_ADDITIONAL_PROPERTY": {
      "value": 1,
      "unit": "text",
      "range": []
    }
  },
  "mode": "Voltage"
}

Set All Analog Inputs

post

Body

application/json

modestring · enumOptionalDefault: VoltagePossible values:

Responses

200

Successful Response

application/json

devstringRequired

circuitstringRequired

modestring · enumOptionalDefault: VoltagePossible values:

422

Validation Error

application/json

post

/controller/ai

HTTPcURLJavaScriptPython

POST /controller/ai HTTP/1.1
Host: localhost:8080
Content-Type: application/json
Accept: */*
Content-Length: 18

{
  "mode": "Voltage"
}

[
  {
    "dev": "text",
    "circuit": "text",
    "modes": {
      "ANY_ADDITIONAL_PROPERTY": {
        "value": 1,
        "unit": "text",
        "range": []
      }
    },
    "mode": "Voltage"
  }
]

List All Analog Outputs

get

Responses

200

Successful Response

application/json

devstringRequired

circuitstringRequired

valuenumberRequired

modestring · enumOptionalDefault: VoltagePossible values:

get

/controller/ao

HTTPcURLJavaScriptPython

GET /controller/ao HTTP/1.1
Host: localhost:8080
Accept: */*

200

Successful Response

[
  {
    "dev": "text",
    "circuit": "text",
    "modes": {
      "ANY_ADDITIONAL_PROPERTY": {
        "value": 1,
        "unit": "text",
        "range": []
      }
    },
    "value": 1,
    "mode": "Voltage"
  }
]

Get Analog Output

get

Path parameters

circuitstringRequired

Responses

200

Successful Response

application/json

devstringRequired

circuitstringRequired

valuenumberRequired

modestring · enumOptionalDefault: VoltagePossible values:

422

Validation Error

application/json

get

/controller/ao/{circuit}

HTTPcURLJavaScriptPython

GET /controller/ao/{circuit} HTTP/1.1
Host: localhost:8080
Accept: */*

{
  "dev": "text",
  "circuit": "text",
  "modes": {
    "ANY_ADDITIONAL_PROPERTY": {
      "value": 1,
      "unit": "text",
      "range": []
    }
  },
  "value": 1,
  "mode": "Voltage"
}

Set Analog Output

post

Path parameters

circuitstringRequired

Body

application/json

valuenumberRequired

modestring · enumOptionalDefault: VoltagePossible values:

Responses

200

Successful Response

application/json

devstringRequired

circuitstringRequired

valuenumberRequired

modestring · enumOptionalDefault: VoltagePossible values:

422

Validation Error

application/json

post

/controller/ao/{circuit}

HTTPcURLJavaScriptPython

POST /controller/ao/{circuit} HTTP/1.1
Host: localhost:8080
Content-Type: application/json
Accept: */*
Content-Length: 28

{
  "value": 1,
  "mode": "Voltage"
}

{
  "dev": "text",
  "circuit": "text",
  "modes": {
    "ANY_ADDITIONAL_PROPERTY": {
      "value": 1,
      "unit": "text",
      "range": []
    }
  },
  "value": 1,
  "mode": "Voltage"
}

Set All Analog Outputs

post

Body

application/json

valuenumberRequired

modestring · enumOptionalDefault: VoltagePossible values:

Responses

200

Successful Response

application/json

devstringRequired

circuitstringRequired

valuenumberRequired

modestring · enumOptionalDefault: VoltagePossible values:

422

Validation Error

application/json

post

/controller/ao

HTTPcURLJavaScriptPython

POST /controller/ao HTTP/1.1
Host: localhost:8080
Content-Type: application/json
Accept: */*
Content-Length: 28

{
  "value": 1,
  "mode": "Voltage"
}

[
  {
    "dev": "text",
    "circuit": "text",
    "modes": {
      "ANY_ADDITIONAL_PROPERTY": {
        "value": 1,
        "unit": "text",
        "range": []
      }
    },
    "value": 1,
    "mode": "Voltage"
  }
]