target.LanguageImplementation Class

Namespace: target

Provide C and C++ compiler implementation details

Description

Use the target.LanguageImplementation class to provide implementation details about the C and C++ compiler for your target hardware. For example, byte ordering.

To create a target.LanguageImplementation object, use the target.create function.

Properties

AtomicFloatSize — Largest atomic float size

integer

Size in bits of the largest floating-point data type that you can atomically load and store on the hardware

Attributes:

GetAccess	public
SetAccess	public

Data Types: int32

AtomicIntegerSize — Largest atomic integer size

integer

Size in bits of the largest integer that you can atomically load and store on the hardware

Attributes:

GetAccess	public
SetAccess	public

Data Types: int32

Endianess — Byte ordering

'Little' (default) | 'Big' | 'Unspecified'

Byte ordering implemented by target hardware.

Attributes:

GetAccess	public
SetAccess	public

DataTypes — Data type definitions

target.DataTypes object

Provides C and C++ data type definitions through properties described in this table.

Property Name	Purpose
Char	target.DataTypes.Char object for char.
Short	target.DataTypes.Short object for short.
Int	target.DataTypes.Int object for int.
Long	target.DataTypes.Long object for long.
LongLong	target.DataTypes.LongLong object for longlong.
Half	target.DataTypes.Half object for a half precision data type that the target hardware uses.
Float	target.DataTypes.Float object for float.
Double	target.DataTypes.Double object for double.
Pointer	target.DataTypes.Pointer object for pointer.
SizeT	target.DataTypes.SizeT object for size_t.
PtrDiffT	target.DataTypes.PtrDiffT object for ptrdiff_t.
NonStandardDataTypes	target.FloatingPointDataType (Simulink Coder) object array for target hardware data types that are not specified by C language standards.

Attributes:

GetAccess	public
SetAccess	private

Id — Object identifier

character vector | string

Value of Name property.

Attributes:

GetAccess	public
SetAccess	private

Name — Name

character vector | string

Name of the target language implementation

Attributes:

GetAccess	public
SetAccess	public

WordSize — Native word size

integer

Native word size for the target hardware.

Attributes:

GetAccess	public
SetAccess	public

Data Types: int32

Examples

Specify Hardware Implementation for New Device

This example shows how to register a new hardware device.

Create a target.Processor object for the new hardware device.

myProc = target.create("Processor",Name="MyProcessor", ...
                        Manufacturer="MyManufacturer");

Create a target.LanguageImplementation object for language implementation details.

myLanguageImplementation = target.create("LanguageImplementation", ...
                                          Name="MyProcessorImplementation");

Specify language implementation details.

myLanguageImplementation.Endianess = target.Endianess.Little;

myLanguageImplementation.AtomicIntegerSize = 64;
myLanguageImplementation.AtomicFloatSize = 64;
myLanguageImplementation.WordSize = 64;

myLanguageImplementation.DataTypes.Char.Size = 8;
myLanguageImplementation.DataTypes.Short.Size = 16;
myLanguageImplementation.DataTypes.Int.Size = 32;
myLanguageImplementation.DataTypes.Long.Size = 64;
myLanguageImplementation.DataTypes.LongLong.IsSupported = true;
myLanguageImplementation.DataTypes.LongLong.Size = 64;
myLanguageImplementation.DataTypes.Float.Size = 32;
myLanguageImplementation.DataTypes.Double.Size = 64;

myLanguageImplementation.DataTypes.Pointer.Size = 32;

myLanguageImplementation.DataTypes.SizeT.Size = 64;
myLanguageImplementation.DataTypes.PtrDiffT.Size = 64;

Associate the language implementation with the hardware device.

myProc.LanguageImplementations = myLanguageImplementation;

Add the target.Processor object to an internal database.

objectsAdded = target.add(myProc);

target.add summary:

    Objects added to internal database for current MATLAB session:
        target.LanguageImplementation    "MyProcessorImplementation"
        target.Processor                 "MyManufacturer-MyProcessor"

• If you are using the MATLAB® Coder™: On the Hardware tab, you see the new device. Alternatively, you can now create a coder.Hardware object for this device by using the coder.hardware function.

• If you are using the Simulink® Coder™: On the Hardware Implementation pane, you can now set Device vendor and Device type to MyManufacturer and MyProcessor respectively.

To remove the objects from the internal database, enter:

target.remove(objectsAdded)

target.remove summary:

    Objects removed from internal database:
        target.LanguageImplementation    "MyProcessorImplementation"
        target.Processor                 "MyManufacturer-MyProcessor"

Create Hardware Implementation by Modifying Existing Implementation

If an existing hardware implementation contains most of the values that you want in a new hardware implementation, you can quickly create the new implementation by creating and modifying a copy of the existing implementation.

Create a target.Processor object for the new hardware device.

myProc = target.create("Processor",Name="MyProcessor", ...
                        Manufacturer="MyManufacturer");

Create a target.LanguageImplementation object that copies an existing language implementation.

myCopiedImplementation = target.create("LanguageImplementation", ...
                                      Name="MyCopiedImplementation", ...
                                      Copy="Atmel-AVR");

Specify the required language implementation details. For example, byte ordering.

myCopiedImplementation.Endianess = target.Endianess.Big;

Associate the language implementation with the hardware device.

myProc.LanguageImplementations = myCopiedImplementation;

Add the target.Processor object to an internal database.

objectsAdded = target.add(myProc);

target.add summary:

    Objects added to internal database for current MATLAB session:
        target.LanguageImplementation    "MyCopiedImplementation"
        target.Processor                 "MyManufacturer-MyProcessor"

To remove the objects from the internal database, enter:

target.remove(objectsAdded)

target.remove summary:

    Objects removed from internal database:
        target.LanguageImplementation    "MyCopiedImplementation"
        target.Processor                 "MyManufacturer-MyProcessor"

Create Hardware Implementation by Reusing Existing Implementation

If your hardware device requires the same hardware implementation as an existing implementation, you can reuse the existing implementation.

Create a target.Processor object for the new hardware device.

myProc = target.create( "Processor",Name="MyProcessor", ...
                        Manufacturer="MyManufacturer");

Retrieve the existing implementation by using the identifier for the device vendor and type.

existingImplementation = target.get("LanguageImplementation", ...
                                  "ARM Compatible-ARM Cortex");

Associate the language implementation with the hardware device.

myProc.LanguageImplementations = existingImplementation;

Add the target.Processor object to an internal database.

objectsAdded = target.add(myProc);

target.add summary:

    Objects added to internal database for current MATLAB session:
        target.Processor                 "MyManufacturer-MyProcessor"
    1 object not added because they already exist.

To remove the objects from the internal database, enter:

target.remove(objectsAdded);

target.remove summary:

    Objects removed from internal database:
        target.Processor    "MyManufacturer-MyProcessor"

Version History

Introduced in R2019a