Программирование МК AVR на языке assembler в среде Linux

Руководствуясь тезисом, что от асма AVR нам никуда не уйти и сидим мы под линуксом, попробуем посмотреть на то, как можно писать и отлаживать программы. Я использую дистрибутив Arch Linux, поэтому в своем повествовании буду опираться на его экосистему.

Сразу скажу, что связку Atmel Studio + wine я предлагать не буду. Не люблю я wine (хоть и пользуюсь по необходимости). Остановимся на нативных средствах, прежде всего компиляторов, обзор которых в сети и личные ковырялки дали выход на триумвират gavrasm, avra и avr-as. Выбор произошел по двум противоречивым критериям: поддержка синтаксиса предлагаемого Atmel и возможность отладки прошивки по шагам в эмуляторе. Последнее для меня более важно, а в плоскости курса @DIHAL так прям вообще необходимо для понимания процесса работы микроконтроллера. Общность синтаксиса с компиляторами от Atmel дает, опять таки с моей точки зрения, лишь возможность без труда адаптировать проекты Atmel Studio к работе в линуксах, что весьма сомнительное преимущество, ибо тот же avr-as существует и под Windows. Предлагаю читателю обзор перечисленной троицы.

gavrasm и avra

Поддерживают синтаксис Atmel. Первый нашелся в AUR и устанавливается командой

$ yaourt -S gavrasm 

Второй так же доступен в AUR

$ yaourt -S avra 

Программа вида

test.S

;---- Определяем целевое устройство         .device atmega16 ;---- Сегмент данных         .dseg ;---- Сегмент кода         .cseg         .org 0x0000          ldi r16, 10 M1:         inc r16         rjmp M1  ;---- Сегмент EEPROM         .eseg 

собирается обоими компиляторами сразу в *.hex и результат работы выглядит примерно одинаково. Чтобы не возмущать благородных донов длинными портянками, помещаю результаты компиляции под спойлеры

$ gavrasm test.S +------------------------------------------------------------+ | gavrasm gerd's AVR assembler Version 3.5 (C)2015 by DG4FAC | +------------------------------------------------------------+ Compiling Source file: test.S ------- Pass:        1 14 lines done.  Pass 1 ok. ------- Pass:        2 14 lines done.   3 words code, 0 words constants, total=3 =  0.0%  No warnings! Compilation completed, no errors. Bye, bye ...  $ ls -l итого 12 -rw-rw----+ 1 maisvendoo users  52 июл 29 15:46 test.hex -rw-rw----+ 1 maisvendoo users 741 июл 29 15:46 test.lst -rw-rw----+ 1 maisvendoo users  92 июл 29 15:46 test.S 

$ avra -l test.lst test.S  AVRA: advanced AVR macro assembler Version 1.3.0 Build 1 (8 May 2010) Copyright (C) 1998-2010. Check out README file for more info     AVRA is an open source assembler for Atmel AVR microcontroller family    It can be used as a replacement of 'AVRASM32.EXE' the original assembler    shipped with AVR Studio. We do not guarantee full compatibility for avra.     AVRA comes with NO WARRANTY, to the extent permitted by law.    You may redistribute copies of avra under the terms    of the GNU General Public License.    For more information about these matters, see the files named COPYING.  Pass 1... Pass 2... done  Used memory blocks:    Code      :  Start = 0x0000, End = 0x0002, Length = 0x0003  Assembly complete with no errors. Segment usage:    Code      :         3 words (6 bytes)    Data      :         0 bytes    EEPROM    :         0 bytes $ ls -l итого 16 -rw-rw----+ 1 maisvendoo users 92 июл 29 15:46 test.S -rw-rw----+ 1 maisvendoo users  0 июл 29 15:55 test.S.cof -rw-rw----+ 1 maisvendoo users 13 июл 29 15:55 test.S.eep.hex -rw-rw----+ 1 maisvendoo users 55 июл 29 15:55 test.S.hex -rw-rw----+ 1 maisvendoo users 61 июл 29 15:55 test.S.obj 

Анализируя результаты можно сказать, что

1. Генерируется файл в формате Intel HEX, пригодный сразу для прошивки в МК
2. Синтаксис совместим с Atmel

Определенно в синтаксисе avra есть отличия, например

        .device atmel16 

дает указание на МК, скрывая от программиста явное указание ссылок на *.inc файл макроопределений. Существует и ряд других нюансов, о которых проще прочесть в документации или в хорошей обзорной статье Valber’а на русском языке. Об особенностях gavrasm можно почитать тут.

Оба рассмотренных компилятора имеют существенный фатальный недостаток — они не генерируют отладочной информации. Хотя в документации по avra такая возможность заявлена

Debugging support AVRA creates a coff file everytime the assembly was sucessful. This file allows AVR Studio or any coff compatible debugger to simulate or emulate the program.

но *.cof файл в выхлопе неизменно оказывается пустым. Отсутствие отладочной информации исключает адекватную отладку по шагам, остро необходимую начинающим. Так что от этих (к слову довольно старых альтернатив) переходим к другому, более могучему компилятору из семейства GNU

avr-as

Установка этого инструментария доступна из официальных репозиториев любого достаточно популярного дистрибутива. В случае с Arch Linux

$ sudo pacman -S avr-gcc avr-libc avr-binutils 

GNU assembler (gas) является бэкэндом к компилятору gcc и обычно явно не вызывается. Связано это с идеологией *nix систем, ориентированных на разработку на C/C++, в которой ассемблеру отводится роль младшего нелюбимого сына. Вместе с тем это обеспечивает глубокую интеграцию ассемблерного кода в программы на C/C++ что, редко, но бывает необходимо. К тому же, если говорить об архитектурах x86/x86_64 синтаксис «гнутого» ассемблера (AT&T) разительно отличается от принятой Intel-нотации (хотя на gas можно использовать и интел-синтаксис, компилятор дает такую возможность). Чего стоит обратный по отношению к интел-нотации порядок операндов в командах, например

Применительно к AVR gas не отходит от нотации Atmel в части оформления команд — порядок операнд здесь привычный, например команда

ldi r16, 10 

в gas для AVR выглядит привычно. Другое дело макросы и директивы компилятора, они отличаются от Atmel. Приведенная выше тестовая программа будет выглядеть так

test.S

#include	"/usr/avr/include/avr/io.h"	  /* Секция данных */ 	.data  /* Секция кода */ 	.section .text  	.org 0x0000  /* Точка входа, обязательная при вызове avr-gcc вместо avr-as */ 	.global main  main:  	ldi r16, 10 M1: 	inc r16 	rjmp M1 

Как видно из исходника секция кода определяется директивой предпроцессора .section .text (аналог .cseg). Аналогом .dseg служит .data. Единственное, чего я пока не понял и не узрел в документации, как определяется содержимое EEPROM (аналог .eseg). Надеюсь среди читателей найдется добрый гуру, который натолкнет меня на ответ. Новичкам же, подобным мне, советую покурить документацию тут и вот здесь для уяснения специфики использования gas для AVR.

Мы же теперь соберем hex-файл, пригодный для прошивки МК. Команда

$ avr-as -mmcu=atmega16 -o test.o test.S

генерирует объектный файл для соответствующего контроллера (в нашем случае ATMega 16). Далее данный объектный файл преобразуется в hex

$ avr-objcopy -O ihex test.o test.hex

Получая на выходе hex-файл вида

test.hex
:060000000AE00395FECFAB
:00000001FF


Тем не менее, мы не ответили на главный вопрос и не обозначили преимущество gas по возможности организации пошаговой отладки. Для этого прежде всего

В линуксах нет достойной альтернативы GDB. Для его использования применительно к МК AVR ставим фронтэнд

$ sudo pacman -S avr-gdb

Данный отладчик обладает всем комплексом противоречий, пугающих новичков: при справедливо заявленной термоядерной мощи порог вхождения его довольно высок. Чтобы разучиться боятся gdb и начать в нем работать очень рекомендую статью величайшего и могучего и, к сожалению, ныне покойного (земля тебе пухом, Мыщъх!) Николая Лихачева aka Крис Касперски «Погружение в технику и философию GDB».

Первое, что нужно для использования gdb — собрать код соответствующим образом, сгенерировав ELF-образ, содержащий отладочные символы

$ avr-as -mmcu=atmega16 -g --gstabs -o test.o test.S

Ключи -g и —gstabs генерируют соответственно отладочные символы и добавляют возможность использовать образ для удаленной отладки в gdb. Компонуем полученный объектный файл в ELF

$ avr-ld -m avr4 -o test.elf test.o

Полученный образ мы используем для отладки нашего теста. Из него же можно сгенерировать и hex-файл

$ avr-objcopy -j .text -j .data -O ihex test.elf test.hex

явно указывая ключем -j включаемые в прошивку секции, ключем -O ihex формат вывода (intel HEX). Получаем тот же файл, что и в предыдущем случае

test.hex
:060000000AE00395FECFAB
:00000001FF


Осталось загрузить полученный код в эмулятор и проверить доступные возможности отладки.

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

$ sudo pacman -S simavr


и более популярный симулятор simulavr, который не был найден даже в AUR, при том что основная масса полезной инфы в сети именно о нем. Собрать из исходников с целью создания PKGBUILD для AUR у меня не вышло, хотя я перебрал все адекватные ветки в официальном репозитории. Пришлось прибить зверский костыль, скачав DEB-пакет для Debian, превратив его в пакет для арча с помощью утилиты debtap

$ debtap simulavr_0.1.2.2-7+b2_amd64.deb

и далее полученный арч-пакет без проблем ставиться в систему.

Версия эта довольно древняя, а текущий релиз (судя по дате последнего коммита в репозитории) ушел довольно далеко.

Что же касается simavr, то он ставится без проблем, поддерживает большее число МК, но на попытки подключения к нему отладчиком выдает в консоль сообщения о крэше эмулятора и разобраться с этим мне пока не удалось. Тут я снова апеллирую к сведующему в вопросе читателю и рассчитываю на подсказку.

Пока же мы используем для отладки костыльно поставленный simulavr

Итак, сначала отладим программу хардкорно — из консоли запустим эмулятор

$ simulavr -d atmega16 -c 8000000 -g -P simulavr-disp

запускаем эмулятор ATMega 16 (ключ -d) на частоте 8 МГц (ключ -с) с опцией удаленной отладки и возможность красивого просмотра регистров контроллера (опция -P, которая по данным из сети в свежайшей версии эмулятора убрана). Видим окошко терминала с содержимым регистров и памяти

наблюдаем в консоли запуска сообщение

Waiting on port 1212 for gdb client to connect...

сообщающее нам о том, что эмулятор ждет подключения отладчика на порту 1212 (порт можно указать при запуске ключем -p). В другой консоли стартуем отладчик

$ avr-gdb -q -tui

первый ключ уберет пафосный выхлоп gdb при запуске, вторая группа ключей активирует просмотр исходников в процессе отладки в применена мной для наглядности (на деле эта опция неудобна по ряду причин). В консоли мы увидим следующее

Подлючаемся к эмулятору

(gdb) target remote:1212

Загружаем ELF-образ в эмулятор (да, именно его а не hex, на чем я обжегся в самом начале) d ‘vekznjh

(gdb) load test.elf

Загружаем отладочные символы
(gdb) file test.elf

ответив «yes» на заданный вопрос, получая следующую картину

Что же, мы видим наш исходник и отладчик, готовый к приему команд. Даем команду next

(gdb) n

и видим как отладчик бодро переместился по коду

можем посмотреть изменившееся состояние регистров контроллера как в консоли эмулятора

так и в окне отладчика

(gdb) info registers
.
.
.
r16 0xa 10
.
.
.
SREG 0x0 0
SP 0x0 0x0