Harmony v3 Drivers and Middleware on PIC32MZ EF MCUs Using FreeRTOS: Step 2

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

Configure I²C Driver and I²C pins

Under the Available Components tab, expand Harmony > Drivers

  • Select and double click on I2C to add the I²C driver to the project.

I2C driver select menu 

Core activation dialog 

freeRTOS activation dialog 

Project Graph freeRTOS 

  • Select FreeRTOS and view the Configuration Options on the right. 
  • Depending on the requirements of the application, the FreeRTOS default configuration can be changed using the GUI. For this tutorial, you will use the default configuration. 

FreeRTOS configuration options

Information

Adding FreeRTOS maps all the Operating System Abstraction Layer (OSAL) Application Programming Interface (API) calls used by the Harmony drivers and system services to FreeRTOS APIs.

  • Associate the I²C driver with I²C instance 1 (I²C1) peripheral by right clicking on the red diamond highlighted in the accompanying image.  

I2C driver instance

I2C driver project graph Peripheral Library linked

  • Click on Instance 0 under I²C Driver to view the Configuration Options. Change the Number of clients to 2. 

Number of clients selection​​​​​

Information

The above configuration allows the same instance of driver to be used by two different clients. The first application client interfaces with the Temperature Sensor thread and the second application client interfaces with the EEPROM thread.

The number of clients for each driver instance is automatically set to one. MPLAB® Harmony Configurator (MHC) assumes a minimum of one client for each instance of the driver.

I2C driver multiclient flowchart​​​​​

Information

If the application had two or more devices that were interfaced through different I²C peripherals, then the driver had to be configured to enable multiple instance support. Multiple instance support is enabled by clicking on the + (plus) sign on the I²C driver block. Every click on the + (plus) sign adds a new instance to the driver. Each instance can be configured separately.

  • Click on I2C to verify the driver is configured in Synchronous mode. 

Select Synchronous mode​​​​​     

  • Select I2C1 Peripheral Library and notice the default configuration by expanding Hardware Settings. 

I2C1 configuration options​​​​​

Information

The I²C retains the default 50 kHz speed because the temperature sensor chip and EEPROM on the I/O1 Xplained Pro Extension Kit can operate at 50 kHz I²C speed.

In MHC, open the pin configuration tabs by clicking Tools > Pin Configuration

Tools > Pin Configuration menu

Select the MHC Pin Settings tab and sort the entries by Ports as shown in the accompanying image. 

Ports Pin Settings​​​​​

  • Now, select the MHC Pin Table tab and then scroll down to the I2C 1 module as shown in the accompanying image. 
  • Enable I²C Clock (SCL1) on RA14 (Pin #95).
  • Enable I²C Data (SDA1) on RA15 (Pin #96).

I2C pins setup​​​​

I2C pins setup​​​​

Information

This completes the configuration of the I²C driver. The application code will use the I²C driver APIs to read the temperature from the temperature sensor and store it in EEPROM. The application also retrieves the last five temperature values stored in the EEPROM. 

Back to Top


Configure Universal Synchronous Asynchronous Receiver Transmitter (USART) Driver and USART pins

Under the Available Components tab, expand Harmony > Drivers

Double click on USART to add the USART Driver to the project.

Select USART

USART driver project graph​​​​​

  • Associate the USART Driver with UART instance 6 (UART6) peripheral by right clicking on the red diamond highlighted in the accompanying image. 

USART driver instance

USART driver project graph Peripheral Library linked

  • Verify that the USART Driver is configured to run in Synchronous mode by clicking on the USART block as shown in the accompanying image. 

USART sync

  • Click on Instance 0 under USART Driver to view the Configuration Options. Change the Number of Clients of the USART Driver Instance from 0 to 3. The User Input thread will use the USART Driver to read the character input on the serial terminal. The Sensor and EEPROM threads will use the USART Driver to print temperature values on the serial terminal. 

I2C driver instance changes

  • Select the UART6 Peripheral Library in the Project Graph and configure it for UART protocol, including setting the Baud Rate to 115,200 Hz. 

UART6 configuration options

Select the Pin Table tab and then scroll down to the UART6 module as shown in the accompanying image. 

  •  Enable USART_TX (U6TX) on RF2 (Pin #79).
  •  Enable USART_RX (U6RX) on RF13 (Pin #57).

USART pins setup

USART pins setup

Information

The application will use the USART Driver for printing messages on the serial terminal and receiving input from the user to retrieve the last five stored values from the EEPROM.

Back to Top