Функции управления соединениями

---

GetConnectionAddress(connection_name)

Функция GetConnectionAddress возвращает текущий адрес устройства, с которым идет обмен. Функция доступна начиная с версии 3.0.

Параметр connection_name указывает для какого соединения необходимо взять адрес. В connection_name можно указывать или ID соединения или его имя переменной. Однако, константы усложняют чтение кода и предпочтительней использовать именованные строки. Если соединение не найдено то возвращается значение nil.

Для соединений, подключенных по RS-485, адресом является число. GetConnectionAddress вернет значения типа number.

Для TCP и UDP соединений адресом является его IP-адрес или имя хоста. GetConnectionAddress вернет значения типа string.

SetConnectionAddress(connection_name, new_address)

Функция SetConnectionAddress заменяет текущий адрес устройства, с которым идет обмен, на новый. Функция доступна начиная с версии 3.0. SetConnectionAddress предназначена для работы в проектах с горячим резервированием контролеров и позволяет читать регистры из конкретного (активного, работающего) ПЛК.

Параметр connection_name указывает для какого соединения необходимо заменить адрес. В connection_name можно указывать или ID соединения или его имя переменной. Однако, константы усложняют чтение кода и предпочтительней использовать именованные строки.

Если соединение не найдено то возвращается значение nil. Если адрес был заменен успешно, функция вернет true. При попытке замены адреса вj dyenhtyyb[ htubcnhf[, функция вернет false.

Для соединений, подключенных по RS-485, адресом является число. SetConnectionAddress ожидает что значение new_address будет типа number.

Для TCP и UDP соединений адресом является его IP-адрес или имя хоста. SetConnectionAddress ожидает что значения new_address будет типа string.

EnableConnection(connection_name)

Функция EnableConnection на лету включает опрос регистров в указанном соединении. Функция доступна начиная с версии 3.0. При этом в конфигурации проекта галочка "Отключить" для указанного соединения не изменяется.

Параметр connection_name указывает для какого соединения необходимо включить опрос. В connection_name можно указывать или ID соединения или его имя переменной. Однако, константы усложняют чтение кода и предпочтительней использовать именованные строки.

DisableConnection(connection_name)

Функция DisableConnection на лету отключает опрос регистров в указанном соединении. Функция доступна начиная с версии 3.0. При этом в конфигурации проекта галочка "Отключить" для указанного соединения не изменяется.

Параметр connection_name указывает для какого соединения необходимо включить опрос. В connection_name можно указывать или ID соединения или его имя переменной. Однако, константы усложняют чтение кода и предпочтительней использовать именованные строки.

IsConnectionEnabled(connection_name)

Функция IsConnectionEnabled сообщает включен ли опрос регистров в указанном соединении. Функция доступна начиная с версии 3.0.

Параметр connection_name указывает для какого соединения необходимо включить опрос. В connection_name можно указывать или ID соединения или его имя переменной. Однако, константы усложняют чтение кода и предпочтительней использовать именованные строки.

GetConnectionErrors(connection_name)

Функция GetConnectionErrors сообщает были ли ошибки при чтении регистров в последнем скане в указанном соединении. Функция доступна начиная с версии 3.0.

Если ошибок не было, то функция возвращает ноль. Если ошибки были, то возвращается ID последнего регистра, который не был прочитан.

Параметр connection_name указывает для какого соединения необходимо включить опрос. В connection_name можно указывать или ID соединения или его имя переменной. Однако, константы усложняют чтение кода и предпочтительней использовать именованные строки.

GetConnectionScanTime(connection_name)

Функция GetConnectionScanTime возвращает время, затраченное на опрос регистров в последнем скане в указанном соединении. Функция доступна начиная с версии 3.0.

Функция возвращает время в миллисекундах.

Параметр connection_name указывает для какого соединения необходимо включить опрос. В connection_name можно указывать или ID соединения или его имя переменной. Однако, константы усложняют чтение кода и предпочтительней использовать именованные строки.

GetConnectionErrorScans(connection_name)

Функция GetConnectionErrorScans возвращает количество последовательных сканов, в которых были ошибки чтения регистров в указанном соединении. Функция доступна начиная с версии 3.0.

Функция возвращает количество сканов, в которых были ошибки чтения. Если в каком-либо скане не было ошибок чтения в данном соединении, то счетчик сбрасывается в ноль.

Параметр connection_name указывает для какого соединения необходимо включить опрос. В connection_name можно указывать или ID соединения или его имя переменной. Однако, константы усложняют чтение кода и предпочтительней использовать именованные строки.