Low Power Application on SAM L21 Using MPLAB® Harmony v3 Peripheral Libraries: Step 2


< Back to Lab Start


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_box.png

2

Verify that the RTC clock is set to run at 1 kHz using the 1 kHz Ultra Low Power Internal Oscillator (OSCULP1K).

rtc_clock_configuration.png

Note:

  • 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 OSCULP1K.
  • On the SAM L21 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 is enough to generate periods of 500 milliseconds.

3

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

rtc_configuration_options.png

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

  • $RTC_ {\rm prescaler} = 1$
  • $F_{\rm GCLK-RTC} = 1024 Hz$
  • $F_{\rm RTC-CNT} = F_{\rm GCLK-RTC} = 1024 Hz$
  • $T_{\rm interrupt-period} = 500 * 10^{-3} s$
(1)
\begin{align} Compare Value = T_{\rm interrupt-period} * F_{\rm RTC-CNT} = 500 * 10^{-3} * 1024 = 512 (0x200) \end{align}

Step 2.2: Configure I²C Peripheral Library, I²C Pins, and Verify I²C Clock

Configure I²C Peripheral

1

Click on the Resource Management [MCC] tab, In the Device Resources, expand Peripherals > SERCOM.
Double-click on SERCOM2 or drag and drop to add the SERCOM instance 2 to the project.

sercom_2_box.png

2

Select the SERCOM 2 peripheral library and configure it for I²C protocol:

sercom_2_configuration_options.png

Configure I²C Pins

1

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

pin_settings_tool.png

2

Once the MCC Pin Settings window is opened, find the Order drop-down list, and select Pins to sort the entries by port names.

sercom_pins_setup_1.png

3

Now, select the MCC Pin Table tab and then scroll down to the SERCOM2 module as shown:

  • Enable I²C data (I2C_SDA) on PA08 (pin #17)
  • Enable I²C clock (I2C_SCL) on PA09 (pin #18)
pin_table_sercom2_configuration.png

4

Go back to the Pin Settings table and customize the PA08 and PA09 pins names as listed:

  • Pin ID: PA08
    • Custom Name: I2C_SDA
  • Pin ID: PA09
    • Custom Name: I2C_SCL
sercom_2_pin_settings.png

Verify I²C Clock

1

Open the Clock Configuration tab by clicking Project Graph > Plugins > Clock Configuration.

clock_configuration.png

2

Open the Peripheral Clock Configuration tab by clicking on the button in the Peripheral Clock Selection.

peripheral_clock_settings.png

3

Once the window is opened, scroll down to the SERCOM2_CORE peripheral and select GCLK0 (12 MHz) as the source clock to generate the peripheral clock frequency.

sercom_2_clock_configuration.png

When a peripheral is added to the project, the peripheral clock is automatically fed by the GCLK0. However, you must configure the peripheral clocks according to your needs (power consumption, performance, …).

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, USART Pins, and Verify USART Clock

Configure USART Peripheral

1

Under the left tab Resource Management (MCC), go to Device Resources and expand Libraries > Harmony > Peripherals > SERCOM.
Double-click on SERCOM3 or drag and drop to add the SERCOM instance 3 to the project.

sercom_3_box.png

2

Under the Resource Management (MCC) tab, go to Device Resources and expand Libraries > Harmony > Tools and double-click on STDIO or drag and drop to add the STDIO tool to the project.

stdio_tool.png

3

Connect the SERCOM3 USART output to the STDIO USART input.

sercom3_stdio_linked.png

4

Select the SERCOM 3 peripheral library in the Project Graph and configure it for USART protocol.

sercom_3_configuration_options.png

Note: In this lab, the SERCOM3 (as USART) interrupt is disabled as the application does not need a callback on USART transfer complete. A USART transmit buffer empty event triggers the DMA to transfer one byte of data from source (user buffer) to destination (USART Tx register). When all the requested bytes are transmitted, the DMA PLIB notifies the application by calling the registered DMA callback event handler.

Configure USART Pins

1

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

pin_settings_tool.png

2

Now, select the MCC Pin Table tab and then scroll down to the SERCOM3 module as listed below:

  • Enable USART Transmit (SERCOM3_TX) on PA22 (pin #43)
  • Enable USART Receive (SERCOM3_RX) on PA23 (pin #44)
pin_table_sercom3_configuration.png

3

Go back to the Pin Settings table and customize the PA22 and PA23 pins names as indicated below:

  • Pin ID: PA22
    • Custom Name: SERCOM3_TX
  • Pin ID: PA23
    • Custom Name; SERCOM3_RX
sercom_3_pin_settings.png

Verify USART Clock

1

Open the Clock Configuration tab by clicking Project Graph > Plugins > Clock Configuration

clock_configuration.png

2

Open the Peripheral Clock Configuration tab by clicking on the button in the Peripheral Clock Selection.

peripheral_clock_settings.png

3

Once the window is opened, scroll down to the SERCOM3_CORE peripheral and select GCLK0 (12 MHz) as the source clock to generate the peripheral clock frequency.

sercom_3_clock_configuration.png

This completes the configuration of the USART peripheral library. The application code will use the USART PLIB APIs to print messages on the serial terminal.

Step 2.4: Configure DMA Peripheral Library

1

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

dma_configuration.png

2

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 the 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 SPI peripheral is configured for 16-bit/32-bit mode, then the beat size must be set to 16/32 bits respectively.
    • Enable Interrupts: In this Tab, SERCOM3 (as USART) Interrupt is enabled.
dma_settings.png



< Back to Lab Start


© 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.