Comment about resource reservations in BSP Init

Kyle Kearney · Kyle Kearney · commit 4ddb0eb63da4 · 2019-08-26T14:19:13.000-07:00
diff --git a/targets/TARGET_Cypress/TARGET_PSOC6/TARGET_CY8CKIT_062S2_43012/cybsp.c b/targets/TARGET_Cypress/TARGET_PSOC6/TARGET_CY8CKIT_062S2_43012/cybsp.c
@@ -43,20 +43,29 @@ cy_rslt_t cybsp_init(void)
     if (CY_RSLT_SUCCESS == result)
     {
         /* Initialize User LEDs */
+        /* Reserves: CYBSP_USER_LED1 */
         result |= cybsp_led_init(CYBSP_USER_LED1);
+        /* Reserves: CYBSP_USER_LED2 */
         result |= cybsp_led_init(CYBSP_USER_LED2);
+        /* Reserves: CYBSP_USER_LED3 */
         result |= cybsp_led_init(CYBSP_USER_LED3);
+        /* Reserves: CYBSP_USER_LED4 */
         result |= cybsp_led_init(CYBSP_USER_LED4);
+        /* Reserves: CYBSP_USER_LED5 */
         result |= cybsp_led_init(CYBSP_USER_LED5);
         /* Initialize User Buttons */
+        /* Reserves: CYBSP_USER_BTN1 */
         result |= cybsp_btn_init(CYBSP_USER_BTN1);
+        /* Reserves: CYBSP_USER_BTN2 */
         result |= cybsp_btn_init(CYBSP_USER_BTN2);
 
         CY_ASSERT(CY_RSLT_SUCCESS == result);
 
         /* Initialize retargetting stdio to 'DEBUG_UART' peripheral */
         if (CY_RSLT_SUCCESS == result)
         {
+           /* Reserves: CYBSP_DEBUG_UART_RX, CYBSP_DEBUG_UART_TX, CYBSP_DEBUG_UART_RTS, CYBSP_DEBUG_UART_CTS
+            *    corresponding SCB instance and one of available clock dividers */
             result = cybsp_retarget_init();
         }
     }
@@ -68,10 +77,15 @@ cy_rslt_t cybsp_init(void)
        when starting up WiFi. */
     if (CY_RSLT_SUCCESS == result)
     {
+       /* Reserves: CYBSP_WIFI_SDIO, CYBSP_WIFI_SDIO_D0, CYBSP_WIFI_SDIO_D1, CYBSP_WIFI_SDIO_D2, CYBSP_WIFI_SDIO_D3
+       *    CYBSP_WIFI_SDIO_CMD, CYBSP_WIFI_SDIO_CLK and CYBSP_WIFI_WL_REG_ON */
         result = cybsp_wifi_sdio_init();
     }
 #endif
-
+    
+    /* CYHAL_HWMGR_RSLT_ERR_INUSE error code could be returned if any needed for BSP resource was reserved by
+    *   user previously. Please review the Device Configurator (design.modus) and the BSP reservation list 
+    *   (cyreservedresources.list) to make sure no resources are reserved by both. */
     return result;
 }
 
diff --git a/targets/TARGET_Cypress/TARGET_PSOC6/TARGET_CY8CKIT_062_BLE/cybsp.c b/targets/TARGET_Cypress/TARGET_PSOC6/TARGET_CY8CKIT_062_BLE/cybsp.c
@@ -42,23 +42,34 @@ cy_rslt_t cybsp_init(void)
     if (CY_RSLT_SUCCESS == result)
     {
         /* Initialize User LEDs */
+        /* Reserves: CYBSP_USER_LED1 */
         result |= cybsp_led_init(CYBSP_USER_LED1);
+        /* Reserves: CYBSP_USER_LED2 */
         result |= cybsp_led_init(CYBSP_USER_LED2);
+        /* Reserves: CYBSP_USER_LED3 */
         result |= cybsp_led_init(CYBSP_USER_LED3);
+        /* Reserves: CYBSP_USER_LED4 */
         result |= cybsp_led_init(CYBSP_USER_LED4);
+        /* Reserves: CYBSP_USER_LED5 */
         result |= cybsp_led_init(CYBSP_USER_LED5);
         /* Initialize User Buttons */
+        /* Reserves: CYBSP_USER_BTN1 */
         result |= cybsp_btn_init(CYBSP_USER_BTN1);
         CY_ASSERT(CY_RSLT_SUCCESS == result);
 
         /* Initialize retargetting stdio to 'DEBUG_UART' peripheral */
         if (CY_RSLT_SUCCESS == result)
         {
+           /* Reserves: CYBSP_DEBUG_UART_RX, CYBSP_DEBUG_UART_TX, corresponding SCB instance and one of available
+            *   clock dividers */
             result = cybsp_retarget_init();
         }
     }
 #endif
 
+    /* CYHAL_HWMGR_RSLT_ERR_INUSE error code could be returned if any needed for BSP resource was reserved by
+    *   user previously. Please review the Device Configurator (design.modus) and the BSP reservation list 
+    *   (cyreservedresources.list) to make sure no resources are reserved by both. */
     return result;
 }
 
diff --git a/targets/TARGET_Cypress/TARGET_PSOC6/TARGET_CY8CKIT_062_WIFI_BT/cybsp.c b/targets/TARGET_Cypress/TARGET_PSOC6/TARGET_CY8CKIT_062_WIFI_BT/cybsp.c
@@ -43,18 +43,26 @@ cy_rslt_t cybsp_init(void)
     if (CY_RSLT_SUCCESS == result)
     {
         /* Initialize User LEDs */
+        /* Reserves: CYBSP_USER_LED1 */
         result |= cybsp_led_init(CYBSP_USER_LED1);
+        /* Reserves: CYBSP_USER_LED2 */
         result |= cybsp_led_init(CYBSP_USER_LED2);
+        /* Reserves: CYBSP_USER_LED3 */
         result |= cybsp_led_init(CYBSP_USER_LED3);
+        /* Reserves: CYBSP_USER_LED4 */
         result |= cybsp_led_init(CYBSP_USER_LED4);
+        /* Reserves: CYBSP_USER_LED5 */
         result |= cybsp_led_init(CYBSP_USER_LED5);
         /* Initialize User Buttons */
+        /* Reserves: CYBSP_USER_BTN1 */
         result |= cybsp_btn_init(CYBSP_USER_BTN1);
         CY_ASSERT(CY_RSLT_SUCCESS == result);
 
         /* Initialize retargetting stdio to 'DEBUG_UART' peripheral */
         if (CY_RSLT_SUCCESS == result)
         {
+           /* Reserves: CYBSP_DEBUG_UART_RX, CYBSP_DEBUG_UART_TX, corresponding SCB instance 
+            *    and one of available clock dividers */
             result = cybsp_retarget_init();
         }
     }
@@ -67,10 +75,15 @@ cy_rslt_t cybsp_init(void)
        when starting up WiFi. */
     if (CY_RSLT_SUCCESS == result)
     {
+       /* Reserves: CYBSP_WIFI_SDIO, CYBSP_WIFI_SDIO_D0, CYBSP_WIFI_SDIO_D1, CYBSP_WIFI_SDIO_D2, CYBSP_WIFI_SDIO_D3
+       *    CYBSP_WIFI_SDIO_CMD, CYBSP_WIFI_SDIO_CLK and CYBSP_WIFI_WL_REG_ON */
         result = cybsp_wifi_sdio_init();
     }
 #endif
 
+    /* CYHAL_HWMGR_RSLT_ERR_INUSE error code could be returned if any needed for BSP resource was reserved by
+    *   user previously. Please review the Device Configurator (design.modus) and the BSP reservation list 
+    *   (cyreservedresources.list) to make sure no resources are reserved by both. */
     return result;
 }
 
diff --git a/targets/TARGET_Cypress/TARGET_PSOC6/TARGET_CY8CMOD_062_4343W/TARGET_CY8CPROTO_062_4343W/cybsp.c b/targets/TARGET_Cypress/TARGET_PSOC6/TARGET_CY8CMOD_062_4343W/TARGET_CY8CPROTO_062_4343W/cybsp.c
@@ -42,14 +42,18 @@ cy_rslt_t cybsp_init(void)
     if (CY_RSLT_SUCCESS == result)
     {
         /* Initialize User LEDs */
+        /* Reserves: CYBSP_USER_LED1 */
         result |= cybsp_led_init(CYBSP_USER_LED1);
         /* Initialize User Buttons */
+        /* Reserves: CYBSP_USER_BTN1 */
         result |= cybsp_btn_init(CYBSP_USER_BTN1);
         CY_ASSERT(CY_RSLT_SUCCESS == result);
 
         /* Initialize retargetting stdio to 'DEBUG_UART' peripheral */
         if (CY_RSLT_SUCCESS == result)
         {
+            /* Reserves: CYBSP_DEBUG_UART_RX, CYBSP_DEBUG_UART_TX, corresponding SCB instance 
+            *    and one of available clock dividers */
             result = cybsp_retarget_init();
         }
     }
@@ -61,10 +65,15 @@ cy_rslt_t cybsp_init(void)
        when starting up WiFi. */
     if (CY_RSLT_SUCCESS == result)
     {
+       /* Reserves: CYBSP_WIFI_SDIO, CYBSP_WIFI_SDIO_D0, CYBSP_WIFI_SDIO_D1, CYBSP_WIFI_SDIO_D2, CYBSP_WIFI_SDIO_D3
+       *    CYBSP_WIFI_SDIO_CMD, CYBSP_WIFI_SDIO_CLK and CYBSP_WIFI_WL_REG_ON */
         result = cybsp_wifi_sdio_init();
     }
 #endif
 
+    /* CYHAL_HWMGR_RSLT_ERR_INUSE error code could be returned if any needed for BSP resource was reserved by
+    *   user previously. Please review the Device Configurator (design.modus) and the BSP reservation list 
+    *   (cyreservedresources.list) to make sure no resources are reserved by both. */
     return result;
 }
 
diff --git a/targets/TARGET_Cypress/TARGET_PSOC6/TARGET_CYW943012P6EVB_01/cybsp.c b/targets/TARGET_Cypress/TARGET_PSOC6/TARGET_CYW943012P6EVB_01/cybsp.c
@@ -42,17 +42,23 @@ cy_rslt_t cybsp_init(void)
     if (CY_RSLT_SUCCESS == result)
     {
         /* Initialize User LEDs */
+        /* Reserves: CYBSP_USER_LED1 */
         result |= cybsp_led_init(CYBSP_USER_LED1);
+        /* Reserves: CYBSP_USER_LED2 */
         result |= cybsp_led_init(CYBSP_USER_LED2);
+        /* Reserves: CYBSP_USER_LED3 */
         result |= cybsp_led_init(CYBSP_USER_LED3);
         /* Initialize User Buttons */
+        /* Reserves: CYBSP_USER_BTN1 */
         result |= cybsp_btn_init(CYBSP_USER_BTN1);
 
         CY_ASSERT(CY_RSLT_SUCCESS == result);
 
         /* Initialize retargetting stdio to 'DEBUG_UART' peripheral */
         if (CY_RSLT_SUCCESS == result)
         {
+           /* Reserves: CYBSP_DEBUG_UART_RX, CYBSP_DEBUG_UART_TX, corresponding SCB instance 
+           *    and one of available clock dividers */
             result = cybsp_retarget_init();
         }
     }
@@ -65,10 +71,15 @@ cy_rslt_t cybsp_init(void)
        when starting up WiFi. */
     if (CY_RSLT_SUCCESS == result)
     {
+       /* Reserves: CYBSP_WIFI_SDIO, CYBSP_WIFI_SDIO_D0, CYBSP_WIFI_SDIO_D1, CYBSP_WIFI_SDIO_D2, CYBSP_WIFI_SDIO_D3
+       *    CYBSP_WIFI_SDIO_CMD, CYBSP_WIFI_SDIO_CLK and CYBSP_WIFI_WL_REG_ON */
         result = cybsp_wifi_sdio_init();
     }
 #endif
 
+    /* CYHAL_HWMGR_RSLT_ERR_INUSE error code could be returned if any needed for BSP resource was reserved by
+    *   user previously. Please review the Device Configurator (design.modus) and the BSP reservation list 
+    *   (cyreservedresources.list) to make sure no resources are reserved by both. */
     return result;
 }
 

Original file line number	Diff line number	Diff line change
`@@ -43,18 +43,26 @@ cy_rslt_t cybsp_init(void)`
`43`	`43`	`if (CY_RSLT_SUCCESS == result)`
`44`	`44`	`{`
`45`	`45`	`/* Initialize User LEDs */`
	`46`	`+ /* Reserves: CYBSP_USER_LED1 */`
`46`	`47`	`result \|= cybsp_led_init(CYBSP_USER_LED1);`
	`48`	`+ /* Reserves: CYBSP_USER_LED2 */`
`47`	`49`	`result \|= cybsp_led_init(CYBSP_USER_LED2);`
	`50`	`+ /* Reserves: CYBSP_USER_LED3 */`
`48`	`51`	`result \|= cybsp_led_init(CYBSP_USER_LED3);`
	`52`	`+ /* Reserves: CYBSP_USER_LED4 */`
`49`	`53`	`result \|= cybsp_led_init(CYBSP_USER_LED4);`
	`54`	`+ /* Reserves: CYBSP_USER_LED5 */`
`50`	`55`	`result \|= cybsp_led_init(CYBSP_USER_LED5);`
`51`	`56`	`/* Initialize User Buttons */`
	`57`	`+ /* Reserves: CYBSP_USER_BTN1 */`
`52`	`58`	`result \|= cybsp_btn_init(CYBSP_USER_BTN1);`
`53`	`59`	`CY_ASSERT(CY_RSLT_SUCCESS == result);`
`54`	`60`
`55`	`61`	`/* Initialize retargetting stdio to 'DEBUG_UART' peripheral */`
`56`	`62`	`if (CY_RSLT_SUCCESS == result)`
`57`	`63`	`{`
	`64`	`+ /* Reserves: CYBSP_DEBUG_UART_RX, CYBSP_DEBUG_UART_TX, corresponding SCB instance`
	`65`	`+ * and one of available clock dividers */`
`58`	`66`	`result = cybsp_retarget_init();`
`59`	`67`	`}`
`60`	`68`	`}`
`@@ -67,10 +75,15 @@ cy_rslt_t cybsp_init(void)`
`67`	`75`	`when starting up WiFi. */`
`68`	`76`	`if (CY_RSLT_SUCCESS == result)`
`69`	`77`	`{`
	`78`	`+ /* Reserves: CYBSP_WIFI_SDIO, CYBSP_WIFI_SDIO_D0, CYBSP_WIFI_SDIO_D1, CYBSP_WIFI_SDIO_D2, CYBSP_WIFI_SDIO_D3`
	`79`	`+ * CYBSP_WIFI_SDIO_CMD, CYBSP_WIFI_SDIO_CLK and CYBSP_WIFI_WL_REG_ON */`
`70`	`80`	`result = cybsp_wifi_sdio_init();`
`71`	`81`	`}`
`72`	`82`	`#endif`
`73`	`83`
	`84`	`+ /* CYHAL_HWMGR_RSLT_ERR_INUSE error code could be returned if any needed for BSP resource was reserved by`
	`85`	`+ * user previously. Please review the Device Configurator (design.modus) and the BSP reservation list`
	`86`	`+ * (cyreservedresources.list) to make sure no resources are reserved by both. */`
`74`	`87`	`return result;`
`75`	`88`	`}`
`76`	`89`
Original file line number	Diff line number	Diff line change
`@@ -42,14 +42,18 @@ cy_rslt_t cybsp_init(void)`
`42`	`42`	`if (CY_RSLT_SUCCESS == result)`
`43`	`43`	`{`
`44`	`44`	`/* Initialize User LEDs */`
	`45`	`+ /* Reserves: CYBSP_USER_LED1 */`
`45`	`46`	`result \|= cybsp_led_init(CYBSP_USER_LED1);`
`46`	`47`	`/* Initialize User Buttons */`
	`48`	`+ /* Reserves: CYBSP_USER_BTN1 */`
`47`	`49`	`result \|= cybsp_btn_init(CYBSP_USER_BTN1);`
`48`	`50`	`CY_ASSERT(CY_RSLT_SUCCESS == result);`
`49`	`51`
`50`	`52`	`/* Initialize retargetting stdio to 'DEBUG_UART' peripheral */`
`51`	`53`	`if (CY_RSLT_SUCCESS == result)`
`52`	`54`	`{`
	`55`	`+ /* Reserves: CYBSP_DEBUG_UART_RX, CYBSP_DEBUG_UART_TX, corresponding SCB instance`
	`56`	`+ * and one of available clock dividers */`
`53`	`57`	`result = cybsp_retarget_init();`
`54`	`58`	`}`
`55`	`59`	`}`
`@@ -61,10 +65,15 @@ cy_rslt_t cybsp_init(void)`
`61`	`65`	`when starting up WiFi. */`
`62`	`66`	`if (CY_RSLT_SUCCESS == result)`
`63`	`67`	`{`
	`68`	`+ /* Reserves: CYBSP_WIFI_SDIO, CYBSP_WIFI_SDIO_D0, CYBSP_WIFI_SDIO_D1, CYBSP_WIFI_SDIO_D2, CYBSP_WIFI_SDIO_D3`
	`69`	`+ * CYBSP_WIFI_SDIO_CMD, CYBSP_WIFI_SDIO_CLK and CYBSP_WIFI_WL_REG_ON */`
`64`	`70`	`result = cybsp_wifi_sdio_init();`
`65`	`71`	`}`
`66`	`72`	`#endif`
`67`	`73`
	`74`	`+ /* CYHAL_HWMGR_RSLT_ERR_INUSE error code could be returned if any needed for BSP resource was reserved by`
	`75`	`+ * user previously. Please review the Device Configurator (design.modus) and the BSP reservation list`
	`76`	`+ * (cyreservedresources.list) to make sure no resources are reserved by both. */`
`68`	`77`	`return result;`
`69`	`78`	`}`
`70`	`79`
Original file line number	Diff line number	Diff line change
`@@ -42,17 +42,23 @@ cy_rslt_t cybsp_init(void)`
`42`	`42`	`if (CY_RSLT_SUCCESS == result)`
`43`	`43`	`{`
`44`	`44`	`/* Initialize User LEDs */`
	`45`	`+ /* Reserves: CYBSP_USER_LED1 */`
`45`	`46`	`result \|= cybsp_led_init(CYBSP_USER_LED1);`
	`47`	`+ /* Reserves: CYBSP_USER_LED2 */`
`46`	`48`	`result \|= cybsp_led_init(CYBSP_USER_LED2);`
	`49`	`+ /* Reserves: CYBSP_USER_LED3 */`
`47`	`50`	`result \|= cybsp_led_init(CYBSP_USER_LED3);`
`48`	`51`	`/* Initialize User Buttons */`
	`52`	`+ /* Reserves: CYBSP_USER_BTN1 */`
`49`	`53`	`result \|= cybsp_btn_init(CYBSP_USER_BTN1);`
`50`	`54`
`51`	`55`	`CY_ASSERT(CY_RSLT_SUCCESS == result);`
`52`	`56`
`53`	`57`	`/* Initialize retargetting stdio to 'DEBUG_UART' peripheral */`
`54`	`58`	`if (CY_RSLT_SUCCESS == result)`
`55`	`59`	`{`
	`60`	`+ /* Reserves: CYBSP_DEBUG_UART_RX, CYBSP_DEBUG_UART_TX, corresponding SCB instance`
	`61`	`+ * and one of available clock dividers */`
`56`	`62`	`result = cybsp_retarget_init();`
`57`	`63`	`}`
`58`	`64`	`}`
`@@ -65,10 +71,15 @@ cy_rslt_t cybsp_init(void)`
`65`	`71`	`when starting up WiFi. */`
`66`	`72`	`if (CY_RSLT_SUCCESS == result)`
`67`	`73`	`{`
	`74`	`+ /* Reserves: CYBSP_WIFI_SDIO, CYBSP_WIFI_SDIO_D0, CYBSP_WIFI_SDIO_D1, CYBSP_WIFI_SDIO_D2, CYBSP_WIFI_SDIO_D3`
	`75`	`+ * CYBSP_WIFI_SDIO_CMD, CYBSP_WIFI_SDIO_CLK and CYBSP_WIFI_WL_REG_ON */`
`68`	`76`	`result = cybsp_wifi_sdio_init();`
`69`	`77`	`}`
`70`	`78`	`#endif`
`71`	`79`
	`80`	`+ /* CYHAL_HWMGR_RSLT_ERR_INUSE error code could be returned if any needed for BSP resource was reserved by`
	`81`	`+ * user previously. Please review the Device Configurator (design.modus) and the BSP reservation list`
	`82`	`+ * (cyreservedresources.list) to make sure no resources are reserved by both. */`
`72`	`83`	`return result;`
`73`	`84`	`}`
`74`	`85`