Эмулкон - эмулятор подключаемого оборудования: ККТ, эквайринг, весы и принтеры без железа

Кому и зачем

Разработка и тестирование торгового оборудования упирается в железо. Касса, эквайринговый терминал, весы, принтер и сканер нужны одновременно; каждая конфигурация требует своего прогона; а сбой «нет бумаги» или «ответ после таймаута» воспроизводится только в момент печати чека и только на живом устройстве. В итоге проверка сценариев откладывается до внедрения, а ошибки ловит клиент.

Эмулкон заменяет этот парк программой: он изображает оборудование для «Библиотеки подключаемого оборудования» (БПО), а вы проверяете те же сценарии на стенде, без железа и без выезда.

Что такое Эмулкон

Это два компонента, которые работают вместе.

• Драйвер для БПО. Подключается в 1С как обычный драйвер оборудования, один на все типы, и передаёт вызовы на сервер. Конфигурация не меняется: вы тестируете то, что уйдёт в работу.
• Сервер эмуляции. В нём живут модели устройств с проверками настоящего железа, сценарии сбоев, журнал всех обменов и веб-интерфейс.

Драйвер не принимает решений: он знает только «метод, параметры, ответ, событие» и передаёт их серверу. Поэтому поведение оборудования меняется настройкой на сервере, без переустановки драйвера и без доработки конфигурации. Повтор команды с тем же идентификатором запроса не выполнит её второй раз, а команды одного устройства идут строго по очереди.

Какое оборудование эмулируется

Двенадцать типов, по требованиям к драйверам БПО версии 4.8:

Сценарии сбоев

Главное, чего не хватает без железа, — управляемых ошибок. Сценарий включается на лету, перезапуск не нужен:

• «нет бумаги» на выбранном по счёту чеке: первый чек проходит, третий падает;
• задержка ответа и ответ после таймаута — проверка поведения 1С в пограничных случаях;
• обрыв связи посреди команды и повтор после восстановления;
• смена состояния устройства: открыта крышка, нет связи с ОФД, переполнен буфер;
• ошибки фискализации и маркировки с кодами и текстами, как у настоящей модели.

Журнал обменов

Каждая команда, ответ и событие попадают в журнал: видно, что именно отправила 1С и что ответило «устройство». Есть отбор по устройству, рабочему месту, времени и типу события, выгрузка в JSON Lines. С таким журналом разбор ошибки занимает минуты, а не полдня, и его удобно приложить к описанию проблемы.

Интерфейсы

Веб-интерфейс

Устройства и их состояние, лента печати, рабочие места, сценарии и журнал в реальном времени. Открывается на сервере, по умолчанию адрес http://127.0.0.1:8737.

Трей у кассы

Показывает всплывающие чеки и слипы, печатает их на принтер Windows, показывает экран терминала «приложите карту» и экран весов — то, что кассир видит на настоящем оборудовании.

Консоль службы

Оснастка в стиле Windows: служба, токены доступа, рабочие места, устройства, сценарии, журнал. Там же настраивается сервер для касс в сети.

Установка и подключение

1. Запустите EmulkonSetup_0.9.5.exe (нужны права администратора). Установщик поставит службу, трей и драйвер и сам проверит, что всё работает.
2. В 1С откройте «Подключение и настройка оборудования» — «Драйверы оборудования» — «Добавить новый драйвер из файла» и укажите EmulkonDriver_0.9.5.zip.
3. Откройте веб-интерфейс сервера, добавьте устройство и рабочее место — можно подключать оборудование в конфигурации.

Драйвер лежит в поставке и после установки доступен по пути C:\Program Files\Emulkon\1C\driver\EmulkonDriver_0.9.5.zip, а также на странице загрузок сервера. Кассы в сети подключаются к одному серверу: «Пуск — Эмулкон, консоль — Служба — Свойства — Сервер для касс в сети», доступ — по токенам.

Сервер отдельно: команда, стенды, CI

Сервер кроссплатформенный, написан на Go и не требует внешних зависимостей. Его можно поднять без установки — общий сервер для команды разработчиков, стенд для приёмочных прогонов или сервис в CI. Каждый разработчик подключает драйвер в своей 1С к адресу сервера: рабочие места и устройства различаются сами (по компьютеру и базе), журнал и сценарии общие, доступ — по токенам. Сборка образа из исходников, которые входят в поставку:

docker build -f deploy/docker/Dockerfile -t emulkon:dev .
docker run -d --name emulkon -p 8737:8737 \
  -e EMULKON_DEVICE_TOKEN=... -e EMULKON_CONTROL_TOKEN=... \
  -v emulkon-data:/data emulkon:dev

Для Linux без Docker в исходниках есть сборочные файлы пакетов .deb и .rpm. Без токенов сервер годится только для локальной работы: при прослушивании не-localhost он предупреждает в журнале, а интерфейс показывает плашку.

Проверено на типовых конфигурациях

Прогоны выполнены на настоящих конфигурациях с настоящей БПО — по шагам: подключение оборудования, регистрация ККТ, чеки, маркировка, оплата картой, весы, принтеры, сканеры, ТСД, RFID, отключение.

Чем отличается от других эмуляторов

Эмуляторов кассы для 1С несколько, но почти все работают с одним-двумя типами устройств, внутри процесса 1С и без журнала обменов. Сравнение по открытым описаниям продуктов:

Сведения о других продуктах — по их открытым описаниям и обзорам на ноябрь 2026 года, сами продукты не запускались. «Нет данных» — в описаниях не нашлось. Названия продуктов принадлежат их правообладателям.

Требования

• Windows 10 или 11, драйвер для x64 и x86, права администратора при установке;
• платформа 1С:Предприятие 8.3 или 8.5, БПО 3.1 — 3.3;
• свободный порт 8737 (по умолчанию сервер слушает только 127.0.0.1);
• для серверной части без установки: Linux с пакетами .deb или .rpm либо Docker;
• SDK Native API 1С для самостоятельной сборки драйвера — он распространяется фирмой «1С».

Ограничения и честные предупреждения

• Только тестовые данные. Эмулкон узнаваем: «ЭМУЛЯТОР» в названии драйвера, в интерфейсе, на чеках и слипах. Реальные номера карт и ПИН не принимаются и не хранятся.
• Не для продакшена. Это инструмент разработки и тестирования. Реальная фискализация, ОФД и работа с покупателями требуют настоящего оборудования.
• Подписи кода нет. SmartScreen может предупредить о неизвестном издателе, антивирус (в том числе Microsoft Defender) иногда помечает установщик — это ложное срабатывание. Сверьте файл с SHA256SUMS: certutil -hashfile EmulkonSetup_0.9.5.exe SHA256. Если файл уже в карантине, восстановите его и разрешите в журнале защиты.
• SDK 1С в поставку не входит — он распространяется фирмой «1С». Исходники драйвера прилагаются, но для пересборки нужен SDK и путь к его каталогу include.

Лицензия, исходный код и обновления

Лицензия — Apache License 2.0, срок не ограничен. Исходный код открыт и входит в поставку: каталог source/, файлы LICENSE и NOTICE, сборка описана в source/README.md. Исходники можно изучать, изменять и собирать самостоятельно — ограничения лицензии обычные для Apache 2.0.

Что в поставке

• EmulkonSetup_0.9.5.exe — установщик: служба сервера, трей, драйвер, проверка работы;
• EmulkonDriver_0.9.5.zip — драйвер для ручной установки в 1С;
• source/ — исходный код целиком: сервер, драйвер, трей, консоль, установщик, документация и отчёты прогонов;
• SHA256SUMS — контрольные суммы файлов;
• INSTALL.txt — краткая инструкция по установке и требования.

Вопросы по работе и предложения — в комментариях к публикации: сюда же приходят сообщения об ошибках, и здесь выходят обновления.