Удалённая синхронизация файлов (WebDAV)

Прибор умеет сам сходить в облачное хранилище по протоколу WebDAV и синхронизировать с ним файлы на microSD-карте или eMMC. Так обновляют файл геозон, забирают логи и раздают файлы на парк приборов, не выезжая к объекту.

Нужны две вещи: карта (или eMMC) в приборе и учётная запись в хранилище с поддержкой WebDAV.

Как работает синхронизация

Копируется отдельный файл или каталог целиком.
Источник приоритетен: если в приёмнике есть файлы, которых нет в источнике, они будут удалены — если не включить keepMissing.
Синхронизация стартует, когда появится интернет-соединение и вставлена карта; после перезагрузки прибора незавершённый процесс продолжается.

Выбор хранилища

Подойдёт любое хранилище с WebDAV — Яндекс.Диск, развёрнутый у вас ownCloud или WebDAV-сервер Galileosky.

Яндекс.Диск. В настройках учётной записи откройте «Аккаунт» → «Пароли и авторизация» → «Пароли приложений» → создайте новый пароль типа «Файлы WebDAV». Пароль показывается только один раз — сохраните его. Адрес сервера — webdav.yandex.ru. Проверить доступ удобно, подключив хранилище сетевым диском в проводнике.

Сервер Galileosky. Многие площадки отказываются от WebDAV как от устаревшей технологии, поэтому доступен собственный сервер: зарегистрируйтесь, подтвердите почту и подключитесь любым файловым менеджером с поддержкой WebDAV (например, WinSCP).

Логин и пароль ограничены по длине: до 39 символов каждый.

Запуск синхронизации

FSSYNC <http|https>://<host[:port]>,<user>,<pass>,<remote>,<local>,[up|down],[true|false]

Параметр	Значение
`http://` / `https://`	без шифрования (порт 80) или с шифрованием (порт 443)
`host[:port]`	имя сервера; порт можно указать явно через двоеточие
`user`, `pass`	учётные данные, до 39 символов каждое
`remote`	имя файла или каталога на сервере; каталог должен оканчиваться на `/` и считается корневым
`local`	имя файла или каталога в приборе; каталог должен оканчиваться на `/`
`direction`	`down` — забрать с сервера, `up` — выгрузить с прибора; по умолчанию `down`
`keepMissing`	`true` — сохранять элементы, которых нет в источнике; `false` — удалять; по умолчанию `true`

Ответы: Synchronization scheduled — запланирована и начнётся при появлении интернета; already scheduled — уже запланирована ранее; not finished yet — предыдущая ещё идёт.

FSSYNC http://webdav.7gis.ru,support@7gis.ru,webdavpassword,/Geofences/,/GEOFENCES/,down,true

Команда скопирует содержимое каталога Geofences с сервера в каталог GEOFENCES на карте прибора, сохранив файлы, которых на сервере нет.

Каталог на карте должен существовать заранее. FSSYNC не создаёт корневой каталог назначения: если его нет на карте, команда не выполнится. Чтобы получить новый каталог, создайте его на сервере и синхронизируйте вместе с содержимым.

Изменение относительно старой документации. Старая дока утверждает, что порт жёстко определяется протоколом (80 или 443). В прошивке 48.28 порт можно задать явно — http://host:8080. Ограничение на суммарную длину логина и пароля в 38 символов тоже устарело: это 39 символов на каждое поле по отдельности.

Команды можно отправлять из вкладки «Команды», по SMS или из ПО мониторинга.

⚙ Открыть команды

Массовая рассылка команды на группу приборов — через удалённый доступ, см. «Удалённое конфигурирование».

Остановка и статус

FSSYNCSTOP

Ответы: terminating — прерывание запланировано; no sync scheduled or running to terminate — прерывать нечего.

FSSYNCSTAT

Возможные ответы:

idle — синхронизация не выполняется и не запланирована;
scheduled: <host>,<remote>,<local> — запланирована;
sync running: <host>,<remote>,<local>; action: <действие> — выполняется.

Действия: list — получение списка на сервере, down fn: <файл> progress: <xx>% — загрузка, up fn: <файл> progress: <xx>% — выгрузка, idle — простой, terminating — запланировано прерывание.

FSSYNCSTAT: sync running: webdav.yandex.ru,/client/fldr/,/fldr/; action: down fn: zones.kml progress: 65%

Что не синхронизируется

При синхронизации корневого каталога прибор пропускает служебные элементы:

Элемент	Что это
`Arc`	архив
`Track`	архив старых приборов
`Pic`	фотографии
`Collector`	сборщик архивов
`logs`	журналы работы
`.wdtmp`	временные файлы WebDAV-клиента
`.fssync`, `.synclist`, `.synclist.xml`	служебные файлы модуля синхронизации
`System Volume Information`	служебный каталог Windows
`log.txt`	журнал диагностических сообщений
`keys.bin`, `keysEx.bin`	ключи iButton

Также пропускается всё, чьё имя начинается с точки.

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

FSSYNC http://webdav.7gis.ru,support@7gis.ru,webdavpassword,/log.txt,/log.txt,up,true

См. также: Хранение данных — внутренняя память, microSD и eMMC · Работа с содержимым файлов · Геозоны · Удалённое конфигурирование прибора