Description

This is the main source code repository of the Emflex firmware.

Emflex was designed to provide users with unified framework for building embedded devices. It incorporates RTOS, a set of drivers for different sensors and modules, BSP that abstracts application code from underlying boards.

Application code (called "profiles") is meant to incorporate all the capabilities provided by framework to easily build embedded devices for different areas, like Home automation, Security, IoT, etc. To ease debugging, Emflex provides CLI and logging components.

Prerequisites

Clone or fetch the code repository with all git submodules To clone the code repository recursively (git 1.9+)
```
git clone --recursive https://github.com/emflex/emflex-firmware.git
```
If it is already cloned, manually fetch all the git submodules.
```
git submodule update --init --recursive
```
Install ARM cross compiler toolchain

Building

Set building configuration parameters inside make_target file. You can choose from the following target platforms.

Name	Description
ST_STM32L_DISCOVERY	STM32L Discovery Kit
ST_STM32VL_DISCOVERY	STM32VL Discovery Kit
ST_STM32F3_DISCOVERY	STM32F3 Discovery Kit
stm32f103_mini	Tiny board based on STM32F103 MCU
gtrack	GSM security board

Also you have to choose one of available profiles.

Name	Description
tracking	GSM security device
actuator	Window opening solution
gps_tracker	Security GSM/GPS device
wifi_camera	Monitoring device with WiFi connectivity
ble_prototype	Smartphone controlled BLE device

To proceed please execute "make"

Compatibility matrix

Below table lists target-profile compatibility

	tracking	actuator	wifi_camera	ble_prototype
ST_STM32L_DISCOVERY	x	x
ST_STM32VL_DISCOVERY
ST_STM32F3_DISCOVERY			x
stm32f103_mini				x
gtrack	x

Commiting new changes

Prior to commit new change, ensure existing functionality is not impacted. Run "./build_targets" to verify compilation of all targets and profiles.

Burning

Connect your device to USB port
Just type "make load" to upload firmware

Debugging

Run gdb server

sudo ./tools/stlink/st-util

Run ARM gdb

arm-none-eabi-gdb build/ch.elf
(gdb) tar extended-remote :4242
(gdb) load
(gdb) continue

LICENSE

Unless stated elsewhere, file headers or otherwise, all files herein are licensed under an LGPLv3 license. For more information, please read the LICENSE file.

emflex / emflex-firmware

readme