Mplab c18 руководство пользователя

Configuring MPLAB and C18 Compiler,Setting up your first Project

---

Mplab Ide Installation
C18 Compiler Toolsuite Inslallation
Toolsuite Settings and creating a new project
Library and Path settings

---

Introduction

Configuring MPLAB with C18 compiler and setting your first project requires some basic set of things which need to be kept in mind all the time while you carry on to avoid un necessary pain. In my previous pic18f4550 programming post we got a quick preliminary description about Programming a Microcontroller. I am assuming that you have already downloaded the tools from, microchip (MPLAB IDE and C18) Compiler from the links provided from the previous post.

If installation for Mplab and C18 Compiler went well for you then, you can quickly skip this part of tutorial and go on the next part with for coding your pic18f4550 microcontroller. PIC18F4550 Blinking LED Method — 1.

Next stage would be to install the weapons, (tools) that we downloaded in our previous post for the war to be won. Snapshot below describes the steps of installation, Configuration of C18 Compiler, creating project and Setting up compiler, library and directories on windows XP OS. Installation and settings won’t be much of a different taste for other Windows OS as well.

MPLAB Installation

---

First Install the MPLAB IDE from the setup file you downloaded.

Incase if in future you loose the shortcut then you can start mplab from
C:Program FilesMicrochipMPLAB IDECoreMPLAB.exe

After installation of Mplab and C18, next step is to create a new project from Project Wizard. All the coding would be handled as individual projects which would contain various the blocks of code interconnected.

For demo purpose we are going to create a Dummy project to understand the project setting.  First create a new folder in your desktop or on your desired location manually. In our tutorial I have created a folder on Desktop “Project1”. All the project files will be stored here; don’t forget the location where you created your project folder. 

So First start MPLAB IDE, which would start blank as an “Untitled Workspace”.

Project Wizard

Create a new project by proceeding through project wizard from top file menus that would help you to setup the setting for your first new project. Project wizard would give you options to select your microcontroller which you intent to code and also it will load the necessary tool suite that you need for project.

Project Wizard

Select the microcontroller from the drop down list menu, which in our case is PIC18F4550.

ToolSuite Selection

Next step would be to select the Toolsuite.
In our case we are going to use C18 Compiler Toolsuite, so while creating the project from project wizard when it prompts, select C18 Toolsuite from the top drop down menu.

From Drop down menu select Microchip C18 Toolsuite
Most of the time the default would be Microchip C18 Toolsuite if you haven’t installed any other Tool suite.

Select the Microchip C18 Toolsuite from Active Tool suite drop down menu and go on to next settings with defaults.

Next step is to give a name to your project, hit browse and Navigate to the location where you created a folder in the beginning of this session. The folder which was created in the beginning was named as project1 for this tutorial. Navigate to the folder that you created.

Navigate inside the folder and then name the new Project. And then click next.

In the next screen Mplab would prompt you to add some files to your project. This prompt would help you to add already coded files. Since we don’t have anything yet coded for our pic18f4550 so proceed with next button leaving things untouched.

When everything is done mplab would display Project Summary with all project parameters such as Device name, Toolsuite and location of the project. Hit finish.

Your project settings are now ready. Created project can be viewed in the same folder where you saved your project few seconds ago. The main project file would be yourprojectname.mcp ( the name which you gave to the project while creating the project inside the folder where you saved ). You can always launch the entire project with your project name. For this tutorial its been named as  project1.mcp inside the main project folder project1.

• Project1 (project Folder)
  • Project1.mcp (Project name)

The Project which is created now would be blank without any coding.

Adding a new C File         

Now since we have created a project, now we have to add C files for writing our code.

Create a new file by either clicking on File > New or click on New File icon.

That would create a new untitled file. Write some dummy string and then hit save. Name the file while saving it. In our case we would name it as main.c.

NOTE:* While saving the file, remember to check the box. “Add this file to project” or the file saved will not be added to the project workspace and the main.c will be missing from project file explorer.

The new added C file would be enlisted in the project explorer Under “Source Files”. Now we have successfully added a C file for writing the codes.

Directory and Compiler library setting

---

You can review the build (Compile) setting for your Project under the menu
Project > Built Options > Project

Built options

By default when the Microchip C18 Toolsuite was chosen from project wizard, it added the directory paths for the links and library setting for the project, which includes the links to the linker files for linking and other necessary libraries. Just in case if the library settings are not set then you can review the setting under the Directory Search Paths.

From drop down menu under the Directories select Library Search Path.

Output Path Setting

By default if you don ’t choose an output folder then all files created during the compilation of the program would be directly dumped into the main project folder (Project1 folder) where you created the project. That would make things looks messy after you compile, and you would find some extra files that compiler generated during compilation.

To avoid that it’s recommended to add a separate output folder. So that compiler would dump all the files into the Output folder including your .hex file which is your final outcome before burning it into the microcontroller.

• Create a new Folder inside the main Project folder and name it as output.
• Open the Directory Setting in the project Built Option

• Select the option from drop down as “Output Directory”

• Hit the browse icon and locate the main project1 folder and then select the folder you just created with name “Output” and then apply settings.

Henceforth whenever you would compile any project all the runtime files and output hex files would be dumped in the output folder. That would make life easy in future.

Hence now we are completely set with MPLAB IDE, compiler and Project settings .. So lets carry on with our first setting on real time coding with hardware c.

 Blinking a led – Method 1

Previous Next

The following section will provide a basic tutorial for using the Microchip C18 compiler with MPLAB.  The tutorial is based on the PIC18F4620 microcontroller, but will work for any other PIC18F device.

Creating a New Project

Before you can start writing code for the PIC Microcontroller, you have to create a project folder manually (e.g. c:Tutorial).  Once you have created folder, follow these steps:

1. Start MPLAB (v8.83)
2. Select Project → Project Wizard
3. Click Next
4. Select PIC18F4620 and click Next
5. Select Microchip C18 Toolsuite under the Active Toolsuite dropdown box
6. Select MPLAB C18 C Compiler (mcc18.exe) under the Toolsuite Contents dropdown box and click Next
7. Click Browse under the Create New Project File
8. Select the folder where you want to create the project (e.g. c:Tutorial)
9. Type the name of the project and try to keep the name of the project the same as the folder name to prevent confusion (e.g.
   Tutorial in this case).  The project file will now have a .mcp extension.
10. Click Save.
11. Click Next
12. Click Next
13. Click Finish

A project view of your project should appear in the top-left corner (Source Files, Header Files, etc.).  Now you are ready to create a new source file

1. Click File → New
2. Click File → Save As
3. Select your project folder (e.g. c:Tutorial) (make sure you change to the correct folder) and type the name of your source file PLUS the .c extension (e.g. flashleds.c).  Do not forget to add the .c after the filename, otherwise it will simply been see as a text file and will not compile.  The name of the source file does not have to be the same as the project.
4. Click Save

The new source file is now created and needs to be added to the project

1. Right-click on Source Files and select Add Files
2. Select the source file you just created (flashleds.c) and click Open

The programming device must now be selected to program the source file onto the PIC

1. Select Programmer ® Select Programmer ® MPLAB ICD2

An output view window should open now which gives feedback about the compiling and programming process.

At this stage all the windows can be rearranged to fit your needs. T he next time you open the project, the windows will stay in these positions.

Writing C Code, Compiling and Programming

In the flashleds.c window, type the following program to make 8 LEDs connected to PORTD flash at a rate of 250ms:

#include <p18f4620.h>
#include <delays.h>

void main(void)
{
    TRISD = 0x00;                   
    while(1)                       
    {
        PORTD = 0xFF;
        Delay10KTCYx(250);
        PORTD = 0x00;       
        Delay10KTCYx(250);
    }
}

To compile the source file, select Project → Make (or just press F10).  The output window should now indicate if it compiled successful (“BUILD SUCCEEDED”) or not (“BUILD FAILED”).  If there are any errors, fix them first before trying to program the PIC Microcontroller.

Before we can use the PIC18F4620 for our project, we need to indicate what the configuration bits for the device should be (this only needs to be done once). 

1. Select Configure → Configuration Bits.
2. If the Configuration Bits set in code option is ticked, un-tick it.
3. You should not be able to select the configuration for each of the configuration bits by clicking in the Settings field.  Select the following configurations:
   OSC      —       HS Oscillator, PLL enabled
   PWRT    —       PWRT enabled
   WDT      —       WDT disabled
    
4. Close the Configuration Bits window
5. Re-compile the code again (F10).

The above method could be simplified by making use of a user defined Config.h library file (in the Example programs – Libraries section) which must be copied into the project folder.  Change the source code to:

#include <p18f4620.h>
#include <delays.h>
#include «Config.h»             // *** ADD THIS LINE ***

void main(void)
{
    TRISD = 0x00;                   
    while(1)                       
    {
        PORTD = 0xFF;
        Delay10KTCYx(250);
        PORTD = 0x00;       
        Delay10KTCYx(250);
    }
}

and then tick the Configuration Bits set in code option in the Configuration Bits window.  Now all the configuration bits will be set to the settings as described in the Config.h file.

Once the code is compiled and the configuration bits are set, the source code can be programmed onto the PIC Microcontroller.

1. Select Programmer → Program.  This will download the source code to the PIC.
2. Select Programmer → Release from Reset to run the code on the PIC Microcontroller.
3. Select Programmer → Hold in Reset to stop the code on the PIC Microcontroller and keep it in the reset state.
4. There are also short-cut buttons at the top-right corner to program, run, and stop the PIC Microcontroller.
5. The code will automatically run when the programmer is removed from the programming (ICSP or RJ-12) port.

Loading an Existing Project

To load an existing project (or a Workspace as it is called in MPLAB), you can:

1. Start MPLAB (v8.83)
2. Select the .mcp file in your project folder and click Open

OR

1.  In windows explorer, go to the project folder
2. Double-click on the project file (e.g. Tutorial.mcp)

The workspace should open exactly the same way it was when you closed it the previous time.

Adding a New Source File to the Project

If you want to create a new source file for the project, or compile an older source file that you have already created, do the following:

1. Remove the previous source file by right-clicking on it in the project window and selecting Remove
2. Right-click on Source Files and select Add Files
3. Select the new source file and click Open

This is also the method that you will ise to load the example programs.

Программирование
PIC-микроконтроллеров

на
языке Си

Лабораторная
работа № 1

Программирование
на языке Си в среде MPLAB
IDE

1.
Цель работы

Изучить
основы разработки и отладки программ
на языке Си для микроконтроллеров
семейства PIC18 с помощью интегрированной
среды программирования MPLAB IDE.

2.
Основные теоретические сведения

2.1.
Средства для программирования в MPLAB
IDE

2.1.1.
Си компилятор MPLAB
C18.
Это кросс-компилятор, работающий на
персональном компьютере и генерирующий
код, который может выполняться на
микроконтроллерах фирмы Microchip
семейства PIC18.
Как и ассемблер, MPLAB
C18
компилятор переводит понятные и привычные
для человека предложения в набор кодов
из нулей и единиц для выполнения
микроконтроллером. Однако, в отличие
от ассемблера, компилятор не выполняет
буквальный перевод мнемоник команд в
машинные коды.

MPLAB
C18
читает стандартные для языка ANSI
C
выражения, такие как “if
( x
== y
)” или “temp
= 0x27”,
и преобразует их в машинные коды для
микроконтроллеров
семейства
PIC18.
Компилятор проявляет при этом значительный
«интеллект». Он может оптимизировать
код, используя подпрограммы, которые
будут использоваться многими функциями.
Он может перегруппировать коды исходной
программы, исключить при этом коды,
которые не будут исполняться, использовать
одинаковые фрагменты кодов в различных
функциях, может определить данные и
регистры, которые используются не
эффективно, и оптимизировать их работу.

Текст
исходной программы использует стандартную
для языка ANSI
C
нотацию. Исходный текст компилируется
в блоки кодов программ и данных, которые
компонуются с другими блоками и затем
размещаются в различных областях памяти
микроконтроллера PIC18.
Этот процесс называется
build (построение),
и очень часто выполняется многократно
в ходе разработки программы, при котором
код пишется, тестируется и отлаживается.
MPLAB
C18
компилятор и связанные с ним программные
средства, такие как линкер (компоновщик)
и ассемблер, могут запускаться из
командной строки, а могут использоваться
в интегрированной среде разработки
MPLAB
IDE.
При этом графический интерфейс
пользователя служит единственной средой
для написания, компилирования и отладки
программ.

Окна
диалогов MPLAB
IDE
и менеджер проектов управляют всеми
деталями компилирования, ассемблирования
и компоновки, позволяя сосредоточить
все внимание на процесс написания и
отладки программ.

MPLAB
C18
компилятор делает разработку программ
для микроконтроллерных устройств
намного удобнее, так как он использует
стандартный язык Си. Кроме того, компилятор
MPLAB
C18
способен генерировать исключительно
эффективный код для микроконтроллеров
семейства PIC18.

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

1. глубокого
   знания системы команд микроконтроллера
   не требуется, элементарное знание
   архитектуры желательно

2. распределение
   регистров и способы адресации управляются
   полностью компилятором

3. лучшая
   читаемость программы, используются
   ключевые слова и выражения, которые
   более свойственны человеческой мысли

4. время
   разработки программ и их отладки
   значительно короче в сравнении с
   программированием на Ассемблере

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

2.1.2.
MPASM
кросс-ассемблер и MPLINK
линкер. Очень часто кросс-ассемблер
используется при написании текста
программы в проекте. MPASM
является компонентом MPLAB
IDE
и он работает вместе с линкером MPLINK,
чтобы скомпоновать ассемблерные секции
кода с секциями, сформированными
компилятором MPLAB
C18.

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

Проектами
в MPLAB
IDE
принято называть группу файлов,
необходимых для работы различных
инструментальных средств среды
разработки, например, такими как MPLAB
C18.
Проект состоит из исходных файлов,
написанных на языке Ассемблер или Си,
заголовочных, объектных и библиотечных
файлов и файла сценария линкера. Каждый
проект должен иметь один или больше
исходных файлов и один файл сценария
линкера.

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

Выходные
файлы проекта включают HEX-файл
(файл с расширением *.hex),
который может быть записан в память
микроконтроллера с помощью программатора,
а также используется симулятором MPLAB
SIM
для проверки работы программы на
компьютере. Дополнительные отладочные
файлы с расширениями *.cof
и *.map
используются MPLAB
IDE
для корреляции имен переменных и функций
из исходных файлов с исполняемыми кодами
и областями памяти микроконтроллера.

В
данной лабораторной работе проекты
будут состоять только из одного исходного
файла и файла сценария линкера.

3. Порядок выполнения работы

При
первоначальном ознакомлении с
интегрированной средой разработки
обычно используется метод “Quick
start
– быстрый старт”. Цель его состоит в
том, чтобы, не углубляясь в подробности,
дать новичку первое представление о
программном средстве, дать возможность
быстро получить конкретный результат.

Рассмотрим
основные особенности программы на языке
Си с использованием компилятора MPLAB
C18.
В качестве микроконтроллера выберем
PIC18F242
с тремя портами ввода/вывода, которые
обозначаются: PORTA,
PORTB,
PORTC.
Программа будет просто увеличивать
число на 1 и выводить его в порт В.

/*******************************************

primer1.c
– пример программы на Си для PIC18

****************************************************/

#include<p18f242.h>

#pragma

config
WDT = OFF, OSC = HS

unsigned

char

counter; // переменная
counter – беззнаковое

//
однобайтное

целое
число

void

main(void)

// здесь начинается главная программа

{

unsigned

char

counter; // переменная
counter – беззнаковое

//
однобайтное

целое
число

PORTB
= 0;

//
очистить регистр данных порта В

TRISB
= 0;

// настроить все линии порта В на вывод

counter
= 1;

// инициализировать counter
значением 1

while(
1 )

{

PORTB
= counter;

// поместить значение counter
в порт В

counter
= counter + 1; // увеличить
counter

}

}

Рассмотрим
основные составляющие программы на
языке Си.

Комментарии.
Это некоторый поясняющий текст, который
при компиляции не учитывается. Комментарии
бывают двух видов:

• многострочные
  (начинаются с комбинации символов /*
  и заканчиваются символами */ );

• однострочные
  (начинаются с комбинации символов //
  до конца строки).

Препроцессор.
При транслировании программ на языке
Си текст сначала обрабатывает специальная
программа – препроцессор. Затем
измененный препроцессором текст
обрабатывается компилятором. Препроцессор
обрабатывает так называемые директивы
препроцессора, заменяя их текстом. Любая
директива начинается со знака #. Первой
директивой в рассмотренной программе
является #include<p18f242.h>,
которая вставляет содержимое заголовочного
файла с именем p18f242.h.
В нем содержатся определения и расположение
всех регистров специальных функций
микроконтроллера PIC18F242.
В общем случае файлы с расширением *.h
являются заголовочными файлами
стандартных библиотек языка Си. Вторая
директива в программе #pragma
config определяет биты
конфигурации МК. В данном случае она
отключает сторожевой таймер, чтобы он
не влиял на работу программы (WDT
= OFF), и устанавливает тип
генератора МК — высокочастотный кварцевый
(OSC = HS).

Соседние файлы в предмете [НЕСОРТИРОВАННОЕ]

• #
• #
• #
• #
• #
• #
• #
• #
• #
• #
• #