Приложение Serial-over-IP (SoI)

Приложение Serial-over-IP (SoI)

Дата релиза:Первоначальная версия (v1.00): 13/4/2009
Последнее обновление (4.30): 28/11/2016
Файлы проекта:Исходный код
Скомпилированный двоичный код для: EM500EV, EM1202EV, EM1000EV, DS1202, DS1000, DS1002, DS1003, DS1010, DS1012, DS1013, EM1000EV+GA1000, DS1000G, DS1002G, DS1003G, DS1010G, DS1010GC, DS1012G, DS1012GC, DS1013G, DS1013GC, EM1206EV, EM1206EV+GA1000, DS1206, DS1206N, DS1100, DS1101, DS1102, TPS3
Версия TIDE Минимум:3.07.76
Версия TiOS Минимум:3.50.04
Версия TDST Минимум:5.07.11
Платформа:EM1000 (DS1000), EM1206, DS1202 (EM1202EV), DS1206 (DS1206N), EM500 (EM500EV)
Может также потребоваться:Device Explorer

О приложении

Знакомство с продукцией Tibbo у многих наших покупателей началось с непрограммируемого сервера устройств (DS203) и модуля (EM203). Данный проект — приложение serial-over-IP (SOI), написанное на событийно-ориентированном языке Tibbo BASIC. Это приложение запускается на программируемых на BASIC устройствах, таких как DS110x (линейка программируемых последовательных контроллеров. Приложение совместимо с нашей готовой прошивкой SOI.

Важные дополнения:

  • поддержка OLED-дисплея для устройств DS1101 и DS1102;
  • поддержка интерфейса Wi-Fi и GPRS с прозрачным переключением между Ethernet, WiFi и GPRS;
  • web-интерфейс администратора — настройка устройств осуществляется через web-браузер;
  • возможность многопортового и мультиканального режима работы.

Важные ограничения функциональности:

  • отсутствует поддержка начальных и стоповых символов со стороны последовательного порта;
  • отсутствует поддержка LinkServer.

Аналогично нашим устройствам с фиксированной прошивкой, приложение SOI работает с набором вспомогательных программ (TDST). У нас также имеется справочник по решениям Serial-over-IP с подробными объяснениями. Представленный на этой странице материал предназначен лишь для получения поверхностного представления, как использовать написанное на Tibbo BASIC приложение SoI. Аналогичным образом мы кратко знакомим читателя с основными понятиями об OLED-дисплее или переключении интерфейсов.

Так, например, мы настроим один последовательный порт для устройства DS1101, чтобы иметь возможность работать с виртуальным последовательным портом VSP ("виртуальной подсистемой COM") на своем компьютере. Существует множество других сценариев использования серверов устройств, о которых мы не рассказываем в этом разделе.

Подготовка DS1101

Устройства DS1101 поставляются с предварительно загруженным SoI-приложением и должным образом проинициализированы. На случай, если на устройстве установлено другое приложение, для его подготовки необходимо выполнить следующее:

  • Загрузите и установите ПО набора вспомогательных программ (TDST) для Windows. Установите последнюю версию, даже если на Вашем ПК уже установлен набор TDST.
  • Загрузите приложение при помощи Device Explorer. Последующие обновления приложения можно выполнить при помощи DS Manager (утилита набора TDST).
  • При первом запуске приложения устройство войдет в режим обработки ошибки. Это означает, что оно требует инициализацию (настройки инициализации хранятся в EEPROM). О режиме обработки ошибок сообщает мигающий светодиод красного свечения. У устройств с дисплеем на экран выводится следующее сообщение:

Обратите внимание: приложение SoI автоматически выключает дисплей по истечении срока ожидания. Для включения дисплея коротко нажмите кнопку MD.

При наличии дисплея:

  • Если дисплей отключен, кратко нажмите кнопку MD для его включения.
  • Когда на экране режим "ERROR MODE" (режим обнаружения ошибки), нажмите и удерживайте кнопку MD до тех пор, пока не увидите сообщение "INIT COMPLETE" (инициализация завершена).
  • Перезагрузите устройство.

При отсутствии дисплея:

  • Нажмите однократно кнопку MD, чтобы ввести режим программирования последовательного устройства (мигают красный и зеленый светодиоды).
  • Нажмите и удерживайте ее для установки исходного состояния.
  • Подождите до тех пор, пока не загорится зеленый светодиод.
  • Выполните перезагрузку, чтобы завершить подготовку (прошивку) устройства.

После перезагрузки вы должны увидеть свое устройство в DS Manager. У подготовленных устройств отключен DHCP, поэтому IP вашего DS1101 будет 1.0.0.1.

Обратите внимание: время от времени у наших пользователей возникают проблемы с брандмауером. Вам, возможно, потребуется отключить брандмауер (или разрешить UDP-трафик через порт 65535) для того, чтобы DS Manager смог увидеть ваше устройство DS1101.

Настройка IP-адреса

  • Найдите ваше устройство DS1101 в списке утилиты DS Manager, щелкните кнопкой мыши по Settings (настройки).
  • Активируйте DHCP или установите нужный IP-адрес.
  • Кнопкой мыши щелкните по OK.
  • Устройство DS1101 перезагрузится с новой конфигурацией IP/DHCP. Можно кликнуть по Refresh (обновить), чтобы увидеть, какой IP-адрес в текущий момент использует устройство DS1101.

Использование административного веб-интерфейса

После того, как всем вашим устройствам присвоены IP-адреса, и Вы их знаете, можно использовать веб-браузер для настройки устройств DS1101. Откройте IP-адрес в браузере. Дальнейшие действия очевидны.

Подсказка: пароля нет, просто щелкните кнопкой мыши по Login. Пароль можно установить потом.

Настройка связи между VSP и DS1101

  • Запустите Мастер подключения Connection Wizard (это утилита Набора Вспомогательных Программ (TDST).
  • На первом экране выберите "Create a link between a Virtual Serial Port and a Device Server" (создать соединение между Виртуальным последовательным портом и Сервером устройств). Кнопкой мыши щелкните по Next.
  • Выберите номер VSP (виртуального COM-порта), которые вы хотите использовать. Например, выберите "Create new VSP" (Создать новый VSP) и выберите COM3 из выпадающего списка (мы исходим из предположения, что COM3 не используется на вашем ПК). Кнопкой мыши щелкните по Next.
  • Укажите сервер устройств. Щелкните кнопкой мыши по Select из списка и дважды щелкните по вашему устройству DS1101 на экране утилиты DS Manager. Больше ничего не меняйте! Щелкните кнопкой мыши по Next.
  • Выберите канал (на DS1101), с которым будет связан VSP на вашем ПК. По завершению щелкните по Next.
  • Выберите, какая сторона (DS1101 или VSP) будут отправлять данные в первую очередь. Есть некоторые тонкости в настройке, но мы на них здесь не будем останавливаться. Вариант "Any side" (любая сторона) беспроигрышный, веберите его и щелкните по Next.
  • Должно появиться окно Gateway and netmask settings (настройки адреса шлюза и маски подсети). Когда устройство DS1101 подключено к одному и тому же сегменту сети с ПК, это окно отображаться не будет. Кнопкой мыши щелкните по Next.
  • Экран Transport protocol and listening ports (транспортный протокол и порты прослушивания). Все, что необходимо, обычно выбирается по умолчанию. Вы будете использовать TCP/IP, и вам не придется задумываться о портах, поскольку все и так будет работать без проблем. Кнопкой мыши щелкните по Next.
  • Экран On-the-fly commands (мгновенные команды). Посредством этих команд выполняется множество операций, однако их самая важная функция — настраивать последовательный канал на устройстве DS1101 согласно требованиям программного обеспечения, которое использует виртуальный COM-порт. Так, например, если приложению требуется 115200bps, оно сообщит об этом (виртуальному) COM-порту, а виртуальный COM-порт отправит мгновенную команду устройству DS1101 переключить назначенный последовательный порт на 115200bps. Именно поэтому не следует изменять выбор в настройках "по умолчанию". Далее щелкните кнопкой мыши по Next.
  • Экран Serial settings for the device server (настройки серийного порта для сервера устройств). Здесь не нужно ничего изменять. Мгновенные команды активированы. Далее выберите Next.
  • Теперь перед вами находится экран со сборной информацией. Можно просмотреть, как будут настроены виртуальный COM-порт и устройство DS1101. Выберите Finish. Работа завершена!

Тестирование связи с VSP-DS1101

Здесь подойдет любое ПО для последовательного порта. Можно воспользоваться нашим многопротокольным сниффером I/O Ninja.

  • Скачайте и установите I/O Ninja.
  • Выберите File > New Session.
  • Выберите Serial и кнопкой мыши щелкните по OK.
  • Выберите свой VSP и кнопкой мыши щелкните по Open Port (иконка с молнией).
  • Теперь I/O Ninja готов к отправке данных на устройство DS1101. Обратите внимание: наше ПО TDST включает в себя утилиту Tibbo Monitor, которую можно найти на панели задач. Утилита Tibbo Monitor ведет журнал активности в виртуальном COM-порту. У вас есть возможность отслеживать все изменения, происходящие при открытии/закрытии порта в I/O Ninja, изменении скорости передачи данных и пр.

Работа с интерфейсами Wi-Fi и GPRS

Наше SOI-приложение позволяет использовать интерфейсы Wi-Fi и GPRS. Исходя из силы сигнала, приложение выбирает лучший среди доступных и активных интерфейсов.

Приоритет всегда остается за Ethernet-интерфейсом. Он остается "активным", пока к устройству подключен кабель Ethernet. Выдерните его, и устройство начнет поиск альтернативных интерфейсов.

Если есть активный Wi-Fi интерфейс, устройство постарается его использовать. При неуспешной попытке подключения устройство обратится к GPRS интерфейсу (если оно доступно и активно). Подключите Ethernet-кабель к устройству, и приложение вновь будет использовать Ethernet-интерфейс.

Устройство DS1101 можно опционально расширить модулем для Wi-Fi интерфейса (GA1000). Предположим, что у вашего устройства уже есть этот модуль, тогда приступим к настройкам:

  • Режим Wi-Fi:
    • Permanent — постоянный режим работы. Означает, что Wi-Fi интерфейс всегда включен. Сразу после загрузки устройство активирует модуль GA1000 и пытается связать его с сетью. Интерфейс подключен, но это не означает, что используется Wi-Fi. При проводном подключении будет использоваться проводное соединение. Если отсоединить Ethernet-кабель, устройство сразу же переключится на Wi-Fi, при этом время на настройку нового подключения не потребуется. Обратите внимание, что у каждого сетевого интерфейса свой IP-адрес, поэтому невозможно получить доступ к IP-адресу Ethernet-интерфейса устройства при отсоединенном кабеле. Вам придется узнавать и, соответственно, IP-адрес Wi-Fi интерфейса.
    • On demand — режим работы по требованию. Означает, что модуль GA1000 обычно отключен. Когда у устройства пропадает соединение по Ethernet, оно активизирует модуль GA1000 и пытается установить беспроводное соединение. Когда Ethernet-соединие вновь становится доступным, устройство автоматически отключает GA1000 и активирует проводное соединение. Этот режим полезен, когда важна экономия энергии.
  • Access Point Name — имя точки доступа, к которой вы пытаетесь подключиться. Обратите внимание, что оно чувствительно к регистру символов.
  • Security — безопасность. Необходимо выбрать уровень безопасности, который будет использовать ваша точка доступа. Если вы не знаете, какой уровень безопасности у точки доступа, просмотрите ее настройки. Внимание! При использовании WPA или WPA2, на установку первого соединения с новой сетью требуется около 1.5 минут. В этом время будут активны светодиоды зеленого и красного свечения, а само устройство будет занято выполнением серьезной задачи. При повторной установке связи переключение с одного интерфейса на другой будет происходить моментально.
  • Password — пароль, чувствительный к регистру символов. Обратите внимание: текстовые пароли (в ASCII) для WEP не поддерживаются. При использовании WEP следует использовать шестнадцатиричную систему исчисления (длина пароля — десять символов).
  • DHCP and other network settings — DHCP и другие настройки Wi-Fi интерфейса. Это те же самые настройки, с которыми вы имели дело при установке проводного соединения. Мы рекомендуем активировать DHCP, если только у вас нет причин, чтобы намеренно этого не делать. Обратите внимание! Не следует пытаться установить один и тот же IP-адрес для обоих адапторов проводного и беспроводного интерфейса. Wi-Fi интерфейс независимый, и у него должен быть свой IP-адрес.

Нужна дополнительная информация?

Почитайте Справочник по решениям для Serial-over-IP!

Приложение Serial-over-IP (SoI)