Report an Issue

If no solution has been found in the previous section, consider those two options:

The Knowledge Base includes updated solutions for popular issues.

Please provide the relevant information listed at section What Information to Provide When Asking for Help and What Information to Provide When Reporting an Installation Issue .

What Information to Provide When Asking for Help

When asking for help, please specify:

  • Mac OS X release — for example, OS X 10.12.3

  • Mac model and year — for example, MacBook Pro late 2012

  • Xcode release — for example, Xcode 8.2.1

  • embedXcode edition — for example, embedXcode for Wiring / Arduino

  • embedXcode release — for example, 6.1.1

  • Name and release of the makefile — for example, ArduinoAVR_166 release 5.3.7

  • IDE version and variant — for example, Arduino AVR 1.6.17 for Arduino 1.8.1

  • Board used — for example, Arduino Uno revision 3

  • Target — for example, Build

All the information is provided under the Info section on the Report Navigator.

  • Open the Report Navigator by selecting the icon.

  • Look for the Project and Board sections.
==== Info ====
---- Project ----
Target      make 

---- Board ----
Name        AVR_UNO (uno)

Look for the Tools section.
---- Tools ----
MacBook Pro 13" (Late 2012)
Mac OS X 10.12.3 (16D32)
Xcode 8.2.1 (8C1002)
embedXcode for Wiring / Arduino release 6.1.1
Makefile ArduinoAVR_166 release 5.3.7
embedXcode_check version 6.0.1 for embedXcode
embedXcode_prepare version 6.0.4 for embedXcode
Arduino AVR 1.6.17 for Arduino 1.8.1
avr-gcc (GCC) 4.9.2

Should the code be attached,

  • Submit a minimal code after having removed as much as possible everything that's not connected to the issue.

  • Include relevant error messages and screen-copies.

  • Add the full content of the Report Navigator.

The first step is to replicate the issue in order to qualify it. Then the investigation can start.

This feature is reserved to embedXcode+ users.

What Information to Provide When Reporting an Installation Issue

When reporting an installation issue, please specify:

  • Mac OS X or macOS release — for example, OS X 10.9.2

  • Mac model and year — for example, MacBook Pro mid-2012

  • Xcode release — for example, Xcode 6.0

  • embedXcode edition — for example, embedXcode+ for mbed

  • embedXcode release — for example, 212

  • Copy and include the log of the installation process,

  • Launch the Console application,

Locate the embedXcode Installation log under the Files section.

  • Copy and paste the full log in the report.

What Requirements to Meet When Asking Support for a New Board

The modular design and standard tools embedXcode relies on, allow to add support for new boards and programmers. 

There are two requirements for adding a board or a programmer.

  • The board or the programmer is supported by a Processing-based Wiring-derived Arduino-like IDE which works on macOS 10.13 High Sierra.

  • The tool-chain, the SDK and the utilities (like the uploader and the debugger) run natively on macOS 10.13 High Sierra.

Please provide the links to the tools and one sample of the board or the programmer, so I can proceed with the evaluation.

If all those requirements are met, please contact me  to ask support for a new board or programmer.

This feature is reserved to embedXcode+ users.