Skip to content

Transition from embedXcode to emCode

This section lists all the changes introduced by emCode compared to embedXcode.

Environment

embedXcode was designed for Apple hardware and software, and used to run on Xcode up to 11 and macOS up to 10.15.

emCode targets the Visual Studio Code IDE and runs on Linux or Windows Linux Sub-system 2 (WSL).

Tests are conducted on Debian 12 and Visual Studio Code 1.81.0.

Main Makefile parameters

Default values for parameters

Default values are now set to the parameters.

If the main Makefile doesn’t define or doesn’t set a value to a parameter, the following default values are used.

The section Build and upload the project lists those parameters and their default values.

New parameters

For building, the new USE_ARCHIVES parameter sets whether existing pre-compiled archives are used first for local libraries.

  • Empty and default value are true to use pre-compiled archives;

  • Uncomment and set to false otherwise to build the libraries.

A serial port can be imposed by SERIAL_PORT over the default from board configuration file.

SERIAL_PORT = /dev/ttyACM1

Deprecated parameters

The parameter KEEP_BOARDS_CONFIGURATIONS is deprecated.

The parameter KEEP_MAIN_CPP for distributing the project is deprecated.

The parameter SELECTED_RESOURCES for preparing the project is deprecated.

The parameter EMBEDXCODE_EDITION is deprecated and replaced by EMCODE_EDITION and set to emCode.

Targets

Deprecated targets

The target Debug is deprecated and replaced by the built-in debugging features of Visual Studio Code.

The target Document is deprecated and replaced by the Doxygen and Doxywizard utilities.

The target Distribution is deprecated.