Hello-World example for theCore embedded C++ framework

This example shows simple console output demo.

Detailed description

See theCore documentation for Hello World example for more information.

Supported targets (boards)

Target name	Configuration file	Description
host	host.json	Host target build
stm32f4_disc	stm32f4_discovery.json	STM32F4 discovery board
tiva_tm4c_launchpad	tiva_tm4c_launchpad.json	TM4C123G LaunchPad Evaluation Kit

Wiring

• If you have Tiva TM4C Launchpad - simply connect it to the USB.

• If you have STM32F4 Discovery board:

  1. Attach any preferable UART-to-USB converter module (such as this) according to following pinout:

     PD8 (USART3 TX)	module's RX
     PD9 (USART3 RX)	module's TX
     GND	module's GND

  2. Connect your STM32 Discovery board to the PC.

Preparing

1. Install and initialize theCore (if not done previously):

   pip3 install tcore
   tcore bootstrap
   

2. Download the example:

   tcore init --remote https://github.com/theCore-embedded/example_hello_world
   

3. Step into the project directory:

   cd example_hello_world
   

Building

• For STM32 Discovery board:

  tcore compile --target stm32f4_disc
  

• For Tiva TM4C LaunchPad:

  tcore compile --target tiva_tm4c_launchpad
  

• For host:

  tcore compile --target host
  

Running

1. If you wish to run the example on the embedded device, launch minicom with device associated with USB <-> UART converter. (/dev/ttyUSB0 here used as an example):

   # From new terminal
   tcore runenv "minicom -D /dev/ttyUSB0"
   

   Or the same, but with superuser permissions:

   # From new terminal
   tcore runenv --sudo "minicom -D /dev/ttyUSB0"
   

2. Run:

   • On TivaC launchpad:

     tcore flash --sudo
     

   • For old STM32F407G-DISC boards, with STLINK/V2:

     tcore flash --sudo
     

   • For new STM32F407G-DISC1 boards, with STLINK/V2.1:

     tcore flash --sudo --debugger-config stlink-v2.1
     

   • For host target, execute:

     ./build/host/hello_world
     

Expected output

Observe console output (either in current shell if running on host, or using

minicom if running on the embedded device):

Welcome to theCore
the_core v0.3.0.307 9ff344b-dirty
Hello World!

Starting delay demonstration...

[--] Waiting for 2 seconds
[--] Done waiting 2 seconds

[----] Waiting for 4 seconds
[----] Done waiting 4 seconds

[--------] Waiting for 8 seconds
[--------] Done waiting 8 seconds