coder.hardware

Create hardware board configuration object for C/C++ code generation from MATLAB code

Description

The coder.hardware function creates a coder.Hardware object that contains hardware board parameters for C/C++ code generation from MATLAB^® code.

To use a coder.Hardware object for code generation, assign it to the Hardware property of a coder.CodeConfig or coder.EmbeddedCodeConfig object that you pass to codegen. Assigning a coder.Hardware object to the Hardware property customizes the associated coder.HardwareImplementation object and other configuration parameters for the particular hardware board.

Note

The code generator enables you to extend the range of supported hardware by using the target.create and target.add functions to register new devices. After you register a new device, you can create a coder.Hardware object for this new device as well.

Creation

Syntax

coder.hardware(boardname)

coder.hardware()

Description

coder.hardware(boardname) creates a coder.Hardware object for the specified hardware board. The board must be supported by an installed support package. To see a list of available boards, call coder.hardware without input parameters.

coder.hardware() returns a cell array of names of boards supported by installed support packages.

Input Arguments

boardname — hardware board name

character vector | string scalar

Hardware board name, specified as a character vector or a string scalar.

Example: 'Raspberry Pi'

Example: "Raspberry Pi"

Properties

Name — Name of hardware board

character vector | string scalar

Name of hardware board, specified as a character vector or a string scalar. The coder.hardware function sets this property using the boardname argument.

CPUClockRate — Clock rate of hardware board

100 (default) | double scalar

Clock rate of hardware board, specified as a double scalar.

Examples

Generate Code for a Supported Hardware Board

Configure code generation for a Raspberry Pi board and generate code for a function foo.

hwlist = coder.hardware();
if ismember('Raspberry Pi',hwlist)
    hw = coder.hardware('Raspberry Pi');
    cfg = coder.config('lib');
    cfg.Hardware = hw;
    codegen foo -config cfg -report
end

Check Supported Hardware Boards

Before creating a coder.Hardware object for a hardware board, check that the board is supported by an installed support package.

List all boards for which a support package is installed.

hwlist = coder.hardware()

Test for an installed support package for a particular board.

hwlist = coder.hardware();
if ismember('Raspberry Pi',hwlist)
    hw = coder.hardware('Raspberry Pi');
end

Tips

• In addition to the Name and CPUClockRate properties, a coder.Hardware object has dynamic properties specific to the hardware board.

• To configure code generation parameters for processor-in-the-loop (PIL) execution on a supported hardware board, use coder.hardware. See PIL Execution with ARM Cortex-A at the Command Line and PIL Execution with ARM Cortex-A by Using the MATLAB Coder App. PIL execution requires Embedded Coder^®.

Version History

Introduced in R2015b