ATH-7333_SDK_Base Базовый комплект средств разработки ПО

Базовый комплект разработки программного обеспечения (Software Development Kit - SDK) предназначен для создания приложений пользователя, использующих управляемые источники питания AKTAKOM ATH-7333, ATH-7335, ATH-7338. Поддерживаются интерфейсы USB и LAN.

Состав комплекта

• динамическая библиотека (DLL) Windows, содержащая все функции, необходимые для работы с прибором;
• заголовочный файл библиотеки на языке Си;
• файл справки с описанием всех функций библиотеки.

Данная версия в соответствии с лицензионным соглашением, является условно-бесплатной и не предусматривает примеров применения или какой-либо технической поддержки. Этот базовый вариант SDK можно рекомендовать для применения высококвалифицированными программистами, которым достаточно перечня функций и перечисления формальных параметров для создания собственного программного обеспечения.

При необходимости наличия примеров программирования или небольшой технической поддержки (по e-mail) следует воспользоваться платной полной версией данного SDK.

Подробное описание состава SDK

Дерево функций:

Имя класса\панели: Имя функции:

Initialize ATH7333_init

Информация об устройстве (Device Info)

Get Channel Count ATH7333_GetChannelCount
Get Channel Max Range ATH7333_GetChannelMaxRange

Конфигурация (Configuration)

Set Control ATH7333_SetControl
Get Status ATH7333_GetStatus
Set Voltage ATH7333_SetVoltage
Get Voltage ATH7333_GetVoltage
Set Current ATH7333_SetCurrent
Get Current ATH7333_GetCurrent

Диагностика (Diagnosis)

Test Voltage ATH7333_TestVoltage
Test Current ATH7333_TestCurrent
Test Temperature ATH7333_TestTemperature

Утилиты (Utility)

Get AUL Device Info ATH7333_GetAULDeviceInfo
Is Opened ATH7333_IsOpened
Is Valid Device ATH7333_IsValidDevice
Reset ATH7333_reset
Set ProcessSysEventFuncPtr ATH7333_SetProcessSysEventFuncPtr

Информация о сокетах (Socket Info)

Socket List Count ATH7333_SocketListCount
Socket List Clear ATH7333_SocketListClear
Add Socket ATH7333_AddSocket
Get Socket ATH7333_GetSocket
Get Device Socket ATH7333_GetDeviceSocket
Set Socket ATH7333_SetSocket
Del Socket ATH7333_DelSocket
Scan Socket ATH7333_ScanSocket

Информация об ошибках (Error Info)

Get Error Message ATH7333_GetErrorMessage
Set Error Message ATH7333_SetErrorMessage
Error Message ATH7333_error_message
Get Last Error ATH7333_GetLastError
Clear Driver Error ATH7333_ClearDrvError

Close ATH7333_Close

Коды ошибок

Все функции данного драйвера возвращают код статуса, показывающий успешность выполнение требующихся действий. Общее правило для этих кодой ошибок следующее:

Код Значение
------------------------------------------------------------
0 Успешно
Положительные величины Предупреждения
Отрицательные величины Ошибки

Пользовательская программа может получить более подробную информацию об ошибках драйвера с помощью функций класса Информация об ошибках (Error Info)

Get Error Message ATH7333_GetErrorMessage
Set Error Message ATH7333_SetErrorMessage
Error Message ATH7333_error_message
Get Last Error ATH7333_GetLastError
Clear Driver Error ATH7333_ClearDrvError

Ниже приведен полный список кодов ошибок и придепреждений драйвера и их стандартные описания:

Код Описание
---------------------------------------------------------------
(0), "Нет ошибки"
(-1), "Неизвестная ошибка"
(-2), "Неправильные параметры функции"
(-3), "Ошибка при обмене данными с прибором"
(-4), "Исчерпан лимит времени на операцию"
(-5), "Ошибка при открытии локального интерфейса"
(-6), "Ошибка при открытии сетевого интерфейса"
(-7), "Неправильный интерфейс"
(-8), "Ошибка при манипулировании с памятью ПК"
(-9), "Невозможно загрузить динамическую библиотеку"
(-10), "Функция не найдена"
(-11), "Прибор не открыт"
(-12), "Неправильный тип AUL-устройства"
(-13), "Процесс прерван пользователем"
(-14), "Файл не найден"
(-15), "Ошибка при открытии файла"
(-16), "Ошибка при закрытии файла"
(-17), "Ошибка при чтении файла"
(-18), "Ошибка при записи файла"
(-19), "Доступ запрещен"
(-20), "Ключ доступна не найден"
(-21), "Неправильный формат команды, запроса или ответа"
(-22), "Команда не поддерживается"
(-23), "Невозможно установить связь с сервером"
(-24), "Устройство блокировано другим пользователем"
(-25), "Сокет не определен"
(-26), "Сокет используется открытым устройством, операции с ним запрещены"

Предупреждения:
(1), "Неизвестное предупреждение"
(2), "Операция не завершена"
(3), "Данные отсутствуют"
(4), "Неправильная версия"
(5), "Автоматическое управление"
(6) "Повторное действие"

Стандартная комплектация

Программное обеспечение в стандартной поставке не имеет физического носителя и может быть загружено на сайте www.aktakom.ru после регистрации прибора с указанием серийного номера.

Программное обеспечение распространяется по лицензии.

Для загрузки программного обеспечения нажмите кнопку «Загрузить» или перейдите в раздел «Техническая поддержка» -> «Загружаемые файлы для Вашего прибора АКТАКОМ», затем авторизуйтесь, указав свой логин и пароль. Если Вы ранее не регистрировались на сайте www.aktakom.ru, пройдите по ссылке «Зарегистрироваться» и укажите все необходимые данные.

Затем выберите из списка Ваш прибор АКТАКОМ и введите его серийный номер. ВНИМАНИЕ! Серийный номер необходимо вводить в точности, как он указан на приборе, со всеми буквами, цифрами и другими знаками. Далее потребуется зарегистрировать Ваш продукт АКТАКОМ, если Вы не сделали этого ранее, и принять условия Лицензионного Договора, после чего Вам будут предоставлены ссылки для загрузки программного обеспечения.

Чтобы начать загрузку, просто нажмите кнопку «Загрузить» и выберите папку, в которую нужно сохранить загружаемый файл. Если загружаемый файл имеет расширение zip, перед установкой программного обеспечения файл необходимо распаковать.

Для загрузки приобретенного программного обеспечения Вам потребуется ввести код загрузки программного обеспечения (это, своего рода, пароль, позволяющий загрузить программное обеспечение АКТАКОМ с сайта www.aktakom.ru). Код загрузки будет передан Вам после оплаты счета и оформления товаро-сопроводительных документов в соответствии с действующим законодательством.

Рекомендуется своевременно сделать резервную копию полученных файлов. В случае утраты программного обеспечения (по любой причине) или кода загрузки повторная поставка осуществляется за дополнительную плату.

Программное обеспечение может быть поставлено на физическом носителе (компакт-диске). Запись программного обеспечения на носитель (компакт диск) и его доставка осуществляются за дополнительную плату.

Вопросы и ответы

Что означает сообщение в программе АКТАКОМ "Прибор не открыт"?

Где можно посмотреть пример использования программы?

Что означает сообщение в программе АКТАКОМ "Прибор не открыт"?

Если при работе с программным обеспечением АКТАКОМ появляется сообщение об ошибке "Прибор не открыт" или "No com-port", это означает, что программе не удалось установить связь с прибором. Причин для этого может быть несколько. 1. Соединение компьютера с прибором физически отсутствует: прибор выключен; интерфейсный кабель не подсоединён. В этом случае прибор также не отобразится в диспетчере устройств Windows. 2. Физическое соединение компьютера с прибором есть, но устройство не установлено в операционной системе — не установлен драйвер или установлен устаревший драйвер. В диспетчере устройств прибор отобразится как "Неизвестное устройство" или будет обозначен не так, как описано в его инструкции. 3. Прибор успешно обнаружен операционной системой, правильно отображается в диспетчере устройств, но в настройках приложения указан неверный тип прибора. Например, к ПК подключён цифровой запоминающий осциллограф АКТАКОМ ACK-3102, а в настройках AKTAKOM Oscilloscope Pro указана другая модель — цифровой запоминающий осциллограф АКТАКОМ ACK-3106. У этих приборов разный набор команд, и цифровой запоминающий осциллограф АКТАКОМ ACK-3102 не сможет правильно ответить на запросы по протоколу цифрового запоминающего осциллографа АКТАКОМ ACK-3106. Приложение (программа AKTAKOM Oscilloscope Pro) не опознает подключённый прибор как корректное оборудование и не выведет его имя в список доступной для подключения аппаратуры. Аналогичная ситуация может возникать, если подключить прибор по интерфейсу LAN и пытаться использовать его, настроив программу на работу через USB. 4. Некоторые приложения (программы) АКТАКОМ требуют активации прибора при первом подключении. Обнаружив подходящий прибор, приложение выводит его имя и серийный номер и предлагает ввести ключ активации. Если закрыть это окно, не введя ключ или ввести ключ ошибочно (например, ввести код загрузки программного обеспечения вместо ключа), то доступ к прибору будет запрещён, и посылки ему команд также будут приводить к ошибке "Прибор не открыт". Наверх

Где можно посмотреть пример использования программы?
Примеры программирования приведены в полной версии SDK, которая является платной и может быть загружена с сайта после оплаты. Для получения счета на оплату следует обратиться в Вашему поставщику приборов Актаком, см. раздел «Где купить» или написать в службу технической поддержки. Наверх

Документация

ATH-7333_SDK Описание библиотеки функций и коды ошибок Редакция: 1.0.3.8 | Дата изменения: 24.05.2019

Читать У Вас уже есть этот прибор? Да     Нет

Установка AKTAKOM ATH-7333_SDK_Base