Skip to content

Latest commit

 

History

History
84 lines (59 loc) · 3.02 KB

README.md

File metadata and controls

84 lines (59 loc) · 3.02 KB
Raw

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 gps_tracker 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.