Skip to Content

MPLAB® Harmony v3 Peripheral Libraries on SAM L10: Step 2

Last modified by Microchip on 2023/11/09 09:09

Configure Real-Time Clock (RTC) Peripheral Library

Under the bottom left Device Resources tab, expand Harmony > Peripherals > RTC. Double-click, or drag and drop, RTC to add the RTC Peripheral Library (PLIB) to the project graph.

Harmony > Peripherals > RTC double click

 

In the clock manager, verify the RTC clock is set to run at 1 kHz internal ultra-low-power clock.

When a module is added to the project graph, the MPLAB® Code Configurator (MCC) automatically enables the clock to the module. The default RTC clock source is an internal 1 kHz ultra-low-power clock (OSCULP1K).

rtc clock setup

On the SAM L10 device, the RTC can be clocked through several low power clock sources of 1 kHz and 32 kHz as shown above. The 1 kHz clock source retained (OSCULP1K) is enough to generate time periods of 500 milliseconds, 1 second, 2 seconds, and 4 seconds.

Go back to the project graph and configure the RTC PLIB to generate a compare interrupt every 500 milliseconds.

RTC Configuration Setup

The Compare Value is set as 0x200. This compare value generates an RTC compare interrupt every 500 milliseconds

  • RTC clock = 1024 Hz
  • RTC Prescaler = 1
  • Required Interrupt rate = 500 ms

Hence, Compare Value = (500/1000) x 1024 = 512 (i.e. 0x200).

Back to top

Configure I²C Peripheral Library and I²C Pins

Under the Device Resources tab, expand Harmony > Peripherals > SERCOM. Double-click on SERCOM1 to add the SERCOM instance 1 to the project.

SERCOM selection

Select the SERCOM 1 Peripheral Library and configure it for the I²C protocol.

SERCOM setup

  • ​The SERCOM1 (as I²C) retains the default 100 kHz speed because the temperature sensor chip on I/O1 Xplained Pro Extension Kit can operate at 100 kHz I²C speed.
  • The SERCOM1 (as I²C) retains the default 50-100 nanoseconds hold time for Serial Data (SDA) Hold Time because it aligns with the minimum (50 nanoseconds) start hold time specified in the specification of the temperature sensor chip (AT30TSE758).
  • The SERCOM1 (as I²C) retains the default 100 nanoseconds for I2C Trise time because it aligns with the maximum (300 nanoseconds) input rise time specified in the specification of the temperature sensor chip (AT30TSE758).

Open the Pin Configuration tabs by clicking Project Graph > Plugins > Pin Configuration.

Open Pin Configuration

Select the Plugins Pin Settings tab and sort the entries by Ports names.

SERCOM pins setup

Now, select the Pin Table tab and then scroll down to the SERCOM1 module.

  • Enable I²C Clock (TWI_SCL)(SERCOM_PAD1) on PA17 (Pin #18)
  • Enable I²C Data (TWI_SDA)(SERCOM_PAD0) on PA16 (Pin #17)

Pin Table tab

This completes the configuration of the I²C peripheral library. The application code will use the I²C PLIB Application Programming Interfaces (APIs) to read temperature from the temperature sensor.

Back to top

Configure Universal Synchronous Asynchronous Receiver Transmitter (USART) Peripheral Library and USART Pins

Under the tab Device Resources tab, expand Harmony > Peripheral > SERCOM.

Double-click on SERCOM0 to add the SERCOM instance 0 to the project.

SERCOM selection for UART

Select the SERCOM0 Peripheral Library in the Project Graph, verify default SERCOM Operation Mode configuration is set as 'USART', and configure it as shown below:

UART SERCOM setup

Verify the default baud rate is set to 115200 Hz.

  • ​SERCOM0 (as USART) interrupt is disabled because Direct Memory Access (DMA) will be used (configured in the following steps) to transfer the application buffer to the USART TX register.
  • As per the "SAM L10 Xplained Pro Evaluation Kit" design, SERCOM0 PAD2 is used for SERCOM0 (as USART) data transmission.
  • The application will use the SERCOM0 (as USART) PLIB for printing messages on the serial terminal. Hence, only the transmit functionality is enabled and the receive functionality is disabled.

Select the Pin Table tab and then scroll down to the SERCOM0 module.

Enable USART_TX on PA24 (Pin #23).

uart sercom pins setup

​

In the SERCOM0 (as USART) configuration, USART is enabled for TX functionality and no USART Rx functionality is enabled.

Back to top

Configure DMA Peripheral Library

Launch DMA Configurator by going to the Project Graph tab in MPLAB X IDE and then selecting Plugins > DMA Configuration.

Open DMA configuration

Click on the DMA Settings tab. Configure DMA Channel 0 to transfer the application buffer to the USART TX register. The DMA transfers one byte from the user buffer to USART transmit buffer on each trigger.

Based on the trigger source, the DMA channel configuration is automatically set by MCC.

  • Trigger Action: Action taken by DMA on receiving a trigger.
    • One beat transfer: Generally used during a memory-to-peripheral or peripheral-to-memory transfer.
    • One block transfer: Generally used during the memory-to-memory transfer on a software trigger.
  • Source Address Mode, Destination Address Mode: Select whether to increment Source/Destination Address after every transfer. Automatically set by MCC based on the trigger type. For example:
    • If the trigger source is USART transmit, then the Source Address is incremented, and the Destination Address is fixed.
    • If the trigger source is USART receive, then the Source Address is fixed, and the Destination Address is incremented.
  • Beat Size: Size of one beat. The default value is 8-bits. For example:
    • If the Serial Peripheral Interface (SPI) peripheral is configured for 16-bit/32-bit mode, then the beat size must be set to 16-bits/32-bits respectively.

Click on Add Channel to add DMA channel and configure the DMA channel as shown below.

SERCOM DMA setup​

USART transmit buffer empty event triggers DMA to transfer one byte of data from source (user buffer) to destination (USART Tx register). When all the requested bytes are transmitted, DMA PLIB notifies the application by calling the registered DMA callback event handler.

Back to top