ASF4 API

1 Advanced Software Framework Version 4 (ASF4) Introduction and Context
This chapter starts with an overview of the features and objectives of ASF4. The context in the larger SW/Tools ecosystem is defined, giving a relation between the ASF4, START, and the IDE. A high-level work-flow overview is presented and documentation resources are described, to give insight into which references to use for what.
2 Software Architecture
3 Driver Implementation and Design Conventions
4 AC Drivers
5 ADC Drivers
6 Analog Glue Function
7 Audio Driver
8 CAN Driver
9 CRC Driver
10 Calendar Drivers
11 Camera Driver
12 Cryptography (AES) Driver
13 DAC Drivers
14 Delay Driver
15 Digital Glue Logic
16 Ethernet MAC Driver
17 Event System Driver
18 External Bus Driver
19 External IRQ Driver
20 Flash Driver
21 Frequency Meter Drivers
22 Graphic LCD Driver
23 Graphics Processing Unit Driver(2D)
24 Hash Algorithm Driver
25 Helper Drivers
26 I2C Drivers
27 I2S Controller Driver
28 MCI Drivers
- 28.1 MCI RTOS Driver
- 28.2 MCI Synchronous Driver
  - 28.2.1 Structs
  - 28.2.2 Functions
    - 28.2.2.1 mci_sync_init
      Initialize MCI low level driver.
    - 28.2.2.2 mci_sync_deinit
      Deinitialize MCI low level driver.
    - 28.2.2.3 mci_sync_select_device
      Select a device and initialize it.
    - 28.2.2.4 mci_sync_deselect_device
      Deselect a device by an assigned slot.
    - 28.2.2.5 mci_sync_get_bus_width
      Get the maximum bus width of a device by a selected slot.
    - 28.2.2.6 mci_sync_is_high_speed_capable
      Get the high-speed capability of the device.
    - 28.2.2.7 mci_sync_send_clock
      Send 74 clock cycles on the line. Note: It is required after card plug and before card install.
    - 28.2.2.8 mci_sync_send_cmd
      Send a command on the selected slot.
    - 28.2.2.9 mci_sync_get_response
      Get 32-bits response of the last command.
    - 28.2.2.10 mci_sync_get_response_128
      Get 128-bits response of the last command.
    - 28.2.2.11 mci_sync_adtc_start
      Send an ADTC command on the selected slot. An ADTC (Addressed Data Transfer Commands) command is used for read/write access.
    - 28.2.2.12 mci_sync_adtc_stop
      Send a command to stop an ADTC command on the selected slot.
    - 28.2.2.13 mci_sync_read_word
      Read a word on the line.
    - 28.2.2.14 mci_sync_write_word
      Write a word on the line.
    - 28.2.2.15 mci_sync_start_read_blocks
      Start a read blocks transfer on the line.
    - 28.2.2.16 mci_sync_start_write_blocks
      Start a write blocks transfer on the line.
    - 28.2.2.17 mci_sync_wait_end_of_read_blocks
      Wait for the end of transfer to be initiated by the mci_start_read_blocks()
    - 28.2.2.18 mci_sync_wait_end_of_write_blocks
      Wait for the end of transfer to be initiated by the mci_start_write_blocks()
    - 28.2.2.19 mci_sync_get_version
      Retrieve the current driver version.
29 PAC Driver
30 PWM Driver
31 Position Decoder Driver
32 Quad SPI Drivers
33 RAND Driver
34 SPI Drivers
35 Segment LCD Drivers
36 Temperature Sensor Drivers
37 Timer Driver
38 USART Drivers
39 USB Drivers
40 Utility Drivers
41 WDT Driver
42 Revision History
The Microchip Web Site
Customer Change Notification Service
Customer Support
Microchip Devices Code Protection Feature
Legal Notice
Trademarks
Quality Management System Certified by DNV
Worldwide Sales and Service

28.2.2.3 mci_sync_select_device

Select a device and initialize it.

int32_t mci_sync_select_device(
    struct mci_sync_desc * mci,
    uint8_t slot,
    uint32_t clock,
    uint8_t bus_width,
    bool high_speed
)

Parameters

slot

Type: uint8_t

Selected slot

clock

Type: uint32_t

Maximum clock to use (Hz)

bus_width

Type: uint8_t

Bus width to use (1, 4, or 8)

high_speed

Type: bool

True, to enable high speed mode

Returns

Type: int32_t

Operation status.

0: Success.
<0: Error code.