PIC24 osa:ref:description

OSA : Типы данных

2010-11-23T13:22:03+03:00

OSA : Типы данных

Системные

OST_UINT8

Платформонезависимое беззнаковое 8-битное целое

OST_UINT16

Платформонезависимое беззнаковое 16-битное целое

OST_UINT32

Платформонезависимое беззнаковое 32-битное целое

OST_WORD

Платформозависимое беззнаковое целое. Имеет разрядность шины данных выбранного контроллера.

Общие

OST_CSEM

Тип счетного семафора.

Определение

typedef OST_UINT8 OST_CSEM;

Тип доступен, только если в OSAcfg.h определена константа OS_ENABLE_CSEM

Переопределение

Этот тип можно изменить, задав вручную его размерность в файле OSAcfg.h:

#define OS_CSEM_SIZE    4

Допустимые значения для OS_CSEM_SIZE:

1	OST_UINT8 (0..2^8-1)
2	OST_UINT16 (0..2^16-1)
4	OST_UINT32 (0..2^32-1)

OST_MSG

Указатель на сообщение.

Определение

typedef void * OST_MSG;

Переопределение

Этот тип можно переопределить, задав константу OS_MSG_TYPE в файле OSAcfg.h:

typedef struct
{
    char * Name;
    char Age;
} MyType;
 
#define OS_MSG_TYPE MyType *

OS_MSG_TYPE можно задавать любым: от простого целого до указателя на память программы.

OST_MSG_CB

Дескриптор указателя на сообщения. Помимо самого указателя содержит флаг состояния свободен/занят.

Определение

typedef struct
{
    char      status;     // Состояние (активно/неактивно)
    OST_MSG   msg;        // Указатель на сообщение
} OST_MSG_CB;

Переопределение

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

OST_DTIMER

Динамический таймер.

Определение

typedef struct
{
    OST_DTIMER_FLAGS Flags;     // Флаги управления и состояния таймера
    void *           Next;      // Указатель на следующий таймер
    OS_DTIMER_TYPE   Timer;     // Сам таймер
} OST_DTIMER;

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

Flags	Флаги состояния (см. OST_DTIMER_FLAGS)
Next	Указатель на следующий активный таймер в списке
Timer	Сам счетчик. Разрядность определяется константой OS_DTIMER_SIZE

Переопределение

Т.к. сам счетчик имеет тип системного таймера, то разрядность динамического таймера можно изменить, задав константу OS_DTIMER_SIZE в файле OSAcfg.h:

#define OS_DTIMER_SIZE       4

Допустимые значения для OS_DTIMER_SIZE:

1	OST_UINT8 (0..2^8-1)
2	OST_UINT16 (0..2^16-1)
4	OST_UINT32 (0..2^32-1)

OST_QTIMER

Таймер для работы с очередью таймеров.

Определение

typedef struct
{
    OST_QTIMER_FLAGS Flags;     // Флаги управления и состояния таймера
    void *           Next;      // Указатель на следующий таймер
    OS_QTIMER_TYPE   Timer;     // Сам таймер
} OST_QTIMER;

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

Flags	Флаги состояния (см. OST_QTIMER_FLAGS)
Next	Указатель на следующий активный таймер в списке
Timer	Сам счетчик. Разрядность определяется константой OS_QTIMER_SIZE

Переопределение

Т.к. сам счетчик имеет тип системного таймера, то разрядность таймера можно изменить, задав константу OS_QTIMER_SIZE в файле OSAcfg.h:

#define OS_QTIMER_SIZE       4

Допустимые значения для OS_QTIMER_SIZE:

1	OST_UINT8 (0..2^8-1)
2	OST_UINT16 (0..2^16-1)
4	OST_UINT32 (0..2^32-1)

OST_QUEUE

Очередь указателей на сообщения.

Определение

typedef struct
{
    OST_QUEUE_CONTROL Q;
    OST_MSG *pMsg;              // Указатель на саму очередь
} OST_QUEUE;

Q - блок управления очередью. pMsg - указатель на буфер в памяти, где будут храниться сами указатели на сообщения.

Переопределение

Возможно переопределение только указателя на сообщение OST_MSG.

OST_SQUEUE

Очередь коротких однобайтовых сообщений.

Определение

typedef struct {
    OST_QUEUE_CONTROL Q;
    OST_SMSG *pSMsg;             // Указатель на очередь сообщений
} OST_SQUEUE;

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

Переопределение

Возможно переопределение только тип короткого сообщения OST_SMSG.

OST_SMSG

Короткое однобайтовое сообщение. Предназначено для обмена задачами коротких сообщений, не прибегая к использованию указателей.

Определение

typedef OST_UINT8   OST_SMSG;

Переопределение

Этот тип можно переопределить, задав константу OS_SMSG_TYPE в файле OSAcfg.h:

#define OS_SMSG_TYPE unsigned long

Допустимы любые перечислимые типы. Следует помнить, что это сообщение не имеет отдельного блока управления или дескриптора, который бы содержал информацию о состоянии сообщения (свободно/занято). Эта информация в самом сообщении: =0 - свободно, !=0 - занято.

OST_TASK_POINTER

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

Определение

typedef OS_TASKS_BANK OST_TCB *  OST_TASK_POINTER;

Следует обратить внимание, что изпользуется префикс OS_TASKS_BANK.

Переопределение

Невозможно

Счетчики таймеров

OS_DTIMER_TYPE

Тип счетчика динамического таймера.

Определение

#if   OS_DTIMER_SIZE == 1
    #define OS_DTIMER_TYPE OST_UINT8
#elif OS_DTIMER_SIZE == 2
    #define OS_DTIMER_TYPE OST_UINT16
#elif OS_DTIMER_SIZE == 4
    #define OS_DTIMER_TYPE OST_UINT32
#endif

Если константа OS_DTIMER_SIZE не определена, то по умолчанию она будет равна OS_TIMER_SIZE.

OS_STIMER_TYPE

Тип статического таймера.

Определение

#if   OS_STIMER_SIZE == 1
    #define OS_STIMER_TYPE OST_UINT8
#elif OS_STIMER_SIZE == 2
    #define OS_STIMER_TYPE OST_UINT16
#elif OS_STIMER_SIZE == 4
    #define OS_STIMER_TYPE OST_UINT32
#endif

Если константа OS_STIMER_SIZE не определена, то по умолчанию она будет равна OS_TIMER_SIZE.

OS_TTIMER_TYPE

Тип таймера в задачах.

Определение

#if   OS_TTIMER_SIZE == 1
    #define OS_TTIMER_TYPE OST_UINT8
#elif OS_TTIMER_SIZE == 2
    #define OS_TTIMER_TYPE OST_UINT16
#elif OS_TTIMER_SIZE == 4
    #define OS_TTIMER_TYPE OST_UINT32
#endif

Если константа OS_TTIMER_SIZE не определена, то по умолчанию она будет равна OS_TIMER_SIZE.

OS_QTIMER_TYPE

Тип таймера в очереди таймеров.

Определение

#if   OS_QTIMER_SIZE == 1
    #define OS_QTIMER_TYPE OST_UINT8
#elif OS_QTIMER_SIZE == 2
    #define OS_QTIMER_TYPE OST_UINT16
#elif OS_QTIMER_SIZE == 4
    #define OS_QTIMER_TYPE OST_UINT32
#endif

Если константа OS_QTIMER_SIZE не определена, то по умолчанию она будет равна OS_TIMER_SIZE.

OSA : События и приоритетность

2009-08-08T16:24:45+03:00

OSA : События и приоритетность

Состояния задач

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

Таким образом, все активные (т.е. созданные сервисом OS_Task_Create) задачи, работающие в OSA, могут находиться в одном из пяти состояний:

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

События и приоритетность

Для того чтобы задача получила управление, нужно, чтобы:

во-первых, произошло то событие, которого она ждет (т.е. стала готовой к выполнению);
во-вторых, чтобы она стала наиболее приоритетной из готовых.

Все задачи имеют приоритет от 0 (самый высокий приоритет) до 7 (самый низкий приоритет). Если к выполнению готовы сразу несколько задач, то первой выполнится та, приоритет которой выше. Если есть несколько готовых задач с одинаковым приоритетом, то они выполнятся последовательно.

События в OSA:

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

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

Например:

    OS_Cond_Wait(TMR1IF);            // Ждем установки флага TMR1IF
    или
    OS_Cond_Wait(ReadADC(0) > 128);  // Ждем, когда напряжение на входе АЦП будет > Vdd/2

Для ожидания событий пятого типа есть два системных сервиса OS_Wait и OS_Wait_TO, которые описаны в разделе системные сервисы.

Состязания приоритетов

Бывает так, что одного и того же события одновременно ожидают две или более задач. Например, они ждут освобождения какого-нибудь ресурса (USART или доступ к внешней EEPROM). Как поведет себя система в этом случае? После того, как событие произойдет, все задачи, ожидающие это событие, перейдут в состояние готовности. Управление же получит задача с наиболее высоким приоритетом. Если после того, как эта задача отработает, событие сбрасывается (например, все задачи ожидали включения семафора, а та задача, которая получила управление, его сбросила), то все остальные задачи опять переходят в состояние ожидания.

OSA : ОПИСАНИЕ

2009-06-04T01:24:01+03:00

OSA : ОПИСАНИЕ

OSA : Предопределенные константы

2010-12-08T15:14:15+03:00

OSA : Предопределенные константы

Constant name	Notes
System
__OSA_VERISON__	Текущая версия OSA в формате ГГММДД ГГ, ММ и ДД - год, месяц и день выпуска Поддается сравнению (каждая последующая больше предыдущей)
Chip type
__OSA_PIC12__	PIC10 or 12-bit PIC12
__OSA_PIC16__	PIC16 or 14-bit PIC12
__OSA_PIC16E__	PIC12F1xxx or PIC16F1xxx
__OSA_PIC18__
__OSA_DSPIC__	dsPIC30 or dsPIC33
__OSA_PIC24__	PIC24F, PIC24FK or PIC24H
__OSA_PIC24F__
__OSA_PIC24FK__
__OSA_PIC24H__
__OSA_DSPIC30__
__OSA_DSPIC33__
__OSA_AVR__	8-bit AVR
__OSA_STM8__
Compiler type
__OSA_CCS__	CCS PICC
__OSA_HTPICC__	HiTech PICC STD
__OSA_HTPICC_PRO__	HiTech PICC PRO
__OSA_MPLABC__	MPLABC18 or MPLABC30
__OSA_MIKROC__	MikroC PRO (ver 3.0 and greater)
__OSA_WINAVR__	WinVAR
__OSA_IAR__	IAR
__OSA_COSMIC__	Cosmic
Chip and compiler
__OSA_PIC12_HTPICC__
__OSA_PIC16_CCS__
__OSA_PIC16_HTPICC__
__OSA_PIC16_MIKROC__
__OSA_PIC16E_HTPICC_PRO__
__OSA_PIC18_HTPICC__
__OSA_PIC18_MPLABC__
__OSA_PIC18_MPLABC_EXT__
__OSA_PIC18_CCS__
__OSA_PIC18_MIKROC__
__OSA_PIC24_MPLABC__	Same as __OS_DSPIC_MPLABC__
__OSA_DSPIC_MPLABC__	Same as __OS_PIC24_MPLABC__
__OSA_AVR_WINAVR__
__OSA_AVR_IAR__
__OSA_STM8_COSMIC__

OSA : Проект

2010-11-15T15:14:22+03:00

OSA : Проект

Создание проекта

Для использования OSA в своем приложении нужно:

Создать проект, используя IDE оболочку. В него, помимо файлов самой программы, включить файл osa.c (он содержит определения всех системных переменных и системных функций).
В папке с файлами программы создать файл системной конфигурации osacfg.h, где задать параметры использования системы (в самом простом случае этот файл может быть пустым). Подробнее об этом файле см. Конфигурация OSAcfg.h. Этот файл можно создать с помощью утилиты OSAcfg_Tool.
Во все файлы, где есть вызовы сервисов OSA, включить файл osa.h.
В параметрах проекта указать пути "Include Search Path":
- путь к файлу osacfg.h текущего проекта;
- путь к файлу osa.h.
В самом начале программы (в фукнции main()) вызвать фукнцию инициализации системы OS_Init(), а в самом конце - вызвать сервис OS_Run().

Примечания для различных IDE и платформ

MPLAB

файл osa.c добавляется правым щелчком мышки в окне проекта (открывается через меню "View/Project")
Include-пути задаются в параметрах проекта: меню "Project/Build options/Project…", вкладка "Directories".

MPLAB и HT-PICC

Ранние версии плагинов HTPICC длч MPLAB'а не позволяли вводить относительные пути, а только абсолютные (т.е. не "..\..\", а "c:\osa")
для PRO-версии компилятора: Чтобы компилятор правильно строил дерево вызовов функций, все создаваемые задачи должны быть объявлены в main() сервисом OS_Task_Define()

void main (void)
{
    OS_Init();
    ...
    OS_Task_Define(Task_Buttons);
    OS_Task_Define(Task_LEDs);
    OS_Task_Define(Task_LCD);
    ...
    OS_Task_Create(Task_Buttons);
    OS_Task_Create(Task_LEDs);
    OS_Task_Create(Task_LCD);
 
}

MPLAB и Mplab C18

Требуется указать путь к библиотекам: меню "Project/Build options/Progect…", вкладка "Directories", пункт "Library Search Path". Там ввести путь для MCC18 (например, c:\mcc18\lib).
там же в параметрах проекта выбрать вкладку "MPLAB C18", категория "Optimization" и снять галочку (если стоит) напротив пункта "Procedural absraction"
Не забыть добавить файл скрипта для линкера: правой кнопкой на папке "Linker Script" в окне "Project" и выбрать скрипт для требуемого контроллера из папки "MCC18\lkr". (Для работы в extended-режиме имя файла скрипта должно иметь суффикс 'e')

MPLAB и Mplab C30

в параметрах проекта выбрать вкладку "MPLAB C30", категория "Optimization" и снять галочку (если стоит) напротив пункта "Procedural absraction"

CCS

файл osa.c в проект включать не нужно!
Чтобы компилятор правильно строил дерево вызовов функций, все создаваемые задачи должны быть объявлены в main() сервисом OS_Task_Define()

void main (void)
{
    OS_Init();
    ...
    OS_Task_Define(Task_Buttons);
    OS_Task_Define(Task_LEDs);
    OS_Task_Define(Task_LCD);
    ...
    OS_Task_Create(Task_Buttons);
    OS_Task_Create(Task_LEDs);
    OS_Task_Create(Task_LCD);
 
}

mikroC PRO IDE

Файл osa.c добавляется в проект через меню "Project/Add File To Project…"
Include-пути задаются через меню "Project/Edit Search Paths…". В открывшемся окне есть два списка путей: Source Files и Header Files. нам нужен список Header Files. Над ним есть кнопка с зеленым плюсиком, давим ее и добавляем нужные пути.
Линкер должен быть проинформирован о том, что функции, которые предполагается использовать как задачи, будут вызываться не напрямую, а через указатель:

#pragma funcall main Task_Buttons       // Говорим компилятору, что Task_Button будет
                                        // вызываться через указатель
 
void Task_Buttons (void)
{
    ...
}

AVR Studio и WinAVR

Пункт меню "Project/New Project":
1. Выбираем Project type: AVR GCC
2. выбираем путь и имя проекта, давим Next
3. в следующем окне выбираем контроллер и тип отладочного средства (Debug Platform), давим Finish
в окне проекта (AVR GCC) правой кнопкой мышки нажимаем на папке "Source Files" и выбираем пункт "Add Existing Source File(s)…" и добавляем файл osa.c
include-пути задаются через меню "Project/Configuration options", вкладка "Include Directories"

IAR

Создаем проект C (меню "Project/Create New Project…")
файл osa.c добавляется через меню "Project/Add files…"
include-пути задаются в параметрах проекта: меню "Project/Options", категория "C/C++ compiler", вкладка "preprocessor", в поле "Additional include directories"
там же в параметрах проекта во вкладке "Optimization" убрать галочку с пункта "Cross call"

IAR STM8

В добавок ко всем требованиям, описанным выше в пункте "IAR", к проекту дорбавить файл "osa\port\stm8\osa_stm_iar.s"

STVD и STM8

проект создается через меню "File/New Workspace".
1. В открывшемся окне выбрать "Create workspace and Porject"
2. далее задаем имя рабочего пространства (workspace) и путь
3. в следующем окне задаем имя проекта, путь, и выбираем компилятор: Raiconance или Cosmic
4. выбираем контроллера
нажимаем правую кнопку мышки на папке Source в окне Workspace, выбираем пункт "Add Files To Folder…" и выбираем файл osa.c
include-пути задаются в параметрах проекта: меню "Project/Settings", вкладка "C compiler", категория "Preprocessor", пункт "Additional include directories"

Raisonance и STM8

создаем новый проект через меню "Project/New project"
файл osa.c добавляется через меню "Project/Add Item…"
include-пути задаются в параметрах проекта: меню "Projetc/properties", пункт "Application Optios", подпункт "Directories". К имеющимся в списке добавить два: путь к osa.h и путь к osacfg.h

OSA : Планировщик

2011-01-18T16:47:57+03:00

OSA : Планировщик

Сервис OS_Run() - это макрос, который содержит бесконечный цикл с работой планировщика. Этот сервис вызывается в самом конце функции main() и полностью передает управление ядру OSA. Планировщик отвечает за проверку готовности задач к выполнению, определение задачи с наивысшим приоритетом (из готовых) и за запуск задач. Вызов сервиса OS_Run() может располагаться только в одном месте программы, т.к. он содержит глобальные метки для возврата из задач.

Планировщик по очереди перебирает все активные задачи, проверяя их готовность и одновременно вычисляя задачу с высшим приоритетом. Если была найдена одна или несколько готовых задач, то из них выбирается та, у которой приоритет выше, и ей передается управление. Подробнее о приоритетах см. "События и проиритетность".

Исключение составляет работа в критической секции. OSA допускает передачу управления планировщику из задачи, выполняющейся в критической секции. Планировщик, определив, что находится в критической секции, не осуществляет поиск готовых задач, а сразу же передает управление последней выполнявшейся задаче.