ОВЕН · SysLibCom · 14 pp.

ОВЕН SysLibCom — Руководство пользователя библиотеки работы с COM-портами (PDF)

Related manuals

Contents

Document text

Содержание 1 Цель документа...........................................................................................................................................3 2 Установка библиотеки.................................................................................................................................4 3 Описание библиотеки SysLibCom..............................................................................................................5 3.1 SysComOpen .......................................................................................................................................5 3.2 PORTS.................................................................................................................................................5 3.3 SysComSetSettings...............................................................................................................................5 3.4 COMSETTINGS....................................................................................................................................6 3.5 SysComSetSettingsEx...........................................................................................................................6 3.6 COMSETTINGSEX ...............................................................................................................................6 3.7 SysComClose .......................................................................................................................................7 3.8 SysComWrite........................................................................................................................................7 3.9 SysComRead........................................................................................................................................8 3.10 SysComGetVersion2300......................................................................................................................8 4 Номера портов ............................................................................................................................................9 5 Пример реализации SysLibCom ...............................................................................................................10 6 Программа тестирования COM-порта ......................................................................................................12 2

Page 2

1 Цель документа

1 Цель документа 1 Цель документа Библиотека SysLibCom предоставляет работу с последовательными портами RS-485/RS-232 ПЛК. Используется для обмена данными с внешними устройствами. Данный документ содержит описание алгоритмов работы блоков, входные/выходные параметры и типы данных каждого блока, и предназначен для ознакомления с составом библиотеки. Для полного понимания принципов работы в среде необходимо ознакомиться с руководством пользователя ALTA IDE. 3

Page 3

2 Установка библиотеки

2 Установка библиотеки 2 Установка библиотеки Чтобы подключить библиотеку к проекту: 1. Откройте редактор Менеджер библиотек одним из способов: дважды нажмите ЛКМ на системную папку Менеджер библиотек в дереве проекта; или нажмите ПКМ на системную папку Менеджер библиотек в дереве проекта и выберите в контекстном меню пункт Открыть : Рисунок 2.1 В редакторе Менеджер библиотек откройте вкладку Магазин . Выберите библиотеку SysLibCom и нажмите кнопку Подключить на карточке библиотеки. Библиотека добавится в проект и отобразится на вкладке Мои библиотеки в редакторе Менеджер библиотек . 4

Page 4

3.3 SysComSetSettings

3 Описание библиотеки SysLibCom 3 Описание библиотеки SysLibCom Библиотека SysLibCom содержит: SysComOpen ; PORTS ; SysComSetSettings ; COMSETTINGS ; SysComSetSettingsEx ; COMSETTINGSEX ; SysComClose ; SysComWrite ; SysComRead ; SysComGetVersion2300 . Блоки библиотеки SysLibCom используются совместно, поэтому отдельные примеры работы каждого блока не приводятся. В разделах Пример реализации SysLibCom и Программа тестирования COM-порта представлены общие готовые примеры программы, демонстрирующие применение всех блоков и работу с портами ПЛК. ПРИМЕЧАНИЕ Вызов элементов библиотеки SysLibCom в AltaIDE реализован через вызов родительского объекта в коде (библиотеки). Пример Settings : SysLibCom.

COMSETTINGS; Таким образом можно удобно отследить к какой библиотеке именно относится каждый элемент программы. 3.1 SysComOpen Функция SysComOpen типа данных DWORD открывает последовательный порт. SysComOpen возвращает дескриптор порта, который используется при вызове других функций библиотеки. В случае ошибки, возвращается 16#FFFFFFFF. 3.2 PORTS Перечисление PORTS: TYPE PORTS : BYTE (COM1:=1, COM2, COM3, COM4, COM5, COM6, COM7, COM8); END_TYPE 3.3 SysComSetSettings Функция SysComSetSettings типа BOOL устанавливает скорость, число стоповых бит, контроль паритета, таймаут, размер буфера и период опроса для последовательного порта.

Требуемые параметры передаются посредством указателя на структуру COMSETTINGS . Возвращает TRUE при успешной установке параметров, иначе FALSE. 5 Имя переменной Тип данных Описание Входные переменные Port PORTS Открываемый порт (например: COM1); Порт определяется перечислением PORTS Имя переменной Тип данных Описание Входные переменные dwHandle DWORD Дескриптор порта, возвращаемый SysComOpen ComSettings REF TO COMSETTINGS _ Указатель на структуру COMSETTINGS

Page 5