Ubuntu Linux
============

zWorkbench доступен в виде snap-пакета — универсального формата для Linux, который работает на большинстве современных дистрибутивов.

.. contents:: Содержание:

Предварительные требования
--------------------------

**Доступ к последовательным портам**

Для корректной работы с COM-портами и USB-UART адаптерами необходимо добавить текущего пользователя в группу ``dialout``:

.. code-block:: bash

    sudo adduser $USER dialout

После выполнения команды необходимо **выйти из системы и войти снова** для применения изменений.

Установка
---------

**Доступные каналы распространения:**

- ``stable`` — стабильная версия (рекомендуется для большинства пользователей)
- ``candidate`` и ``beta`` — тестовые версии с новыми функциями
- ``edge`` — ежедневные сборки (только для опытных пользователей)

**Установка стабильной версии:**

.. code-block:: bash

    sudo snap install zworkbench

.. figure:: image/36.png
   :align: center

**Установка других версий:**

.. code-block:: bash

    # Кандидатская версия
    sudo snap install zworkbench --candidate

    # Бета-версия
    sudo snap install zworkbench --beta

    # Сборка из основной ветки
    sudo snap install zworkbench --edge

После установки программа доступна через меню приложений:

.. figure:: image/411.png
   :align: center

Запуск программы:

.. code-block:: bash

    zworkbench

.. figure:: image/57.png
   :align: center

Настройка доступа к оборудованию
--------------------------------

Snap-пакеты по умолчанию ограничивают доступ к оборудованию. Для работы с USB-устройствами и последовательными портами выполните:

.. code-block:: bash

    sudo snap connect zworkbench:raw-usb
    sudo snap connect zworkbench:serial-port

Эти команды предоставляют приложению доступ к:

- ``raw-usb`` — прямое взаимодействие с USB-устройствами
- ``serial-port`` — работа с последовательными портами (/dev/ttyUSB0, /dev/ttyACM0 и др.)

**Проверка подключенных интерфейсов:**

.. code-block:: bash

    snap connections zworkbench

При успешной настройке вывод будет содержать:

::

    Interface           Plug                         Slot            Notes
    raw-usb             zworkbench:raw-usb            :raw-usb        manual
    serial-port         zworkbench:serial-port        :serial-port    manual

Просмотр информации о пакете
----------------------------

.. code-block:: bash

    snap info zworkbench

.. figure:: image/67.png
   :align: center

Обновление
----------

Snap-пакеты обновляются автоматически. Для ручного обновления:

.. code-block:: bash

    sudo snap refresh zworkbench

.. figure:: image/79.png
   :align: center

**Переключение между каналами:**

.. code-block:: bash

    sudo snap refresh zworkbench --channel=beta

Удаление
--------

.. code-block:: bash

    sudo snap remove zworkbench

Дополнительная информация
-------------------------

- `zWorkbench в Snap Store <https://snapcraft.io/zworkbench>`_
- `Официальная документация по snap <https://snapcraft.io/docs/>`_

Примечание: подключение интерфейсов (raw-usb, serial-port) выполняется только один раз после установки.