Удобное использование libmaple в Eclipse CDT

Библиотека libmaple для работы с stm32 уже упоминалась здесь. Для начинающих осваивать stm32 она представляет собой значительно более высокоуровневую, простую и понятную альтернативу CMSIS+SPL.

Входит она в состав Maple IDE от leaflabs, который является подобием среды ардуино. И если в IDE всё делается классическими скетчами, то сама libmaple, доступна отдельно от IDE и позволяет писать под stm32 на С/С++. Это и есть её основное назначение, на сайте присутствует соответствующая документация. Используются для этого внешние arm-none-eabi тулчейны, хотя наверняка можно изверуться и использовать входящий в состав IDE тулчейн на базе Code Sourcery G++.

Полученый бинарник заливается через USB bootloader, который тоже доступен в исходных кодах. Собственно-говоря, у них всё доступно в исходных кодах. Использование бутлоадера необязательно. Можно спокойно заливать через st-link, смещая базовый адрес на 0x5000 от начала flash, для сохранения бутлоадера. После сброса он передаст управление вашему коду. Но использовать бутлоадер вполне удобно, в libmaple есть всё необходимое для этого.

Надо сказать, что саму библиотеку libmaple предлагается использовать достаточно забавным способом — каждый раз делать свой проект на основе копии сорцов библиотеки. Буквально — скачиваем (git clone) её сорцы, переименовываем каталог и хакаем её, превращая в собственный проект. В ней уже содержистя своя билд-система на make с обильным использованием фрагментов мэйкфайлов.

Понятное дело, когда такой проект всего один (два-три максимум) — это нестрашно. Но по мере роста количества проектов (с учётом лёгкости её использования), кол-во бардака во вселенной начинает расти… Каждый раз, когда выходят апдейты к библиотеке на github (мы же не против получить фиксы и улучшения), нам необходимо смержить их с каждым своим проектом. А если мы сами что-то поправили в библиотеке, нам точно так же необходимо ручками разнести это во все проекты. Это неудобно. И потому…

И потому, в один прекрасный момент, сотрудник leaflabs Marti Bolivar решил сделать мир чуточку лучше. И выпустил свой проект example-libmaple-project, который является шаблоном пустого проекта, использующего библиотеку libmaple, лежащую в стороне, в количестве одного экземпляра. В ней больше вообще ненадо ничего менять.

Wow! Скажем мы :) Мир заиграл новыми красками! И будем почти правы… Почти — потому что не бывает всегда всё хорошо, что-то должно быть обязательно не так :) И оно не так — проект использовал shell-скрипт в качестве обёртки вокруг make. Что плохо укладывалось в концепцию Makefile project with existing sources в Eclipse CDT.

Когда меня это стало огорчать совсем сильно, я пошёл и отослал автору фикс, который он любезно включил в проект с моими дополнениями в README на тему удобного использования этого счастья в Eclipse CDT. Теперь там красота — никаких хаков с шелл-скриптами, честный Makefile и полная любовь с Eclipse.

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

Заодно была пофикшена сама libmaple — теперь она умеет работать с Summon/Linaro GCC.

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

Стоит упомянуть ещё один недостаток libmaple — она не только альтернативна CMSIS, но и не опирается на него в своей реализации. Это приводит к определённым усилиям по портированию её на более свежие/продвинутые камни и к достаточно чувствительным задержкам в её развитии. Если не ошибаюсь, были одна-две попытки переписать её поверх CMSIS, но особого успеха они не принесли.

Краткий перевод-компиляция необходимых шагов:

1. Устанавливаем тулчейн и прописываем его в PATH, я поставил Summon ARM GCC в ~/sat/
   
2. Устанавливаем Eclipse CDT (у меня 3.7, всё дальнейшее в соотв. с этой версией).
   
3. Открываем окно терминала и делаем:
   

   cd ~/my-some-work-dir
   git clone https://github.com/leaflabs/libmaple
   git clone https://github.com/mbolivar/example-libmaple-project
   git clone https://github.com/leaflabs/maple-bootloader
   

   
   
4. Копируем пустой main.cpp из корня example-libmaple-project в корень libmaple.
   
5. Идём в Makefile проекта example-libmaple-project и задаём значения следующих переменных:
   
   • BOARD — тип платы. Посмотреть список совместимых можно с помощью make list-boards.
   • MEMORY_TARGET — способ установки бинарника: flash, ram или jtag. Подробности смотрим в make help и документации libmaple.
6. Можно прописать глобально переменную окружения LIB_MAPLE_HOME, указывающую на корень libmaple, но можно этого и не делать, если мы будем использовать разные версии для разных проектов. Если вы собираетесь работать из командной строки без Eclipse, то можно ничего больше не делать. Единственное, что LIB_MAPLE_HOME тогда стоит всё же задать — либо через переменную окружения, либо в Makefile.
   
7. Запускаем Eclipse CDT и создаём/открываем workspace.
   
8. Для каждого из трёх проектов делаем: File -> New -> Project… -> Makefile Project with Existing Code и указываем на нужный проект.
   
9. Правый клик на проект example-libmaple-project, идём в Properties -> C/C++ Build -> Behaviour tab и меняем дефолтный target all на sketch
   
10. Если мы не задали переменную окружения LIB_MAPLE_HOME глобально, мы можем задать её для конкретного проекта: Properties -> C/C++ Build -> Environment.
    
11. Наконец, если мы вообще нигде не определили LIB_MAPLE_HOME, можно прописать её значение явно в Makefile проекта example-libmaple-project.
    
12. Идём в Properties -> C/C++ General -> Indexer и включаем чекбоксы: 'Enable project specific settings', 'Index unused headers as C files' и 'Index unused headers as C++ files'.
    
13. Теперь идём в Properties -> C/C++ General -> Paths and Symbols и добавляем следующие пути на вкладке Includes (можно прописать абсолютные пути, но удобнее всё же пользоваться переменной LIB_MAPLE_HOME, которую мы задали ранее). При задании каждого пути стоит включить чекбоксы, отвечающие за создание пути для каждого языка и конфигурации. Необходимые пути (не перепутайте тип скобок):
    

    ${LIB_MAPLE_HOME}/wirish/include
    ${LIB_MAPLE_HOME}/libmaple/include
    ${LIB_MAPLE_HOME}/wirish/boards/<directory with your board name>/include
    ${LIB_MAPLE_HOME}/libmaple/<directory with your cpu family code>/include
    

    
    Пример моих путей для проца и платы:
    

    ${LIB_MAPLE_HOME}/wirish/boards/maple_RET6/include
    ${LIB_MAPLE_HOME}/libmaple/stm32f1/include
    

    
    
14. На забудьте сохранить настройки кнопкой Apply или OK.
    
15. Теперь можно делать проекту clean и build.
    

Вопросы и исправления приветствуются!