Начало работы с инструментами разработки STM8 на GNU/Linux

# Arch Linux
$ yaourt -S visual-studio-code-bin

# Ubuntu и Mint Linux
$ wget https://go.microsoft.com/fwlink/?LinkID=760868 -O vscode.deb
$ sudo dpkg -i vscode.deb

$ code

> [SDCC](http://sdcc.sourceforge.net) SourceForge  
> Документация SDCC Мануал [PDF](http://sdcc.sourceforge.net/doc/sdccman.pdf)

### Скачивание библиотеки стандартных периферий STM8 [SPL]

SDCC поддерживает STM8, но по причинам лицензирования (ах, ST!) [Стандартная библиотека периферий (SPL)](https://my.st.com/content/my_st_com/en/products/embedded-software/mcus-embedded-software/stm8-embedded-software/stsw-stm8069.html) отсутствует.

Кто-то разработал патч, который делает SPL совместимой с SDCC, доступен здесь: [SPL_2.2.0_SDCC_patch](https://github.com/gicking/SPL_2.2.0_SDCC_patch).

### Программатор

#### ST-Link![ST-LINK-V2.jpg](assets/img/st-link_v2.png)Программатор ST-Link или его клон, используемый для записи вашего скомпилированного кода (файлы) в микроконтроллер.
Для программатора вам нужен тот, который поддерживает режим SWIM (Single Wire Interface Module). Вы можете (рекомендуется) использовать оригинальный отладочный модуль STMicroelectronics — ST-Link V2 (вы можете приобрести этот вариант б/у за 20$ или меньше). Если вы хотите сэкономить средства, можно купить подделку стоимостью менее 10$ (пожалуйста, обратите внимание, что эти дешевые отладочные модули поддерживают только программный режим, что работает хорошо, но не обеспечивает полной функциональности и скорости оригинальных отладочных модулей ST). Также вы можете самостоятельно собрать открытые источники Stlink Tools.> Обновление прошивки ST-LINK/V2-1 [STSW-LINK007](https://www.st.com/en/development-tools/stsw-link007.html).

> Открытая версия инструментов STMicroelectronics Stlink доступна [здесь](https://github.com/texane/stlink)

> Black Magic Probe, открытый JTAG & SWD ГНУ отладчик и программатор [здесь](https://github.com/blacksphere/blackmagic/wiki).#### STM8FLASH

Это единственная программа, способная общаться через интерфейс SWIM ST-LINK для загрузки скомпилированного кода (прошивки) в микроконтроллер.

> **libusb-1.0-0-dev** необходим для компиляции stm8flash

Установите **stm8flash** из пакета [AUR].

```shell
## Arch Linux 
$ yaourt -S aur/stm8flash-git

## Ubuntu, Mint Linux
## Установка из исходников git репозитория
$ git clone https://github.com/vdudouyt/stm8flash.git
$ cd stm8flash
$ make
$ sudo make install

# STM32 discovery boards, с встроенным st/linkv1
# Например, STM32VL.

SUBSYSTEMS=="usb", ATTRS{idVendor}=="0483", ATTRS{idProduct}=="3744", \
    MODE="660", GROUP="plugdev", TAG+="uaccess", \
    SYMLINK+="stlinkv1_%n"

# STM32 discovery boards, с встроенным st/linkv2
# Например, STM32L, STM32F4.

SUBSYSTEMS=="usb", ATTRS{idVendor}=="0483", ATTRS{idProduct}=="3748", \
    MODE="660", GROUP="plugdev", TAG+="uaccess", \
    SYMLINK+="stlinkv2_%n"

# STM32 nucleo boards, с встроенным st/linkv2-1
# Например, STM32F0, STM32F4.

SUBSYSTEMS=="usb", ATTRS{idVendor}=="0483", ATTRS{idProduct}=="374b", \
    MODE="660", GROUP="plugdev", TAG+="uaccess", \
    SYMLINK+="stlinkv2-1_%n"
``````markdown
# Подсистемы

```shell
SUBSYSTEMS=="usb", ATTRS{idVendor}=="0483", ATTRS{idProduct}=="3752", \
    MODE="660", GROUP="plugdev", TAG+="uaccess", \
    SYMLINK+="stlinkv2-1_%n"

# Подсистемы для устройств ST-Link/V3 (отдельные и встроенные) в режиме USBLoader и стандартном (отладочном) режиме
SUBSYSTEMS=="usb", ATTRS{idVendor}=="0483", ATTRS{idProduct}=="374d", \
    MODE="660", GROUP="plugdev", TAG+="uaccess", \
    SYMLINK+="stlinkv3loader_%n"

SUBSYSTEMS=="usb", ATTRS{idVendor}=="0483", ATTRS{idProduct}=="374e", \
    MODE="660", GROUP="plugdev", TAG+="uaccess", \
    SYMLINK+="stlinkv3_%n"

SUBSYSTEMS=="usb", ATTRS{idVendor}=="0483", ATTRS{idProduct}=="374f", \
    MODE="660", GROUP="plugdev", TAG+="uaccess", \
    SYMLINK+="stlinkv3_%n"

SUBSYSTEMS=="usb", ATTRS{idVendor}=="0483", ATTRS{idProduct}=="3753", \
    MODE="660", GROUP="plugdev", TAG+="uaccess", \
    SYMLINK+="stlinkv3_%n"

$ sudo mv *.rules /etc/udev/rules.d/
$ sudo udevadm control --reload-rules && sudo udevadm trigger

Обычно первым шагом к обучению программированию на микроконтроллере является просто мигание светодиода, как аналог "Привет, мир!" примера, используемого в языках программирования для ПК. На этот раз мы рассмотрим, как начать программировать и разрабатывать на микроконтроллерах серии STM8 компании STMicroelectronics.

На этом этапе вы должны иметь рабочую среду разработки и можете приступить к экспериментам с платой.

[Руководство по STM8S](https://www.st.com/content/ccc/resource/technical/document/reference_manual/9a/1b/85/07/ca/eb/4f/dd/CD00190271.pdf/files/CD00190271.pdf/jcr:content/translations/en.CD00190271.pdf)

##### stm8_blinky.c

```c
#include "stm8l.h"

#define Led_Init GPIO_Init(GPIOD, GPIO_PIN_1, GPIO_MODE_OUT_PP_LOW_FAST)
#define Led_ON   GPIO_WriteHigh(GPIOD, GPIO_PIN_1)
#define Led_OFF  GPIO_WriteLow(GPIOD, GPIO_PIN_1)
#define Led_TOG  GPIO_WriteReverse(GPIOD, GPIO_PIN_1)

void main(void) 
{
   // Инициализация порта светодиода, пина
   Led_Init;

   // Включение светодиода
   Led_ON;

   // Цикл
   while(1){
      // Переключение светодиода вкл/выкл
      Led_TOG;

      // Пауза
      for(uint16_t d = 0; d < 19000; d++) {
         for(uint8_t c = 0; c < 5; c++);
      }
   }
}

$ sdcc -lstm8 -mstm8 --opt-code-size --std-sdcc99 --nogcse --all-callee-saves --debug --verbose --stack-auto --fverbose-asm --float-reent --no-peep -I./ -I./STM8S_StdPeriph_Driver/inc -D STM8S003 ./stm8_blinky.c

$ stm8flash -c stlinkv2 -p stm8s003f3 -u
Определение области OPT
Разблокированное устройство. Опция байты сброшены до состояния по умолчанию.
Записано байт: 11

## Расширенное использование

### Отладчик GDB

![gdb.png](assets/img/gdb.png)
GDB предоставляет широкие возможности для отслеживания и изменения выполнения программ. Пользователь может наблюдать и изменять значения внутренних переменных программы, а также вызывать функции независимо от обычного поведения программы.

#### OpenOCD

Установите **openocd** с **[github.com/sysprogs/openocd](https://github.com/sysprogs/openocd)** для последнего обновления, чтобы использовать устройства **STM8**

```shell
$ git clone git@github.com:sysprogs/openocd.git
или
$ git clone git@github.com:ntfreak/openocd.git
$ cd openocd
$ ./bootstrap
$ ./configure
$ make
$ sudo make install

$ wget https://sourceforge.net/projects/stm8-binutils-gdb/files/stm8-binutils-gdb-sources-2020-03-22.tar.gz/download -O stm8-binutils-gdb-sources-2018-03-04.tar.gz

$ tar -xf stm8-binutils-gdb-sources-2020-03-22.tar.gz
$ cd stm8-binutils-gdb-sources
$ ./patch_binutils.sh
$ ./configure_binutils.sh

```shell
$ cd binutils-2.30
$ make
$ sudo make install

$ sdcc -mstm8 led.c --out-fmt-elf --all-callee-saves --debug --verbose --stack-auto --fverbose-asm --float-reent --no-peep

$ openocd -f interface/stlink.cfg -f target/stm8s105.cfg -c "init" -c "reset halt"

$ stm8-gdb test.elf --tui
start

$ stm8-gdb test.elf --tui
target extended-remote localhost:3333
load
break main
continue

{
    "name": "STM8-gdb",
    "type": "cppdbg",
    "request": "launch",
    "program": "${workspaceRoot}/build/main.elf",
    "args": [],
    "stopAtEntry": true,
    "cwd": "${workspaceRoot}",
    "environment": [],
    "externalConsole": false,
    "MIMode": "gdb",
    "miDebuggerPath": "stm8-gdb",
    "setupCommands": [
        {
            "description": "Подключение к цели",
            "text": "-target-select extended-remote localhost:3333",
            "ignoreFailures": true
        }
    ],
    "logging": {
        "moduleLoad": true,
        "trace": true,
        "engineLogging": true,
        "programOutput": true,
        "exceptions": true
    }
}