Системные настройки

Установка стартовой страницы

Для установки стартовой страницы необходимо вызвать функцию со следующей сигнатурой:

await window.asm.setStartupPage(page)

Где, page - строка с адресом веб-ресурса для загрузки веб-страницы.

Пример установки стартовой страницы:

// Объявление адреса ресурса для загрузки страницы
const page = "https://startup.page"

// Установка стартовой страницы
await window.asm.setStartupPage(page)

Помимо доступа на уровне браузерных скриптов существует возможность изменения стартовой страницы посредвом вызова HTTP API.

В качестве примера использования такой возможности приведен пример производства POST-запроса с помощью утилиты curl:

# Сделать стартовой страницу google.com
curl -d '{"url":"https://google.com"}' -H "Content-Type: application/json" -X POST http://asmhost:9009/startupPage

Переключение панели Dev-Tools

Возможность вызова панели Dev-Tools браузера осуществляется посредством HTTP API.

В качестве примера использования такой возможности приведен пример производства POST-запроса с помощью утилиты curl:

# Открыть панель
curl -d '{"open":true}' -H "Content-Type: application/json" -X POST http://asmhost:9009/devTools

# Закрыть панель
curl -d '{"open":false}' -H "Content-Type: application/json" -X POST http://asmhost:9009/devTools

Установка статического IP-адреса

Для установки статического IP-адреса для сетевого интерфейса устройства необходимо вызвать функцию со следующей сигнатурой:

await window.asm.setStaticIp(staticIP)

Где, staticIP - объект-структура, характеризующий параметры сетевого интерфейса. Для получения объекта необходимо вызвать фукнцию со следующей сигнатурой:

const staticIP = await window.asm.newStaticIp(ip, mask, broadcast, gateway)

Где, ip ,с типом string, характеризует IP-адрес, который будет установлен в качестве статического; mask, с типом string, характеризует маску подсети; broadcast, с типом string, характеризует широковещательный адрес; gateway, с типом string, характеризует адрес сетевого шлюза.

Пример установки статического IP-адреса:

// IP-адрес
const ip = "192.168.1.10"

// Маска
const mask = "255.255.255.0"

// Широковещательный адрес
const broadcast = "192.168.1.255"

// Адрес шлюза
const gateway = "192.168.1.254"

// Получение структуры параметров сетевого интерфейса
const staticIP = window.asm.newStaticIp(ip, mask, broadcast, gateway)

// Установка стартовой страницы
await window.asm.setStaticIp(staticIP)

Установка динамического IP-адреса

Для установки динамического IP-адреса для сетевого интерфейса устройства необходимо вызвать функцию со следующей сигнатурой:

await window.asm.setDynamicIP()

Так как функция не имеет параметров и возвращаемых значений, в качестве примера возможно использование вышеприведенное описание её сигнатуры.

Получение текущей конфигурации сетевого интерфейса

Для получения текущей конфигурации сетевого интерфейса устройства необходимо вызвать функцию со следующей сигнатурой:

const conf = await window.asm.getNetconf()

Где, conf - объект-структура конфигурации сетевого интерфейса, который имеет поля:

  • hostname с типом string. Характеризует имя хоста,
  • ip с типом string. Характеризует IP-адрес,
  • mask с типом string. Характеризует маску подсети,
  • gateway с типом string. Характеризует адрес шлюза,
  • broadcast с типом string. Характеризует широковещательный адрес,
  • ipv6 с типом string. Характеризует IPv6-адрес,
  • prefixlenv6 с типом string. Характеризует длину IPv6-адреса,
  • gatewayv6 с типом string. Характеризует адрес IPv6-шлюза,
  • mac с типом string. Характеризует MAC-адрес,
  • dhcp с типом boolean. Положительное значение говорит о том, что сетевой интерфес получает IP-адрес динамически,

Так как функция не имеет параметров, в качестве примера возможно использование вышеприведенное описание её сигнатуры.

Получение заводского серийного номера

Для получение заводского серийного номера устройства, который является уникальным идентификатором устройства, необходимо вызвать функцию со следующей сигнатурой:

const serialNumber = await window.asm.getSerialNumber()

Где, serialNumber - объект-структура, содержащей поле value ,с типом string, который характеризует серийный номер.

Так как функция не имеет параметров, в качестве примера возможно использование вышеприведенное описание её сигнатуры.