¶ Задача
Активация выходной линии при попадании устройства в одну из геозон.
Список геозон может превышать 1000 шт.
¶ Загрузки
Основное:
Файл с программой
Дополнительно:
¶ Реализация
¶ Список с геозонами
Список с геозонами представлен в виде файла с массивом значений int32.
Файл размещается в корневой директории на SD-карте (поэтому программу можно использовать только с устройствами, которые поддерживают работу с SD-картой).
У
.INTфайла со споском геозон бинарный формат. Поэтому для его создания предусмотрена специальная программаgeozone_to_int_converter.exe, которая позволяет конвертировать списки геозон из форматов, удобных для восприятия человеком, в бинарный.INTфайл.
¶ Общая логика
Программа обеспечивает работу устройства со списком геозон (форма геозоны - окружность). Она проверяет принадлежность координат устройства хотя бы одной геозоне из списка.
Скорость обработки геозон 300 шт/сек.
Каждый раз после проверки всего списка фиксируется положение:
- внутри
- снаружи
А так же, фиксируется факт изменения положения:
- вход в зону
- выход из зоны
- смена геозоны
В тестовой программе в зависимости от положения производится управление выходом:
| Внутри | ➜ | Выход 1 = ВКЛ |
| Снаружи | ➜ | Выход 1 = ВЫКЛ |
¶ Настройка
¶ Подготовка списка геозон
Конвертируйте список геозон в .INT файл при помощи утилиты geozone_to_int_converter.exe
Запомните количество геозон, которое будет получено в результате работы программы.
Это значение нужно будет ввести в настройкуInt32 p1
Поместите файл CExxxx.INT в корень SD-карты.
Если название файла отличается от
CE0001.INT, то необходимо указать это в настройкеInt32 p0
¶ В конфигурации устройства
¶ На вкладке "Выходные линии"
Настройте Выход 1 как "Общего назначения"
¶ На вкладке "Complex Events"
- Включите функцию Complex Events. И запишите конфигурацию в устройство (затем снова подключитесь к устройству и продолжайте далее)
- Загрузите программу в устройство.
Пример загрузки программы в устройство описан в этой статье
-
Задайте необходимые настройки для работы программы.
Подробное описание настроек программы приведено ниже в соответствующем разделе
- Настройте пользовательские параметры
- Для завершения настройки снова запишите конфигурацию в устройство.
¶ Дополнительно
¶ Настройки программы
¶ Int32 p0
| Параметр в конфигурации | int32_p0 |
| Связанная переменная | GZ_INT_ARR_ID |
| Описание | Идентификатор .INT массива на SD карте |
| По умолчанию | 1 |
| Диапазон значений | 1 .. 65535 (если в конфигурации 0, то используется значение по умолчанию) |
Идентификатор определяет название имени файла на SD-карте со списком геозон.
Название файла должно быть в формате CExxxx.INT, где xxxx это GZ_INT_ARR_ID в шестнадцатеричном виде:
| GZ_INT_ARR_ID = 1 | ➜ | CE0001.INT |
| GZ_INT_ARR_ID = 300 | ➜ | CE012C.INT |
¶ Int32 p1
| Параметр в конфигурации | int32_p1 |
| Связанная переменная | GZ_MAX_COUNT |
| Описание | Программное ограничение списка геозон |
| По умолчанию | 1000 |
| Диапазон значений | 1 .. 2147483647 (если в конфигурации 0, то используется значение по умолчанию) |
Для обеспечения максимальной скорости обработки списка это значение должно соответствовать реальному количеству геозон в файле.
Программа проверяет в процессе работы со списком данный лимит. И если номер прочитанной геозоны превышает данную настройку, то программа досрочно прервет поиск по файлу и начнет с самого начала.
Если лимит не достугнут, то программа выполняет чтение геозон до конца файла.
¶ Int32 p2
| Параметр в конфигурации | int32_p2 |
| Связанная переменная | GZ_RADIUS_METERS |
| Описание | Радиус каждой геозоны в метрах |
| По умолчанию | 3000 |
| Диапазон значений | 1 .. 2147483647 (если в конфигурации 0, то используется значение по умолчанию) |
Список геозон содержит только координаты центров окружностей.
Программа берет радиус геозон из этой переменной.
¶ Bool p0
| Параметр в конфигурации | bool_p0 |
| Связанная переменная | OUTSIDE_STATE |
| Описание | Состояние выходной линии №1, если объект СНАРУЖИ |
| По умолчанию | 0 |
| Диапазон значений | 0 .. 1 |
Настройка позволяет инвертировать логику активации выходной линии в зависимости от положения устройства.
OUTSIDE_STATE = 0, то выход ВЫКЛючен СНАРУЖИ и ВКЛючен ВНУТРИ.
OUTSIDE_STATE = 1, то выход ВКЛючен СНАРУЖИ и ВЫКЛючен ВНУТРИ.
¶ Пользовательские параметры
¶ Пользовательский параметр CE 1
| Связанная переменная | gz_id_active |
| Описание | Идентификатор текущей активной геозоны. Если 0, то устройство СНАРУЖИ |
| Передавать как | 2 или 4 байтовый параметр |
| Тип переменной | I32 |
¶ Пользовательский параметр CE 2
| Связанная переменная | gz_id_last |
| Описание | Идентификатор последней активной геозоны. Если 0, то устройство не посещало геозон |
| Передавать как | 2 или 4 байтовый параметр |
| Тип переменной | I32 |
¶ Пользовательский параметр CE 3
| Связанная переменная | err_total |
| Описание | Счетчик ошибок работы с SD-картой. Если значение больше 0, то с момента последнего включения устройства были ошибки при чтении данных из SD-карты |
| Передавать как | 2 или 4 байтовый параметр |
| Тип переменной | I32 |
¶ События
нет
¶ Команды
нет
¶ Схема
¶ Часть 1
В самом начале программы, в ветке "+" условия on startup выполняется восстановление переменных из конфигурации и телеметрии. Эти условия выполняются единожды при вклюении устройства.
¶ Часть 2
Условие enable GZ scan открывает ветку логики, которая производит чтение геозон на SD-карте и последующее управление выходной линией.
Условие добавлено для явного выделения логики программы в отдельную ветку (это наглядно и позволяет совмещать несколько программ в одну).
¶ Часть 3
В этой части программы выполняется базовая логика работы с SD-картой и проверка нахождения устройства внутри одной из геозон.
¶ ERROR_ACTIONS
Отдельно отметим блок error actions. Он подсчитывает ошибки при работе с SD-картой для удобной диагностики работы программы.
Если ошибка разовая, то она просто будет посчитана и сохранена в переменной err_total.
Если подряд идет несколько ошибок, то программа устанавливает флаг had_err_series и пробует начать чтение списка с самого начала. Для удобства диагностики этот флаг обнуляетися только при включении устройства.
Количество ошибок для установки флага had_err_series задается переменной MAX_ERR_SERIES (по умолчанию значение переменной 5 ).
¶ Часть 4
В этой части по условию on new cycle выполняются сервисные функции и обработка пользовательской логики. Условие on new cycle выполняется после чтения всего списка геозон (т.е. сначала анализируется ВЕСЬ список, а потом выполняются действия).
В блоке SERVICE_2 выполняется запись переменных в пользовательские параметры для сохранения в телеметрии и передачи на сервер.
Далее идет ряд веток "заготовок" для внедрения пользовательской логики.
Внутрь "заготовок" можно подставить несколько блоков или целые ветки пользовательской логики.
Чтобы не повредить структуру программы рекомендуется соблюдать правила:
➜ не менять существующие переменные
➜ любые ответвления НЕ должны обходить блок INIT
¶ ON_ENTRY
Ветка on ENTRY выполняется при входе в геозону.
Это краткосрочное событие, которое активируется в момент входа.
¶ ON_CHANGE
Ветка on CHANGE выполняется при одновременном выполнении двух условий:
- произошел вход в геозону
- gz_id_last gz_id_active (предыдущая геозона отлична от текущей)
Это краткосрочное событие, которое активируется в момент входа в новую геозону.
¶ ON_EXIT
Ветка on EXIT выполняется при выходе из геозоны.
Это краткосрочное событие, которое активируется в момент выхода.
¶ OUTSIDE
Блок OUTSIDE выполняется каждый раз если устройство снаружи геозоны.
В тестовой программе здесь выполняется установка значения выхода:
¶ INSIDE
Блок INSIDE выполняется каждый раз если устройство внутри геозоны.
В тестовой программе здесь выполняется установка значения выхода:
¶ Общие замечания
Логика программы построена так, что все геозоны воспринимаются как единое пространство.
Поэтому ветки ON_ENTER и ON_EXIT не сработают, если устройство переходит из геозоны в геозону.
Например, если геозоны наложены друг на друга.