11. [DKST 57.02] Поддержка HTTP API

HTTP API

Команда

Вызов

Ответ

Примечание

Реле

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

/relay.cgi?rN

N — номер реле

relay_result('error');

relay_result('ok', 2, 1);

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

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

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

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

/relay.cgi?rN=S

N — номер реле (1-4)

S — режим работы (1 — вкл., 0 — выкл.)

relay_result('ok')

relay_result('error')

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

/relay.cgi?rN=f

N — номер реле (1-4)

F—  инверсионное состояние

relay_result('ok')

relay_result('error')

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

/relay.cgi?rN=f,10

N — номер реле (1-4)

F—  инверсионное состояние

relay_result('ok')

relay_result('error')

Линии Input и Output

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

/io.cgi?ioN

N — номер линии (1-16 Input, 17-20 Output)

io_result('error')

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

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

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

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

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

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

/io.cgi?io

io_result('error')

io_result('ok', 246);

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

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

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

бит 0 = линия 1

бит 1 = линия 2

...

бит 7 = линия 8

Например:

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

11100111 — 231 (4 и 5 линии в лог.0, остальные в лог.1)

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

/io.cgi?ioN=S

N — номер линии (17-20 Output)

S — режим работы (1 — вкл., 0 — выкл.)

io_result('error')

io_result('ok')

Ресет, переключение линии в инверсное состояние на время в режиме «выход»

/io.cgi?ioN=f,T

N — номер линии (17-20 Output)

T — время переключения в с.

io_result('error')

io_result('ok')

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

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

/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 — температура выше нормы.