Драйвер контрольно-кассовой техники v.10
Функции
Программирование параметров ККТ

Методы программирования параметров (настроечных таблиц) ККТ Подробнее...

Функции

DTOX_SHARED_EXPORT int DTOX_SHARED_CCA libfptr_upload_picture_from_file (libfptr_handle handle)
 Загружает картинку в память ККТ или во внешнее хранилище. Подробнее...
 
DTOX_SHARED_EXPORT int DTOX_SHARED_CCA libfptr_clear_pictures (libfptr_handle handle)
 Очищает память ККТ или внешнее хранилище от картинок Подробнее...
 
DTOX_SHARED_EXPORT int DTOX_SHARED_CCA libfptr_write_device_setting_raw (libfptr_handle handle)
 Записывает настройку во внутреннюю таблицу ККТ. Подробнее...
 
DTOX_SHARED_EXPORT int DTOX_SHARED_CCA libfptr_read_device_setting_raw (libfptr_handle handle)
 Считывает настройку из внутренней таблицы ККТ. Подробнее...
 
DTOX_SHARED_EXPORT int DTOX_SHARED_CCA libfptr_commit_settings (libfptr_handle handle)
 Применяет записанные методами libfptr_write_device_setting_raw() и libfptr_write_device_setting() настройки. Подробнее...
 
DTOX_SHARED_EXPORT int DTOX_SHARED_CCA libfptr_init_settings (libfptr_handle handle)
 Инициализирует системные таблицы начальными значениями Подробнее...
 
DTOX_SHARED_EXPORT int DTOX_SHARED_CCA libfptr_read_device_setting (libfptr_handle handle)
 Считывает настройку из внутренней таблицы ККТ. Подробнее...
 
DTOX_SHARED_EXPORT int DTOX_SHARED_CCA libfptr_write_device_setting (libfptr_handle handle)
 Записывает настройку во внутреннюю таблицу ККТ. Подробнее...
 

Подробное описание

Методы программирования параметров (настроечных таблиц) ККТ

Функции

◆ libfptr_clear_pictures()

DTOX_SHARED_EXPORT int DTOX_SHARED_CCA libfptr_clear_pictures ( libfptr_handle  handle)

Очищает память ККТ или внешнее хранилище от картинок

Аргументы
handleДескриптор
Возвращаемые значения
-1Ошибка
0Успех

◆ libfptr_commit_settings()

DTOX_SHARED_EXPORT int DTOX_SHARED_CCA libfptr_commit_settings ( libfptr_handle  handle)

Применяет записанные методами libfptr_write_device_setting_raw() и libfptr_write_device_setting() настройки.

Поведение метода зависит от ККТ, но требуется всегда вызывать его после программирования набора настроек ККТ, иначе ККТ может восстановить старые настройки при перезагрузке.

Аргументы
handleДескриптор
Возвращаемые значения
-1Ошибка
0Успех

◆ libfptr_init_settings()

DTOX_SHARED_EXPORT int DTOX_SHARED_CCA libfptr_init_settings ( libfptr_handle  handle)

Инициализирует системные таблицы начальными значениями

Предупреждения
Для корректной инициализации таблиц необходимо после вызова метода выключить и включить ККТ.
Аргументы
handleДескриптор
Возвращаемые значения
-1Ошибка
0Успех

◆ libfptr_read_device_setting()

DTOX_SHARED_EXPORT int DTOX_SHARED_CCA libfptr_read_device_setting ( libfptr_handle  handle)

Считывает настройку из внутренней таблицы ККТ.

Данный метод предназначен для унификации работы с настройками ККТ. Каждому из параметров (Настройки ККТ) соответствует настройка во внутренних таблицах ККТ. Возвращаемые из метода значения регламентированы библиотекой и будут автоматически преобразованы из значений, соответствующих текущей модели ККТ.

Общие параметры
Название Описание Тип параметра Обязательность или
значение по умолчанию
Входные параметры
LIBFPTR_PARAM_SETTING_ID Номер настройки int +
Выходные параметры
LIBFPTR_PARAM_SETTING_VALUE Значение настройки Зависит от настройки

Пример использования:

// Чтение настройки "DNS ОФД"
{
// Обработка ошибки
return;
}
std::vector<wchar_t> answerStr(1024);
int size = libfptr_get_param_str(handle, LIBFPTR_PARAM_SETTING_VALUE, &answerStr[0], answerStr.size());
if (size > answerStr.length())
{
answerStr.resize(size);
libfptr_get_param_str(handle, LIBFPTR_PARAM_ANSWER_BUFFER, &answerStr[0], answerStr.size());
}
// Чтение настройки "Порт ОФД"
{
// Обработка ошибки
return;
}
Аргументы
handleДескриптор
Возвращаемые значения
-1Ошибка
0Успех

◆ libfptr_read_device_setting_raw()

DTOX_SHARED_EXPORT int DTOX_SHARED_CCA libfptr_read_device_setting_raw ( libfptr_handle  handle)

Считывает настройку из внутренней таблицы ККТ.

Возможные значения можно узнать в описании конкретной модели ККТ.

Общие параметры
Название Описание Тип параметра Обязательность или
значение по умолчанию
Входные параметры
LIBFPTR_PARAM_TABLE Номер таблицы int +
LIBFPTR_PARAM_ROW Номер ряда int +
LIBFPTR_PARAM_FIELD Номер поля int +
Выходные параметры
LIBFPTR_PARAM_FIELD_VALUE Значение поля bytearray

Пример использования:

{
// Обработка ошибки
return;
}
std::vector<uchar> value;
int size = libfptr_get_param_bytearray(handle, LIBFPTR_PARAM_FIELD_VALUE, &value[0], value.size());
if (size > value.size())
{
value.resize(size);
libfptr_get_param_bytearray(handle, LIBFPTR_PARAM_FIELD_VALUE, &value[0], value.size());
}
Аргументы
handleДескриптор
Возвращаемые значения
-1Ошибка
0Успех

◆ libfptr_upload_picture_from_file()

DTOX_SHARED_EXPORT int DTOX_SHARED_CCA libfptr_upload_picture_from_file ( libfptr_handle  handle)

Загружает картинку в память ККТ или во внешнее хранилище.

Метод подходит для загрузки статичных, часто используемых изображений, для ускорения их печати. Номер картинки, полученный в результате вызова метода, в дальнейшем может быть использован для печати картинки из памяти ККТ (libfptr_print_picture_by_number). Некоторые ККТ позволяют печатать картинку, загруженную таким образом, в клише.

Общие параметры
Название Описание Тип параметра Обязательность или
значение по умолчанию
Входные параметры
LIBFPTR_PARAM_FILENAME Путь к файлу string +
LIBFPTR_PARAM_SCALE_PERCENT Масштаб, проценты int 100%
Выходные параметры
LIBFPTR_PARAM_PICTURE_NUMBER Номер картинки int

Пример использования:

libfptr_set_param_str(handle, LIBFPTR_PARAM_FILENAME, L"С:\\picture.png");
{
// Обработка ошибки
return;
}

Поддерживаются форматы:

  • bmp
  • png

Библиотека сама преобразует изображение в черно-белое.

Аргументы
handleДескриптор
Возвращаемые значения
-1Ошибка
0Успех

◆ libfptr_write_device_setting()

DTOX_SHARED_EXPORT int DTOX_SHARED_CCA libfptr_write_device_setting ( libfptr_handle  handle)

Записывает настройку во внутреннюю таблицу ККТ.

Данный метод предназначен для унификации работы с настройками ККТ. Каждому из параметров (Настройки ККТ) соответствует настройка во внутренних таблицах ККТ. Передаваемые в метод значения регламентированы библиотекой и будут автоматически преобразованы в подходящие для текущей ККТ значения.

Общие параметры
Название Описание Тип параметра Обязательность или
значение по умолчанию
Входные параметры
LIBFPTR_PARAM_SETTING_ID Номер настройки int +
LIBFPTR_PARAM_SETTING_VALUE Значение настройки Зависит от настройки +

Пример использования:

// Запись настройки "DNS ОФД"
{
// Обработка ошибки
return;
}
// Запись настройки "Порт ОФД"
{
// Обработка ошибки
return;
}
Аргументы
handleДескриптор
Возвращаемые значения
-1Ошибка
0Успех

◆ libfptr_write_device_setting_raw()

DTOX_SHARED_EXPORT int DTOX_SHARED_CCA libfptr_write_device_setting_raw ( libfptr_handle  handle)

Записывает настройку во внутреннюю таблицу ККТ.

Возможные значения можно узнать в описании конкретной модели ККТ.

Общие параметры
Название Описание Тип параметра Обязательность или
значение по умолчанию
Входные параметры
LIBFPTR_PARAM_TABLE Номер таблицы int +
LIBFPTR_PARAM_ROW Номер ряда int +
LIBFPTR_PARAM_FIELD Номер поля int +
LIBFPTR_PARAM_FIELD_VALUE Значение поля bytearray +

Пример использования:

uchar value[] = { 0x01 };
libfptr_set_param_bytearray(handle, LIBFPTR_PARAM_FIELD_VALUE, value, sizeof(value) / sizeof(value[0]));
{
// Обработка ошибки
return;
}
Аргументы
handleДескриптор
Возвращаемые значения
-1Ошибка
0Успех