В процессе разработки программного обеспечения для взаимодействия с кассовым оборудованием АТОЛ через C# программисты часто сталкиваются с ситуацией, когда исходный код кажется идентичным, но скомпилированный exe файл отказывается выполнять печать чека. Особенно это актуально при использовании старых драйверов 8-й серии и библиотеки FprnM1C.dll. Разберем детально причины такого поведения и способы устранения ошибок.
Одной из наиболее вероятных причин неработоспособности свежескомпилированного приложения является несоответствие разрядности процесса. Библиотека FprnM1C.dll представляет собой 32-битный COM-компонент. Рассмотрим, как это влияет на работу в современных операционных системах.
Если в настройках проекта Visual Studio в поле Platform Target указано значение Any CPU, то на 64-битной Windows приложение запустится как 64-битный процесс. При попытке инициализировать 32-битную библиотеку FprnM1C.dll внутри такого процесса возникнет исключение, так как 64-битное приложение не может напрямую загружать 32-битные DLL. Проанализируем правильный алгоритм настройки:
x86.Поскольку работа идет через COM-интерфейс, Visual Studio при добавлении ссылки на FprnM1C.dll создает промежуточную сборку (Interop). Разберем шаги по обновлению этих зависимостей, если код перестал работать:
Во-первых, необходимо полностью удалить старую ссылку из раздела References и добавить её заново, выбрав компонент из списка зарегистрированных в системе COM-объектов. Во-вторых, обратим внимание на свойство Embed Interop Types (Внедрить типы взаимодействия). Для старых драйверов АТОЛ иногда требуется установить это значение в False, а свойство Copy Local — в True. Это заставит приложение использовать внешнюю Interop-библиотеку, что повышает стабильность вызовов методов.
Выясним причину, по которой библиотека может быть видна в системе, но не вызываться из кода. Библиотека FprnM1C.dll должна быть правильно зарегистрирована через regsvr32. На 64-битных системах важно использовать правильную версию утилиты. Выполним следующие действия в командной строке от имени администратора:
Для 64-битных систем:
C:\Windows\SysWOW64\regsvr32.exe "C:\PathToDriver\FprnM1C.dll"
Если регистрация прошла успешно, операционная система создаст необходимые записи в реестре, к которым будет обращаться ваше C# приложение при создании экземпляра объекта AddIn.FPrnM45 (или аналогичного для вашей версии).
Проанализируем пример типичной реализации печати через 8-ю версию драйвера. Даже если логика кажется одинаковой, дьявол кроется в деталях инициализации. Посмотрим на фрагмент кода, который часто используется для работы с АТОЛ:
// Создание объекта драйвера
var driver = new FprnM1C.FPrnM45();
// Установка параметров связи
driver.DeviceEnabled = true;
if (driver.ResultCode != 0)
{
Console.WriteLine("Ошибка инициализации: " + driver.ResultDescription);
return;
}
// Начало работы с чеком
driver.Mode = 1; // Регистрация
driver.SetMode();
driver.BeginItem();
driver.ItemType = 1;
driver.Name = "Тестовый товар";
driver.Price = 100.00;
driver.Quantity = 1;
driver.EndItem();
Важно убедиться, что все свойства (Price, Quantity) передаются в правильных типах данных, ожидаемых COM-объектом. Иногда неявное приведение типов в C# может привести к ошибкам, которые не видны при компиляции, но проявляются в Runtime.
Как отмечают специалисты, 8-я версия драйвера является морально устаревшей и сложной в поддержке из-за привязки к COM. Рассмотрим альтернативный и более надежный путь — использование 10-й версии драйвера (ДТО 10). В ней реализована нативная поддержка .NET через библиотеку Atol.Drivers10.Fptr.dll.
Проанализируем преимущества перехода на 10-ю версию:
Посмотрим на пример кода при использовании ДТО 10:
using Atol.Drivers10.Fptr;
// Создание объекта
IFptr fptr = new Fptr();
fptr.open();
// Формирование чека через параметры
fptr.setParam(Constants.LIBFPTR_PARAM_REPORT_TYPE, Constants.LIBFPTR_RT_CLOSE_SHIFT);
fptr.report();
fptr.close();
Для реализации печати чека в 10-й версии рекомендуется использовать JSON-задания. Это позволяет избежать проблем с "повисшими" чеками при обрыве связи. Выясним, как это выглядит структурно:
string jsonTask = "{ \"type\": \"sell\", \"items\": [ { \"name\": \"Товар\", \"price\": 100, \"quantity\": 1, \"amount\": 100, \"tax\": { \"type\": \"vat10\" } } ] }";
fptr.setParam(Constants.LIBFPTR_PARAM_JSON_DATA, jsonTask);
fptr.processJson();
Часто забываемый момент — наличие системных библиотек Microsoft Visual C++ Redistributable. Драйверы АТОЛ написаны на C++, и для их работы в системе должны быть установлены пакеты 2008 и 2010 годов (именно x86 версии, так как драйвер 8-й серии 32-битный). Если на машине разработчика эти пакеты есть, а на целевом ПК — нет, приложение не сможет инициализировать FprnM1C.dll.
Подводя итог, если ваше скомпилированное приложение на C# не работает с ККТ АТОЛ, в первую очередь проанализируйте настройки разрядности проекта (x86) и обновите COM-ссылки. Однако самым стратегически верным решением будет отказ от использования FprnM1C.dll в пользу современных библиотек драйвера 10-й версии, которые избавят вас от сложностей с регистрацией компонентов и совместимостью архитектур.