# EPLab

Программное обеспечение для работы с устройствами линейки EyePoint, предназначенными для поиска неисправностей на печатных платах в ручном режиме (при помощи ручных щупов).

## Возможности

- Непрерывное измерение ВАХ с возможностью быстрой перестройки параметров измерителя.
- Сравнение ВАХ в реальном времени с двух каналов.
- Создание плана тестирования – файла с набором эталонных ВАХ, снятых для различных точек с заданными параметрами.
- Тестирование с использованием ранее созданного плана тестирования (с автоматической установкой параметров измерителя).
- Сохранение ВАХ в виде изображений.
- Генерация HTML отчетов с результатами тестирования.

## Запуск в Windows

1. Установите [MSVC 2013 redistributable](https://www.microsoft.com/en-us/download/details.aspx?id=40784) и [MSVC 2015 redistributable](https://www.microsoft.com/ru-ru/download/details.aspx?id=48145).

2. Установите драйвер `ivm.inf` из папки `drivers\ivm`.

3. Если вы планируете использовать мультиплексор, установите драйвер `epmux.inf` из папки `drivers\epmux`.

4. Дважды кликните по `eplab.exe`. Также можно перейти в терминале в папку, в которой расположен исполняемый файл, и выполнить команду:

   ```bash
   eplab.exe
   ```

## Подключение устройств в Windows

По умолчанию при запуске к ПО не подключено ни одно устройство. Чтобы подключить к ПО устройство, перейдите:

```bash
File -> Connection
```

В появившемся диалоговом окне `Connection setup` выберите необходимое устройство и нажмите кнопку `Connect`.

Чтобы запустить приложение с уже подключенными к нему устройствами, в командной строке выполните команду:

```bash
eplab.exe <ivm_url> [--ref <ivm_url>]
```

ПО может работать как с одним, так и с двумя измерителями (второй измеритель задавать не обязательно). `ivm_url` - это адрес COM-порта. Также `ivm_url` может быть `virtual` (будет использоваться виртуальный измеритель). Пример запуска:

```bash
eplab.exe com:\\.\COM13 --ref virtual
```

## Запуск в Linux

1. Перед первым запуском обычно нужно прописать в системе VID и PID устройства для драйвера виртуального COM-порта:

   ```bash
   sudo sh -c 'echo 1CBC 0007 > /sys/bus/usb/drivers/cdc_acm/new_id'
   ```

2. Для корректной работы ПО с COM-портами пользователь должен находиться в группе `dialout`. Чтобы добавить пользователя в эту группу, выполните команду (здесь предполагается, что имя пользователя `username`):

   ```bash
   sudo adduser username dialout
   ```

   После добавления пользователя в группу `dialout` перезагрузите компьютер.

3. Также для работы ПО требуется установить библиотеки из папки `lib`. Для этого выполните скрипт `install_libs.sh`:

   ```bash
   sudo bash install_libs.sh
   ```

4. Дважды кликните по иконке файла `eplab`. Также можно перейти в терминале в папку, в которой расположен исполняемый файл, и выполнить команду:

   ```bash
   ./eplab
   ```

   Если возникнет ошибка с правом доступа, предоставьте права на выполнение. Для этого в терминале выполните команду:

   ```bash
   chmod ugo+x eplab
   ```
   
5. Если при открытии устройств все же возникают какие-то проблемы, попробуйте запустить ПО с правами `root`:

   ```bash
   sudo ./eplab
   ```

## Подключение устройств в Linux

По умолчанию при запуске к ПО не подключено ни одно устройство. Чтобы подключить к ПО устройство, перейдите:

```bash
File -> Connection
```

В появившемся диалоговом окне `Connection setup` выберите необходимое устройство и нажмите кнопку `Connect`.

Чтобы запустить приложение с уже подключенными к нему устройствами, в командной строке выполните команду:

```bash
./eplab <ivm_url> [--ref <ivm_url>]
```
ПО может работать как с одним, так и с двумя измерителями (второй измеритель задавать не обязательно). `ivm_url` - это адрес COM-порта. Также `ivm_url` может быть `virtual` (будет использоваться виртуальный измеритель). Пример запуска:

```bash
./eplab com:///dev/ttyACM0 --ref virtual
```

## Дополнительно

- Для работы с сетевым устройством АСА нужно запустить сервер версии 4.3.2.

- Для корректной работы приложения на виртуальной машине нужно настроить сеть виртуальной машины. Для этого:

  ```bash
  Меню -> Устройства -> Сеть -> Настроить сеть -> Тип подключения -> Сетевой мост
  ```

  После настройки сети нужно перезагрузить виртуальную машину, чтобы настройки вступили в силу.

