+7 (812) 670-9095
Обратная связьEnglish
Главная → Статьи → Системное ПО → Статья #18. Группы флагов событий: вспомогательные службы и структуры данных
Версия для печати

Статья #18. Группы флагов событий: вспомогательные службы и структуры данных

7 ноября 2018

Эта статья продолжает описывать группы флагов событий.




Статья #18. Группы флагов событий: вспомогательные службы и структуры данных


Вспомогательные службы групп флагов событий


Nucleus RTOS имеет три вызова API, которые предоставляют вспомогательные функции для групп флагов событий: получение информации о группе, получение информации о количестве групп флагов событий в приложении и получение указателей на все группы флагов событий. Первые два вызова реализованы в Nucleus SE.


Получение информации о группе флагов событий


Этот служебный вызов возвращает информацию о группе флагов событий. Реализация этого вызова в Nucleus SE отличается от реализации в Nucleus RTOS тем, что возвращается меньше информации, так как именование объектов и порядок приостановки задач не поддерживается, а сама приостановка задач может быть деактивирована.


Вызов для получения информации о группе событий в Nucleus RTOS
Прототип служебного вызова:
STATUS NU_Event_Group_Information(NU_EVENT_GROUP *group, CHAR *name, UNSIGNED *event_flags, UNSIGNED *tasks_waiting, NU_TASK **first_task);

Параметры:

group – указатель на предоставляемый пользователем блок управления группой флагов событий;
name – указатель на 8-символьную область для имени группы флагов событий, сюда включен и терминирующий ноль;
event_flags – указатель на переменную, которая примет текущее значение указанной группы флагов событий;
tasks_waiting – указатель на переменную, которая примет количество приостановленных задач в этой группе флагов событий;
first_task – указатель на переменную типа NU_TASK, которая примет указатель на первую приостановленную задачу.


Возвращаемое значение:
NU_SUCCESS – вызов был успешно завершен;
NU_INVALID_GROUP – некорректный указатель на группу флагов событий.

Вызов для получения информации о группе событий в Nucleus SE
Этот вызов поддерживает основной функционал Nucleus RTOS API.

Прототип служебного вызова:
STATUS NUSE_Event_Group_Information(NUSE_EVENT_GROUP group, U8 *event_flags, U8 *tasks_waiting, NUSE_TASK *first_task);

Параметры:

group – индекс группы флагов событий, о которой запрашивается информация;
event_flags – указатель на переменную, которая примет текущее значение указанной группы флагов событий;
tasks_waiting – указатель на переменную которая примет количество приостановленных задач в этой группе флагов событий (ничего не возвращается, если приостановка задач деактивирована);
first_task – указатель на переменную типа NUSE_TASK, которая примет индекс первой приостановленной задачи (ничего не возвращается, если приостановка задач деактивирована).


Возвращаемое значение:
NUSE_SUCCESS – вызов был успешно завершен;
NUSE_INVALID_GROUP – некорректный индекс группы флагов событий.

Реализация получения информации о группе событий в Nucleus SE
Реализация этого вызова API довольно проста:


*event_flags = NUSE_Event_Group_Data[group];
 
#if NUSE_BLOCKING_ENABLE
 
    *tasks_waiting = NUSE_Event_Group_Blocking_Count[group];
    if (NUSE_Event_Group_Blocking_Count[group] != 0)
    {
        U8 index;
 
        for (index=0; index<NUSE_TASK_NUMBER; index++)
        {
            if ((LONIB(NUSE_Task_Status[index]) ==
                 NUSE_EVENT_SUSPEND)
                && (HINIB(NUSE_Task_Status[index]) == group))
            {
                *first_task = index;
                break;
            }
        }
    }
    else
    {
        *first_task = 0;
    }
 
#else
 
    *tasks_waiting = 0;
    *first_task = 0;
 
#endif
 
return NUSE_SUCCESS;


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


Получение количества групп флагов событий


Этот служебный вызов возвращает количество групп флагов событий в приложении. В Nucleus RTOS это значение со временем меняется, и возвращаемое значение показывает текущее количество групп, а в Nucleus SE это значение определяется во время сборки и не меняется со временем.


Вызов счетчика групп флагов событий в Nucleus RTOS
Прототип служебного вызова:
UNSIGNED NU_Establised_Event_Groups(VOID);

Параметры:
Отсутствуют.

Возвращаемое значение:
Текущее количество созданных групп флагов событий.

Вызов счетчика групп флагов событий в Nucleus SE
Прототип служебного вызова:
U8 NUSE_Event_Group_Count(void);

Параметры:
Отсутствуют.

Возвращаемое значение:
Количество сконфигурированных групп флагов событий.

Реализация счетчика групп флагов событий в Nucleus SE

Реализация этого вызова API довольно тривиальна: возвращается значение символа #define NUSE_EVENT_GROUP_NUMBER.


Структуры данных


Как и все другие объекты Nucleus SE, группы флагов событий используют один или два массива структур данных (оба размещаются в ОЗУ), размер массивов зависит от числа групп, определенных в настройках.

Настоятельно рекомендую, чтобы код приложения не использовал прямой доступ к этим структурам данных, а обращался к ним через предоставляемые функции API. Это позволит избежать несовместимости с будущими версиями Nucleus SE и нежелательных побочных эффектов, а также упростит портирование приложения на Nucleus RTOS. Для лучшего понимания работы кода служебных вызовов и для отладки ниже приведен подробный обзор структур данных.


Данные в ОЗУ

Эти данные имеют следующую структуру:

NUSE_Event_Group_Data[] – массив данных типа U8, имеющих одну запись для каждой сконфигурированной группы флагов; в нем хранятся данные флагов событий.
NUSE_Event_Group_Blocking_Count[] – массив типа U8, содержащий счетчик заблокированных задач в каждой группе флагов событий. Этот массив существует, только когда активирована функциональность блокировки в API.


Эти структуры данных инициализируются нулями в функции NUSE_Init_Event_Group() при запуске Nucleus SE. Одна из следующих статей предоставит полное описание процедур запуска Nucleus SE.


Ниже приведено описание этих структур данных в файле nuse_init.c:

RAM U8 NUSE_Event_Group_Data[NUSE_EVENT_GROUP_NUMBER];
 
#if NUSE_BLOCKING_ENABLE
 
    RAM U8 NUSE_Event_Group_Blocking_Count[NUSE_EVENT_GROUP_NUMBER];
 
#endif

Данные в ПЗУ

Для реализации групп флагов событий не используются данные в ПЗУ.

Объем памяти для групп флагов событий


Как и для всех объектов ядра Nucleus SE, объем памяти, необходимый для групп флагов событий, предсказуем.

Объем данных в ПЗУ для всех групп флагов событий в приложении равен 0.

Объем памяти в ОЗУ для всех групп флагов событий при активированной функциональности блокировки API равен NUSE_EVENT_GROUP_NUMBER * 2.


В противном случае он равен NUSE_EVENT_GROUP_NUMBER.

Нереализованные вызовы API

Три вызова API для групп флагов событий, которые можно найти в Nucleus RTOS, не были реализованы в Nucleus SE.

Создание группы флагов событий


Этот вызов API создает группу флагов событий. В Nucleus SE в этом вызове нет необходимости, так как группы флагов событий создаются статически.


Прототип служебного вызова:
STATUS NU_Create_Event_Group(NU_EVENT_GROUP *group, CHAR *name);

Параметры:

group – указатель на предоставляемый пользователем блок управления группой флагов событий; используется в качестве дескриптора для управления группами флагов событий в других вызовах API;
name – указатель на 8-символьное имя группы флагов событий с включенным в эту область терминирующим нулевым байтом.


Возвращаемое значение:
NU_SUCCESS – вызов был успешно завершен;
NU_INVALID_GROUP – нулевой указатель на блок управления группы флагов событий (NULL) или уже используется.

Удаление группы флагов событий


Этот вызов API удаляет ранее созданную группу флагов событий. В Nucleus SE в этом вызове нет необходимости, так как группы флагов событий создаются статически и не могут быть удалены.


Прототип служебного вызова:
STATUS NU_Delete_Event_Group(NU_EVENT_GROUP *group);

Параметры:
group – указатель на блок управления группой флагов событий.

Возвращаемое значение:
NU_SUCCESS – вызов был успешно завершен;
NU_INVALID_GROUP – некорректный указатель на группу флагов событий.

Указатели групп флагов событий


Этот вызов API составляет последовательный список указателей на все группы флагов событий в системе. В Nucleus SE в этом вызове нет необходимости, так как группы флагов событий имеют простые индексы, а не указатели.


Прототип служебного вызова:
UNSIGNED NU_Event_Group_Pointers(NU_EVENT_GROUP *pointer_list, UNSIGNED maximum_pointers);

Параметры:
pointer_list – указатель на массив указателей NU_EVENT_GROUP, этот массив заполняется указателями на созданные в системе группы флагов событий;
maximum_pointers – максимальное количество указателей в массиве.

Возвращаемое значение:
Количество указателей NU_EVENT_GROUP в массиве.

Совместимость с Nucleus RTOS


При разработке Nucleus SE моей целью было обеспечить максимальный уровень совместимости программного кода с Nucleus RTOS. Группы флагов событий не стали исключением, и, с точки зрения разработчика, они реализованы практически так же, как и в Nucleus RTOS. Существуют некоторые несовместимости, которые я посчитал допустимыми, с учетом того, что финальный код станет более понятным и более эффективным с точки зрения объема требуемой памяти. В остальном, вызовы API Nucleus RTOS могут быть практически напрямую использованы как вызовы Nucleus SE.


Идентификаторы объектов


В Nucleus RTOS все объекты описываются структурами данных (блоками управления), имеющими определенный тип. Указатель на этот блок управления служит идентификатором группы флагов событий. Я решил, что в Nucleus SE для эффективного использования памяти необходим другой подход: все объекты ядра описываются несколькими таблицами в ОЗУ и/или ПЗУ. Размер этих таблиц определяется количеством сконфигурированных объектов каждого типа. Идентификатор конкретного объекта – индекс в этой таблице. Таким образом, я определил NUSE_EVENT_GROUP в качестве эквивалента U8, переменная этого типа (не указатель) служит в качестве идентификатора группы флагов событий. С этой небольшой несовместимостью легко справиться если код переносится с Nucleus SE на Nucleus RTOS и наоборот. Обычно над идентификаторами объектов не выполняются никакие операции, кроме перемещения и хранения.

Nucleus RTOS также поддерживает присвоение имен группам флагов событий. Эти имена используются только при отладке. Я исключил их из Nucleus SE, чтобы сэкономить память.


Количество флагов в группе


В Nucleus RTOS группы флагов событий содержат по 32 флага, в Nucleus SE я уменьшил их число до восьми, так как этого достаточно для простых приложений и позволяет сэкономить ОЗУ. Nucleus SE может быть легко модифицирована, если требуются более крупные группы флагов событий.


Функция поглощения флагов


В Nucleus RTOS присутствует функция для очистки (поглощения) флагов событий после их чтения. Я решил исключить эту функцию из Nucleus SE для упрощения системы, так как поглощение (удаление) флагов происходит, когда все заблокированные задачи получили флаги для чтения, а это было бы сложно реализовать. При необходимости, считывающая флаги задача всегда может очистить их при помощи отдельного вызова API.


Нереализованные вызовы API


Nucleus RTOS поддерживает семь служебных вызовов для работы с группами флагов событий. Из них, три не реализованы в Nucleus SE. Детали этих вызовов, а также решение об их исключении из Nucleus SE были описаны выше. В следующей статье будут рассматриваться семафоры.


Об авторе: Колин Уоллс уже более тридцати лет работает в сфере электронной промышленности, значительную часть времени уделяя встроенному ПО. Сейчас он – инженер в области встроенного ПО в Mentor Embedded ( подразделение Mentor Graphics). Колин Уоллс часто выступает на конференциях и семинарах, автор многочисленных технических статей и двух книг по встроенному ПО. Живет в Великобритании. Профессиональный блог Колина: https://blogs.mentor.com/colinwalls/, e-mail: colin_walls@mentor.com


Источник: https://www.embedded.com/design/operating-systems/4460441/Event-flag-groups--utility-services-and-data-structures

Теги: ОСРВ, RTOS, флаги событий, группы флагов событий, микроконтроллеры