Особенности поддержки языка Си в панелях СП210

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

Файл включает в себя:

• заголовок, сформированный на основе информации, указанной при создании файла;

• директиву #include, подключающую системный заголовочный файл macro.h;

• директиву #define, определяющую макрос препроцессора __SYS_DEFINE__ (не представляет интереса для пользователя);

• функцию __MAIN__, по умолчанию не имеющую реализации (аналог функции main, описанной в стандарте языка Си). Её код создается пользователем.

Примечание

Шаблон создаваемого файла можно изменить путём редактирования файла \Tool\Macro\Template\UFunHeader.txt в директории установки конфигуратора.

При вызове макроса фактически происходит выполнение функции __MAIN__, являющейся точкой входа в программу. Таким образом, каждый файл исходного кода в дереве проекта соответствует одной программе. Помимо директив и функции __MAIN__ файл исходного кода может содержать:

• объявления и определения других функций;

• объявления и определения глобальных переменных;

• определения структур, объединений, перечислений и псевдонимов.

Таким образом, в рамках функции __MAIN__ могут вызываться другие функции, созданные пользователем, или размещённые в подключаемых через директиву #include библиотеках.

Объявление и определение – это две важные концепции языка Си. Объявление – это способ сообщить компилятору о существовании объекта, а определение – способ создать объект и выделить память под его хранение.

Заголовочные файлы в основном содержат объявления (интерфейс), а файлы исходного кода – определения (реализацию).

Расширение заголовочных файлов - .h.

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

Заголовочные файлы могут включать:

• директивы препроцессора;

• объявления внешних (extern) переменных;

• объявление и определение структур, объединений, перечислений и псевдонимов;

• объявление (прототипы) функций.

При создании макросов вы можете обойтись без использования заголовочных файлов. В случае их использования – предпримите усилия, чтобы в рамках файла исходного кода один и тот же заголовочный файл подключался не более одного раза (c помощью директив #ifndef или #pragma once).

Типы данных языка Си можно разделить на следующие категории:

• тип bool;

• целочисленные;

• значения с плавающей точкой;

• указатели;

• массивы (и их частный вид – строки);

• структуры;

• объединения;

• перечисления;

• псевдонимы;

• тип void.

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

1. Тип bool

Логический тип данных используется для представления значения, которое имеет только два возможных состояния – true (1) или false (0). Этот тип применяется для описания бинарных событий и команд (например, отсутствие/наличие тревоги, отключение/включение насоса и т. д.). Значения данного типа поддерживают логические операции.

Переменная типа bool занимает 1 байт памяти.

Примечание

Для использования макросов true и false требуется подключить заголовочный файл stdbool.h.

2. Целочисленные типы

Целочисленные типы отличаются друг от друга наличием/отсутствием знака и диапазоном значений. Значения этих типов поддерживают арифметические и побитовые операции, а также операции сравнения.

В таблице указаны размеры типов применительно к панели и её эмулятору; на других платформах размер может отличаться. Наличие нескольких вариантов именования для каждого типа связано с некоторыми историческими особенностями языка Си и наличием в панели псевдонимов для этих типов.

При выполнении арифметических операций возможен эффект переполнения – например, если переменная типа uint16_t имеет значение 65535 (это верхний предел ее диапазона) и мы прибавим к ней 1, то переменная получит значение 0 (т. е. ее значение станет равным нижней границе диапазона ее значений). Для панелей оператора СП210 переполнение и беззнаковых, и знаковых типов обрабатывается одним и тем же способом.

Деление на 0 приведет к исключению, в результате чего выполнение всех макросов прекращается до перезагрузки панели или перезапуска эмулятора.

Примечание

Типы с постфиксом _t является типами фиксированного размера, для которых гарантируется совпадение размера на всех платформах. Для их использования требуется подключить заголовочный файл stdint.h.

3. Типы данных с плавающей точкой

Значения этих типов поддерживают арифметические операции и операции сравнения. В реализации панелей оператора тип long double по диапазону и точности соответствует типу double, так что его использование не имеет смысла.

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

Значения с плавающей точкой могут иметь особые состояния – такие, как NaN и бесконечность. Для проверки, является ли значение особым, используются макросы заголовочного файла math.h

4. Указатели

Переменная типа «указатель» содержит адрес другой переменной (или функции – но об этом лучше прочитать в учебной литературе). Указатели обеспечивают гибкую и эффективную работу с памятью, и поэтому активно используются в коде стандартной библиотеки Си (и других библиотек). Они позволяют создавать функции, которые способны обрабатывать и модифицировать наборы данных произвольного типа и размера.

Для панелей оператора СП210 размер указателей составляет 4 байта, так как аппаратная платформа является 32-битной.

Указатели поддерживают арифметические операции и специфические операции получения адреса (&) и разыменования – доступа к значению, расположенному по адресу (*). Частой ошибкой является разыменование неинициализированного указателя («нулевого» или имеющего некорректное значение, не совпадающее с доступным адресом памяти). Результатом подобной операции является возникновение исключения, которое делает невозможным продолжение нормальной работы панели до её перезагрузки.

5. Массивы

Массив объединяет набор объектов одного и того же типа. Данные массива размещаются в памяти последовательно. Для доступа к элементу массива используется оператор []. Индексация массивов ведется с 0.

Массивы часто обрабатываются в цикле for:

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

Если при инициализации массива не указать его размер – то компилятор определит его автоматически на основании числа инициализаторов.

Можно инициализировать лишь нужные элементы массива – остальные автоматически будут инициализированы нулями.

Доступны массивы переменной длины (variable-length array; VLA) – их размер может меняться в процессе работы программы. В этом случае при доступе к элементу массива следует контролировать, что индекс соответствует текущему размеру массива. Для VLA не поддерживается инициализация и использование модификатора static.

Массивы могут быть многомерными:

Имя массива является указателем на его начальный элемент. Поэтому при использовании функций Reads/Writes (и других функций, принимающих на вход указатель) необязательно использовать оператор получения адреса (&).

Зная о родстве массивов и указателей – можно оценить, как в языке Си реализованы арифметические операции над последними.

То есть увеличение значения указателя на 1 «смещает» его на количество байт, равное типу указателя: «ptr + n» эквивалентно «ptr + n * sizeof(*ptr)».

Кроме того, указатели, как и массивы, поддерживают индексный доступ.

6. Строки

В языке Си нет отдельного типа данных для строк. Вместо этого строки реализованы как массивы символов. В стандарте C99 доступны два вида символов:

Строка в кодировке ASCII представляет собой массив char, а строка в кодировке UTF-16 – массив wchar_t. Строки в языке Си являются нуль-терминированными – каждая строка должна заканчиваться символом, имеющим код «0» (NULL-терминатором). При инициализации строки этот символ добавляется автоматически. Строковые литералы обрамляются двойными кавычками (в отличие от отдельных символов, обрамляемых одинарными кавычками). Для UTF-16 значение литерала предваряется префиксом L.

С помощью символа «\» можно экранировать управляющие последовательности и HEX-коды символов. Это, в частности, позволяет инициализировать строки c использованием кодировки Win-1251.

Для работы с символами и строками используются следующие заголовочные файлы:

В заголовочном файле string.h также объявлены функции для работы с памятью, которые часто используются применительно к массивам – memcpy, memmove, memcmp, memset и др.

7. Структуры

Структура объединяет набор объектов разных типов. Каждый объект размещается в отдельных ячейках памяти.

Можно совместить объявление структуры с её определением:

Для доступа к полю структуры через указатель на структуру используется специфический оператор «->»:

В языке Си присутствует поддержка битовых полей (bitfield) – разновидностей структур, содержащих только целочисленные поля, для каждого из которых указано количество занимаемых бит.

При использовании структур можно столкнуться с выравниванием памяти (memory aligment). Рассмотрим влияние выравнивания на простом примере. Пусть у нас определена структура с двумя полями, одно из которых имеет тип uint8_t, а второе – uint32_t.

Первое поле занимает 1 байт, второе 4 – и логично предположить, что вся структура будет занимать 5 байт. Но с помощью оператора sizeof можно убедиться, что в реальности в панели структура занимает 8 байт (для других платформ результат может быть иным):

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

«Центральные процессоры в качестве основной единицы при работе с памятью используют машинное слово, размер которого может быть различным. Однако размер слова всегда равен нескольким байтам (байт является наименьшей единицей, в которой отсчитываются адреса). Как правило, машинное слово равно 2k байтам, то есть состоит из одного, двух, четырёх, восьми и т. д. байтов.

При сохранении какого-то объекта в памяти может случиться, что некое поле, состоящее из нескольких байтов, пересечёт “естественную границу” слов в памяти. Некоторые модели процессоров не могут обращаться к данным в памяти, нарушающим границы машинных слов. Некоторые могут обращаться к невыровненным данным дольше, нежели к данным, находящимся внутри целого “машинного слова” в памяти».

В некоторых ситуациях требуется управлять выравниванием памяти (например – отключить его); это, например, может быть удобным при реализации протоколов, когда структуру требуется «наложить» на байтовый буфер запроса или ответа.

Для этого существуют различные средства, но проще всего воспользоваться директивой pack:

Структуры могут иметь произвольную вложенность и свободно сочетаются с массивами – например, можно объявить массив структур, одним из полей которой является структура, одним из полей которой является массив и т. д.

8. Объединения

Объединения очень похожи на структуры, за одним существенным отличием – все их объекты размещаются в одних и тех же ячейках памяти. Это обеспечивает разные варианты представления одних и тех же данных.

9. Перечисления

Перечисление позволяет указать для конкретных значений целочисленной переменной символьные названия, что повышает читабельность кода. В языке Си все перечисления трактуются как значения типа int и имеют соответствующий диапазон доступных значений. Часто перечисления используются в качестве меток оператора switch.

Значения элементов перечислений могут быть указаны в явном виде:

При этом для некоторых элементов значения могут быть опущены:

Значения элементов перечисления могут быть «значимыми»:

10. Псевдонимы (typedef)

Ключевое слово typedef создает псевдоним для типа данных, что повышает читабельность кода.

11. Тип void

Void – это специфический тип данных. Он является неполным – создать переменную данного типа нельзя. Но void можно использовать:

• в качестве типа, возвращаемого функцией – это будет означать, что данная функция не возвращает никакого значения (см., например, Beep);

• при создании функций, которые не принимают никаких параметров (см., например, Beep);

• при указании параметров функции, которые могут иметь произвольный тип (см., например, функцию WriteF);

• указатель на void соответствует указателю на произвольный тип данных. Это может использоваться при создании функций, которые должны работать с данными произвольного типа (см., например, функции семейства Read/Write).

Переменная – это именованный участок памяти, в котором хранится значение. Для использования переменной её необходимо определить в файле исходного кода, указав тип. Определение может быть проведено в любом месте файла, что влияет на область видимости и существования переменной.

Определение переменной должно быть сделано перед её использованием (т. е. в расположенных выше строках файла).

Переменные могут быть глобальными и локальными.

Глобальные переменные определяются вне функций. Они доступны для использования в рамках всего файла исходного кода. Кроме того, их можно использовать в других файлах (см. пункт). Если для глобальной переменной не указано значение инициализации – то она инициализируется значением 0. Значение глобальной переменной сохраняется между вызовами программы.

Локальные переменные объявляются внутри функций. Они доступны для использования только в рамках блочного оператора, в котором определены (блочный оператор представлен парой фигурных скобок). Если для локальной переменной не указано значение инициализации – то при старте программы она будет содержать произвольное значение («мусор»). Значение локальной переменной не сохраняется между вызовами программы. Частным случаем локальных переменных являются параметры функции.

Инициализация – это процесс однократной записи в переменную предустановленного значения при запуске программы.

Способы инициализации для других типов данных приведены в примерах пункт.

При объявлении и определении переменных и функций могут использоваться спецификаторы. Основными из них являются static и extern. Спецификатор размещается перед типом переменной или перед типом значения, возвращаемого функций.

Локальные переменные со спецификатором static сохраняют свои значения между вызовами программы. Кроме того, если для них не указаны значения инициализации – то они инициализируются значением 0.

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

Как показано в примере выше, спецификатор extern используется для объявления (импорта) переменных, которые определены в другом файле.

Переменные с квалификатором const расцениваются как константы, значения которых не должны изменяться в процессе работы программы. Попытки каким-либо образом изменить эти значения (например, с помощью использования указателей) приводятся к неопределённому поведению (undefined behavior) программы.

Литерал – это элемент исходного кода, который соответствует фиксированному значению. Например, в строке

значение 11.22 является литералом.

Для литералов определённых категорий доступны префиксы и постфиксы, влияющие на их формат и тип.

Префиксы для целочисленных типов:

• 0x (шестнадцатеричная система счисления; HEX);

• 0b (двоичная система счисления).

Префиксы для строк:

• префикс L указывает на кодировку UTF-16.

Постфиксы для целочисленных типов:

• u (U) – признак «беззнаковости» литерала. Может сочетаться с другими постфиксами (например, ul – unsigned long);

• l (L) – литерал является значением типа long;

• ll (LL) – литерал является значением типа long long.

По умолчанию (без постфикса) целочисленный литерал интерпретируется компилятором как значение типа int.

Постфиксы для типов с плавающей точкой:

• f (f) – литерал является значением типа float;

• L (L) – литерал является значением типа long double.

По умолчанию (без постфикса) литерал с плавающей точкой интерпретируется компилятором как значение типа double.

Постфиксы позволяют:

• добиться нужной интерпретации литерала, что в некоторых случаях может быть очень важно (см. пример с делением ниже);

• сэкономить память;

• повысить читабельность кода.

Идентификатор – это имя, указываемое при объявлении/определении переменных, функций, псевдонимов типов данных, макросов и других сущностей.

В языке Си идентификаторы являются регистрозависимыми, т. е. var и Var – это два разных идентификатора.

На идентификатор накладываются следующие ограничения:

• может включать в себя буквы английского языка, цифры и символы нижнего подчеркивания (_);

• первый символ не может быть цифрой;

• не может совпадать с ключевым словом языка Си или идентификатором, используемым в стандартной библиотеке языка Си;

• длина идентификатора не может превышать 256 символов.

В языке Си поддержаны однострочные и многострочные комментарии:

Кнопки редактора макросов позволяют закомментировать/раскомментировать выделенные строки с помощью однострочных комментариев.

Выражение — это упорядоченный набор операций над переменными, литералами и функциями.

Для преобразования типов используется специфический оператор:

В выражении могут одновременно использоваться несколько операторов:

Порядок их вычисления зависит от приоритета. Для управления приоритетом используются скобки – они имеют высший приоритет:

В языке Си поддерживается множественное присваивание:

Арифметические, логические и «сдвиговые» операторы могут комбинироваться с оператором присваивания:

Характерными для языка Си являются операторы инкремента и декремента, которые могут быть префиксными и постфиксными:

Некоторые характерные для других языков операторы в Си представлены в виде функций заголовочного файла math.h:

• abs (получение абсолютной величины числа);

• pow (возведение в степень);

• sin, cos;

• и др.

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

Ниже приведен пример определения и вызова функции, которая имеет 2 параметра:

• T типа float;

• IsAirSaturation типа bool.

Эти параметры принимают значения аргументов функции, переданные ей при вызове.

В результате выполнения функция возвращает значение типа float.

Оператор return традиционно размещается в конце функции, но может располагаться в любых ее фрагментах (в т. ч. таких операторов в функции может быть несколько, чтобы организовать выход из функции при различных условиях).

В некоторых ситуациях в качестве аргументов функции используются указатели – см., в частности, примеры использования функций Reads/Writes.

Если требуется указать, что функция не имеет явного возвращаемого значения (например, она как раз манипулирует данными, полученными по указателю), то в качестве типа функции следует использовать void.

Если функция не имеет параметров, то вместо них указывается void.

Характерный пример – функция Beep, которая используется для активации зуммера панели. Она не принимает и не возвращает никаких значений, и объявлена следующим образом:

Препроцессор – это программа, подготавливающая код на языке Си к компиляции. К основным задачам препроцессора относятся:

• вставка в обрабатываемый файл содержимого других заголовочных файлов с помощью директивы #include;

• выполнение макроподстановок для директив #define;

• выполнение директив условной компиляции (не рассматриваются в рамках данного документа);

• выполнение других директив.

Директива #include используется для подключения заголовочных файлов – в частности, заголовочных файлов стандартной библиотеки языка Си. Это требуется для возможности вызова функций этой библиотеки. Например, для использования функций заголовочного файла math.h требуется добавить такую строку:

или такую:

Разница между этими двумя формами заключается только в принципе поиска файлов, что не имеет значения при работе с панелями оператора.

Директива #define используется для определения констант и макросов. Препроцессор заменяет первый аргумент директивы вторым, выполняя макроподстановку.

См. также список предопределённых констант #define, автоматически создаваемых препроцессором.

В качестве констант также можно использовать переменные с квалификатором const – по сравнению с макроконстантами этот подход уменьшает вероятность ошибки, так как для таких переменных компилятор сможет проверить соответствие типов.

Пример макроса c параметрами:

Такой макрос можно заменить функцией. Но подобные макросы полезны тем, что могут быть добавлены на вкладку Встроенные функции редактора макросов.

Если требуется, чтобы макрос выполнял несколько отдельных выражений, то используется идиома do {…} while(0):

В макросах с параметрами могут использоваться специфические операторы # (обрамление параметра макроса двойными кавычками) и ## (объединение двух лексем). См. примеры использования этих операторов в статье на Википедии.

Примечание

Макросы с параметрами требуют тщательной расстановки скобок, поэтому использовать их следует с осторожностью.

Директивы #warning и #error позволяют вывести в лог компилятора предупреждение или сообщение об ошибке. Это, например, позволяет расставлять в исходном коде различного рода напоминания.

Директива #pragma позволяет выполнить указанное после имени директивы действие. Список поддерживаемых действий зависит от компилятора. Например, в пункте 12.5.4 использовалась #pragma pack для управления выравниванием в структуре.

Стандартная библиотека языка Си позволяет использовать в программе широкий набор функций, определённых в стандарте языка. Для использования конкретной функции требуется с помощью директивы #include подключить к программе заголовочный файл, в котором объявлена данная функция.

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

Регистры области памяти PSW и SPSW представлены как массивы данных:

Для работы с другими областями памяти используются специальные функции. Некоторые из этих функций могут использоваться и для работы с PSW и SPSW:

В функциях Read/Reads/Write/WriteF/Writes в случае использования протокола Modbus для параметра DataArea доступны следующие значения:

Эти наборы эквивалентны, т. е. можно, например, использовать TP7_4x для протоколов Modbus ASCII и Modbus TCP.

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

В функциях Read/Reads/Write/WriteF/Writes в случае доступа к внутренней памяти панели для параметра DataArea доступны следующие значения:

• TP_PSB;

• TP_SPSB;

• TP_PSW;

• TP_PFW;

• TP_SPSW;

• TP_SPFW.

В функциях Read/Reads/Write/WriteF/Writes для параметра DataType доступны следующие значения:

• DT_Bit;

• DT_Byte (доступен только для некоторых протоколов обмена);

• DT_WORD;

• DT_DWORD;

• DT_DDWORD;

• DT_Word_String;

• DT_DWord_String;

• DT_DDWord_String.

Функции GetPSB и GetSPSB используются для получения значения бита области PSB (GetPSB) или SPSB (GetSPSB).

Функции SetPSB и SetSPSB используются для установки значения бита области PSB (SetPSB) или SPSB (SetSPSB).

Функция Read используется для чтения одного параметра из памяти панели или slave-устройства в переменную макроса. Для настройки параметров функции с помощью вспомогательного меню введите в редакторе кода Read и поставьте открывающую скобку.

Функция Write используется для записи одного значения макроса в память панели или slave-устройство. Для настройки параметров функции с помощью вспомогательного меню введите в редакторе кода Write и поставьте открывающую скобку.

Функция Reads используется для чтения одного или нескольких параметров из памяти панели или slave-устройства в переменные макроса. Для настройки параметров функции с помощью вспомогательного меню введите в редакторе кода Reads и поставьте открывающую скобку.

Функция Writes используется для записи одного или нескольких значений макроса в память панели или slave-устройство. Для настройки параметров функции с помощью вспомогательного меню введите в редакторе кода Writes и поставьте открывающую скобку.

Функция WriteF используется для записи одного значения с плавающей точкой в память панели или slave-устройство. Для настройки параметров функции с помощью вспомогательного меню введите в редакторе кода WriteF и поставьте открывающую скобку.

8. Функции ReadPFW и ReadSPFW

Функции ReadPFW и ReadSPFW используются для чтения одного или нескольких регистров области PFW (ReadPFW) или SPFW (ReadSPFW) в переменные макроса.

Функции WritePFW и WriteSPFW используются для записи значений макроса в один или несколько регистров области PFW (WritePFW) или SPFW (WriteSPFW).

Данные функции используются для работы с переменными вкладки С устройства, импортированными из ПЛК с системой исполнения CODESYS V3.5 и опрашиваемыми по протоколу CODESYS V3 (PLC Handler) или OPC UA Client.;

Функция CodeSysRead используется для чтения значения переменной из вкладки Библиотека переменных – С устройства в переменную макроса. Для настройки параметров функции с помощью вспомогательного меню введите в редакторе кода CodeSysRead и поставьте открывающую скобку.

Функция CodeSysWrite используется для записи значения переменной макроса в переменную вкладки Библиотека переменных – С устройства. Для настройки параметров функции с помощью вспомогательного меню введите в редакторе кода CodeSysWrite и поставьте открывающую скобку.

Функция CodeSysReadString используется для чтения значения строковой переменной из вкладки Библиотека переменных – С устройства в переменную макроса. Для строк типа WSTRING выполняется автоматическая конвертация в ASCII. Для настройки параметров функции с помощью вспомогательного меню введите в редакторе кода CodeSysReadString и поставьте открывающую скобку.

Функция CodeSysWriteString используется для записи строковой переменной макроса в переменную вкладки Библиотека переменных – С устройства. Для строк типа WSTRING должна использоваться кодировка ASCII (конвертация будет выполнена автоматически). Строка не должна содержать символы кириллицы. Для настройки параметров функции с помощью вспомогательного меню введите в редакторе кода CodeSysWriteString и поставьте открывающую скобку.

Данные функции используются совместно с протоколом Пользовательский и позволяют реализовать отправку и получение через заданный COM-порт произвольного набора байт.

1. Функция COMSend

Функция COMSend отправляет в COM-порт заданный набор байт.

2. Функция COMReceive

Функция COMReceive используется для чтения данных из буфера COM-порта.

Данные функции используются для работы с элементом Холст.

Функция DCMapClear используется для очистки холста.

Функция DCMapDrawCircle используется для отрисовки на холсте окружности.

Функция DCMapDrawCircleArc используется для отрисовки на холсте дуги.

Функция DCMapDrawEllipse используется для отрисовки на холсте эллипса.

Функция DCMapDrawEllipseArc используется для отрисовки на холсте эллиптической дуги.

Функция DCMapDrawLine используется для отрисовки на холсте линии.

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

Функция DCMapSetBackColor используется для установки фона холста.

Функция ScreenJump используется для переключения экрана.

Функция OpenWindow используется для открытия окна.

Функция CloseWindow используется для закрытия окна.

Макрос GET_BIT используется для извлечения указанного бита целочисленной переменной.

Макрос SET_BIT используется для установки указанного бита целочисленной переменной в значение true.

Макрос RESET_BIT используется для установки указанного бита целочисленной переменной в значение false.

Макрос HIWORD используется для получения старшего слова значения типа DWORD.

Макрос LOWORD используется для получения младшего слова значения типа DWORD.

Макрос HIBYTE используется для получения старшего байта значения типа WORD.

Макрос LOBYTE используется для получения младшего байта значения типа WORD.

Макрос MAKEDWORD используется для «сборки» значения типа DWORD из двух значений типа WORD.

Макрос MAKEWORD используется для «сборки» значения типа WORD из двух значений типа BYTE.

Макрос MAX возвращает наибольшее из двух числовых значений.

Макрос MIN возвращает наименьшее из двух числовых значений.

Функция Beep используется для включения зуммера.

Функция Delay организует синхронную (блокирующую) задержку выполнения кода функции.

Функция Lock организует блокировку доступа к секции кода для исключения несогласованного доступа к одним и тем же данным из разных функций. Функция UnLock снимает блокировку.

У пользователя отсутствует возможность подключения дополнительных библиотек, написанных на языке Си. Вместо этого можно добавить на вкладку Встроенные функции пользовательские макросы. Для этого следует в директории установки конфигуратора:

• открыть файл \Tool\Macro\sys\macro_def.h;

• в конец файла с помощью директивы #define добавить новый макрос;

• в папке \Tool\Macro\Definition добавить .html файл, имя которого должно совпадать с именем макроса. В качестве примера структуры файла смотрите уже существующие файлы данной директории.

При настройке в графическом элементе действия Вызов макроса следует указать режим исполнения: синхронный или асинхронный. Эта настройка определяет, блокирует ли выполнение макроса работу остальных макросов проекта: синхронный — блокирует, асинхронный — не блокирует.

Рассмотрим пример. Пусть в проекте создано два макроса:

Значения регистров PSW0 и PSW1 привязаны к цифровым дисплеям.

Создана функциональная область с режимом запуска бит управления (PSB0), в которой настроен вызов макросов Func0 и Func1. На экране также размещен переключатель, устанавливающий бит PSB0 в значение TRUE и таким образом запускающий исполнение обоих макросов.

Если для макроса Func0 настроен режим исполнения Синхронный, то сразу после нажатия на переключатель в регистр PSW0 будет записано значение 1, а спустя 5 секунд в регистр PSW1 будет записано значение 2. То есть фактически макрос Func1 будет запущен на исполнение только после завершения работы макроса Func0, в котором с помощью функции Delay организована блокирующая задержка.

Если для макроса Func0 настроен режим исполнения Асинхронный, то сразу после нажатия на переключатель в регистр PSW0 будет записано значение 1, а в регистр PSW1 – значение 2. То есть фактически макрос Func1 будет запущен на исполнение одновременно с Func0.

При этом режим исполнения макроса Func1 не повлияет на описанное выше поведение; режим исполнения определяет, будет ли настраиваемый макрос блокировать исполнение других макросов проекта.

Примечание

Синхронные макросы, настроенные в разных элементах, не блокируют работу друг друга.

Примечание

Синхронные макросы не блокируют обработку визуализации панели и обмен, настроенный через элементы.

При работе с файлами следует учитывать следующие особенности:

• для работы с файлами используются функции заголовочного файла stdio.h;

• для работы с директориями используются функции заголовочного файла unistd.h (mkdir, rmdir);

• директория монтирования USB-накопителя: /mnt/udisk;

• требования к USB-накопителю: файловая система FAT32, объём – не более 32 Гб;

• перед работой с USB-накопителем следует проверить факт его монтирования с помощью системного бита SPSB15. Попытка доступа к непримонтированному накопителю может привести к исключению в приложении панели;

• для размонтирования USB-накопителя перед его извлечением следует установить системный бит SPSB201. Извлечение накопителя «на горячую» (без размонтирования) может привести к повреждению файлов или выходу из строя самого накопителя;

• в режиме эмуляции можно работать с файлами на ПК (при условии, что эти файлы доступны для пользователя, от имени которого запускается конфигуратор). В этом случае пути к файлам должны экранироваться: C:\\test_folder\\test_file.txt

  .

  В качестве рабочей директории используется директория установки конфигуратора;

• закрытие файла (fclose) не гарантирует, что сразу после этого буферизированные данные будут записаны в файл. Используйте функцию fflush для принудительной записи. При работе с директориями для аналогичной цели можно использовать функцию system("sync") из заголовочного файла stdlib.h.