John Wellbelove a676076d84 Squashed commit of the following:
commit 97a6e6a03557359442123d439cef9bdf6dea2d1b
Author: John Wellbelove <github@wellbelove.co.uk>
Date:   Sun Feb 7 11:02:49 2021 +0000

    Squashed commit of the following:

    commit 04ba91bcccc8e12867962bc3746665f430672a23
    Author: John Wellbelove <github@wellbelove.co.uk>
    Date:   Sat Feb 6 10:43:34 2021 +0000

        Updated shared message unit test

    commit fababc5cf748073464b4294a50c201cb0aa4fa13
    Author: John Wellbelove <github@wellbelove.co.uk>
    Date:   Fri Feb 5 09:41:52 2021 +0000

        Updated FSM generator

    commit ff287bcf0a833ca70933354b42b8b036b422ff81
    Author: John Wellbelove <github@wellbelove.co.uk>
    Date:   Fri Feb 5 09:35:56 2021 +0000

        Updated message router generator

    commit 52724e1e62b55dad81e2f80dd656026d828b3214
    Author: John Wellbelove <github@wellbelove.co.uk>
    Date:   Thu Feb 4 13:06:50 2021 +0000

        Updated unit tests

    commit 0d89105262aa050577ccc17ddc6eece9f4fc5d18
    Author: John Wellbelove <github@wellbelove.co.uk>
    Date:   Tue Feb 2 20:09:35 2021 +0000

        Interim commit

    commit ce8385ff24826103c7a55267ccf3f8a31f517e0b
    Author: John Wellbelove <github@wellbelove.co.uk>
    Date:   Tue Feb 2 18:13:29 2021 +0000

        Squashed commit of the following:

        commit 007b56d03513887636b84fc246e57d6c4f8b777e
        Author: John Wellbelove <github@wellbelove.co.uk>
        Date:   Tue Feb 2 18:09:51 2021 +0000

            Squashed commit of the following:

            commit 6107c4538be149137209d85e5f41031291bc7150
            Author: John Wellbelove <github@wellbelove.co.uk>
            Date:   Tue Feb 2 12:15:31 2021 +0000

                Added move constructor and move assignment to etl::shared_message

            commit c9a5716012db9b614ea67660ebf64dcb790ce571
            Author: John Wellbelove <github@wellbelove.co.uk>
            Date:   Sun Jan 31 12:36:29 2021 +0000

                Squashed commit of the following:

                commit e5f4eb6fb38c337c82fcc250f17a8f21eb788975
                Author: John Wellbelove <github@wellbelove.co.uk>
                Date:   Sun Jan 31 12:34:49 2021 +0000

                    Squashed commit of the following:

                    commit 23c5f1d3f9b13ff9e46ce3de96aefeb655d5ed97
                    Author: John Wellbelove <github@wellbelove.co.uk>
                    Date:   Sun Jan 31 12:32:35 2021 +0000

                        Fixed rollover error for etl::queue_spsc_atomic

                        Added 'required_alignment' parameter to 'allocate' for etl::imemeory_block_allocator.
                        Updated QueuedMessageRouter example

        commit e5f4eb6fb38c337c82fcc250f17a8f21eb788975
        Author: John Wellbelove <github@wellbelove.co.uk>
        Date:   Sun Jan 31 12:34:49 2021 +0000

            Squashed commit of the following:

            commit 23c5f1d3f9b13ff9e46ce3de96aefeb655d5ed97
            Author: John Wellbelove <github@wellbelove.co.uk>
            Date:   Sun Jan 31 12:32:35 2021 +0000

                Fixed rollover error for etl::queue_spsc_atomic

                Added 'required_alignment' parameter to 'allocate' for etl::imemeory_block_allocator.
                Updated QueuedMessageRouter example

    commit c9a5716012db9b614ea67660ebf64dcb790ce571
    Author: John Wellbelove <github@wellbelove.co.uk>
    Date:   Sun Jan 31 12:36:29 2021 +0000

        Squashed commit of the following:

        commit e5f4eb6fb38c337c82fcc250f17a8f21eb788975
        Author: John Wellbelove <github@wellbelove.co.uk>
        Date:   Sun Jan 31 12:34:49 2021 +0000

            Squashed commit of the following:

            commit 23c5f1d3f9b13ff9e46ce3de96aefeb655d5ed97
            Author: John Wellbelove <github@wellbelove.co.uk>
            Date:   Sun Jan 31 12:32:35 2021 +0000

                Fixed rollover error for etl::queue_spsc_atomic

                Added 'required_alignment' parameter to 'allocate' for etl::imemeory_block_allocator.
                Updated QueuedMessageRouter example

commit 007b56d03513887636b84fc246e57d6c4f8b777e
Author: John Wellbelove <github@wellbelove.co.uk>
Date:   Tue Feb 2 18:09:51 2021 +0000

    Squashed commit of the following:

    commit 6107c4538be149137209d85e5f41031291bc7150
    Author: John Wellbelove <github@wellbelove.co.uk>
    Date:   Tue Feb 2 12:15:31 2021 +0000

        Added move constructor and move assignment to etl::shared_message

    commit c9a5716012db9b614ea67660ebf64dcb790ce571
    Author: John Wellbelove <github@wellbelove.co.uk>
    Date:   Sun Jan 31 12:36:29 2021 +0000

        Squashed commit of the following:

        commit e5f4eb6fb38c337c82fcc250f17a8f21eb788975
        Author: John Wellbelove <github@wellbelove.co.uk>
        Date:   Sun Jan 31 12:34:49 2021 +0000

            Squashed commit of the following:

            commit 23c5f1d3f9b13ff9e46ce3de96aefeb655d5ed97
            Author: John Wellbelove <github@wellbelove.co.uk>
            Date:   Sun Jan 31 12:32:35 2021 +0000

                Fixed rollover error for etl::queue_spsc_atomic

                Added 'required_alignment' parameter to 'allocate' for etl::imemeory_block_allocator.
                Updated QueuedMessageRouter example

commit e5f4eb6fb38c337c82fcc250f17a8f21eb788975
Author: John Wellbelove <github@wellbelove.co.uk>
Date:   Sun Jan 31 12:34:49 2021 +0000

    Squashed commit of the following:

    commit 23c5f1d3f9b13ff9e46ce3de96aefeb655d5ed97
    Author: John Wellbelove <github@wellbelove.co.uk>
    Date:   Sun Jan 31 12:32:35 2021 +0000

        Fixed rollover error for etl::queue_spsc_atomic

        Added 'required_alignment' parameter to 'allocate' for etl::imemeory_block_allocator.
        Updated QueuedMessageRouter example
2021-02-07 11:47:21 +00:00
.circleci Resolve 0U ambiguity in string utility tests 2020-08-02 15:14:52 +01:00
.github Make modifying constexpr C++14 only 2020-12-03 18:56:12 +00:00
arduino Merge branch 'master' into development 2021-01-14 09:31:24 +00:00
examples Squashed commit of the following: 2021-01-31 12:36:29 +00:00
images Added etl::ibitset::span() member functions to return a span of the underlying binary data. 2020-07-27 10:52:07 +01:00
include/etl Squashed commit of the following: 2021-02-07 11:47:21 +00:00
support Squashed commit of the following: 2021-02-07 11:47:21 +00:00
temp Updated version numbers 2020-12-01 13:19:44 +00:00
test Squashed commit of the following: 2021-02-07 11:47:21 +00:00
uml UML framework diagrams 2017-08-03 09:53:33 +01:00
.gitattributes Merge branch 'hotfix/issue-303-etl-not-compatible-with-arduino-ide' into development 2020-12-08 13:19:42 +00:00
.gitignore Squashed commit of the following: 2021-01-31 12:36:29 +00:00
.gitlab-ci.yml Trigger CI pipelines on gitlab 2018-11-04 10:10:50 +00:00
.gitmodules Merge remote-tracking branch 'origin/feature/CMake' into development 2018-05-31 22:21:09 +01:00
appveyor.yml Conditionally disable template deduction guide tests 2020-09-29 11:55:21 +01:00
CMakeLists.txt CMakeLists test 2020-09-30 09:53:29 +01:00
conanfile.py Fixed version number retrieval from Github 2020-11-27 18:29:08 +00:00
Doxyfile Updated doxygen file (#131) 2019-06-14 22:41:45 +01:00
file.txt Added etl::buffer_descriptors. 2020-11-12 19:13:10 +00:00
library.json Squashed commit of the following: 2021-02-07 11:47:21 +00:00
library.properties Squashed commit of the following: 2021-02-07 11:47:21 +00:00
LICENSE Merge remote-tracking branch 'origin/master' into development 2018-07-12 21:32:54 +01:00
meson.build Updated version numbers 2020-12-20 17:55:27 +00:00
README.md Update README.md 2020-10-02 18:17:44 +01:00
todo.txt Merge remote-tracking branch 'origin/feature/etl__make_string' into development 2019-12-04 20:55:18 +00:00

Embedded Template Library (ETL)

GitHub release (latest by date) License CI CI CI Codacy Badge

Motivation

C++ is a great language to use for embedded applications and templates are a powerful aspect. The standard library can offer a great deal of well tested functionality, but there are some parts of the standard library that do not fit well with deterministic behaviour and limited resource requirements. These limitations usually preclude the use of dynamically allocated memory and containers with open ended sizes.

What is needed is a template library where the user can declare the size, or maximum size of any object upfront. Most embedded compilers do not currently support the standard beyond C++ 03, therefore excluding the programmer from using the enhanced features of the later library.

This is what the ETL attempts to achieve.

Summary

The ETL is not designed to completely replace the STL, but complement it. Its design objective covers three areas.

  • Create a set of containers where the size or maximum size is determined at compile time. These containers are direct equivalents of those supplied in the STL.
  • Be compatible with C++ 03 but implement as many of the C++ 11 additions as possible.
  • Add other useful components that are not present in the standard library.

The embedded template library has been designed for lower resource embedded applications. It contains a set of containers, algorithms and utilities, some of which emulate parts of the STL. There is no dynamic memory allocation. The library makes no use of the heap. All of the containers have a fixed capacity allowing all memory allocation to be determined at compile time. The library is intended for any compiler that supports C++ 03.

Main features:

  • Cross platform. This library is not specific to any processor type.
  • No dynamic memory allocation
  • No RTTI required
  • Very little use of virtual functions. They are used only when they are absolutely necessary for the required functionality
  • A set of fixed capacity containers. (array, bitset, deque, forward_list, list, queue, stack, vector, map, set, etc.)
  • As the storage for all of the container types is allocated as a contiguous block, they are extremely cache friendly
  • Templated compile time constants
  • Templated design pattern base classes (Visitor, Observer)
  • Reverse engineered C++ 0x11 features (type traits, algorithms, containers etc.)
  • Type-safe enumerations
  • Type-safe typedefs
  • 8, 16, 32 & 64 bit CRC calculations
  • Checksums & hash functions
  • Variants (a type that can store many types in a type-safe interface)
  • Choice of asserts, exceptions, error handler or no checks on errors
  • Many utilities for template support.
  • Easy to read and documented source.
  • Free email support

Any help porting the library to work under different platforms and compilers would be gratefully received. I am especially interested in people who are using Keil, IAR, Green Hills, TI Code Composer etc, bare metal or RTOS, and DSPs.

See (https://www.etlcpp.com) for up-to-date information.