Руководство пользователя по MPLAB® компилятору Си для PIC24 и dsPIC®

где xxxx соответствует обозначению микросхемы устройства. Файлы заголовков Cи находятся в каталоге support\h.

Включение файла заголовка необходимо для того, чтобы использовать имена SFR (например, CORCONbits).

Например, следующий модуль, скомпилированный для микросхемы dsPIC30F2010, включает две функции: одну для включения окна PSV и другую для выключения окна PSV.

#include <p30f2010.h> void

EnablePSV(void)

{

CORCONbits.PSV = 1;

}

void DisablePSV(void)

{

CORCONbits.PSV = 0;

}

Соглашение о файлах заголовка процессора таково, что каждый SFR имеет то же имя, которое используется в документации на микросхему, например, CORCON для регистра управления ядром. Если регистр имеет отдельные биты, представляющие интерес, тогда там также будет структура, определенная для этого SFR, и ее имя будет аналогично имени SFR, с добавлением «bits». Например, CORCONbits для регистра управления ядром. Отдельные биты (или битовые поля), названы в

16-битовый компилятор Си. Руководство

структуре теми же именами, что и биты в документации, например PSV для бита PSV регистра CORCON. Вот полное определение CORCON (возможны изменения):

/* CORCON: CPU Mode control Register */

Файлы заголовков процессора описанные в п. 7.3. «Файлы заголовков процессора» именуют все SFR для каждой микросхемы, но не определяют адреса SFR.

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

ОтдельныйTranslatedнабор файлов сценария компоновки, по одному на микросхему, расположен в каталоге support\gld. Эти файлы сценария компоновки определяют

-T p30fxxxx.gld

где xxxx соответствует обозначению микросхемы устройства.

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

pic30-gcc -o app2010.o -T p30f2010.gld app2010.c

Опция командной строки -o присваивает имя выходному исполняемому COFF файлу, а опция -T конкретизирует имя микросхемы dsPIC30F2010. Если p30f2010.gld не будет обнаружен в текущем каталоге, компоновщик ищет его в известных ему библиотечных путях. Для установки по умолчанию сценарии компоновки включены в путь PIC30_LIBRARAY_PATH. Подробнее см. п. 3.6. «Переменные окружения».

7.5.Использование SFR

При использовании SFR в приложении следует выполнить три шага.

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

#include <p30f6014.h>

Глава 7. Файлы поддержки устройства

2.Работайте с SFR как с любыми другими переменными в Cи. SFR можно читать и писать в исходном код.

Например, следующий оператор сбрасывает в 0 все биты SFR первого таймера.

TMR1 = 0;

Следующий оператор представляет 15-й бит регистра T1CON, который является битом включения таймера. Он устанавливает бит с именем TON в 1, этим запуская таймер.

T1CONbits.TON = 1;

См. «MPLAB® Assembler, Linker and Utilities for PIC24 MCUs and dsPIC® DSCs User’s Guide» (DS51317) для подробностей об использовании сценариев компоновщика.

Следующий пример является часами реального времени. Он использует несколько SFR. Описания для них находятся в файле p30f6014.h. Этот файл должен быть скомпонован с использованием специфического сценария компоновки, находящегося в файле p30f6014.g d.

ПРИМЕР 7-1. ЧАСЫ РЕАЛЬНОГО ВРЕМЕНИ

** используется 1-й таймер тактируемый от TCY ** и прерывание по истечению периода

*/Translated

#include <p30f6014.h>

/* Период Tim r1 для 1 ms при FOSC = 20 MHz */ #define TMR1 PERIOD 0x1388

void __attribute__((__interrupt__)) _T1Interrupt(void) { static int sticks=0;