GNU MCU Eclipse

A family of Eclipse CDT extensions and tools for GNU ARM & RISC-V development

The ilg.gnumcueclipse.debug.core.cprojectExtra extension point


This extension point provides decoupled access to the C project extra data from the debug plug-ins.

It must be implemented by distributions that have their own method of storing extra definitions associated with project configurations (like vendor id and device name).


The Eclipse definition of this extension point is in ilg.gnumcueclipse.debug.core/schema/cproject_extra_data.exsd.


The extension point refers to a factory that creates a class that must implement ICProjectExtraDataManager.

The only function required is:

public Map<String, String> getExtraProperties(IConfiguration config);

Where is this extension point used?

The class enumerates all cprojectExtra extension points and returns the first one that can provide data for the requested configuration.

This CProjectExtraDataManagerProxy.getExtraProperties(config) is called from PeripheralsService.etPeripherals(IContainerDMContext containerDMContext, DataRequestMonitor<IPeripheralDMContext[]> drm):

String vendorId = null;
String deviceName = null;

CProjectExtraDataManagerProxy dataManager = CProjectExtraDataManagerProxy
Map<String, String> propertiesMap = dataManager.getExtraProperties(config);
if (propertiesMap != null) {
    vendorId = propertiesMap.get(CProjectPacksStorage.DEVICE_VENDOR_ID);
    deviceName = propertiesMap.get(CProjectPacksStorage.DEVICE_NAME);

if (vendorId != null && deviceName != null) {

    Leaf tree = SvdUtils.getTree(vendorId, deviceName);
    List<Leaf> list = SvdUtils.getPeripherals(tree);

    fPeripheralsDMContexts = createPeripheralsContexts(containerDMContext, list);


} else {

    drm.setStatus(new Status(
        "There are no peripheral descriptions available, assign a device to the project."));

As seen above, this extension point is used to get the and associated with a project, and from it get the SVD to populate the Peripherals view.

Where is this extension point implemented?

This extension point is implemented one in ilg.gnumcueclipse.managedbuild.cross:


The data manager created by this factory is ilg.gnumcueclipse.managedbuild.cross.xpi/ which returns the entire map of extra properties associated with GNU MCU Eclipse projects, stored in .cproject:

<storageModule moduleId="ilg.gnumcueclipse.managedbuild.packs">
    <option id="" value="STM32F407VG"/>
    <option id="" value="STM32F407"/>
    <option id="" value="STM32F4 Series"/>
    <option id="" value="STMicroelectronics"/>
    <option id="" value="13"/>
    <option id="cmsis.device.pack.vendor" value="Keil"/>
    <option id="" value="STM32F4xx_DFP"/>
    <option id="cmsis.device.pack.version" value="2.3.0"/>
    <option id="" value="STM32F4-Discovery"/>
    <option id="cmsis.board.revision" value="Rev.C.1"/>
    <option id="" value="STMicroelectronics"/>
    <option id="cmsis.board.clock" value="8000000"/>
    <option id="cmsis.board.pack.vendor" value="Keil"/>
    <option id="" value="STM32F4xx_DFP"/>
    <option id="cmsis.board.pack.version" value="2.3.0"/>
    <option id="" value="Cortex-M4"/>
    <option id="cmsis.compiler.define" value="STM32F407xx"/>
    <memory section="IRAM1" size="0x20000" start="0x20000000" startup="0"/>
    <memory section="IRAM2" size="0x10000" start="0x10000000" startup="0"/>
    <memory section="IROM1" size="0x100000" start="0x08000000" startup="1"/>