- PVSM.RU - https://www.pvsm.ru -

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

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

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

Предыдущие статьи серии:

Статья #17. Группы флагов событий: введение и базовые службы [1]
Статья #16. Сигналы [2]
Статья #15. Разделы памяти: службы и структуры данных [3]
Статья #14. Разделы памяти: введение и базовые службы [4]
Статья #13. Структуры данных задач и неподдерживаемые вызовы API [5]
Статья #12. Службы для работы с задачами [6]
Статья #11. Задачи: конфигурация и введение в API [7]
Статья #10. Планировщик: дополнительные возможности и сохранение контекста [8]
Статья #9. Планировщик: реализация [9]
Статья #8. Nucleus SE: внутреннее устройство и развертывание [10]
Статья #7. Nucleus SE: введение [11]
Статья #6. Другие сервисы ОСРВ [12]
Статья #5. Взаимодействие между задачами и синхронизация [13]
Статья #4. Задачи, переключение контекста и прерывания [14]
Статья #3. Задачи и планирование [15]
Статья #2. ОСРВ: Структура и режим реального времени
Статья #1. ОСРВ: введение.

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

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). Колин Уоллс часто выступает на конференциях и семинарах, автор многочисленных технических статей и двух книг по встроенному ПО. Живет в Великобритании. Профессиональный блог Колина [16], e-mail: colin_walls@mentor.com.

Автор: EasyLy

Источник [17]


Сайт-источник PVSM.RU: https://www.pvsm.ru

Путь до страницы источника: https://www.pvsm.ru/api/298255

Ссылки в тексте:

[1] Статья #17. Группы флагов событий: введение и базовые службы: https://habr.com/post/428131/

[2] Статья #16. Сигналы: https://habr.com/post/427439/

[3] Статья #15. Разделы памяти: службы и структуры данных: https://habr.com/post/426477/

[4] Статья #14. Разделы памяти: введение и базовые службы: https://habr.com/post/426425/

[5] Статья #13. Структуры данных задач и неподдерживаемые вызовы API: https://habr.com/post/425353/

[6] Статья #12. Службы для работы с задачами: https://habr.com/post/424713/

[7] Статья #11. Задачи: конфигурация и введение в API: https://habr.com/post/424481/

[8] Статья #10. Планировщик: дополнительные возможности и сохранение контекста: https://habr.com/post/423967/

[9] Статья #9. Планировщик: реализация: https://habr.com/post/422615/

[10] Статья #8. Nucleus SE: внутреннее устройство и развертывание: https://habr.com/post/422617/

[11] Статья #7. Nucleus SE: введение: https://habr.com/post/418601/

[12] Статья #6. Другие сервисы ОСРВ: https://habr.com/post/418677/

[13] Статья #5. Взаимодействие между задачами и синхронизация: https://habr.com/post/415429/

[14] Статья #4. Задачи, переключение контекста и прерывания: https://habr.com/post/415427/

[15] Статья #3. Задачи и планирование: https://habr.com/post/415329/

[16] блог Колина: http://blogs.mentor.com/colinwalls

[17] Источник: https://habr.com/post/428890/?utm_campaign=428890