Harmony v3 Peripheral Libraries on SAMC2x: Step 2

Step 2.1: Configure RTC Peripheral Library

1

Click on the Resource Management [MCC] tab, In the Device Resources, expand Peripherals > RTC.
Double-click or drag and drop RTC to add the RTC peripheral library (PLIB) to the project graph.

rtc_adding.png

2

Verify that the RTC clock is set to run at 1 kHz internal ultra-low power clock.

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

rtc_clock_setup.png

Note: On the SAMC21N device, 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.

3

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

rtc_configuration_setup.png

Note: 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 (0x200).

Step 2.2: Configure I²C Peripheral Library and I²C pins

1

Under the left tab Resource Management (MCC), go to Device Resources and expand Libraries > Harmony > Peripherals > SERCOM.

Double-click on SERCOM5 to add the SERCOM instance 5 to the project.

sercom_selection.png

Select the SERCOM5 peripheral library and configure it for Inter-Integrated Circuit (I²C) protocol as shown.

sercom_setup.png

Note: The SERCOM5 (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.

2

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

open_pin_configuration.png

3

Select the Project Graph > Plugins > Pin Settings tab and sort the entries by Port names as shown below.

sercom_pins_setup_1.png

Now, select the Plugins > Pin Table tab and then scroll down to the SERCOM5 module as shown below.

  • Enable I²C Clock (TWI_SCL) on PB17 (Pin #65)
  • Enable I²C Data (TWI_SDA) on PB16 (Pin #64)
sercom_pins_setup_2.png

Note: This completes the configuration of the I²C peripheral library. The application code will use the I²C PLIB APIs to read temperature from the temperature sensor.

Step 2.3: Configure USART Peripheral Library and USART pins

1

Under the left tab Resource Management (MCC), go to Device Resources and expand Libraries > Harmony > Peripherals > SERCOM.

Double-click on SERCOM4 to add the SERCOM instance 4 to the project.

sercom_selection_for_uart.png

Select the SERCOM4 peripheral library in the Project Graph and configure it for Universal Synchronous Asynchronous Receiver Transmitter (USART) protocol as shown below.

uart_sercom_setup.png

Verify the default baud rate is set to 115200 Hz.

Note: The application will use the SERCOM4 (as USART) PLIB for printing messages on the serial terminal. Hence, only the transmit functionality is enabled and the receive functionality is disabled.

2

Select the Pin Table tab and then scroll down to the SERCOM4 module as shown below.

Enable USART_TX on PB10 (Pin #30).

uart_sercom_pins_setup.png

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

Step 2.4: Configure DMA Peripheral Library

1

From the Project Graph tab, select Plugins > DMA Configuration to launch the DMA Configuration window.

open_dma_configuration.png

2

Click on the DMA Settings tab. Configure DMA Channel 0 to transfer application buffer to the USART TX register. The DMA transfers one byte from 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.
  • Enable Interrupts: In this Tab, SERCOM4 (as USART) Interrupt is enabled.
sercom_dma_setup.png



Next Step >

© 2024 Microchip Technology, Inc.
Notice: ARM and Cortex are the registered trademarks of ARM Limited in the EU and other countries.
Information contained on this site regarding device applications and the like is provided only for your convenience and may be superseded by updates. It is your responsibility to ensure that your application meets with your specifications. MICROCHIP MAKES NO REPRESENTATIONS OR WARRANTIES OF ANY KIND WHETHER EXPRESS OR IMPLIED, WRITTEN OR ORAL, STATUTORY OR OTHERWISE, RELATED TO THE INFORMATION, INCLUDING BUT NOT LIMITED TO ITS CONDITION, QUALITY, PERFORMANCE, MERCHANTABILITY OR FITNESS FOR PURPOSE. Microchip disclaims all liability arising from this information and its use. Use of Microchip devices in life support and/or safety applications is entirely at the buyer's risk, and the buyer agrees to defend, indemnify and hold harmless Microchip from any and all damages, claims, suits, or expenses resulting from such use. No licenses are conveyed, implicitly or otherwise, under any Microchip intellectual property rights.