Установка соединения¶

Когда Вы первый раз откроете программу, Вы увидите следующее окно.

При запуске, все доступные в системе порты обновляются и добавляются в список портов 1. Вы можете вручную обновить список доступных портов, после добавления новых устройств, нажатием кнопки “Открыть порт” 2.

После выбора необходимого порта, выберите (или введите) необходимую скорость передачи данных (baud rate) для выбранного устройства 3. Установите флажок “Заполнить автоматически” 4 если Вы хотите чтобы программа заполнила информацию о модеме автоматически при подключении к устройству. Также в любой момент можно сделать это вручную используя кнопку “Заполнить информацию” 5. Тот же результат может быть получен нажатием горячей клавиши F5 (обновить информацию, см. Горячие клавиши).

Для подключения к модему нажмите кнопку “Открыть порт” 6. Если порт был успешно открыт, индикатор текущего статуса 7 станет зелёным. Индикатор статуса может быть трех разных цветов: красный при закрытом порту, зелёный - при открытом, синий - в режиме “загрузки”.

В нижней части окна располагается консольный монитор. Левая 8 часть отвечает за красивые статусные сообщения и фильтрованный вывод AT-команд, правая 9 часть является монитором последовательного COM-соединения и отображает всё что попадает в COM-порт.

Текстовое поле 10 в самом низу позволяет слать AT-команды модему напрямую. Текстовое поле 11 осуществляет поиск по обоим консольным окнам.

Очередь команд¶

При общении с модемом, будь то ручные команды или автоматическая кнопка настройки модема, AT-команды складываются в “очередь” команд. Очередь можно приостанавливать и возобнавлять, а также повторять последнюю (неудавшуюся) команду.

На скриншоте отображён список команд, появившихся после запуска конфигурирования приложения модема (см. Конфигурирование приложения модема). Текущая работающая команда подсвечена зелёным цветом если это AT-команда, и синим цветом если это длительный процесс (загрузка прошивки по протоколу XModem, перенастройка аналоговых и цифровых входов).

Флажок “Автопауза” 1 отвечает за приостановку очереди в случае возникновения ошибок при выполнении команды. В большинстве сценариев, этот влажок должен быть активен.

Кнопка “Пауза/Продолжить” 2 позволяет вручную приостановить/возобновить очередь. Если очередь приостановлена, Вы всё ещё можете посылать модему AT-команды, которые будут выполнены сразу же после ввода в параллельной (другой) очереди, работающей без остановок специально для этого применения.

Кнопка “Повторить” 3 позволяет повторить последнюю (неудавшуюся) AT-команду если очередь в данный момент приостановлена. Эта команда исполняется в параллельной очереди, позволяя заменить ввод одной и той же команды вручную.

Индикатор состояния 4 нужен для отображения прогресса долгих событий (таких как загрузка прошивки или перенастройка большого количества портов).

Настройки ModemManager¶

Для более комфортной работы с программой Вы можете настроить её удовлетворяющим Вас образом. Для этого перейдите на вкладку “Настройки” 1. Если Вы желаете пропустить часть по настройке программы, можете перейти к части Подготовка к работе.

Выпадающий список “Язык приложения” 2 позволяет выбрать язык всего приложения. Локализация включает не только перевод интерфейса, но также перевод всех сообщений, статусов и т. п. На текущий момент доступны два языка: английский и русский.

В списке “Автодополнение” 3 можно выбрать тип автодополнения при вводе ручных AT-команд. Всего есть 4 типа дополнения:

8 - Нет

9 - Всплывающая подсказка

10 - Дополнение в строке

11 - Подсказка и дополнение

Флажок “Автоматически показывать очередь” 4 делает именно то, что говорит: открывает вкладку “Очередь” (см. Очередь команд) при старте выполнения длинной очереди команд для того, чтобы Вы могли видеть что происходит в данный момент.

Флажок “Раскраска COM-монитора” 5 улучшает вид вывода монитора последовательного порта (справа снизу) путём раскраски “синтаксиса” отдельных частей, например оранжевый - для текста в кавычках.

Флажок “Сохранить настройки при выходе” 6 необходим для сохранение всевозможных статусов и установленных настроек приложения между сессиями. Если Вы хотите запретить изменение настроек, снимите эту галочку и приложение будет начинать каждый раз с теми же настройками (текущими сохранёнными).

И, наконец, кнопка “Сбросить настройки” 7 сбрасывает все возможные настроки на их стандартные значения без возможности возврата :)

Подготовка к работе¶

Перед началом использования модема, необходимо подготовить его для работы. Если у Вас есть чистый (новый) модем без нашего приложения и конфигурации, необходимо записать изначальную операционную систему и её загрузчик. Для этого нажмите кнопку “Подготовка чистого модема” в нижней левой части экрана на вкладке “Соединение”. Будет произведена первоначальная подготовка модема для корректной работы.

Это действие полностью перезаписывает операционную систему и сбрасывает настройки модема. Для перенастройки модема под ваши нужды, проделайте следующие шаги на вкладке “Автоматический режим”:

1 Переразбить внутреннюю память модема (место под приложение и файловую систему) если Вам это необходимо.

2 Настроить внешнюю (интернет) APN для sim-карты.

3 Удостовериться, что необходимые флажки активны.

4 Установить этот флажок если Вы хотите обновить внутреннее время модема и обновить (получить снова) информацию о модеме после выполнения всех действий.

5 Нажать кнопку “Начать” для старта автоматического процесса подготовки модема. Очередь (см. Очередь команд) будет заполнена необходимыми командами и начнёт настройку модема.

Если Вы хотите обновить приложение (прошивку) (или загрузить его первый раз), нажмите кнопку “Обновление из облака” 6. Процесс обновления приложения из облака не до конца явный, потому как Вам вероятно придётся обходить некоторые ошибки вводом команд вручную. Если Вы обнаружите какие-либо ошибки, обратите внимание к разделу Проблемы и их решение.

Конфигурирование приложения модема¶

Конфигурирование (настройка) приложения (прошивки) модема работает только если эта прошивка присутствует на модеме (что очевидно).

1 - заполнить информацию из модема.

2 - заполнить информацию из XML файла. Вы можете получить XML-файл с настройками под Вашу конфигурацию и просто загрузить всю конфигурацию из него.

3 - сохранить текущую конфигурацию с экрана в XML файл для дальнейшего использования.

4 - сбросить конфигурацию на стандартную (определяется версией приложения, прошитого в модеме).

5 - включить/выключить конфигурирование всех блоков. Вы можете переключить статус вкл./выкл. отдельного блока путём клика по нему с зажатой клавишей CTRL.

6 button configures all on-screen configuration into modem.

Проблемы и их решение¶

Функциональность¶

• Стабильная связь с модемом

  

• Полная информация о модеме

  

  • Общая информация

  • Информация о памяти

  • Информация о прошивке

• Очередь команд

  

  • Все команды добавляются в общую очередь, работающую в фоне

  • Пользователи могут приостанавливать и продолжать команды, добавленные в очередь

  • Очередь может автоматически останавливаться при возникновении ошибок (если настроено)

  • Список текущих команд очереди отображается на экране. Текущая команда подсвечивается другим цветом

  • При запуске автоматической настройки модема, вкладка очереди автоматически открывается для просмотра

• Загрузка прошивки, используя XModem-протокол

  

• Автоматическая конфигурация модема

  

  • Стереть приложение

  • Запись загрузчика и прошивки

  • Разбивка памяти

    • Выбор разделов приложения и файловой системы, автоматическая разбивка после

    • Минимальный размер раздела памяти под приложение составляет 256 КиБ (для защиты)

    • Визуальное отображение распределённой памяти

  • Запись приложения

  • Подготовка модема к удалённой прошивке

  • Синхронизация времени

Удобство¶

• Автодополнение команд с всплывающим списком истории

  

• Локализация всех графических элементов, статус-сообщений и т. п.

  

• Сохранение всех настроек между сессиями

  

Визуальный стиль¶

• Чистое и фильтрованное окно консоли

  

  • Дата выполнения команды

  • Цветные статусы в консоли

• Низкоуровневое окно COM-монитора

  

  • Содержит всю историю команд пока порт открыт

• Поиск по обоим консольным окнам

  

• Цветные и заметные статус-индикаторы

  

• Гибкий дизайн - окна полностью растягиваемы и сжимаемы, совместимы с любыми разрешениями экранов, внутренние разделители позволяют раздвигать элементы для большей гибкости. Также, можно показать/скрыть некоторые окна горячими клавишами (F11/F12).

  

• Индикатор прогресса показывает процесс загрузки файла

  

Горячие клавиши¶

Общие:

F1 - PDF документация (при наличии), иначе - вебсайт

Ctrl + F1 - Прочитать ID текущей машины (ПК): необходимо для проверки лицензии (разблокировки полной версии)

F5 - Обновить (прочитать) информацию о модеме

F6 - Обновить (прочитать) конфигурацию приложения

F9 - Записать текущие настройки модема в XML-базу установленных модемов

F11 - Скрыть / показать Консольное окно

F12 - Скрыть / показать Главное окно

Ctrl + L - Очистить консоль

Ctrl + S - Сохранить все настройки, включая текущую APN-конфигурацию

Ctrl + M - режим полноэкранного монитора COM-порта, может быть совмещён с режимом Отделения окна (ПКМ -> Вынести в отдельное окно)

Ctrl + Space - Приостановить/Возобновить очередь

Ввод AT-команд:

Return - Послать команду

Ctrl + Z - Послать данные для загрузки (символ substutite в конце строки)

Навигация внутри окна:

Ctrl + I - Переключиться на поле ввода AT-команд

Ctrl + F - Перейти на поле поиска

Alt + 1 - переключиться на 1ую вкладку Соединение

Alt + 2 - переключиться на 2ую вкладку Очередь

Alt + 3 - переключиться на 3ю вкладку Настройки

Alt + 4 - переключиться на 4ую вкладку Информация

Alt + 5 - переключиться на 5ую вкладку Автоматический режим

Alt + 6 - переключиться на 6ую вкладку Конфигурация

Разработка¶

• Чистая кодовая база и архитектура

• Минимальные зависимости

• Мультипоточность: вся работа совершается в фоне, графический интерфейс не тормозит

• Разные классы делают распределённую работу

• Конструктивные комментарии для большинства блоков кода

• Части кода закрыты в блоках региона #regions для удобства