WavIoT — беспроводная система учета ресурсов

API модуля gateway

ID статьи: 52
Последнее обновление: 26 May, 2020

API - методы модуля gateway

Модуль gateway выполняет функции NB-Fi базовой станции. Данный HTTP API-интерфейс предоставляет доступ к  модулю gateway для администрирования и мониторинга базовой станции. Данные методы доступны как при подключении непосредственно к сетевому интерфейсу БС, так и на API – сервере http://api.waviot.ru

Таблица 1. Сводная таблица всех API методов модуля gateway

Описание

URL

Метод

Требует авторизацию, роль

Чтение номера БС

/gateway/localid

GET

да, guest

Чтение списка параметров БС

/gateway/read_params

GET

да, guest

Изменение параметров БС

/gateway/write_params

GET

да, admin

Конфигурирование GPS

/gateway/gps

GET

да, admin

Конфигурирование часов

/gateway/time

GET

да, admin

Чтение списка UL и DL пакетов БС

/gateway/messages

GET

да, guest

Чтение списка ошибок БС

/gateway/alarms

GET

да, guest

Конфигурирование настроек подключения TCP/IP

/gateway/network

GET

да, admin

Перезагрузка БС

/gateway/reboot

GET

да, admin

Чтение номера БС

Чтение номера базовой станции.

Запрос:

URL

Список параметров

Пример запроса

/gateway/localid

/gateway/localid

Ответ:

BODY

{ "id": 9450}

Чтение списка параметров БС

Чтение всех значений параметров БС, включая последний хартбит, содержащий текущее состояние базовой станции  

Запрос:

URL

Список параметров

Пример запроса

/gateway/read_params

id

/gateway/read_params?id=9450

Ответ:

BODY

{

  "auto_correction": true,

  "bs_id": 8604,

  "dl_freq": 446000000,

  "dl_freq2": 864000000,

  "dl_freqs": "446000000,864000000",

  "ext_filter": false,

  "freq_plans": "0",

  "if_freq": 137500000,

  "if_freq2": 137909600,

  "last_hb": {

    "bs_id": 8604,

    "bs_revisions": {

      "ax_rev": "ax.6",

      "bswin_rev": "3.1.1",

      "fpga_rev": 748,

      "hw_rev": "3.1"

    },

    "bs_state": 15,

    "bs_type": "BS3",

    "fpga_temperature": 96.87890625,

    "latitude": 56.414027,

    "longitude": 37.543765,

    "mode": "USPD",

    "msg_type": "beat_nbfi_e",

    "receiver": {

      "bands": [

        {

          "noise": -152.3894805908203,

          "ul_bitrates": [

            20,

            23,

            21,

            24,

            26,

            28,

            30,

            31,

            32,

            33

          ],

          "ul_freq_plan": 384

        }

      ],

      "enabled": true,

      "ul_base_freqs": [

        868800000

      ]

    },

    "stats": [

      {

        "aver_noise": -151,

        "dl_aver_power": 23,

        "dl_modems_total": 11,

        "dl_total": 297,

        "period": 60,

        "ts": 1590484541,

        "ul_aver_rssi": -91,

        "ul_modems_total": 18,

        "ul_total": 136

      }

    ],

    "temperature": 76,

    "time_published": 1590484556,

    "transmitter": {

      "bands": [

        {

          "dl_bitrates": [

            0,

            1,

            2,

            3,

            10,

            11,

            12,

            13

          ],

          "dl_freq_plan": 0

        }

      ],

      "busyness": 63.34394073486328,

      "busyness_aver": 49.61235809326172,

      "dl_base_freqs": [

        446000000,

        864000000

      ],

      "enabled": true,

      "lbt": false,

      "max_duty_cycle": 100,

      "max_power": 26

    },

    "version": 1

  },

  "lbt": false,

  "logoffset": 220,

  "max_duty_cycle": 100,

  "max_power": 26,

  "mode": "USPD",

  "nbfi_time_sync": true,

  "one_sec_pulse_tester": false,

  "result": true,

  "send_dl": true,

  "ul_freq": 868800000

}

Изменение параметров БС

Изменение значений параметров БС 

Запрос:

URL

Список параметров

Пример запроса

/gateway/write_params

id, ul_freq, ul_freq2, dl_freqs, ext_filter, meslog_ttl, mode,nbfi_time_sync, send_dl, max_power,max_duty_cycle,lbt

/gateway/write_params?id=9450&ul_freq=868800000&dl_freqs=446000000,869100000

Ответ:

BODY

{

  "result": true

}

Описание параметров БС 

Имя параметра

Тип

Описание

Значение по умолчанию

id

int

номер БС

обязательный параметр

ul_freq

int

базовая частота приема (диапазон 1), Гц

нет

ul_freq2

int

базовая частота приема (диапазон 2), Гц

нет

dl_freqs

int,int,...

базовые частоты передачи, Гц

нет

ext_filter

bool

вкл/выкл внешний приемный фильтр

нет

meslog_ttl

int

время жизни лога UL и DL пакетов в локальном логе пакетов, сек

нет

mode

string

режим работы – текстовый параметр, сохраняемый в файле конфигурации БС

нет

nbfi_time_sync

bool

вкл/выкл синхонизацию системного времени от NB-Fi сервера

нет

send_dl

bool

вкл/выкл передающий радиоканал

нет

max_power int

максимальный уровень выходного радиосигнала передатчика, дБм 

нет

max_duty_cycle int максимальное значение скважности передачи, %  нет
lbt bool вкл/выкл режим LBT нет

Конфигурирование GPS

Чтение координат GPS 

Запрос:

URL

Список параметров

Пример запроса

/gateway/gps

id

/gateway/gps?id=9450

Ответ:

BODY

{

  "latitude": 56.414298,

  "longitude": 37.543753,

  "ntp": true,

  "result": true

}

Изменение значений параметров GPS 

Запрос:

URL

Список параметров

Пример запроса

/gateway/gps

id,  ntp

/gateway/gps?id=9450&ntp=true

Ответ:

BODY

{

  "result": true

}

Описание параметров GPS 

Имя параметра

Тип

Описание

Значение по умолчанию

id

int

номер БС

обязательный параметр

ntp

bool

вкл/выкл синхронизацию времени от GPS

нет

Конфигурирование часов

Чтение текущего времени 

Запрос:

URL

Список параметров

Пример запроса

/gateway/time

id

/gateway/time?id=9450

Ответ:

BODY

{

  "result": true,

  "timestamp": 1544609726

}

Установка текущего времени 

Запрос:

URL

Список параметров

Пример запроса

/gateway/time

id,  utc

/gateway/time?id=9450&utc=1544609726

Ответ:

BODY

{

  "result": true

}

Включение или отключение системной синхронизации времени

Запрос:

URL

Список параметров

Пример запроса

/gateway/time

id,  ntp

/gateway/time?id=9450&ntp=false

Ответ:

BODY

{

  "result": true

}

Чтение списка UL и DL пакетов БС

Позволяет получить список всех пакетов, принятых и отправленных базовой станцией за последние

meslog_ttl секунд.

Запрос:

URL

Список параметров

Пример запроса

/gateway/messages

id, from, to, ids, types, limit

/gateway/messages?id=9450&ids=7520047&types=0,1&limit=3

Ответ:

BODY

[

  {

    "freq": 868822400,

    "iterator": 25,

    "modem_id": 7520047,

    "offset": 900,

    "payload": "E07DFB594AA5067B",

    "phy": "UL_DBPSK_3200_PROT_D",

    "rssi_or_pwr": -79,

    "snr": 59,

    "time_saved": 1544620282429,

    "type": "UL"

  },

  {

    "freq": 868790400,

    "iterator": 24,

    "modem_id": 7520047,

    "offset": 700,

    "payload": "C0F683B9B904716D",

    "phy": "UL_DBPSK_3200_PROT_D",

    "rssi_or_pwr": -76,

    "snr": 59,

    "time_saved": 1544620281111,

    "type": "UL"

  },

  {

    "freq": 446054556,

    "iterator": 24,

    "modem_id": 7520047,

    "offset": 0,

    "payload": "72372DFA7956257FB412",

    "phy": "DL_PSK_FASTDL",

    "rssi_or_pwr": 26,

    "snr": 0,

    "time_saved": 1544620280855,

    "type": "DL"

  }

]

Описание параметров запроса 

Имя параметра

Тип

Описание

Значение по умолчанию

id

int

номер БС

обязательный параметр

from

int

таймстамп времени начала данных

0

to

int

таймстамп времени окончания данных

текущее время

ids

int,int

список номеров устройств (разделитель запятая)

все номера

types

int,int

список типов пакетов (разделитель запятая), 0 – UL, 1- DL

все типы

limit

int

ограничение количества пакетов

1000

Чтение списка ошибок БС

Позволяет получить лог ошибок базовой станции.

Запрос:

URL

Список параметров

Пример запроса

/gateway/alarms

id, from, to, limit, clear

/gateway/alarms?id=9450&ids=7520047&limit=3

Ответ:

BODY

[

  {

    "alarm_code": 3,

    "alarm_text": "Gateway state changed: from 13 to 15",

    "id": 283,

    "time_saved": 1544605471654,

    "value": 15.013

  },

  {

    "alarm_code": 3,

    "alarm_text": "Gateway state changed: from 15 to 13",

    "id": 282,

    "time_saved": 1544605261710,

    "value": 13.015

  },

  {

    "alarm_code": 3,

    "alarm_text": "Gateway state changed: from 13 to 15",

    "id": 281,

    "time_saved": 1544533171659,

    "value": 15.013

  },

  {

    "alarm_code": 3,

    "alarm_text": "Gateway state changed: from 5 to 13",

    "id": 280,

    "time_saved": 1544533141669,

    "value": 13.005

  },

  {

    "alarm_code": 5,

    "alarm_text": "Connected to server",

    "id": 279,

    "time_saved": 1544533087683

  }

]

Описание параметров запроса 

Имя параметра

Тип

Описание

Значение по умолчанию

id

int

номер БС

обязательный параметр

from

int

таймстамп времени начала данных

0

to

int

таймстамп времени окончания данных

текущее время

limit

int

ограничение количества пакетов

1000

clear

bool

true  - очистить лог ошибок

false

Конфигурирование настроек подключения TCP/IP

Чтение текущих настроек

Запрос:

URL

Список параметров

Пример запроса

/gateway/network

id

/gateway/network?id=9450

Ответ:

BODY

{

  "address": "192.168.0.144",

  "gateway": "192.168.0.255",

  "iface": "static",

  "netmask": "255.255.255.0",

  "result": true

}

Изменение настроек подключения

Запрос:

URL

Список параметров

Пример запроса

/gateway/network

id, iface, address, gateway, netmask

/gateway/network?id=9450 &iface=static&address=192.168.0.144&gateway=192.168.0.255&netmask=255.255.255.0

Ответ:

BODY

{

  "result": true

}

Описание параметров запроса 

Имя параметра

Тип

Описание

Значение по умолчанию

id

int

номер БС

обязательный параметр

iface

string

dhcp либо static

обязательный параметр

address

string

IP адрес БС

старое значение

gateway

string

IP адрес шлюза по умолчанию

старое значение

netmask

string

маска подсети

старое значение

Перезагрузка БС

Запрос:

URL

Список параметров

Пример запроса

/gateway/reboot

id

/gateway/reboot?id=9450

Ответ:

BODY

{

  "result": true

}

Эта статья была:   Полезна | Не полезна
Сообщить об ошибке
ID статьи: 52
Последнее обновление: 26 May, 2020
Ревизия: 12
Просмотры: 329
Комментарии: 0
Опубликовано: 13 Dec, 2018 от Batura D.
Обновлено: 26 May, 2020 от Batura D.