Skip to main content

Тулчейн для STM8 под линукс на базе SDCC

Установка

SDCC

Есть соблазн установить из репозитория:

1
$ sudo yum install sdcc

но, поскольку там довольно старая версия (для такой новой для sdcc архитектуры, как stm8), то рекомендую ставить последний снапшот отсюда: находим нужную нам архитектуру i386 или AMD64 и качаем предскомлиленный архив бинарников:

1
2
3
4
5
6
wget http://freefr.dl.sourceforge.net/project/sdcc/snapshot_builds/amd64-unknown-linux2.5/sdcc-snapshot-amd64-unknown-linux2.5-20151028-9381.tar.bz2
tar xjf sdcc-snapshot-amd64-unknown-linux2.5-20151015-9358.tar.bz2                                                                      
cd sdcc
sudo cp -a * /usr
cd ..
rm -rf sdcc sdcc-snapshot-amd64-unknown-linux2.5-20151015-9358.tar.bz2

 Проверить корректную установку можно командой: 

1
sdcc -v

hex2bin

 Аналогично устанавливаем последнюю версию hex2bin, которой получаем бинарь, который в свою очередь будем кормить программатору:

1
2
3
4
5
6
7
8
wget http://heanet.dl.sourceforge.net/project/hex2bin/hex2bin/Hex2bin-2.1.tar.bz2
tar xjf Hex2bin-2.1.tar.bz2                                                    
cd Hex2bin-2.1        
make clean
CFLAGS='-Wall -Wextra -std=c99' make
sudo make install
cd ..
rm -rf Hex2bin-2.1.tar.bz2 Hex2bin-2.1

stm8flash

Есть такой замечательный программатор stm8flash, который позволяет зашивать STM8 через стандартный st-link (или его китайские клоны) по интерфейсу SWIM; скачиваем и устанавливаем:

1
2
3
4
5
6
git clone https://github.com/vdudouyt/stm8flash.git
cd stm8flash
make
sudo make install
cd ..
rm -rf stm8flash

 Дополнительно хорошо бы установить рулы для возможности работы с st-link из под обычного юзера, для чего заимствуем готовые файлы из опенсорсного проекта st-link’а для STM32: 

1
2
3
4
sudo wget https://raw.githubusercontent.com/texane/stlink/master/49-stlinkv1.rules -O /etc/udev/rules.d/49-stlinkv1.rules
sudo wget https://raw.githubusercontent.com/texane/stlink/master/49-stlinkv2.rules -O /etc/udev/rules.d/49-stlinkv2.rules
sudo wget https://raw.githubusercontent.com/texane/stlink/master/49-stlinkv2-1.rules -O /etc/udev/rules.d/49-stlinkv2-1.rules
sudo udevadm control --reload-rules

Альтернативные инструменты

Справедливости ради, отмечу существование stm8flasher — утилиты, которой можно шить по UART старшие STM8, имеющие встроенный загрузчик, но в силу того, что не работаю с «жирными» STM8 эту утилиту не пробовал.

Также, начиная с весны 2016г, стал подностью бесплатным французский компилятор Cosmic, к сожалению, версия для линукса хоть и существует, но недоступна свободно и поставляется на отдельных условиях (с демоном лицензий flex lm).

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

Пример

Компиляция проекта из одного файла-исходника:

1
sdcc -lstm8 -mstm8 -opt-code-size --out-fmt-ihx $(CFLAGS) $(LDFLAGS) project.c

Конвертация в bin:

1
hex2bin -p 75 project.ihx

Зашивка:

1
stm8flash -cstlinkv2 -pstm8s103 -s flash -w project.bin

Разбор примера

sdcc

 Основные опции sdcc, которые скорее всего потребуется использовать:

  •  -c для компилирования в объектник (типичный проект с несколькими исходными файлами,  линковка будет запущена отдельной командой)
  • —std-c99 для компиляции согласно стандарта C99 (в действительности, C99-фичи поддержаны только частично, но на моих исходниках необходимо указывать эту опцию, инача sdcc вылетает с ошибкой)
  • —opt-code-size для оптимизации выходного байт-кода по размеру

 hex2bin

  • -p [value] — значение (в hex), которым будут заполняться пустые ячейки (0х75 — недопустимый опкод для архитектуры stm8, его выполнение приводит к переходу в процедуру reset)
  • -s [address] — также есть опциональная возможность задания стартового адреса  (в hex, фактически — смещение)

stm8flash

Общий формат команды:

1
stm8flash -c <stlink|stlinkv2> -p <partname> [-s flash|eeprom|0x8000] [-r|-w|-v] <filename>

Note!: В последней версии появилась поддержка формата hex и возможность программирования OptionBytes.

 

Читать далее

Автовставка истории изменений в техническую документацию на AsciiDoc

Задача

При написании технической документации является хорошим тоном включать секцию с историей изменений (т.н. Revision History). Как правило, сама документация также хранится в гите и имеет свою историю изменений, поэтому грех этим не воспользоваться, чтобы автоматизировать процесс.

Решение

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

Примем, что для истории ревизий нам необходима следующая информация:

  • дата изменения
  • имя автора изменения
  • суть изменения

Для формирования таблицы с историей ревизий используем замечательную команду git log:

1
2
3
4
5
6
7
8
9
10
11
$ git log --max-count=10 --no-merges --date=short --pretty=format:"| %ad | %an | %s"
| 2017-04-05 | Dmitry Murzinov | [ipxact2verilog] minor changes
| 2017-04-04 | Dmitry Murzinov | minor changes
| 2017-04-04 | Dmitry Murzinov | First scatch for verilog CSR generator
| 2017-04-03 | Dmitry Murzinov | Was added Make to build translate files (*.mo) for gettext
| 2017-04-03 | Dmitry Murzinov | Was added multilingual support to AsciiDoc Register Overview table
| 2017-04-03 | Dmitry Murzinov | First try to multilingual support
| 2017-04-03 | Dmitry Murzinov | an AsciiDoc Register Overview table now data width independent
| 2017-04-03 | Dmitry Murzinov | Was added dimension of fields for Regs Overview table
| 2017-04-03 | Dmitry Murzinov | Ability to generate an AsciiDoc Register Overview table
| 2017-04-03 | Dmitry Murzinov | Was added an example config file

— как видим на выходе отличная заготовка для asciidoc-таблицы.

Подробнее об опциях команды:

  • —max-count= — указываем желаемое число последних коммитов
  • —branches= — если интересуют только конкретные ветки (например release/production), указываем тут
  • —tags= — аналогично с тегами, можно задавать паттерн типа rev*.*, v?.?.? и т.п.
  • —no-merges — не выводить в лог слияния веток

У меня установлен гит довольно старый (v1.8), в новых версиях появилась кудо более гибкая кастомизация даты. Тонкую настойку на славянский формат даты «19.2.2015» в новом гите можно осуществить следующей командой:

1
git log -n 10 --date=format:'%d.%m.%Y' --pretty=format:"| %cd | %cn | %s" 

Также в зависимости от того хранится ли документация отдельно либо является частью репозитария СФ-блока будет различаться git log, возмодно потребуется указывать конкретный исходник документа или группу исходников, например:

1
git log -n 10 --pretty=format:"| %ad | %an | %s"  doc/src/IP-core.adoc

или: 

1
git log -n 10 --pretty=format:"| %ad | %an | %s"  doc/src/*.adoc

Итоговый скрипт

Получившийся скрипт выглядит следующим образом:

1
2
3
4
5
6
7
#!/bin/bash
echo ".Revision History" > $1
echo "[cols=\"^2s,^8,^26\",options=\"header\"]" >> $1
echo "|===================================================" >> $1
echo "| Date | Author | Comments" >> $1
git log --max-count=10 --date=short --pretty=format:"| %ad | %an | %s" doc/src/*.adoc >> $1
echo "|===================================================" >> $1

Вызов скрипта: 

1
./generate-revision-history.sh revhist.adoc

В сборочном .adoc-файле включаем сгенерированный файл в соответствующую секцию: 

1
2
3
4
5
[abstract]
== История изменений документа / Revision Changes
 
include::revhist.adoc[leveloffset=+1]
<<<<

Также будет полезно добавить revhist.adoc в .gitignore (как файл, генерируемый автоматически); и в мейкфайл — как зависимость при сборке конечного PDF.

 

 

Читать далее

asciidoctor-pdf: asciidoc для самых маленьких

Для тех кто хотел попробовать подход единого источника при написании технической документации, но кого смущала монстроузность настройки AsciiDoctor‘a (все эти DocBook, xslt, fopub и прочие прелести) есть альтернатива, которая позволит пощупать все прелести аскидока с легким стартом.

Преимущества документации в asciidoc

Для тех, кто забыл или не в теме, напомню основные пункты:

  • Текстовый формат мета-языка разметки (тут же такие wiki-форматы как Markdown, reStructuredText, DokuWiki, etc)
  • Контроль изменений (версионирование в отличие от бинарных форматов документов, позволяющее делать простой diff между ревизиями
  • WYSIWIG-превью в лайв-режиме
  • Возможность накрутки своего корпиративного стиля при генерации различных выходных форматов: pdf, epub,mobi, fb2, html

asciidoctor-pdf

Основное отличие от AsciiDoctor’a  — использование вместо апачевского FO-процессора FOP (java) движка Prawn (Ruby). Также используется значительно облегченная (по сравнению с AsciiDoctor) система конфигов на основе микроразметки YAML.

Установка

Несмотря на то, что asciidoctor-pdf требует наличия ruby >= 2.0.0, по факту его можно установить без ошибок и эксплуатировать лишь на более свежих версиях, к несчастью в CentOS7 установлена 2.0.0:

1
2
$ ruby --version
ruby 2.0.0p598 (2014-11-13) [x86_64-linux]

Чтож, методом проб, ошибок и гугленья устанавливаем 2.3.1:

1
2
3
4
5
6
7
8
curl -sSL https://rvm.io/mpapis.asc | sudo gpg --import -
curl -L get.rvm.io | sudo bash -s stable
source /etc/profile.d/rvm.sh
rvm reload
rvm requirements run
rvm install 2.3.1
rvm use 2.3.1 --default
ruby --version

Ставим зависимости для asciidoctor-pdf:

1
2
3
4
5
6
7
8
9
10
$ gem install prawn --version 1.3.0
$ gem install addressable --version 2.4.0
$ gem install prawn-svg --version 0.21.0
$ gem install prawn-templates --version 0.0.3
$ gem install prawn-table --version 0.2.2
$ gem install prawn-icon --version 1.3.0
$ gem install treetop
$ gem install thread_safe
$ gem install safe_yaml
$ gem install asciidoctor

Ставим сам asciidoctor-pdf:

1
$ gem install asciidoctor-pdf --pre

либо последнюю версию в разработке:

1
2
git clone --depth=1 https://github.com/asciidoctor/asciidoctor-pdf
cd asciidoctor-pdf/bin

Опционально, для подсветки синтаксиса можно доустановить один из движков на выбор (рекомендуют Rouge как предпочтительный):

1
2
3
$ gem install rouge
$ gem install pygments.rb
$ gem install coderay

Настройка

Конфиг можно иметь по-проектно, либо вынести основные настройки в глобальный конфиг (в нём полезно например хранить настройки шрифтов):

1
gems/asciidoctor-pdf-v.v.v/data/themes/default-theme.yml

Примеры конфигов для оформления, которые можно использовать как базу  для оформления собственных стилей:

Тестовый запуск примера из репозитория asciidoctor-pdf:

1
asciidoctor-pdf -a pdf-style=../data/themes/base-theme.yml ../examples/basic-example.adoc

Кириллизация

Шрифты

Из-за подхода к набору символов в шрифтах по умолчанию на кириллических документах вылезает неприятное сообщение:

1
The following text could not be fully converted to the Windows-1252 character set: ...

И кирилические символы не отображаются в выходном документе. Эту проблему можно решить, если подключить внешние шрифты, для этого надо сделать две вещи:

  1. Прописать в конфиг-файле соответствие шрифта и файла, в котором он содержится
  2. При вызове asciidoctor-pdf указать путь к папке, в которой хранятся шрифты (к сожалению, на текущий момент можно передать только один путь)

В конфиге пишем что-то вроде:

1
2
3
4
5
6
7
8
9
10
11
12
font:
  catalog:
    Consolas:
      normal: consola.ttf
      bold:   consolab.ttf
      italic: consolai.ttf
      bold_italic: consolaz.ttf
    Verdana:
      normal: verdana.ttf
      bold:   verdanab.ttf
      italic: verdanai.ttf
      bold_italic: verdanaz.ttf

Далее указываем где будут использоваться в документе эти шрифты:

1
2
3
4
5
base_font_family: Verdana
...
literal_font_family: Consolas
...
code_font_family: Consolas

Теперь вызываем с указанием, в которой хранятся шрифты (в RHEL/CentOS это, например, /usr/share/fonts):

1
asciidoctor-pdf -a pdf-style=theme.yml -a pdf-fontsdir=/usr/share/fonts/msttcore example.adoc

Метазаголовки

Для корректной локализации различных служебных маркеров, в самом файле документа adoc в самом начале переопределяем переменные (на свой корпоративный вкус):

1
2
3
4
:listing-caption: Код
:chapter-label: Глава
:toc-title: Оглавление
:version-label: Версия

Дополнительные утилиты

Также в комплекте идёт шелл-скрипт optimize-pdf, который использует Ghostscript для сжатия и минификации выходного pdf.

1
$ ./optimize-pdf basic-example.pdf

В системе должен быть установлен Ghostscript >= 9.10, поэтому Cent OS7  в пролете:

1
2
$ gs -v
GPL Ghostscript 9.07 (2013-02-14)

 

Ссылки по теме

Читать далее

Работа с IP-XACT на примере Kactus2 в CentOS7

Сборка и установка

Устанавливаем зависимости:

1
sudo yum install -y  qt-devel qt5-qttools-devel qt5-qhelpgenerator

Скачиваем и собираем:

1
2
3
4
5
6
7
8
9
10
$ wget https://netcologne.dl.sourceforge.net/project/kactus2/kactus2-3.4.0.tar.gz
$ tar xzf kactus2-3.4.0.tar.gz
$ cd kactus2-3.4.0
$ ./configure
Configuring Kactus2...
 
Generating compressed help files...
./configure: line 21: qhelpgenerator: command not found
./configure: line 22: qcollectiongenerator: command not found
Qmake not found. Please set variable QTBIN_PATH to Qt binary files.

(далее…)

Читать далее

[Clock Solution] Формирователи тактовых сигналов

В этой заметке буду  собирать информацию о решениях для формирования и менеджмента тактовых сигналов (преимущественно для ПЛИС), добытые из схемотехнических решений (открытых и не очень) разнообразных отладок на FPGA.

ФАПЧи, «менеджеры» и разветвители

  •  SI5342/SI5344/SI5345 — $20/$20/$30, ФАПЧ с ультранизким джиттером, 2/4/10 диф.выходами и четырьмя входами, управляемая по I2C, диапазон выходных частот: от 100 Гц до 1028 МГц
  • SI5338A — $15, ФАПЧ с низким джиттером, четырьмя диф.выходами и двумя входами, управляемая по I2C, диапазон выходных частот: 0.16..710 МГц
  • SI5351B — $2.5, ФАПЧ и независимый ГУН (управляемый с наружной ножки),  восемь выходов, управление по I2C, диапазон выходных частот: 2,5 кГц..200 МГц
  • SI5351A — $1, две ФАПЧ, от 3х до 8ми выходов, управление по I2C, диапазон выходных частот: 2,5 кГц..200 МГц

 

 Источники тактового сигнала

  • SiT8208A — $1.5, MEMS-генератор с перестраиваемой выходной частотой в пределах 1..80 МГц и стабильностью до ±20ppm, доступные размеры: от 2*2.5мм до 5*7мм

Читать далее

Начало работы с ATMEL SAM V71 в CLI

Установка arm-none-eabi-gcc

Ставим по привычке в /opt:

1
2
3
wget https://launchpad.net/gcc-arm-embedded/4.9/4.9-2015-q3-update/+download/gcc-arm-none-eabi-4_9-2015q3-20150921-linux.tar.bz2
tar xjf gcc-arm-none-eabi-4_9-2015q3-20150921-linux.tar.bz2
sudo mv gcc-arm-none-eabi-4_9-2015q3 /opt

Настроечный файл тулчейна /opt/arm-2015q3.setup:

1
2
3
4
GCC_ARM=/opt/gcc-arm-none-eabi-4_9-2015q3
export GCC_ARM
PATH="${GCC_ARM}/bin:$PATH"
export PATH

(далее…)

Читать далее

[PoM] Power-on-Module: питание мощных FPGA-потребителей на PCB

Задача

  1. Подбор All-in-One компактных DC/DC-преобразователей для обеспечения всех нужных питаний для нежирных ПЛИС. В большинстве из них сделан упор на компактность и минимальное вмешатесльтво в управление работой со стороны системы
  2. Подбор мощных DC/DC-преобразователей на несколько (десятков) ампер для запитки жирных ПЛИС и/или процессоров. Большинство из них проектировались специально для использования с сильножружими ПЛИС

 

Компакт класс (All-in-One)

Linear Technology

  • LTC3569 — отлично подойдёт для какого-нибудь середнячка типа Spartan-6: три DC/DC (1.2A и 2×600мA), высокая частота преобразования (до 3МГц —  можно индуктивности покомпактнее), входной диапазон: 2.5..5.5V (хочешь от USB питай, хочешь от LiIon)

(далее…)

Читать далее