Skip to content

Latest commit

 

History

History
118 lines (77 loc) · 4.04 KB

README.md

File metadata and controls

118 lines (77 loc) · 4.04 KB
Raw

Sduino: Small Devices Arduino

Getting started on the STM8 the easy way.

An Arduino-like programming API that can be used from within the Arduino IDE or for Makefile-controlled builds.

  • Project website for more information on supported hardware and the programming API

  • github issue tracker for bug reports and other issues tightly related to the repository content

  • The STM8 board of the stm32duino forum: For general discussions and suggestions

Since this project is based on the SDCC Small Devices C compiler, I called it "Small Devices -uino" or "Small-duino". It is entirely based on free tools that are available for Linux, MacOS, and Windows: SDCC, make, and stm8flash.

This project is not supposed to be “better than Arduino”. It’s purpose is to give you a head start into a different CPU architecture if you happen to have a professional need or a private desire for it.

Installation

Starting with version 0.3.0 automatic IDE integration is supported via the Arduino Boards Manager. This is the recommanded way of installation now. For a manual non-IDE installation please check the manual installation instructions.

Start the Arduino-IDE. In File->Preferences, Settings tab, enter

https://github.com/tenbaht/sduino/raw/master/package_sduino_stm8_index.json

as an Additional Boards Manager URL.

  • Open Tools->Board:...->Boards Manager
  • Find Sduino by typing 'sd' into the search line
  • Click on the list entry
  • Click on Install.

Now you should find a new entry STM8S Boards in the list at Tools->Board:...

  • Choose STM8S103F3 Breakout Board from the list
  • open the standard Blink example from File->Examples->01. Basics->Blink
  • compile it by hitting Verify

Known issues

The Arduino IDE Version 1.8.7 suffers from a known regression bug. If you see the error message "select upload port first" apply this workaround.

Included libraries

Most parts of the Arduino core system and some Arduino libraries are already ported to C-syntax. The resulting API is still very close to the C++ version and porting an existing application is not hard. Check out the migration guide for details.

Communication

  • SPI: Real hardware-SPI up to 10MHz.
  • I2C: Port of the I2C master library by Wayne Truchsess
  • HardwareSerial: The standard serial interface.

Displays

  • LiquidCrystal: HD44780 based text LCDs
  • PCD8544: Monochrome graphical LCD based on the PCD8544 controller like the Nokia 5110 display. SPI mode only.
  • Mini_SSD1306: SSD1306-based monochrome OLED displays with 128x64 pixels. I2C support only.

Motor control

  • Stepper: Stepper motors with 2, 4 or 5 phases.
  • Servo: Up to 12 servos using only 1 timer.

Compatibility with the Arduino world

Since there is no free C++ for the STM8, it is impossible to do a full 1:1 port of the whole enviroment as is has been done for the STM32 and the ESP8266.

This is not a drop-in replacement for an AVR, but thanks to some C preprocessor magic the programming API is still very, very similar and it is often enough to just move over the opening bracket of the class instanciation statement and to replace the dot in a method call for an underscore. Check the migration guide for an overview.

Supported Systems:

Arduino IDE versions 1.8.7, 1.8.5 and 1.6.13 are tested, but any version >=1.6.6 should work.

Version 1.8.7 might require a workaround if you see an error message "select upload port first".

  • Linux 64 bit: Tested on Ubuntu 16.04
  • Linux 32 bit: Tested on Ubuntu 16.04
  • Windows: Tested on Windows 7. Sduino might work on XP (not tested), but the ST-Link/V2 driver is not available anymore for XP.
  • MacOS: tested on 10.13.