etl/docs/getting-started/compilers.md
John Wellbelove 4a88884b39
Issue/add hugo support for documentation (#1449)
* Add ranges

* Initial Hugo setup

* Work in progress

* Added selection for local or remote site

* Updated to 'light' theme

* Changed to using Hextra Hugo theme

* Changed to using Hextra Hugo theme

* Changed to Hextra Hugo theme

* Change to Hextra Hugo theme

* Updated Hugo setup.

* Updated Hugo setup.

# Conflicts:
#	docs/releases/_index.md

* Work in progress

* Added new fonts

Added new documentation

* Latest documentation updates

* Latest documentation updates

# Conflicts:
#	docs/containers/array.md
#	docs/containers/array_view.md
#	docs/containers/array_wrapper.md
#	docs/containers/bip_buffer_spsc_atomic.md
#	docs/containers/bitset.md
#	docs/containers/indirect_vector.md
#	docs/containers/vector.md
#	docs/getting-started/compilers.md

* Added bloom_filter markdown doc

* Added more documentation

Updated CSS for light and dark modes

* Fixed some menus

Added mode documentation files

* Updated CSS rules

Added badges to home page
Added uniqur_ptr + pool tutorial

* Fixed formatting on the home page markdown

Modified light amd dark code formatting

* Updated unique_ptr-with-pool

* Added container and shared message tutorials

* Updates to documentation

* Added const_multimap

* Updated source-formatting.md

* Added initial raw text files form Web site editor

* Innore coverage build directory

* Exported raw text documentation files from the web site editor

* Hugo updates

* Added Hugo intalation and markdown descriptions

* More addition to the documentation

* Added closure.md and updates to delegate.md

* Added format.md

* Added documentation for etl::delegate_observable, etl::function, Base64 codec

* Added io_port documentation

* Added basic_format_spec

* Added documentation for string_stream and string utilities.

* Added more documentation

Updated the documentation CSS

* Added documentation for clocks, day, duration

* Added more documentation for chrono classes

Updated callouts

* More chrono documentation

* Completed chrono documentation

* Maths functions documentation

* Completed maths documentation

* Completed maths documentation

* Completed maths documentation

* Completed maths documentation

* Added multiple documentation files

* Added iterator.md

* Added debug_count.md and versions.md

* Added debug_count.md and versions.md

* Added more documentation

* More documentation

* Added some design pattern documentation

Modified some of the layout files
Modified the About documentation

* Converted more documentation pages

Modified the site CSS

* Added more documentation

Moced some documentation files to new directories

* Added more documentation

Tweaks to CSS

* Added callback_timer_deferred_locked documentation

* Added callback_timer_locked documentation

* More documentation updates

* More documentation updates

* More documentation updates

* New documentation files.

Harmonised file name format

* New documentation files.

* Multiple document updates

* Multiple document updates

* Final conversion of web pages

* Updates before PR

* Updates before PR

* Updates before PR

# Conflicts:
#	docs/blog/_index.md

* Final pre PR updates

* Updates to message framework documentation

* Renamed directory

* Fix spelling

* Added author and date to blog files

Moved documentation files merged from development

* Fixed 'Description' typo

* Fix typos

# Conflicts:
#	docs/IO/io_port.md
#	docs/containers/sets/const-multiset.md
#	docs/containers/sets/const-set.md
#	docs/maths/correlation.md
#	docs/maths/gamma.md

* Renamed two files to lower case

* Minor renaming

* Added author and date

* Updated callout on bresenham_line.md

Added support for showing the ETL version on the documentation first page, by copying the version.txt file as a hugo asset.
Updated the Python 'update_release.py' to copy 'version.txt'

* Replace space in filename with hyphen.

Added more information to hugo-commands.md

* Replace space in filename with hyphen.

Added more information to hugo-commands.md

# Conflicts:
#	docs/getting-started/view-the-docs-locally/hugo-commands.md

* Added a link to pseudo_moving_average.md

* Updated title pages for groups

* Fixed missing 404 for non-existent pages

* Fixed coordinate variable names in the 'Calculating the intersection' example

---------

Co-authored-by: Roland Reichwein <Roland.Reichwein@bmw.de>
Co-authored-by: John Wellbelove <john.wellbelove@etlcpp.com>
Co-authored-by: John Wellbelove <john.wellbelove@etlcpp.co.uk>
2026-06-06 13:12:44 +01:00

3.7 KiB

title weight
Compilers 3

The library is intended to be used on multiple platforms and devices. Not every single combination ofcompiler/IDE/device/library template have been, or can realistically be, checked. A set of profiles have been created for the most popular setups. If you have issues porting the library to your platform then contact me, and I will do my best to resolve anyincompatibilities. If you have no issues, or have solved it by yourself then please let me know so that I may add information about it to this page.

Visual Studio

Has been compiled under VS2019 and VS2022.
No known issues.

GCC

Has been compiled under GNU GCC on Windows & Linux.
No known issues, apart from early versions of GCC that may need to define the macro __STDC_LIMIT_MACROS in the project properties.

Keil

uVision ARM
Define the macro __STDC_LIMIT_MACROS in the project properties.
Compiled with version 5 & 6 ARM compilers.
No known issues.

TI Code Composer

MPS430
Define the macro __STDC_LIMIT_MACROS in the project properties. In TI projects you have the choice between EABI and COFF file formats. There is a known issue with the COFF format when creating static libraries that use templates. You may find that the linker will complain about 'undefined symbols'.
The only known workaround is to declare a dummy type in the main application that uses the template with the same parameter types.

e.g. If your static library uses etl::vector<MyType, N> then declare a dummy type etl::vector of the same type in the application.

IAR Embedded Workbench

AVR Compiler
ARM

Define the macro __STDC_LIMIT_MACROS in the project properties.No known issues.

Segger Embedded Studio

ARM
If using STLPort then the macro ETL_STLPORT must be defined in the profile.

Greenhills

ARM
No known issues.

Zephyr OS

The ETL uses 'placement new'. To enable this from Zephyr you need to add the following to proj.conf.
CONFIG_LIB_CPLUSPLUS=yCONFIG_NEWLIB_LIBC=y

avr-gcc 9.2

If you are using -std=c++2a you will find the compiler complaining aboutredeclaration of C++ built-in type char8_t [-fpermissive] Add this to your etl_profile.h or define it in the project properties.
#define ETL_NO_SMALL_CHAR_SUPPORT 0
You may also want to define #define ETL_CPP20_SUPPORTED 0

Arduino

Arduino IDE
Visual Studio with Visual Micro extension
The Arduino programming platform is not supplied with an implementation of the STL. The ETL can use of somefeatures of the STL to compile, and therefore either one must be acquired or the project is compiled with ETL_NO_STL defined. A suitable STL implementation may be downloaded from the Arduino library resource; It is called ArduinoSTL.

Add #include <ArduinoSTL.h> to the start of every file that uses the ETL. Remember to add the directory to the include path.

The alternative option is to compile with ETL_NO_STL defined, if the STL is not used in your project. Partially tested for Zero, Uno, Yún, Mega, Industrial 101 and Leonardo boards using test_embedded_compile.cpp

Issues

Zero
Arduino101
TinyTile
<algorithm> must be edited to move the template function iter_swap before the declaration of swap_ranges.The template class variant will not currently compile unless the header file is either renamed or the include path somehow altered, as the platform also defines a header named variant.h.

Duo
Fails to find ArduinoSTL.h even though it is present. If ArduinoSTL.h is removed, then fails with printf has not been declared.

General
It may be necessary to add the following lines to the beginning of the file.

#undef min
#undef max