Как создать новый проект.

1. Выбор папки проекта. Создайте на диске папку для своего проекта. Важное примечание! MPLAB не поддерживает корректно длинные и русские имена папок, то есть имя должно состоять из латинских букв и не более 8. Тоже самое относится и к названию проекта и к именам исходных файлов. В противном случае MPLAB откажется файлы редактировать и будет жаловаться, что не может их открыть при ассемблировании.
2.  Создание исходного файла для проекта.  В папке \template\code где установлен MPLAB находятся файлы-заготовки для проектов на ассемблере. Можно, конечно, создать пустой файл с расширением .asm для проекта, но проще взять готовый. Если Вы уже выбрали тип микроконтроллера для своего проекта, то скопируйте соответствующий файл в папку своего проекта и переименуйте во что-то типа: prog.asm (<my project>.asm).
3. Выбор языка инструментальной среды. Выберите Project>Install Language Tool из меню. Выберите Language Suite: Microchip и Tool Name: MPASM. Если не указан путь к файлу ассемблера mpasmwin.exe, укажите. Затем установите опцию Windowed и нажмите OK.
4. Создание файла проекта. В MPLAB выберите Project>New Project, укажите путь к Вашей папке и введите имя файла проекта, желательно такое же, как и имя основного исходного файла файла. Возможно указание нескольких папок через точку с запятой, для примера, таким образом: c:\mplab\projects\mpproj\include;c:\include\h;..\sys. Нажмите OK.
5. Установка конфигурации. После перечисленных действий откроется окно редактирования проекта. Для простоты не будем добавлять дополнительные файлы, файлы библиотек и компоновки. Нажмите кнопку Change.. в пункте Development Mode. Откроется окно с вкладками для установки. В дальнейшем это окно можно будет вызвать, выбрав Options>Development Mode. Остановимся подробнее:
   - Tools. Выберите инструментальную среду. Скорее всего у Вас нет дополнительного оборудования, поэтому придется довольствоваться симулятором MPLAB-SIM (установите признак) и выберите тип микроконтроллера.
   - Clock. Выберите тип генератора тактовых импульсов (кварцевый резонатор, внутренний или внешний RC-генератор, внешняя частота и т. д.) и его частоту.
   - Configuration. Конфигурация сторожевого таймера и памяти программ. Если Вы разрешаете использование сторожевого таймера, то задайте и коэффициент деления предделителя. А для микроконтроллеров 17-й серии необходимо указать какая память программ будет использоваться: внутренняя (microcontroller), внешняя (microprocessor) или обе (extended microcontroller).
   - Pins. Разрешите или запретите использование вывода внешнего сброса (MCLR).
   - Break option. Конфигурация прерываний и стека при отладке (лучше пока оставить по умолчанию).
   Нажимаете OK.
6. Конфигурация выходного файла. Щелкните, чтобы подсветить на файле <my project>[.hex]. При этом станет доступно меню Node Properties. В ранних версиях MPLAB без вызова окна конфигурации выходного файла нельзя было добавить в проект свой исходный файл. Можно попробовать изменить конфигурацию, а можно оставить по умолчанию.
7. Добавление исходного файла. Чтобы добавить свой исходный файл на ассемблере, который Вы скопировали и переименовали в папке своего проекта нажмите на кнопке Add Node. В открывшемся окне выберите свой файл и нажмите OK. После этого нажмите OK в окне редактирования проекта. Если нажмете Cancel, то проект записан не будет! В дальнейшем это окно всегда можно будет вызвать через Project>Edit Project..
8. Открытие исходного файла. Теперь можете открыть свой исходный файл для редактирования: File>Open.. 

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

В начало

Компилирование

После завершения процесса будет вызвано окно с генерированной коммандной строкой, перечнем предупреждений или ошибок (если есть) и результатом компиляции: были ли ошибки (build failed) или нет (build successful ). Помощь при исправлении ошибок может оказать файл-листинг, вызвать который можно из меню таким образом: Window>Absolute Listing.

 В начало

Запуск и отладка проекта

Для инициализации системы выберите Debug>Run>Reset. При этом программный счетчик (PC)будет сброшен на нулевой адрес 0x00. В файле источника указатель (темная панель - dark bar) установится на команду, соответствующую нулевой ячейки памяти. Сброс происходит автоматически и после перекомпилирования проекта. 

MPLAB-SIM можно использовать для отладки программы при отсутствии внутрисхемного эмулятора. Это накладывает некоторые ограничения:
- невозможность отладки программы с реальными входными сигналами на выводах микроконтроллера.
- невозможность запускать выполнение программы в реальном времени. Скорость выполнения зависит от многих факторов: количества открытых окон и запущенных приложений, скорости самого компьютера и других. Замечу, что для ускорения прохода при отладке подпрограмм различных задержек, можно воспользоваться директивой IFDEF.
Зато к положительным сторонам можно отнести практически никакую стоимость данного инструмента в отличии от нескольких тысяч долларов за эмулятор.

Чтобы запустить отлаживаемую программу в пошаговом режиме (одна команда за одно нажатие) можете выбрать в меню Debug>Run>Step или нажать <F7> или кнопку   на панели инструментов. При этом текущая команда будет выполнена, программный счетчик увеличится и указатель установится на следующую инструкцию (если, конечно, не было команд ветвления, перехода или модификации PC). Кнопка тоже выполняет программу в пошаговом режиме, только подпрограммы будут выполняться за одно нажатие (в непрерывном режиме).

Для запуска программы  в непрерывном режиме выберите Debug>Run>Run или нажмите <F9> или кнопку на панели инструментов. Программа будет выполняться до тех пор, пока Вы не прервете работу, выбрав в меню Debug>Run>Halt или нажав <F5> или кнопку или произойдет останов в заранее установленной точке прерывания (breakpoint). 

 В начало