Adding documentation for MBED_APP_START and MBED_APP_SIZE in TARGET_CY8C62XX and TARGET_CY8CKIT_062_BLE linker scripts

Yossi Levy · Yossi Levy · commit 0a5b355d9c70 · 2019-03-14T14:26:23.000+02:00
diff --git a/targets/TARGET_Cypress/TARGET_PSOC6/TARGET_CY8C62XX/TARGET_MCU_PSOC6_M4/device/TOOLCHAIN_ARM_STD/cy8c6xx7_cm4_dual.sct b/targets/TARGET_Cypress/TARGET_PSOC6/TARGET_CY8C62XX/TARGET_MCU_PSOC6_M4/device/TOOLCHAIN_ARM_STD/cy8c6xx7_cm4_dual.sct
@@ -46,6 +46,10 @@
   #define MBED_ROM_START    0x10002000
 #endif
 
+;* MBED_APP_START is being  used by the bootloader build script and 
+;* will be calculate by the system. Without bootloader the MBED_APP_START 
+;* is equal to MBED_ROM_START 
+;* 
 #if !defined(MBED_APP_START)
   #define MBED_APP_START    MBED_ROM_START
 #endif
@@ -54,6 +58,10 @@
   #define MBED_ROM_SIZE     0x000FE000
 #endif
 
+;* MBED_APP_SIZE is being  used by the bootloader build script and 
+;* will be calculate by the system. Without bootloader the MBED_APP_SIZE 
+;* is equal to MBED_ROM_SIZE 
+;* 
 #if !defined(MBED_APP_SIZE)
   #define MBED_APP_SIZE     MBED_ROM_SIZE
 #endif
diff --git a/targets/TARGET_Cypress/TARGET_PSOC6/TARGET_CY8C62XX/TARGET_MCU_PSOC6_M4/device/TOOLCHAIN_GCC_ARM/cy8c6xx7_cm4_dual.ld b/targets/TARGET_Cypress/TARGET_PSOC6/TARGET_CY8C62XX/TARGET_MCU_PSOC6_M4/device/TOOLCHAIN_GCC_ARM/cy8c6xx7_cm4_dual.ld
@@ -44,6 +44,10 @@ ENTRY(Reset_Handler)
   #define MBED_ROM_START    0x10002000
 #endif
 
+/* MBED_APP_START is being  used by the bootloader build script and 
+* will be calculate by the system. Without bootloader the MBED_APP_START 
+* is equal to MBED_ROM_START 
+*/ 
 #if !defined(MBED_APP_START)
   #define MBED_APP_START    MBED_ROM_START 
 #endif
@@ -52,6 +56,10 @@ ENTRY(Reset_Handler)
   #define MBED_ROM_SIZE     0x000FE000
 #endif
 
+/* MBED_APP_SIZE is being  used by the bootloader build script and 
+* will be calculate by the system. Without bootloader the MBED_APP_SIZE 
+* is equal to MBED_ROM_SIZE 
+*/ 
 #if !defined(MBED_APP_SIZE)
   #define MBED_APP_SIZE     MBED_ROM_SIZE
 #endif
diff --git a/targets/TARGET_Cypress/TARGET_PSOC6/TARGET_CY8C62XX/TARGET_MCU_PSOC6_M4/device/TOOLCHAIN_IAR/cy8c6xx7_cm4_dual.icf b/targets/TARGET_Cypress/TARGET_PSOC6/TARGET_CY8C62XX/TARGET_MCU_PSOC6_M4/device/TOOLCHAIN_IAR/cy8c6xx7_cm4_dual.icf
@@ -45,6 +45,10 @@ if (!isdefinedsymbol(MBED_ROM_START)) {
   define symbol MBED_ROM_START = 0x10002000;
 }
 
+/* MBED_APP_START is being  used by the bootloader build script and 
+ * will be calculate by the system. Without bootloader the MBED_APP_START 
+ * is equal to MBED_ROM_START 
+ */ 
 if (!isdefinedsymbol(MBED_APP_START)) {
   define symbol MBED_APP_START = MBED_ROM_START;
 }
@@ -53,6 +57,10 @@ if (!isdefinedsymbol(MBED_ROM_SIZE)) {
   define symbol MBED_ROM_SIZE = 0x000FE000;
 }
 
+/* MBED_APP_SIZE is being  used by the bootloader build script and 
+ * will be calculate by the system. Without bootloader the MBED_APP_SIZE 
+ * is equal to MBED_ROM_SIZE 
+ */ 
 if (!isdefinedsymbol(MBED_APP_SIZE)) {
   define symbol MBED_APP_SIZE = MBED_ROM_SIZE;
 }
diff --git a/targets/TARGET_Cypress/TARGET_PSOC6/TARGET_CY8CKIT_062_BLE/device/TOOLCHAIN_ARM_STD/cy8c6xx7_cm4_dual.sct b/targets/TARGET_Cypress/TARGET_PSOC6/TARGET_CY8CKIT_062_BLE/device/TOOLCHAIN_ARM_STD/cy8c6xx7_cm4_dual.sct
@@ -46,15 +46,22 @@
   #define MBED_ROM_START    0x10002000
 #endif
 
+;* MBED_APP_START is being  used by the bootloader build script and 
+;* will be calculate by the system. Without bootloader the MBED_APP_START 
+;* is equal to MBED_ROM_START 
+;* 
 #if !defined(MBED_APP_START)
   #define MBED_APP_START MBED_ROM_START
 #endif
 
-
 #if !defined(MBED_ROM_SIZE)
   #define MBED_ROM_SIZE     0x000FE000
 #endif
 
+;* MBED_APP_SIZE is being  used by the bootloader build script and 
+;* will be calculate by the system. Without bootloader the MBED_APP_SIZE 
+;* is equal to MBED_ROM_SIZE 
+;* 
 #if !defined(MBED_APP_SIZE)
   #define MBED_APP_SIZE MBED_ROM_SIZE
 #endif
diff --git a/targets/TARGET_Cypress/TARGET_PSOC6/TARGET_CY8CKIT_062_BLE/device/TOOLCHAIN_GCC_ARM/cy8c6xx7_cm4_dual.ld b/targets/TARGET_Cypress/TARGET_PSOC6/TARGET_CY8CKIT_062_BLE/device/TOOLCHAIN_GCC_ARM/cy8c6xx7_cm4_dual.ld
@@ -44,6 +44,10 @@ ENTRY(Reset_Handler)
   #define MBED_ROM_START    0x10002000
 #endif
 
+/* MBED_APP_START is being  used by the bootloader build script and 
+* will be calculate by the system. Without bootloader the MBED_APP_START 
+* is equal to MBED_ROM_START 
+*/ 
 #if !defined(MBED_APP_START)
   #define MBED_APP_START MBED_ROM_START
 #endif
@@ -52,6 +56,10 @@ ENTRY(Reset_Handler)
   #define MBED_ROM_SIZE     0x000FE000
 #endif
 
+/* MBED_APP_SIZE is being  used by the bootloader build script and 
+* will be calculate by the system. Without bootloader the MBED_APP_SIZE 
+* is equal to MBED_ROM_SIZE 
+*/ 
 #if !defined(MBED_APP_SIZE)
   #define MBED_APP_SIZE MBED_ROM_SIZE
 #endif
diff --git a/targets/TARGET_Cypress/TARGET_PSOC6/TARGET_CY8CKIT_062_BLE/device/TOOLCHAIN_IAR/cy8c6xx7_cm4_dual.icf b/targets/TARGET_Cypress/TARGET_PSOC6/TARGET_CY8CKIT_062_BLE/device/TOOLCHAIN_IAR/cy8c6xx7_cm4_dual.icf
@@ -45,6 +45,10 @@ if (!isdefinedsymbol(MBED_ROM_START)) {
   define symbol MBED_ROM_START = 0x10002000;
 }
 
+/* MBED_APP_START is being  used by the bootloader build script and 
+ * will be calculate by the system. Without bootloader the MBED_APP_START 
+ * is equal to MBED_ROM_START 
+ */ 
 if (!isdefinedsymbol(MBED_APP_START)) {
   define symbol MBED_APP_START = MBED_ROM_START;
 }
@@ -53,6 +57,10 @@ if (!isdefinedsymbol(MBED_ROM_SIZE)) {
   define symbol MBED_ROM_SIZE = 0x000FE000;
 }
 
+/* MBED_APP_SIZE is being  used by the bootloader build script and 
+ * will be calculate by the system. Without bootloader the MBED_APP_SIZE 
+ * is equal to MBED_ROM_SIZE 
+ */ 
 if (!isdefinedsymbol(MBED_APP_SIZE)) {
   define symbol MBED_APP_SIZE = MBED_ROM_SIZE;
 }

Original file line number	Diff line number	Diff line change
`@@ -45,6 +45,10 @@ if (!isdefinedsymbol(MBED_ROM_START)) {`
`45`	`45`	`define symbol MBED_ROM_START = 0x10002000;`
`46`	`46`	`}`
`47`	`47`
	`48`	`+/* MBED_APP_START is being used by the bootloader build script and`
	`49`	`+ * will be calculate by the system. Without bootloader the MBED_APP_START`
	`50`	`+ * is equal to MBED_ROM_START`
	`51`	`+ */`
`48`	`52`	`if (!isdefinedsymbol(MBED_APP_START)) {`
`49`	`53`	`define symbol MBED_APP_START = MBED_ROM_START;`
`50`	`54`	`}`
`@@ -53,6 +57,10 @@ if (!isdefinedsymbol(MBED_ROM_SIZE)) {`
`53`	`57`	`define symbol MBED_ROM_SIZE = 0x000FE000;`
`54`	`58`	`}`
`55`	`59`
	`60`	`+/* MBED_APP_SIZE is being used by the bootloader build script and`
	`61`	`+ * will be calculate by the system. Without bootloader the MBED_APP_SIZE`
	`62`	`+ * is equal to MBED_ROM_SIZE`
	`63`	`+ */`
`56`	`64`	`if (!isdefinedsymbol(MBED_APP_SIZE)) {`
`57`	`65`	`define symbol MBED_APP_SIZE = MBED_ROM_SIZE;`
`58`	`66`	`}`