Текст документа
Содержание 1 Цель документа...........................................................................................................................................3 2 Установка библиотеки.................................................................................................................................4 3 Описание библиотеки SysLibSockets.........................................................................................................5 3.1 SysSockCreate .....................................................................................................................................5 3.2 SysSockBind.........................................................................................................................................6 3.3 SysSockListen ......................................................................................................................................7 3.4 SysSockAccept.....................................................................................................................................7 3.5 SysSockRecv и SysSockSend.
Протокол TCP .......................................................................................8 3.6 SysSockRecvFrom и SysSockSendTo. Протокол UDP............................................................................9 3.7 SysSockShutdown .............................................................................................................................. 11 3.8 SysSockClose..................................................................................................................................... 11 3.9 SysSockSetOption ..............................................................................................................................
11 3.10 SysSockGetOption ............................................................................................................................13 3.11 SysSockHtonl....................................................................................................................................13 3.12 SysSockHtons...................................................................................................................................14 3.13 SysSockNtohl....................................................................................................................................14 3.14 SysSockNtohs...................................................................................................................................14 3.15 SysSockConnect...............................................................................................................................15 3.16 SysSockIoctl .....................................................................................................................................15 2
Стр. 2
1 Цель документа
1 Цель документа 1 Цель документа Данный документ описывает программную реализацию передачи данных с помощью сетевых протоколов UDP и TCP для контроллеров ОВЕН, программируемых в среде ALTA IDE, c помощью библиотеки SysLibSockets. 3
Стр. 3
2 Установка библиотеки
2 Установка библиотеки 2 Установка библиотеки Чтобы подключить библиотеку к проекту: 1. Откройте редактор Менеджер библиотек одним из способов: дважды нажмите ЛКМ на системную папку Менеджер библиотек в дереве проекта; или нажмите ПКМ на системную папку Менеджер библиотек в дереве проекта и выберите в контекстном меню пункт Открыть : Рисунок 2.1 В редакторе Менеджер библиотек откройте вкладку Магазин . Выберите библиотеку SysLibSockets и нажмите кнопку Подключить на карточке библиотеки. Библиотека добавится в проект и отобразится на вкладке Мои библиотеки в редакторе Менеджер библиотек . 4
Стр. 4
3.1 SysSockCreate
3 Описание библиотеки SysLibSockets 3 Описание библиотеки SysLibSockets Сокеты могут работать в блокирующем и неблокирующем режиме. В блокирующем режиме все операции, производимые с сокетом, являются синхронными, а в неблокирующем асинхронными. Например, в блокирующем режиме функция чтения завершает свою работу только после получения данных, что, соответственно, делает время цикла ПЛК непрогнозируемым. В неблокирующем режиме вызов любой функции не останавливает цикл ПЛК. Библиотека SysLibSockets поддерживает работу с сокетами по TCP/IP и UDP. Библиотека SysLibSockets содержит функции: SysSockCreate ; SysSockBind ; SysSockListen ; SysSockAccept ; SysSockRecv и SysSockSend.
Протокол TCP ; SysSockRecvFrom и SysSockSendTo. Протокол UDP ; SysSockShutdown ; SysSockClose ; SysSockSetOption ; SysSockGetOption ; SysSockHtonl ; SysSockHtons ; SysSockNtohl ; SysSockNtohs ; SysSockConnect . Часть функций библиотеки ссылаются на структуры: Таблица 3.1 – Описание структур библиотеки SysLibSockets Описание структуры SOCKADDRESS Таблица 3.2 – Описание структуры SOCKADDRESS Далее в документе описаны все функции библиотеки. 3.1 SysSockCreate Функция типа данных DINT создает новый сокет и возвращает для него идентификатор (handle) сокета. 5 Структура Описание SOCKADDRESS Структура для хранения адреса. См.
описание в таблице ниже SOCKET FD SET _ _ Структура используется в функции SysSockSelect, которая не поддержана SOCKET TIMEVAL _ Структура используется в функции SysSockSelect, которая не поддержана Переменная Тип Описание sin family _ INT Семейство протоколов. Входные аргументы: • SOCKET AF INET (для семейства IPv4) _ _ sin port _ WORD Порт sin addr _ DWORD IP-адрес, к которому будет привязан сокет. Входные аргументы: • SOCKET INADDR ANY (все адреса локального хоста) _ _ – TCP и UDP сервер (SysSockBind); • 32-х битное значение IP-адреса – TCP клиент (SysSockConnect) и UDP клиент (SysSockRecvFrom/ SysSockSendTo). sin zero _ ARRAY [0..7] OF SINT Дополнение до размера структуры SOCKADDRESS.
Поле должно содержать массив нулей и служит только для увеличения размера структуры до стандартных 16 байт. Переменную не обязательно использовать в проекте
Стр. 5