|
1 | | -# Arduino_Core_STM8 |
2 | | -STM8 core support for Arduino |
| 1 | +# Arduino core support for STM8 based boards |
| 2 | +[](https://github.com/stm32duino/Arduino_Core_STM8/releases/latest) |
| 3 | + |
| 4 | +* [Introduction](https://github.com/stm32duino/Arduino_Core_STM8#Introduction)<br> |
| 5 | +* [Getting Started](https://github.com/stm32duino/Arduino_Core_STM8#getting-started)<br> |
| 6 | +* [Boards available](https://github.com/stm32duino/Arduino_Core_STM8#boards-available)<br> |
| 7 | +* [Troubleshooting](https://github.com/stm32duino/Arduino_Core_STM8#troubleshooting)<br> |
| 8 | +* [Wiki](https://github.com/stm32duino/wiki/wiki/) |
| 9 | + |
| 10 | +## Introduction |
| 11 | + |
| 12 | +This repo adds the support of STM8 architecture in Arduino IDE.<br> |
| 13 | + |
| 14 | +This porting is based on several external components : |
| 15 | +* STMicroelectronics Standard Peripheral Libraries (SPL) |
| 16 | + * [SPL for STM8L](https://www.st.com/en/embedded-software/stsw-stm8016.html) |
| 17 | + * [SPL for STM8S](https://www.st.com/en/embedded-software/stsw-stm8069.html) |
| 18 | +* Cosmic compiler, allowing to compile c++ source code on stm8 family (http://www.cosmic-software.com/) |
| 19 | + |
| 20 | +For now, the solution is running on Windows only. |
| 21 | + |
| 22 | +## Getting Started |
| 23 | + |
| 24 | +This repo is available as a package usable with [Arduino Boards Manager](https://www.arduino.cc/en/guide/cores). |
| 25 | + |
| 26 | +Use this link in the "*Additional Boards Managers URLs*" field: |
| 27 | + |
| 28 | +https://github.com/stm32duino/BoardManagerFiles/raw/master/STM8/package_stm8_index.json |
| 29 | + |
| 30 | +For full instructions on using the "**Boards Manager**", see the [Getting Started](https://github.com/stm32duino/wiki/wiki/Getting-Started) page. |
| 31 | + |
| 32 | +For advanced user, you can use the repository: see the [Using git repository](https://github.com/stm32duino/wiki/wiki/Using-git-repository) page. |
| 33 | + |
| 34 | +## Boards available |
| 35 | + * STM8L |
| 36 | + * [Nucleo STM8L152R8](https://www.st.com/en/evaluation-tools/nucleo-8l152r8.html) |
| 37 | + |
| 38 | + * STM8S |
| 39 | + * [Nucleo STM8S208RB](https://www.st.com/en/evaluation-tools/nucleo-8s208rb.html) |
| 40 | + |
| 41 | + |
| 42 | +## Troubleshooting and known issues |
| 43 | + |
| 44 | +Please note that this is a new core using a new compiler. You may face some issues with libraries compatibility.<br> |
| 45 | +We have several known issues : |
| 46 | + * Windows 10: |
| 47 | + *Board binary may be corrupted when plugged on a Windows 10 machine. |
| 48 | + To ensure compatibility with Windows 10, please upgrade STLink with revision 2.32.22 or higher (estimated availability October 1st).* |
| 49 | + * Endianness: |
| 50 | + *STM8 microcontrollers are natively Big Endian whereas Arduino boards and STM32 microcontrollers are Little Endian. |
| 51 | + By default, some libraries don't handle endianess, therefore these won't be directly compatible with STM8 (this is the case of SD library for example).* |
| 52 | + |
| 53 | +If you have any issue, you could [file an issue on Github](https://github.com/stm32duino/Arduino_Core_STM8/issues/new). |
| 54 | + |
| 55 | +If you have a question about compiler, you can also send a mail to Cosmic support : [send a mail to Cosmic support](mailto:support@cosmic.fr) |
3 | 56 |
|
0 commit comments