This message will disappear after all relevant tasks have been resolved.

Semantic MediaWiki

There are 1 incomplete or pending task to finish installation of Semantic MediaWiki. An administrator or user with sufficient rights can complete it. This should be done before adding new data to avoid inconsistencies.

Coming soon

Target description

This tutorial will help you to:

Use the X-NUCLEO-SRC1M1 shield that includes a TCPP02-M18 protection circuit and provides a USB Type-C^® connector
Create a USB-PD Source Device with the NUCLEO-G0B1RE board and the X-NUCLEO-SRC1M1 shield by using STM32CubeIDE software

Prerequisites

Computer with Windows 7 (or higher)

Hardware

NUCLEO-G0B1RE (tested on rev C) ^[1]

X-NUCLEO-SRC1M1 ^[2]
USB cable Type-A to Micro-B
USB Type-C^® to Type-C^® cable
A USB-PD sink device to test our USB-PD device

Software

STM32CubeIDE (tested with V1.7.0) ^[3]
STM32CubeMonitor-UCPD(tested with V1.1.1) ^[4]
X-CUBE-TCPP MCU Firmware Package (BSP) ^[5]

Literature

UM2324 NUCLEO-G0B1RE User Manual

Create a USB-PD Source Device

60min

1. Creating the project

Open STM32CubeIDE and create a New STM32 Project. As a target selection, choose the NUCLEO-G0B1RE from the "Board Selector" Tab

File:0-newproject.png

Click "Next", then enter you project's name. Leave the other fields as default and click "Finish".

File:1-newproject.png

2. Configuring the system

When prompted for initializing peripherals with their default mode, click No.
At this point your project is created and you are left with the STM32CubeMX view. In the next steps, we will configure the peripherals and options needed for the project.

2.1. Configure UCPD peripheral

Select the UCPD1 peripheral and enable it in source mode. Under the NVIC Settings tab, enable USB global interrupts.

File:0-UCPD1Conf.png

Under the DMA Settings tab, add UCPD1_RX and UCPD1_TX DMA requests. Select channel 4for RX and channel 2 for TX.

File:1-UCPD1Conf.png

2.2. Configure FreeRTOS Middleware

In the Middleware section, enable FreeRTOS with CMSIS_V1 interface. Under the Config Parameters tab, change "TOTAL_HEAP_SIZE" to 7000 bytes.

Then, under the Include Parameters tab, Enable "eTaskGetState" include definition.

2.3. Configure USBPD Middleware

In the Middleware section, enable USBPD with the following configuration:

Port Configuration: Port 0: UCPD1
Stack Configuration: PD3 Full Stack
Timer service Source: TIM1

Under the PDO General Definitions tab, verify the following configuration:

Number of Sink PDOs for port 0: 1
Port 0 Sink PDO 1 0x0001912C (correspond to a simple 5V / 3A source)

File:0-USBPDConf.png

The following table is extracted from USB Power Delivery Specification, Table 6-9 Fixed Supply PDO - Source. Used values and associated decoding for this project have been added to the table.

Bit(s)	Description	Used value	Decoding
B31..30	Fixed supply	00b	No
B29	Dual-Role Power	0b	No
B28	USB Suspend Supported	0b	No
B27	Unconstrained Power	0b	No
B26	USB Communications Capable	0b	No
B25	Dual-Role Data	0b	No
B24..22	Reserved - Shall de set to zero	000b	No
B21..20	Peak Current	00b	Peak Equals
B19..10	Voltage in 50mV units	01100100b	5V
B9..0	Maximum current in 10mA units	100101100b	3A

2.4. Configure ADC peripheral

In order for the Power Delivery stack to work, VBUS needs to be monitored. To do it, an ADC needs to be configured to measure the VBUS voltage and current.
As we are going to use the X-NUCLEO-SRC1M1 BSP, the ADC configuration does not need to be done in CubeMX.
As we need the ADC LL drivers for it to work properly, we still need to configure the ADC in CubeMX fot it to include the drivers files, but the actual configuration and init function will not be called in our project.
In the Communication section, enable ADC peripheral channel 0. Leave the configuration as default, as the X-NUCLEO-SRC1M1 BSP will reconfigure it.

File:0-ADC1Conf.png

2.5. Configure I2C peripheral

As the X-NUCLEO-SRC1M1 shield includes a TCPP02-M18 which communicate via I2C, we need to enable the I2C peripheral in our project.
In the Communication section, enable I2C2 peripheral, in I2C mode. Leave the configuration as default, as the X-NUCLEO-SRC1M1 BSP will reconfigure it.

File:0-I2C2Conf.png

Note: We need to enable the I2C peripheral in the CubeMX view in order for code generation to include the I2C drivers, like we did for the ADC.

2.6. Configure Clocks

Under the Clock Configuration main tab, change system clock mux to PLLCLK. It will set HCLK clock to 64MHz.

Information

The mandatory settings for the simple USB-PD sink application are finished.

The following part is highly recommended for debugging

2.7. [OPTIONAL] Configure Tracer for debug

2.7.1. Configure LPUART

On the STM32G0 Nucleo-64 board, the Virtual COM port connected to the ST-LINK is the LPUART1.

Warning

The default STM32CubeMX pins used by LPUART1 must be changed to match the STM32G0 Nucleo-64 hardware:

PA2 for TX
PA3 for RX.

In the Connectivity section, enable LPUART1 in Asynchronous mode, and baudrate 921600 bauds. Leave the rest as default.
In the pinout view, right click PA2 and PA3 to remap them to LPUART1_TX and LPUART1_RX.

Under the DMA Configuration tab, add a request for LPUART1_TX.

Finally, under the NVIC Settings tab, enable LPUART1 global interrupts.

2.7.2. Configure embedded tracer

In the Utilities section, select TRACER_EMB and use LPUART1 as the trace source.

Then, go back to the USBPD middleware configuration and check the Tracer Source checkbox.

2.8. Configure UCPD monitor firmware responder for debug

The firmware interactive stack responder can be activated if interaction with the USB-PD stack is needed, using the UCPD monitor tool STM32CubeMonUCPD. In the Utilities section, enable GUI_INTERFACE, then enter free text to describe the board.

File:0-GUIConf.png

3. Configure project

Once the configuration is finished, few parameters must be saved in the project manager tab before saving the project.
Under the project manager tab, select a name for the project. For the project directory, avoid using One drive, if STM32CubeMX is not in One drive too.
Configure the minimum stack size to 0xC00. This is the first version, which can be tuned later, depending on the application needs.

File:0-projectConf.png

Under the Code Generator tab, STMicroelectronics recommends checking the Add necessary library files as reference tab.

Under the Advanced Settings tab, change LPUART driver to LL to save a bit of memory heap size and check "Do not generate function call" for the MX_I2C2_Init and MX_ADC1_Init functions.

File:2-projectConf.png

4. Add BSP to the project

Board Support Package (BSP) for the X-NUCLEO-SRC1M1 shield needs to be added to the project. The files needs to be copied manually in the project's folder.
Get the latest BSP from GitHub x-cube-tcpp.

Manually copy the three following folders:

x-cube-tcpp
└── Drivers
    └── BSP
        ├── 📁STM32G0xx_Nucleo
        ├── 📁X-NUCLEO-SRC1M1
        └── Components
            └── 📁tcpp0203

Into:

<ProjectFolder>
└── Drivers
    └── BSP
        ├── 📁STM32G0xx_Nucleo
        ├── 📁X-NUCLEO-SRC1M1
        └── Components
            └── 📁tcpp0203

Then, create a file named ".extSettings" at the project's root folder (please mind the dot character in the filename) and fill it with the following code:

[ProjectFiles]
HeaderPath=Drivers\BSP\X-NUCLEO-SRC1M1;Drivers\BSP\STM32G0xx_Nucleo;Drivers\BSP\Components\tcpp0203
[Others]
Define=TCPP0203_SUPPORT;USE_STM32G0XX_NUCLEO
HALModule=
[Groups]
Drivers/BSP/X-NUCLEO-SRC1M1=Drivers/BSP/X-NUCLEO-SRC1M1/src1m1_usbpd_pwr.c;Drivers/BSP/X-NUCLEO-SRC1M1/src1m1_bus.c;
Drivers/BSP/STM32G0xx_Nucleo=Drivers/BSP/STM32G0xx_Nucleo/stm32g0xx_nucleo.c
Drivers/BSP/Components/tcpp0203=Drivers/BSP/Components/tcpp0203/tcpp0203.c;Drivers/BSP/Components/tcpp0203/tcpp0203_reg.c

This file is used to tell the code generator to include the BSP files when generating the project.

5. Generate code

Save your file with Ctrl+s and select generate code if prompted. You can also generate code from the STM32CubeIDE menu by clicking Project/Generate Code, or by pressing Alt+K.

A warning appears, informing that a proper HAL timebase is not defined. It is safer to use a dedicated timer as a HAL timebase source.
For this demonstration, the below warning can be ignored by clicking Yes.

Information

This becomes the recommended standard way of working in the forthcoming firmware package deliveries, especially when using CMSIS OS V2, which defines Systick as FreeRTOS™ timebase.

For this demonstration, the warning can be ignored by clicking Yes.

In this project, different folders can be found:

The USBPD folder contains the source files that we need to edit to enrich the Power Delivery application.
The Core folder contains the source files for the core of the project.
The Drivers folder contains the HAL drivers for the STM32, and the BSP for the Nucleo board and X-NUCLEO-SRC1M1 shield.
The Middleware folder contains the source files and the libraries for FreeRTOS™ and USB-PD.
The Utilities folder contains the GUI (UCPD monitor) and tracer embedded source files part.

The Drivers folder in the project Explorer view should contain the BSP folders added earlier.

File:0-projTree.png

6. Complete USB-PD application

Now that the peripherals are initialized by STM32CubeMX, some minimum level of the application needs to be added:

ADC needs to be calibrated, and conversion needs to start.
src1m1_conf.h file needs to be created from its template, and added to the project
User code needs to be added in several files

6.1. Add SRC1M1 configuration file

In the Drivers\BSP\X-NUCLEO-SRC1M1 folder you will find src1m1_conf_template.h. Copy it to Core\Inc folder, and rename it src1m1_conf.h. It is the configuration file used for the X-NUCLEO-SRC1M1 BSP.

6.2. Modification in usbpd_dpm_user.h

Add the following code between the /* USER CODE BEGIN Typedef */ tags:

…
/* USER CODE BEGIN Typedef */
typedef struct
{
  uint32_t                      DPM_ListOfRcvSNKPDO[USBPD_MAX_NB_PDO];   /*!< The list of received Sink Power Data Objects from Port partner
                                                                              (when Port partner is a Sink or a DRP port).                         */
  uint32_t                      DPM_NumberOfRcvSNKPDO;                   /*!< The number of received Sink Power Data Objects from port Partner
                                                                              (when Port partner is a Sink or a DRP port).
                                                                              This parameter must be set to a value lower than USBPD_MAX_NB_PDO    */
  uint32_t                      DPM_RDOPosition;                         /*!< RDO Position of requested DO in Source list of capabilities          */
  uint32_t                      DPM_RDOPositionPrevious;                 /*!< RDO Position of requested DO in Source list of capabilities          */
  uint32_t                      DPM_RequestedVoltage;                    /*!< Value of requested voltage                                           */
  uint32_t                      DPM_RequestedCurrent;                    /*!< Value of requested current                                           */
  uint32_t                      DPM_RcvRequestDOMsg;

  uint32_t                      DPM_RequestDOMsg;                        /*!< Request Power Data Object message to be sent                         */
  uint32_t                      DPM_RequestDOMsgPrevious;                /*!< Previous Request Power Data Object message to be sent                */
} USBPD_HandleTypeDef;
/* USER CODE END Typedef */
…

Add the following code between the /* USER CODE BEGIN Private_Variables */ tags:

…
/* USER CODE BEGIN Private_Variables */
extern USBPD_HandleTypeDef DPM_Ports[USBPD_PORT_COUNT];
/* USER CODE END Private_Variables */
…

6.3. Modification in usbpd_pdo_defs.h

Add the following code between the /* USER CODE BEGIN typedef */ tags:

…
/* USER CODE BEGIN typedef */

/**
  * @brief  USBPD Port PDO Structure definition
  */
typedef struct
{
  uint32_t *ListOfPDO;         /*!< Pointer on Power Data Objects list, defining
                                      port capabilities */

  uint8_t  *NumberOfPDO;       /*!< Number of Power Data Objects defined in ListOfPDO
                                     This parameter must be set at max to @ref USBPD_MAX_NB_PDO value */
} USBPD_PortPDO_TypeDef;

/**
   * @brief  USBPD Port PDO Storage Structure definition
   */
typedef struct
{
  USBPD_PortPDO_TypeDef    SourcePDO;      /*!< SRC Power Data Objects */
} USBPD_PWR_Port_PDO_Storage_TypeDef;
/* USER CODE END typedef */
…

6.4. Modification in usbpd_pwr_if.c

Add the following code between the /* USER CODE BEGIN Private_Variables */ tags:

…
/* USER CODE BEGIN Private_Variables */
/**
  * @brief  USBPD Port PDO Storage array declaration
  */
USBPD_PWR_Port_PDO_Storage_TypeDef PWR_Port_PDO_Storage[USBPD_PORT_COUNT];
/* USER CODE END Private_Variables */
…

Add the following code between the /* USER CODE BEGIN USBPD_PWR_IF_Init */ tags:

…
/* USER CODE BEGIN USBPD_PWR_IF_Init */
  USBPD_StatusTypeDef _status = USBPD_OK;

  /* Set links to PDO values and number for Port 0 (defined in PDO arrays in H file). */
  PWR_Port_PDO_Storage[USBPD_PORT_0].SourcePDO.ListOfPDO = (uint32_t *) PORT0_PDO_ListSRC;
  PWR_Port_PDO_Storage[USBPD_PORT_0].SourcePDO.NumberOfPDO = &USBPD_NbPDO[1];

  return _status;
/* USER CODE END USBPD_PWR_IF_Init */
…

Add the following code between the /* USER CODE BEGIN USBPD_PWR_IF_SetProfile */ tags:

…
/* USER CODE BEGIN USBPD_PWR_IF_SetProfile */
  USBPD_PDO_TypeDef        _pdo;
  USBPD_SNKRDO_TypeDef     _rdo;

  _rdo.d32 = DPM_Ports[PortNum].DPM_RcvRequestDOMsg;
  _pdo.d32 = PORT0_PDO_ListSRC[0];

  return (BSP_ERROR_NONE == BSP_USBPD_PWR_VBUSSetVoltage_Fixed(PortNum, _pdo.SRCFixedPDO.VoltageIn50mVunits * 50,
                                                     (_rdo.FixedVariableRDO.OperatingCurrentIn10mAunits * 10),
                                                     (_rdo.FixedVariableRDO.MaxOperatingCurrent10mAunits * 10)) ? USBPD_OK : USBPD_ERROR);
/* USER CODE END USBPD_PWR_IF_SetProfile */
…

Add the following code between the /* USER CODE BEGIN USBPD_PWR_IF_GetPortPDOs */ tags:

…
/* USER CODE BEGIN USBPD_PWR_IF_GetPortPDOs */
  uint32_t   nbpdo, index, nb_valid_pdo = 0;
  uint32_t   *ptpdoarray = NULL;
  USBPD_PDO_TypeDef pdo_first;
  USBPD_PDO_TypeDef pdo;

  /* Check if valid port */
  if (USBPD_PORT_IsValid(PortNum))
  {
    /* According to type of PDO to be read, set pointer on values and nb of elements */
    switch(DataId)
    {
    case USBPD_CORE_DATATYPE_SRC_PDO :
      nbpdo = *PWR_Port_PDO_Storage[PortNum].SourcePDO.NumberOfPDO;
      ptpdoarray = PWR_Port_PDO_Storage[PortNum].SourcePDO.ListOfPDO;
      /* Save the 1st PDO */
      pdo_first.d32 = *ptpdoarray;
      /* Reset unchunked bit if current revision is PD2.0*/
      if (USBPD_SPECIFICATION_REV2 == DPM_Params[PortNum].PE_SpecRevision)
      {
        pdo_first.SRCFixedPDO.UnchunkedExtendedMessage  = USBPD_PDO_SRC_FIXED_UNCHUNK_NOT_SUPPORTED;
      }
      break;
    default :
      nbpdo = 0;
      break;
    }

    /* Copy PDO data in output buffer */
    for (index = 0; index < nbpdo; index++)
    {
      pdo.d32 = *ptpdoarray;
      /* Copy only PDO (and not APDO in case of current revision is PD2.0) */
      if ((USBPD_SPECIFICATION_REV2 == DPM_Params[PortNum].PE_SpecRevision)
          && (pdo.GenericPDO.PowerObject == USBPD_CORE_PDO_TYPE_APDO))
      {
      }
      else
      {
        /* Copy 1st PDO as potentially FRS or UNCHUNKED bits have been reset */
        if (0 == index)
        {
          (void)memcpy(Ptr, (uint8_t*)&pdo_first.d32, 4u);
        }
        else
        {
          (void)memcpy((Ptr + (nb_valid_pdo * 4u)), (uint8_t*)ptpdoarray, 4u);
        }
        nb_valid_pdo++;
      }
      ptpdoarray++;
    }
    /* Set nb of read PDO (nb of u32 elements); */
    *Size = nb_valid_pdo;
  }
/* USER CODE END USBPD_PWR_IF_GetPortPDOs */
…

Add the following code between the /* USER CODE BEGIN USBPD_PWR_IF_SearchRequestedPDO */ tags:

…
/* USER CODE BEGIN USBPD_PWR_IF_SearchRequestedPDO */
  if((RdoPosition == 0) || (RdoPosition > *PWR_Port_PDO_Storage[PortNum].SourcePDO.NumberOfPDO))
  {
    /* Invalid PDO index */
  return USBPD_FAIL;
  }

  *Pdo = PWR_Port_PDO_Storage[PortNum].SourcePDO.ListOfPDO[RdoPosition - 1];
  return USBPD_OK;
/* USER CODE END USBPD_PWR_IF_SearchRequestedPDO */
…

6.5. Modification in usbpd_dpm_user.c

Add the following code between the /* USER CODE BEGIN Private_Variables */ tags:

…
/* USER CODE BEGIN Private_Variables */
USBPD_HandleTypeDef DPM_Ports[USBPD_PORT_COUNT];
/* USER CODE END Private_Variables */
…

Add the following code between the /* USER CODE BEGIN USBPD_USER_PRIVATE_FUNCTIONS_Prototypes */ tags:

…
/* USER CODE BEGIN USBPD_USER_PRIVATE_FUNCTIONS_Prototypes */
static USBPD_StatusTypeDef DPM_TurnOnPower(uint8_t PortNum, USBPD_PortPowerRole_TypeDef Role);
static USBPD_StatusTypeDef DPM_TurnOffPower(uint8_t PortNum, USBPD_PortPowerRole_TypeDef Role);
/* USER CODE END USBPD_USER_PRIVATE_FUNCTIONS_Prototypes */
…

Add the following code between the /* USER CODE BEGIN USBPD_DPM_UserInit */ tags:

…
/* USER CODE BEGIN USBPD_DPM_UserInit */
  /* PWR SET UP */
  if(USBPD_OK !=  USBPD_PWR_IF_Init())
  {
    return USBPD_ERROR;
  }
  return USBPD_OK;
/* USER CODE END USBPD_DPM_UserInit */
…

Add the following code between the /* USER CODE BEGIN USBPD_DPM_UserCableDetection */ tags:

…
/* USER CODE BEGIN USBPD_DPM_UserCableDetection */
  switch(State)
  {
  case USBPD_CAD_EVENT_ATTACHED:
  case USBPD_CAD_EVENT_ATTEMC:
    {
      if (DPM_Params[PortNum].PE_PowerRole == USBPD_PORTPOWERROLE_SRC)
      {
        if (USBPD_OK != USBPD_PWR_IF_VBUSEnable(PortNum))
        {
          /* Should not occur */
          osDelay(6000);
          NVIC_SystemReset();
        }
      }
      break;
    }
  case USBPD_CAD_EVENT_DETACHED :
  case USBPD_CAD_EVENT_EMC :
  default :
    {
      if (DPM_Params[PortNum].PE_PowerRole == USBPD_PORTPOWERROLE_SRC)
      {
        if (USBPD_OK != USBPD_PWR_IF_VBUSDisable(PortNum))
        {
          /* Should not occur */
          while(1);
        }
      }
      break;
    }
  }
/* USER CODE END USBPD_DPM_UserCableDetection */
…

Add the following code between the /* USER CODE BEGIN USBPD_DPM_HardReset */ tags:

…
/* USER CODE BEGIN USBPD_DPM_HardReset */
  DPM_USER_DEBUG_TRACE(PortNum, "ADVICE: update USBPD_DPM_HardReset");
  switch (Status)
  {
  case USBPD_HR_STATUS_WAIT_VBUS_VSAFE0V:
    if (USBPD_PORTPOWERROLE_SRC == CurrentRole)
    {
      /* Reset the power supply */
      DPM_TurnOffPower(PortNum, USBPD_PORTPOWERROLE_SRC);
    }
    break;

  case USBPD_HR_STATUS_WAIT_VBUS_VSAFE5V:
    if (CurrentRole == USBPD_PORTPOWERROLE_SRC)
    {
      /* Power on the power supply */
      DPM_TurnOnPower(PortNum, CurrentRole);
    }
    break;

  default:
    break;
  }
/* USER CODE END USBPD_DPM_HardReset */
…

Add the following code between the /* USER CODE BEGIN USBPD_DPM_GetDataInfo */ tags:

…
/* USER CODE BEGIN USBPD_DPM_GetDataInfo */
  /* Check type of information targeted by request */
  switch(DataId)
  {
//  case USBPD_CORE_DATATYPE_REQ_VOLTAGE:       /*!< Get voltage value requested for BIST tests, expect 5V*/
    // break;
//  case USBPD_CORE_DATATYPE_SRC_PDO:           /*!< Handling of port Source PDO                         */
    // break;
    case USBPD_CORE_DATATYPE_REQ_VOLTAGE:       /*!< Get voltage value requested for BIST tests, expect 5V*/
      *Size = 4;
      (void)memcpy((uint8_t*)Ptr, (uint8_t *)&DPM_Ports[PortNum].DPM_RequestedVoltage, *Size);
      break;
    case USBPD_CORE_DATATYPE_SRC_PDO:           /*!< Handling of port Source PDO                         */
      USBPD_PWR_IF_GetPortPDOs(PortNum, DataId, Ptr, Size);
      *Size *= 4;
      break;
//  case USBPD_CORE_PPS_STATUS:                 /*!< PPS Status message content                          */
    // break;
//  case USBPD_CORE_SNK_EXTENDED_CAPA:          /*!< Retrieve of Sink Extended capability message content*/
    // break;
//  case USBPD_CORE_INFO_STATUS:                /*!< Information status message content                  */
    // break;
//  case USBPD_CORE_MANUFACTURER_INFO:          /*!< Retrieve of Manufacturer info message content       */
    // break;
//  case USBPD_CORE_BATTERY_STATUS:             /*!< Retrieve of Battery status message content          */
    // break;
//  case USBPD_CORE_BATTERY_CAPABILITY:         /*!< Retrieve of Battery capability message content      */
    // break;
  default:
    DPM_USER_DEBUG_TRACE(PortNum, "ADVICE: update USBPD_DPM_GetDataInfo:%d", DataId);
    break;
  }
/* USER CODE END USBPD_DPM_GetDataInfo */
…

Add the following code between the /* USER CODE BEGIN USBPD_DPM_SetDataInfo */ tags:

…
/* USER CODE BEGIN USBPD_DPM_SetDataInfo */
  /* Check type of information targeted by request */
  switch(DataId)
  {
//  case USBPD_CORE_DATATYPE_RDO_POSITION:      /*!< Reset the PDO position selected by the sink only */
    // break;
   case USBPD_CORE_DATATYPE_RDO_POSITION:      /*!< Reset the PDO position selected by the sink only */
    if (Size == 4)
    {
      uint8_t* temp;
      temp = (uint8_t*)&DPM_Ports[PortNum].DPM_RDOPosition;
      (void)memcpy(temp, Ptr, Size);
      DPM_Ports[PortNum].DPM_RDOPositionPrevious = *Ptr;
      temp = (uint8_t*)&DPM_Ports[PortNum].DPM_RDOPositionPrevious;
      (void)memcpy(temp, Ptr, Size);
    }
    break;
//  case USBPD_CORE_DATATYPE_RCV_SRC_PDO:       /*!< Storage of Received Source PDO values        */
    // break;
//  case USBPD_CORE_DATATYPE_RCV_SNK_PDO:       /*!< Storage of Received Sink PDO values          */
    // break;
  // case USBPD_CORE_DATATYPE_RCV_REQ_PDO :     /*!< Storage of Received Sink Request PDO value   */
    // if (Size == 4)
    // {
      // memcpy((uint8_t *)&DPM_Ports[PortNum].DPM_RcvRequestDOMsg,  Ptr, 4);
    // }
    // break;
    case USBPD_CORE_DATATYPE_RCV_REQ_PDO :     /*!< Storage of Received Sink Request PDO value   */
      if (Size == 4)
      {
        memcpy((uint8_t *)&DPM_Ports[PortNum].DPM_RcvRequestDOMsg,  Ptr, 4);
      }
      break;
//  case USBPD_CORE_INFO_STATUS:                /*!< Information status message content           */
    // break;
//  case USBPD_CORE_ALERT:                      /*!< Storing of received Alert message content    */
    // break;
//  case USBPD_CORE_GET_MANUFACTURER_INFO:      /*!< Storing of received Get Manufacturer info message content */
    // break;
//  case USBPD_CORE_GET_BATTERY_STATUS:         /*!< Storing of received Get Battery status message content    */
    // break;
//  case USBPD_CORE_GET_BATTERY_CAPABILITY:     /*!< Storing of received Get Battery capability message content*/
    // break;
//  case USBPD_CORE_SNK_EXTENDED_CAPA:          /*!< Storing of Sink Extended capability message content       */
    // break;
  default:
    DPM_USER_DEBUG_TRACE(PortNum, "ADVICE: update USBPD_DPM_SetDataInfo:%d", DataId);
    break;
  }
/* USER CODE END USBPD_DPM_SetDataInfo */
…

Add the following code between the /* USER CODE BEGIN USBPD_DPM_EvaluateRequest */ tags:

…
/* USER CODE BEGIN USBPD_DPM_EvaluateRequest */
  DPM_USER_DEBUG_TRACE(PortNum, "ADVICE: update USBPD_DPM_EvaluateRequest");
  return USBPD_REJECT;
  USBPD_StatusTypeDef _retr = USBPD_REJECT;
  USBPD_PDO_TypeDef pdo;
  USBPD_SNKRDO_TypeDef rdo;

  /* read the request value received */
  rdo.d32 = DPM_Ports[PortNum].DPM_RcvRequestDOMsg;

  /* Search PDO in Port Source PDO list, that corresponds to Position provided in Request RDO */
  if (USBPD_PWR_IF_SearchRequestedPDO(PortNum,  rdo.GenericRDO.ObjectPosition, &pdo.d32) == USBPD_OK)
  {

    /* Evaluate the request */
    if(pdo.GenericPDO.PowerObject == USBPD_CORE_PDO_TYPE_FIXED)
    {
      if((rdo.FixedVariableRDO.OperatingCurrentIn10mAunits > pdo.SRCFixedPDO.MaxCurrentIn10mAunits)
         || (rdo.FixedVariableRDO.MaxOperatingCurrent10mAunits > pdo.SRCFixedPDO.MaxCurrentIn10mAunits))
      {
        /* Sink requests too much maximum operating current */
        /* USBPD_DPM_EvaluateRequest: Sink requests too much maximum operating current */
        _retr =  USBPD_REJECT;
      }
      else
      {
        /* Save the power object */
        *PtrPowerObject = pdo.GenericPDO.PowerObject;
        /* Set RDO position and requested voltage in DPM port structure */
        DPM_Ports[PortNum].DPM_RequestedVoltage = pdo.SRCFixedPDO.VoltageIn50mVunits * 50;
        DPM_Ports[PortNum].DPM_RDOPositionPrevious = DPM_Ports[PortNum].DPM_RDOPosition;
        DPM_Ports[PortNum].DPM_RDOPosition = rdo.GenericRDO.ObjectPosition;
         _retr = USBPD_ACCEPT;
      }
    }
  }

  return _retr;
/* USER CODE END USBPD_DPM_EvaluateRequest */
…

Add the following code between the /* USER CODE BEGIN USBPD_USER_PRIVATE_FUNCTIONS */ tags:

…
/* USER CODE BEGIN USBPD_USER_PRIVATE_FUNCTIONS */
/**
  * @brief  Turn Off power supply.
  * @param  PortNum The current port number
  * @param  Role    Port power role
  * @retval USBPD_OK, USBPD_ERROR
  */
static USBPD_StatusTypeDef DPM_TurnOffPower(uint8_t PortNum, USBPD_PortPowerRole_TypeDef Role)
{
  USBPD_StatusTypeDef status;

  status = USBPD_PWR_IF_VBUSDisable(PortNum);
  return status;
}

/**
  * @brief  Turn On power supply.
  * @param  PortNum The current port number
  * @param  Role    Port power role
  * @retval USBPD_ACCEPT, USBPD_WAIT, USBPD_REJECT
  */
static USBPD_StatusTypeDef DPM_TurnOnPower(uint8_t PortNum, USBPD_PortPowerRole_TypeDef Role)
{
  USBPD_StatusTypeDef status;

  /* Enable the output */
  status = USBPD_PWR_IF_VBUSEnable(PortNum);
  return status;
}
/* USER CODE END USBPD_USER_PRIVATE_FUNCTIONS */
…

7. Compile and run the application

The compilation must be performed without error.
Since we configured not to call the ADC and I2C initialization functions, you should get two compilation warnings, telling you that these function have been declared, but not used. You can ignore theses two warnings.

Build the application by clicking on the button (or select Project/Build Project.
Run the application by clicking on the button (or select Run/Run)

8. Establish the first explicit contract

Compile the application, flash the board, start the STM32G0 program, keep the USB cable plugged, as the Virtual COM port is mandatory, and launch STM32CubeMonitor-UCPD application. The user's board must appear in the list when clicking "Refresh list of connected boards", so double click on the corresponding line (or click "NEXT").

File:0-cubeMon.png

Note: The ComPort may be different. It depends on the number of boards installed on the computer. Then double click on the desired UCPD port, here Port 0, or select it and click "NEXT".

File:1-cubeMon.png

Click on the "TRACES" button in the bottom right corner to get protocol traces. Then it is possible to plug a power delivery source cable into the USB Type-C® receptacle of the X-NUCLEO-USBPDM1 shield. The screen may look like this:

File:2-cubeMon.png

Note: The SRC PDO part may look different. It depends on the capabilities of the power source.

The figure above shows the communication between the STM32G0 and the power delivery source on the right panel. It is possible to verify the correct sequence to reach an explicit contract:

The capabilities are sent by the STM32G0 (OUT orange message).
The request is sent by the sink (IN green message).
The ACCEPT and the PS_RDY are sent by the STM32G0 (OUT orange message).
The contract negociation ends by the POWER_EXPLICIT_CONTRACT notification (blue message).

For more details on how to use this tool, refer to UM2468. And for more details on the protocol, refer to UM2552. Note that this trace is very helpful for debugging and application development.

You can also use the Measurement window in STM32CubeMonitor-UCPD to display a graph of the measured VBUS voltage and delivered current. Set the sampling period and click start.

File:3-cubeMon.png

9. References

[1] NUCLEO-G0B1RE

[2] X-NUCLEO-SRC1M1

[3] STM32CubeIDE

[4] STM32CubeMonitor-UCPD

[5] X-CUBE-TCPP

[1]

[2]

[3]

[4]

[5]

Getting started with USB-Power Delivery Source

Contents

1. Creating the project

2. Configuring the system

2.1. Configure UCPD peripheral

2.2. Configure FreeRTOS Middleware

2.3. Configure USBPD Middleware

2.4. Configure ADC peripheral

2.5. Configure I2C peripheral

2.6. Configure Clocks

2.7. [OPTIONAL] Configure Tracer for debug

2.7.1. Configure LPUART

2.7.2. Configure embedded tracer

2.8. Configure UCPD monitor firmware responder for debug

3. Configure project

4. Add BSP to the project

5. Generate code

6. Complete USB-PD application

6.1. Add SRC1M1 configuration file

6.2. Modification in usbpd_dpm_user.h

6.3. Modification in usbpd_pdo_defs.h

6.4. Modification in usbpd_pwr_if.c

6.5. Modification in usbpd_dpm_user.c

7. Compile and run the application

8. Establish the first explicit contract

9. References