9. [DKSF 564.1] Поддержка HTTP API

HTTP API

Команда

Вызов

Ответ

Примечание

Реле

Запрос состояния реле

/relay.cgi?rN

Где:

N — номер реле

relay_result('error');

relay_result('ok', 2, 1);

первый аргумент всегда 'ok'

второй аргумент — состояние реле

третий аргумент — моментальное состояние реле

Управление реле

/relay.cgi?rN=S

Где:

N — номер реле

S  — новое состояние реле (1 - включено, 0 - выключено)

relay_result('ok')

relay_result('error')

Переключение реле в инверсное состояние

/relay.cgi?rN=f

Где:

N — номер реле

f — команда переключения

relay_result('ok')

relay_result('error')

Ресет, переключение реле в инверсное состояние на время

/relay.cgi?rN=f,10

Где:

N — номер реле

f — команда переключения

10 — время переключения в секундах

relay_result('ok')

relay_result('error')

Линии дискретного входа

Запрос состояния линии

/io.cgi?ioN

Где:

N — номер линии

io_result('error')

io_result('ok', -1, 1, 339)

Первый аргумент: всегда 'ok' (при ошибке запроса — 'error').

Второй аргумент: всегда «-1», для расширения API в будущем.

Третий аргумент: текущее моментальное состояние IO-линии, включая состояние сброса.

Четвертый аргумент: счетчик импульсов на данной IO-линии, считается по фронту.

Запрос состояния всех линий

/io.cgi?io

io_result('error')

io_result('ok', 15);

Первый аргумент: всегда 'ok' (при ошибке запроса — 'error').

Второй аргумент: бит-карта состояния линий.

Бит-карта (представлена в десятичном формате):

бит 0 = линия 1

бит 1 = линия 2

бит 2 = линия 3

бит 3 = линия 4

Например:

00000000 — 0 (все линии в лог.0)

00000111 — 7 (на линии 4 лог.0, на остальных - лог.1)

Термодатчики

Запрос состояния датчика

/thermo.cgi?tN

Где:

N — номер датчика

thermo_result('error')

thermo_result('ok', 36, 2);

Первый аргумент: всегда 'ok' (при ошибке запроса — 'error').

Второй аргумент: текущая температура.

Третий аргумент: статус датчика.

0 — датчик не подключен или сбоит;

1 — температура ниже нормы;

2 — температура в норме;

3 — температура выше нормы.

Датчики влажности

Запрос влажности

/relhum.cgi?hN

Где:

N — номер датчика

relhum_result('error')

relhum_result('ok', 55, 2)

Первый аргумент: всегда 'ok'.

Второй аргумент: относительная влажность, %.

Третий аргумент: статус датчика.

0 — датчик не подключен или сбоит;

1 — влажность ниже нормы;

2 — влажность в норме;

3 — влажность выше нормы.

Запрос температуры

/relhum.cgi?tN

Где:

N — номер датчика

relhum_result('error')

relhum_result('ok', 25, 2)

Первый аргумент: всегда 'ok'.

Второй аргумент: температура, °C.

Третий аргумент: статус датчика.

0 — датчик не подключен или сбоит;

1 — температура ниже нормы;

2 — температура в норме;

3 — температура выше нормы.