This repository is at the same time a demonstrator and a template for the STM8 eForth Modular Build feature. implements board support for a simple demo device: board specific setting are entirely in the board support folder (STM8L051F3 in the example) and STM8 eForth dependencies are taken care of by the Makefile.

Building the code can be done manually (on Linux make sure that Python and SDCC are installed) or automatically wuth Travis-CI.

Make a copy or clone of the code in this repository, connect your board to the serial interface and run make on a Linux system with STM8FLASH, SDCC and Python 2.7 (with some chages Python3 can be used).

You can also run make flash to only build the binary and flash it to you board and make term to start an installed e4thcom.

If you want build automation, first create a Travis-CI account, link it to your GitHub account and enable your fork of this repository:

Install the Travis-CI CLI tool and install credentials:

(base) thomas@w500:~/source/stm8s/stm8ef-modular-build$ travis setup releases --force
Username: tg9541
Password for tg9541: *******************
File to Upload: test
Deploy only from TG9541/stm8ef-modular-build? |yes| 
Encrypt API key? |yes| 

Change (back) FILE to Upload from file: test to the following:

  file:
    - "out/stm8ef-bin.zip"
    - "out/stm8ef-bin.tgz"
  skip_cleanup: true

Create and configure a Travis-CI webhook in your repository (my settings are here).

Make the Travis-CI badge point to your accounts:

[![Travis-CI](https://travis-ci.org/TG9541/stm8ef-modular-build.svg)](https://travis-ci.org/TG9541/stm8ef-modular-build)