ETL

C++(11/14) Embedded Template Library for AVR 8-bit microcontrollers.

ETL is a header only template library geared towards the size and performance constraints of embedded applications.

###Using ETL in an Atmel Studio project

Create a new C++ project :

'File' -> 'New Project' -> 'GCC C++ Executable Project'
Select your target device

Configure the project to use C++11 : In 'Project' -> 'Project properties' -> 'Toolchain' -> 'AVR/GNU C++ Compiler' -> 'Miscellaneous' add -std=c++11 in the 'Other flags:' field (or add -std=gnu++1y if you need C++14 functionnalities such as std::make_unique).
Add ETL include path in your configuration : In 'Project' -> 'Project properties' -> 'Toolchain' -> 'AVR/GNU C++ Compiler' -> 'General'
- add "C:\your_path\ETL\include" in the 'Default Include Paths:' field.*
- Add "C:\your_path\ETL\libstd\include" unless your toolchain has already a C++ standard library.
  
  *(where your_path is the actual location of the ETL library).
Add #include <etl.h> in your cpp file. You can now use new, delete, new[], delete[] and placement new operators. The free store manager provides you additional functions :

  etl::FreeStore::GetMemorySize()  
  etl::FreeStore::GetMemoryFragmentation()  
  etl::Freestore::GetFreeMemory()

An optional freestore trace log can be activated by defining ETL_FREESTORE_LOG_DEPTH with the requested log depth (3 bytes are used per log so a 64 log depth will consume 192 bytes of SRAM) :

  #define ETL_FREESTORE_LOG_DEPTH 64
  #include <etl.h>

This defines three public variables in :

  uint8_t etl::FreeStore::DebugTracePolicy::log_counter;       // number of logged operations
  Operation etl::FreeStore::DebugTracePolicy::log_operation[]  // logged operation
  void* etl::FreeStore::DebugTracePolicy::log_address[]        // logged address

spacegonzo/ETL

ETL