Home ·

# SAMA5D3 QML Type

Contains chip-specific information about SAMA5D3 device. More...

Import Statement: | import SAMBA.Device.SAMA5D3 3.2
Inherits: | Device
Inherited By: | SAMA5D3EK and SAMA5D3Xplained

- List of all members, including inherited members

## Properties

- config : alias

## Methods

- checkDeviceID()
- initialize()

## Detailed Description

This QML type contains configuration, applets and tools for supporting the SAMA5D3 device.

## Applets

SAM-BA uses small programs called "Applets" to initialize the device or flash external memories. Please see SAMBA::Applet for more information on the applet mechanism.

### Low-Level Applet

This applet is in charge of configuring the device clocks.

The only supported command is "init".

### External RAM Applet

This applet is in charge of configuring the external RAM.

The Low-Level applet must have been initialized first.

The only supported command is "init".

Note: The external RAM is not needed for correct operation of the other applets. It is only provided as a way to upload and run user programs from external RAM.

### SDMMC Applet

This applet is used to read/write SD/MMC and e.MMC devices. It supports all HSMCI peripherals present on the SAMA5D3 device (see SAMA5D3Config for configuration information).

Supported commands are "init", "read" and "write".

### SerialFlash Applet

This applet is used to flash AT25 serial flash memories. It supports all SPI peripherals present on the SAMA5D3 device (see SAMA5D3Config for configuration information).

Supported commands are "init", "read", "write" and "blockErase".

### NAND Applet

This applet is used to flash NAND memories (see SAMA5D2Config for configuration information).

Supported commands are "init", "read", "write" and "blockErase".

## Configuration

When creating an instance of the SAMA5D3 type, some configuration can be supplied. The configuration parameters are then used during applet initialization where relevant.

### Board selection

A set of pre-configured values can be selected by instanciating sub-classes of SAMA5D3. The following preset boards are available:

Command-Line Name | QML Name | Board Name
--- | --- | ---
sama5d3-ek | SAMA5D3EK | SAMA5D3x-MB
sama5d3-xplained | SAMA5D3Xplained | SAMA5D3 Xplained

### Custom configuration

Each configuration value can be set individually. Please see SAMA5D3Config for details on the configuration values.

For example, the following QML snipplet configures a device using SPI1 on I/O set 2 and Chip Select 3 at 33Mhz:

    SAMA5D3 {
            config {
                    serialflash {
                            instance: 1
                            ioset: 1
                            chipSelect: 3
                            freq: 33
                    }
            }
    }

## Property Documentation

config : alias

The device configuration used by applets (peripherals, I/O sets, etc.)

See also SAMA5D3Config.

## Method Documentation

checkDeviceID()

Checks that the device is a SAMA5D3.

Reads CHIPID_CIDR register using the current connection and display a warning if its value does not match the expected value for SAMA5D3.

initialize()

Initialize the SAMA5D3 device using the current connection.

This method calls checkDeviceID.