EPLab

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

Установка в Windows

1. Установите MSVC 2013 redistributable и MSVC 2015 redistributable (разрядность должна совпадать с разрядностью Python).

2. Установите зависимости для Python, перейдя в папку scripts и запустив скрипт rebuild_venv.bat.

3. В зависимости от разрядности вашей ОС установите драйвер ivm.inf из папки resources\win32\drivers\ivm или resources\win64\drivers\ivm.

4. Если Вы планируете использовать мультиплексор, установите драйвер epmux.inf из папки resources\win32\drivers\epmux или resources\win64\drivers\epmux в зависимости от разрядности вашей ОС.

Установка в Linux

1. Установите библиотеку libcurl:

   sudo apt-get update
   sudo apt-get install libcurl3
   sudo apt-get install libcurl4-openssl-dev

2. Установите библиотеки для работы со звуком и для сборки пакетов Python:

   sudo apt-get install -y python3-dev libasound2-dev

3. Установите зависимости для Python, перейдя в папку scripts и запустив скрипт rebuild_venv.sh:

   bash rebuild_venv.sh

Запуск в Windows

ПО предоставляет возможность работать с устройствами IVM10 и АСА (Meridian) по отдельности.

Запуск в Windows для работы с IVM10

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

venv\Scripts\python main.py --test <ivm_url> [--ref <ivm_url>]

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

venv\Scripts\python main.py --test com:\\.\COM13 --ref virtual

Запуск в Windows для работы с АСА

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

venv\Scripts\python main.py --test xmlrpc://172.16.3.213 --ref virtualasa --config eplab_asa_options.json

Здесь предполагается, что:

• сервер устройства АСА имеет IP адрес 172.16.3.213 и прослушивает порт 8888;
• совместно с устройством АСА запускается виртуальный измеритель (за это отвечает аргумент virtualasa);
• ПО получает файл с конфигурацией eplab_asa_options.json для работы с устройством АСА.

Запуск в Windows в общем случае

Приложение можно запустить, перейдя в папку scripts и запустив скрипт run.bat.

Возможные ошибки при запуске в Windows

Если у вас возникла такая ошибка:

qt.qpa.plugin: Could not find the Qt platform plugin "windows" in "" This application failed to start because no Qt platform plugin could be initialized. Reinstalling the application may fix this problem.

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

set QT_QPA_PLATFORM_PLUGIN_PATH=venv\Lib\site-packages\PyQt5\Qt\plugins\platforms

Запуск в Linux

ПО предоставляет возможность работать с устройствами IVM10 и АСА (Meridian) по отдельности.

Запуск в Linux для работы с IVM10

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

venv/bin/python3 main.py --test <ivm_url> [--ref <ivm_url>]

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

venv/bin/python3 main.py --test com:///dev/ttyACM0 --ref virtual

Запуск в Linux для работы с АСА

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

venv/bin/python3 main.py --test xmlrpc://172.16.3.213 --ref virtualasa --config eplab_asa_options.json

Здесь предполагается, что:

• сервер устройства АСА имеет IP адрес 172.16.3.213 и прослушивает порт 8888;
• совместно с устройством АСА запускается виртуальный измеритель (за это отвечает аргумент virtualasa);
• ПО получает файл с конфигурацией eplab_asa_options.json для работы с устройством АСА.

Запуск в Linux в общем случае

Приложение можно запустить, перейдя в папку scripts и запустив скрипт run.sh:

bash run.sh

Возможные ошибки при запуске в Linux

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

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

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

   sudo adduser username dialout

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

3. Если при открытии устройств все же возникают какие-то проблемы, попробуйте запустить ПО с правами root.

4. Если у вас возникла такая ошибка:

   qt.qpa.plugin: Could not load the Qt platform plugin "xcb" in "" even though it was found.

   выполните следующую команду:

   export QT_DEBUG_PLUGINS=1

   Запустите приложение еще раз. Возможно, отладочный уровень логирования поможет Вам понять, что дополнительно требуется для Qt.

   Возможно, Вам поможет установка следующих библиотек:

   sudo apt-get install --reinstall libxcb-xinerama0
   sudo apt-get install libxcb-randr0-dev libxcb-xtest0-dev libxcb-xinerama0-dev libxcb-shape0-dev libxcb-xkb-dev
   sudo apt-get install libxkbcommon-x11-dev

   Если у Вас не хватает libxcb-util.so.1, попробуйте:

   sudo ln -fs /usr/lib/x86_64-linux-gnu/libxcb-util.so.0.0.0 /usr/lib/x86_64-linux-gnu/libxcb-util.so.1.0.0
   sudo ln -fs /usr/lib/x86_64-linux-gnu/libxcb-util.so.0.0.0 /usr/lib/x86_64-linux-gnu/libxcb-util.so.1.0
   sudo ln -fs /usr/lib/x86_64-linux-gnu/libxcb-util.so.0.0.0 /usr/lib/x86_64-linux-gnu/libxcb-util.so.1

Запуск тестов

Для запуска тестов перейдите в папку scripts и запустите скрипт:

• run_tests.bat, если Вы работаете в Windows;

• run_tests.sh, если Вы работаете в Linux:

  bash run_tests.sh

Выпуск релиза

Для выпуска релиза перейдите в папку scripts и запустите скрипт:

• release.bat, если Вы работаете в Windows (ВНИМАНИЕ! Релиз нужно выпускать на Windows 7);

• release.sh, если Вы работаете в Linux (ВНИМАНИЕ! Релиз нужно выпустить на Ubuntu 18):

  bash release.sh

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

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

• Для корректной работы приложения необходимо отключить брандмауэр (firewall) на компьютере.

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

  Настроить -> Сеть -> Адаптер 1 -> Включить сетевой адаптер -> Тип подключения -> Сетевой мост
  

  Аналогично нужно настроить адаптер 2:

  Настроить -> Сеть -> Адаптер 2 -> Включить сетевой адаптер -> Тип подключения -> NAT