Home ·

# SAMA5D4 QML Type

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

Import Statement: | import SAMBA.Device.SAMA5D4 3.7
Inherits: | Device
Inherited By: | SAMA5D4EK and SAMA5D4Xplained

- List of all members, including inherited members

## Properties

- config : alias

## Methods

- checkDeviceID()
- commandLineSecureCommand(command, args)
- commandLineSecureCommandHelp(command)
- commandLineSecureCommands()
- initialize()

## Detailed Description

This QML type contains configuration, applets and tools for supporting the SAMA5D4 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 SAMA5D4 device (see SAMA5D4Config 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 SAMA5D4 device (see SAMA5D4Config for configuration information).

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

### NAND Applet

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

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

## Configuration

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

### Preset Board selection

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

Command-Line Name | QML Name | Board Name
--- | --- | ---
sama5d4-ek | SAMA5D4EK | SAMA5D4x-MB
sama5d4-xplained | SAMA5D4Xplained | SAMA5D4 Xplained Ultra

### Custom configuration

Each configuration value can be set individually. Please see SAMA5D4Config 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:

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

## Property Documentation

config : alias

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

See also SAMA5D4Config.

## Method Documentation

checkDeviceID()

Checks that the device is a SAMA5D4.

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

commandLineSecureCommand(command, args)

Handle monitor commands through a SecureConnection

Handle secure commands specific to the secure SAM-BA monitor of SAMA5D4 devices.

commandLineSecureCommandHelp(command)

Show help for monitor commands supported by a SecureConnection

commandLineSecureCommands()

List SAMA5D4 specific commands for its secure SAM-BA monitor

initialize()

Initialize the SAMA5D4 device using the current connection.

This method calls checkDeviceID.