Загрузка проекта и конфигурирование
===================================

Загрузка проекта
----------------

Панель является свободно программируемым контроллером, поэтому может содержать любую программу.  На этой странице можно загрузить эту программу в панель. Для загрузки можно выбрать стандартную программу, которая хранится в ресурсах zTunes или выбрать любой произвольный `*.bin` файл. Проект создается и экспортируется из программы zWorkbench.

 
.. figure:: image/project.jpg
   :align: center
   :scale: 30%

   
Для выбора стандартного проекта установите флажок. Для выбора произвольного проекта снимите флажок и длительным нажатием на поле ввода выберите файл. Файл проекта необходимо скопировать на смартфон средствами операционной системы.
Для контроля правильности выбранного проекта в нижней части экрана отображается информация о нем - тип контроллера в проекте, код и версия проекта. Если эта информация не отображается, то возможно файл поврежден или выбран файл не того формата.
После выбора проекта для загрузке необходимо нажать кнопку :guilabel:`Далее >>>`.

В случае успешной загрузки панель будет перегружена, программа предложит перейти на страницу поиска.
   
Конфигурирование
----------------

Проект, загруженный в панель может иметь набор переменных для настройки алгоритма работы. Для стандартного проекта это набор параметров A0-A7, B0-B7 и т.д.
Для редактирования этих параметров установите переключатель **Конфигурирование контроллера** и нажмите :guilabel:`Далее >>>`.  Программа предложит прочитать переменные из контроллера. 

**Внимание!!!**
Если отказаться от чтения, то значения всех переменных будут выставлены по умолчанию.

.. figure:: image/config.jpg
   :align: center
   :scale: 30%

Список доступных параметров отображается в виде списка, разделенного на группы.

.. figure:: image/config_1.jpg
   :align: center
   :scale: 30%
   
Для того чтобы прочитать параметры из контроллера нажмите кнопку :guilabel:`Прочитать` , для записи параметров в контроллер - кнопку :guilabel:`Записать`.

Для редактирование нажмите на элемент списка и установите нужное значение.

.. figure:: image/config_2.jpg
   :align: center
   :scale: 30%
   
   
   
Формат файла конфигурации
-------------------------

Нестандартные проекты, загруженные в контроллер, так-же можно конфигурировать. Для этого необходимо создать файл конфигурации определенного формата и выбрать его в поле ввода на странице загрузка проекта. Выбор осуществляется через длительное нажатие, как и выбор файла проекта.

.. figure:: image/project_2.jpg
   :align: center
   :scale: 30%

Файл конфигурации – это список переменных Modbus. Каждая переменная конфигурации описывается одним блоком:

* **name** – имя переменной, отображаемое в приложении
* **group** – имя группы, может отсутствовать
* **type** – тип данных переменной (uchar – без знаковый однобайтовый, char – знаковый однобайтовый, ushort – без знаковый двухбайтовый, short –знаковый двухбайтовый, uint - без знаковый 4-х байтовый, int - знаковый 4-х байтовый, float и double – дробный 4-х байтовый и 8-и байтовый, bool – логический)
* **value** – значение переменной
* **min** и **max** – мин. и макс. значение переменной (ограничение для редактирования пользователем)
* **description** – текстовое описание переменной (необязательный параметр)
* **source** – источник данных. В текущей версии поддерживается только протокол Modbus, поэтому параметр source должен иметь обязательный формат - "source": {"modbus": {"register": 50008}}. Параметр **register** задает адрес регистра для переменной.

**Внимание!!!** В текущей версии поддерживается редактирование только целочисленных типов данных.

Пример файла конфигурации для панели Z031

| {
| "data":
| [
|   {"name": "B0", "group" : "Параметры B", "type": "short", "value": 15, "min":15, "max": 30,"description": "Минимальная уставка температуры", "source": {"modbus": {"register": 50008}}},
|   {"name": "B1", "group" : "Параметры B", "type": "short", "value": 35, "min":30, "max": 255,"description": "Максимальная уставка температуры", "source": {"modbus": {"register": 50009}}},
|   {"name": "A4", "group" : "Параметры A", "type": "short", "value": 3, "min":0, "max": 7, "description": "Максимальное кол-во скоростей вентилятора", "source": {"modbus": {"register": 50004}}},
|   {"name": "A5", "group" : "Параметры A", "type": "uchar", "value": 6, "description": "Дополнительная конфигурация вентилятора", "source": {"modbus": {"register": 50005}}},
| ]
| }


Пример файла можно скачать здесь_.

.. _здесь: http://files.zentec.ru/ztunes/doc/Z031_стандарт.json