<![CDATA[
# Инструкция по установке и запуску «Система управления оборудованием “DeviceControl”»
## Требования
- **ОС:** Windows 7/8/10/11 или Windows Server 2008/2012/2016/2019/2022
- **Права:** Администратор (для установки сервисов)
- **Сеть:** TCP/IP для работы с устройствами
## Подготовка к установке
1. Распакуйте дистрибутив в выбранную директорию (например, `C:\DeviceControl\`)
2. Убедитесь, что все файлы присутствуют в директории `install/`
3. Закройте все приложения, которые могут использовать порты 7890, 7891
## Установка сервисов
### Автоматическая установка (рекомендуется)
1. Откройте командную строку **от имени администратора**
2. Перейдите в директорию `install/`:
```cmd
cd C:\DeviceControl\install
```
3. Запустите скрипт установки:
```cmd
install.bat
```
4. Следуйте инструкциям на экране
Скрипт автоматически:
- Удалит старые версии сервисов (если установлены)
- Зарегистрирует основной сервис `IServ` с ручным запуском (через `/install`)
- Зарегистрирует лицензионный сервис `DCLicense` с автоматическим запуском (через `/install`)
- Запустит лицензионный сервис, который автоматически запустит основной сервис
- Запустит эмуляторы устройств для тестирования (если они находятся в папке `emulators/`)
- Проверит наличие конфигурационных файлов
**Примечание:** При установке сервисов могут появляться диалоговые окна, которые автоматически минимизируются.
### Ручная установка
Если автоматическая установка не подходит, выполните следующие команды от имени администратора:
```cmd
REM Регистрация основного сервиса (ручной запуск)
cd C:\DeviceControl\install
devcon-srv.exe /install
sc config "IServ" start= demand
REM Регистрация лицензионного сервиса (автоматический запуск)
dclicense-srv.exe /install
sc config "DCLicense" start= auto
REM Запуск лицензионного сервиса
sc start "DCLicense"
```
**Важно:** При ручной установке используйте `/install` для правильной регистрации сервисов. Имя сервиса определяется самим исполняемым файлом, поэтому может отличаться от `DeviceControlSrv` или `DCLicenseSrv`.
## Настройка конфигурации
### 1. Настройка лицензионного сервиса (licservice.conf)
Откройте файл `licservice.conf` и проверьте/настройте следующие параметры:
```ini
[general]
; Имя основного сервиса в Windows (DisplayName)
mainServiceName=IServ
; Путь к директории основного сервиса (опционально)
; Если не указан, используется путь относительно текущей директории
mainServicePath=
; Путь к config.conf основного сервиса
; Если указан как относительный путь, то относительно mainServicePath
mainConfigPath=config.conf
; Имя файла лога
log=DCLicense.log
```
**Важно:**
- `mainServiceName` должно соответствовать отображаемому имени основного сервиса (по умолчанию `IServ`)
- Если основной сервис установлен в другой директории, укажите `mainServicePath`
- Если `config.conf` находится в другой директории, укажите полный путь в `mainConfigPath`
### 2. Настройка основного сервиса (config.conf)
Откройте файл `config.conf` и настройте параметры:
```ini
[general]
local=127.0.0.1 # IP-адрес для прослушивания
localPort=7890 # Порт HTTP API
useAuth=0 # Использование аутентификации (0/1)
user=admin # Имя пользователя (если useAuth=1)
password=cmvov1945 # Пароль (если useAuth=1)
enabled=1 # Включен ли сервис (1/0)
remote=* # Разрешенные IP-адреса (* = все)
log=iSrv.log # Имя файла лога
logLevel=3 # Уровень логирования (0-3)
UPSMon=1 # Мониторинг ИБП (1/0)
UIElem=UItrigger,UIlamp,UITriggerTimer,UISlider,UIButton
UIset=UItrigger,UISlider,UIButton
UIget=UIlamp,UISlider
[images]
local=127.0.0.1 # IP-адрес для веб-интерфейса изображений
localPort=7891 # Порт веб-интерфейса изображений
enabled=0 # Включен ли веб-интерфейс изображений (1/0)
isControl=1 # Режим управления (1/0)
rows=6 # Количество строк в интерфейсе
```
### 3. Настройка устройств (setup.conf)
Добавьте ваши устройства в файл `setup.conf`. Пример:
```ini
[device1]
name=Проектор в зале
IP=192.168.1.100
PORT=4352
PLUGIN=pjlink
PASSWORD=*
image=hand-r.svg
[device2]
name=Панель в переговорной
IP=192.168.1.101
PORT=5000
PLUGIN=iiyama
ID=1
image=hand-r.svg
```
### 4. Настройка команд (commands.conf)
Настройте команды для управления устройствами. Пример:
```ini
[power_on]
plugin=pjlink
function=power
params=ON
[power_off]
plugin=pjlink
function=power
params=OFF
[status]
plugin=pjlink
function=status
```
## Запуск системы
### Автоматический запуск (рекомендуется)
1. **Перезагрузите компьютер** - лицензионный сервис запустится автоматически и запустит основной сервис
ИЛИ
2. **Запустите лицензионный сервис вручную:**
```cmd
sc start DCLicenseSrv
```
Лицензионный сервис автоматически запустит основной сервис.
### Ручной запуск основного сервиса
Если нужно запустить основной сервис вручную (без лицензионного):
```cmd
sc start DeviceControlSrv
```
**Внимание:** При ручном запуске основного сервиса лицензионный ключ не будет сгенерирован, и сервис может не работать корректно.
## Проверка работы
### 1. Проверка статуса сервисов
```cmd
sc query DeviceControlSrv
sc query DCLicenseSrv
```
Оба сервиса должны быть в состоянии `RUNNING`.
**Примечание:** Если вы используете другую версию основного сервиса, имя сервиса может отличаться. Используйте `sc query` для поиска сервиса по отображаемому имени `IServ`.
### 2. Проверка эмуляторов (если используется тестирование)
Если вы используете эмуляторы для тестирования, проверьте, что они запущены:
```cmd
tasklist | findstr "emulator"
```
Должны быть видны три процесса:
- `pjlink-emulator.exe`
- `iiyama-emulator.exe`
- `panphonics-emulator.exe`
Также проверьте, что порты прослушиваются:
```cmd
netstat -an | findstr "4352 5000 23"
```
### 3. Проверка веб-интерфейса
Откройте в браузере:
```
http://127.0.0.1:7890
```
Должен открыться веб-интерфейс системы управления устройствами.
### 4. Проверка логов
Проверьте логи сервисов:
- `DCLicense.log` - лог лицензионного сервиса
- `iSrv.log` - лог основного сервиса (или имя, указанное в `config.conf`)
## Управление сервисами
### Остановка сервисов
```cmd
REM Остановка основного сервиса
sc stop DeviceControlSrv
REM Остановка лицензионного сервиса (автоматически остановит основной)
sc stop DCLicenseSrv
```
### Запуск сервисов
```cmd
REM Запуск лицензионного сервиса (рекомендуется)
sc start DCLicenseSrv
REM Или запуск основного сервиса напрямую
sc start DeviceControlSrv
```
### Перезапуск сервисов
```cmd
sc stop DCLicenseSrv
timeout /t 3 /nobreak
sc start DCLicenseSrv
```
## Удаление сервисов
### Автоматическое удаление
Запустите `install.bat` - он автоматически удалит старые версии перед установкой новых.
### Ручное удаление
```cmd
REM Остановка сервисов
sc stop DeviceControlSrv
sc stop DCLicenseSrv
REM Удаление сервисов
sc delete DeviceControlSrv
sc delete DCLicenseSrv
```
## Тестирование с эмуляторами
### Автоматический запуск эмуляторов
При установке через `install.bat` эмуляторы запускаются автоматически после успешного запуска лицензионного сервиса. Эмуляторы запускаются в минимизированных окнах из папки `emulators/`.
### Ручной запуск эмуляторов
Для ручного запуска эмуляторов:
1. Перейдите в директорию `emulators/`
2. Запустите `start-emulators.cmd`
Или запустите каждый эмулятор отдельно:
```cmd
cd emulators
start "PJLink Emulator" /MIN pjlink-emulator.exe 4352 "PJLink Projector"
start "Iiyama Emulator" /MIN iiyama-emulator.exe 5000 1 "Iiyama Panel"
start "Panphonics Emulator" /MIN panphonics-emulator.exe 23 admin "Panphonics Device"
```
3. Настройте `setup.conf` для работы с эмуляторами (см. `TEST_EXAMPLE.md`)
Подробнее см. файл `TEST_EXAMPLE.md`.
## Устранение проблем
### Сервис не запускается
1. Проверьте права администратора
2. Проверьте логи сервисов
3. Убедитесь, что порты 7890, 7891 не заняты:
```cmd
netstat -an | findstr "7890 7891"
```
4. Проверьте конфигурационные файлы на ошибки
### Лицензионный сервис не запускает основной сервис
1. Проверьте `licservice.conf`:
- Правильность `mainServiceName`
- Существование пути к `config.conf`
2. Проверьте `DCLicense.log` на ошибки
3. Убедитесь, что дата системы не превышает 31.12.2026 (для демонстрационной версии ПО)
### Основной сервис не видит устройства
1. Проверьте настройки в `setup.conf`
2. Проверьте, что плагины находятся в директории `plugins/`
3. Проверьте логи основного сервиса
4. Проверьте сетевую связность с устройствами
### Веб-интерфейс не открывается
1. Проверьте, что сервис запущен
2. Проверьте настройки `local` и `localPort` в `config.conf`
3. Проверьте файрвол Windows
4. Попробуйте открыть `http://127.0.0.1:7890` вместо `localhost`
## Дополнительная информация
- **Лицензия:** Действует до 31.12.2026 (для демонстрационной версии ПО)
- **Привязка:** К HDD ID компьютера
- **Управление:** Автоматическое через лицензионный сервис
## Поддержка
При возникновении проблем:
1. Проверьте логи сервисов
2. Проверьте конфигурационные файлы
3. Убедитесь, что все компоненты установлены корректно
## По вопросам установки ПО:
Александр Ковернинский
+7 (967) 178 53 77
support@devcon.site
Время работы : Пн.-Пт. 10:00 – 18-00 (по МСК)
]]>