= Шина StampLine - руководство и диагностика  =


Шина StampLine построена на базе линии RS485 с расширенным протоколом Modbus и является универсальной шиной для подключения периферийных устройств как в системах МультиХаб, так и к отдельным контроллерам (snail, rvm и т.д.)


Подключение устройств возможно следующими способами:
 * К шине напрямую (octopus)
 * Напрямую к мастер-контроллеру (snail, rvm и т.д.)
 * К компьютеру через шлюз eth485
 * К компьютеру через мастер-контроллер в режиме прокси.


Адресация устройств:
 * При подключении через octopus адрес имеет вид "serial:<порт>:<адрес устройства>", где порт: /dev/sl0
 * При подключении через шлюз eth485 адрес имеет вид "udp:<ip-адрес>:<порт>:<адрес устройства>", где порт: 5060/5061 - первый/второй каналы соответственно.
 * При подключение через прокси адрес имеет вид "proxy:<адрес устройства>"

== Утилита testpoint ==

Утилита testpoint используется для диагностики устройств на шине и обновлении ПО.
При использовании прокси утилита может быть интегрирована в вышестоящее приложение (например, protodemo).

== Получение информации и обновление ПО == 


Утилита опрашивает устройство по адресу, определяет его тип и позволяет провести операции с устройством в зависимости от его типа.



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

{{{
testpoint.exe udp:192.168.0.100:5060:20
}}}

Результат отобразит тип устройства, версию протокола и прошивки.
{{{
Device responded: device type = IOPoint [4], protocol version = 3, version = 1.7
}}}


Для обновления ПО необходимо выполнить:

{{{
testpoint.exe udp:192.168.0.100:5060:20 upgrade main.bin
}}}

Где main.bin - путь к файлу прошивки.

Аналогично для устройств octopus:

{{{
testpoint serial:/dev/sl0:20 upgrade main.bin
}}}


Для устройств на octopus с одним выходом StampLine можно не указывать полностью адрес вида serial:/dev/sl0:20, можно указывать только адрес самого устройства Интранет:

{{{
testpoint 20 upgrade main.bin
}}}






Устройства шины StampLine, поддерживающие загрузку обновления, имеют специальную программу - загрузчик. При попытке обновить ПО контроллер перезагружается в режим загрузчика и работает уже по адресу загрузчика - 254.
Если при обновлении ПО произошел сбой (обновление прервано), то необходимо повторить обновление уже по адресу загрузчика (254), например:

{{{
testpoint.exe udp:192.168.0.100:5060:254 upgrade main.bin
}}}


''' Важно! Если в сети окажутся несколько устройств в режиме загрузчика (адрес 254), то обновление будет невозможно, потребуется физическое отключение устройства от сети для исключения конфликта.


== Диагностика устройств с использованием утилиты testpoint ==



== IOPoint (версия < 3) ==

Адрес устройства по-умолчанию: 20

Для включения каналов в релейном режиме использовать дополнительные опции relay set <номер канала>, например

{{{
testpoint.exe serial:COM1:20 relay set 5
}}}


Для включения каналов в диммируемом режиме использовать дополнительные опции dimmer set <уровень канала 1> <уровень канала 2> ..., например

{{{
testpoint.exe serial:COM1:20 dimmer set 50 20 30
}}}

== IOPoint (версия >= 3) ==

Адрес устройства по-умолчанию: 20

Для включения каналов в релейном/диммируемом режиме использовать дополнительные опции set <значение канала 1>  <значение канала 2> ..., например команда установит значение первых трех каналов 100/100/0

{{{
testpoint.exe serial:COM1:20 set 100 100 0
}}}


Для тестирования можно использовать дополнительные опцию test, например

{{{
testpoint.exe serial:COM1:20 test
}}}

В режиме тестирования утилита будет по кругу последовательно включать все каналы.


== InfoBoard ==

Адрес устройства по-умолчанию: 16

Для установки логотипа на экран использовать дополнительную опцию logo, например:

{{{
testpoint.exe serial:COM1:16 logo
}}}

Для установки текста "Автоматизировано stampsoft.ru" использовать опцию txt, например:

{{{
testpoint.exe serial:COM1:16 txt
}}}

Для тестовой растровой картинки использовать опцию raster, например:

{{{
testpoint.exe serial:COM1:16 raster
}}}

Для теста режима мигания использовать дополнительную опцию blink к указанным выше, например:

{{{
testpoint.exe serial:COM1:16 raster blink
}}}


== Outled ==

Адрес устройства по-умолчанию: 16

Для базовой проверки (рисует 0000 на экране) - запускать без аргументов

{{{
testpoint.exe serial:COM1:16
}}}

Для установки произвольного текста указать текст

{{{
testpoint.exe serial:COM1:16 1234
}}}

Для циклического теста (выводит с секундным периодом 0000, 1111, 2222 и т.д.) использовать параметр test

{{{
testpoint.exe serial:COM1:16 test
}}}

== TouchPoint (+ WavePanel) ==


Адрес устройства по-умолчанию: 30

{{{
testpoint.exe serial:COM1:30
}}}

При нажатии на сенсор будут появляться сообщения вида 

{{{
Event 1 at channel 3
}}}


== Шлюз eth485 ==

Адрес устройства: 255

Шлюзы eth485 отвечают на двух портах (каналах) при обращении по сети ethernet.

{{{
testpoint.exe udp:192.168.1.114:5060:255

или 

testpoint.exe udp:192.168.1.114:5061:255

}}}