Установка библиотеки

Требования

Python 3.11 или выше
Драйвер D2XX для Windows
Драйвер libftdi для Linux (на большинстве современных дистрибутивов предустановлен)

🐧 Linux

Тестировалось на Ubuntu 22.04 LTS

1️⃣ Установка Python и pip

sudo apt install python3 python3-pip

2️⃣ Установка библиотеки

pip install libspectrum

3️⃣ Настройка прав доступа к USB

Важно

Этот шаг необходим для работы с устройством без прав root

echo 'SUBSYSTEMS=="usb", ATTRS{idVendor}=="0403", ATTRS{idProduct}=="6014",  MODE="0666"' | sudo tee /etc/udev/rules.d/69-spectrometer.rules
sudo udevadm control --reload

🪟 Windows

1️⃣ Установка драйверов FTDI

Примечание

Если на компьютере ранее работал Atom, этот шаг можно пропустить

Скачайте драйвер FTDI
Доступен portable установщик: CDM212364_Setup.zip

Tip

Официальный гайд FTDI по установке драйверов

2️⃣ Установка зависимостей

Установите Распространяемый пакет Visual C++ для Visual Studio 2015
Установите 64-битный Python (3.11+)

3️⃣ Установка библиотеки

pip install libspectrum

🔍 Проверка установки

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

from pyspectrum import Spectrometer

# Должно выполниться без ошибок
spectrometer = Spectrometer()

Готово!

После успешного выполнения всех шагов библиотека готова к использованию

🚨 Возможные проблемы

Проблема	Решение
Ошибка доступа к USB (Linux)	Проверьте правила udev и перезагрузите систему
ImportError (Windows)	Убедитесь, что установлен правильный драйвер FTDI
ModuleNotFoundError	Проверьте версию Python и правильность установки библиотеки

Поддержка

При возникновении проблем создайте issue на GitHub.