MediaTek LinkIt Development Platform for RTOS Memory Layout Developer's Guide

Transcription

1 MediaTek LinkIt Develpment Platfrm fr RTOS Memry Layut Develper's Guide Versin: 1.1 Release date: 31 March MediaTek Inc. MediaTek cannt grant yu permissin fr any material that is wned by third parties. Yu may nly use r reprduce this dcument if yu have agreed t and been bund by the applicable license agreement with MediaTek ( License Agreement ) and been granted explicit permissin within the License Agreement ( Permitted User ). If yu are nt a Permitted User, please cease any access r use f this dcument immediately. Any unauthrized use, reprductin r disclsure f this dcument in whle r in part is strictly prhibited. THIS DOCUMENT IS PROVIDED ON AN AS-IS BASIS ONLY. MEDIATEK EXPRESSLY DISCLAIMS ANY AND ALL WARRANTIES OF ANY KIND AND SHALL IN NO EVENT BE LIABLE FOR ANY CLAIMS RELATING TO OR ARISING OUT OF THIS DOCUMENT OR ANY USE OR INABILITY TO USE THEREOF. Specificatins cntained herein are subject t change withut ntice.

2 MediaTek LinkIt Develpment Dcument Revisin Histry Revisin Date Descriptin March 2016 Initial versin March 2016 Add MT2523x memry layut illustratin MediaTek Inc. Page i f iii

3 MediaTek LinkIt Develpment Table f cntents 1. Overview Memry Layut and Cnfiguratin fr MT76x Memry layut view Prgramming guide Memry layut adjustment with a linker script Memry layut adjustment with a scatter File Memry Layut and Cnfiguratin fr MT2523x Memry layut Prgramming guide Memry layut adjustment with a linker script Memry layut adjustment with a scatter file MediaTek Inc. Page ii f iii

4 Lists f tables and figures MediaTek LinkIt Develpment Table 1. Tips fr changing the memry layut f MT76x7 platfrm... 5 Figure 1. The lad view f the MT76x7 memry layut... 3 Figure 2. The executin view f the MT76x7 memry layut... 3 Figure 3. MT2523x virtual memry mapping... 7 Figure 4. Lad view f the MT2523x memry layut withut FOTA... 8 Figure 5. Executin view f the MT2523x memry layut withut FOTA... 9 Figure 6. Lad view f the MT2523x memry layut with full binary FOTA... 9 Figure 7. Executin view f the MT2523x memry layut with full binary FOTA MediaTek Inc. Page iii f iii

5 MediaTek LinkIt Develpment 1. Overview This dcument prvides details n the memry layut design and cnfiguratin f MediaTek LinkIt Develpment Platfrm fr real-time perating system (RTOS). The platfrm includes: MT76x7 chipsets: MT7687F, MT7697, and MT7697D. MT2523x chipsets: MT2523D, and MT2523G. Each memry layut has tw types f views, lad view and an executin view. The design cncept will be described based n the tw views: Lad view describes a memry regin and sectin f each image in terms f the address it is lcated at befre the image is prcessed. Executin view describes a memry regin and sectin f each image in terms f the address it is lcated at during the image executin. Different tlchains have different layut cnfiguratin files. The GCC tlchain uses a linker script; The ARMCC tlchain uses a scatter file. The memry layut cnfiguratin will be described separately fr each tlchain MediaTek Inc. Page 1 f 17

6 2. Memry Layut and Cnfiguratin fr MT76x7 MediaTek LinkIt Develpment The memry layut fr the MediaTek LinkIt Develpment Platfrm fr RTOS is based n the type f the memry available n the supprted SOCs. MT7687F is equipped with three types f memry strage: Serial Flash, SYSRAM and Tightly Cupled Memry (TCM). This dcument guides yu thrugh the details f the memry layut and its use Memry layut view Lad view MT7687F has 2MB internal serial flash memry. The lad view n the flash memry prvided by the platfrm is shwn in Figure 1. Btlader. The first 32kB f memry is allcated fr the btlader. The btlader binary is lcated at ut/<bard>/<prject>/. The btlader is nt cnfigurable. Nne Vlatile Data Management (NVDM) buffer. There are tw blcks reserved fr the NVDM buffer management. The first NVDM buffer after the Btlader (see Figure 1) is nt cnfigurable, but the secnd NVDM buffer is cnfigurable, see sectin 2.3, Memry layut adjustment with a linker script fr mre details. N9 RAM Cde. The N9 binary is lcated under ut/<bard>/<prject>/. The N9 RAM Cde is nt cnfigurable. ARM Crtex-M4 firmware. The applicatin binary is lcated under ut/<bard>/<prject>/. The ARM Crtex-M4 firmware is cnfigurable see sectin 2.3, Memry layut adjustment with a linker script fr mre details. FOTA buffer. Firmware update ver the air (FOTA) buffer is reserved fr FOTA memry management. The FOTA buffer is cnfigurable see sectin 2.3, Memry layut adjustment with a linker script fr mre details. Nte: Fr mre infrmatin abut FOTA, please refer t MediaTek LinkIt Develpment Platfrm fr RTOS Firmware Update lcated under SDK /dc flder MediaTek Inc. Page 2 f 17

7 MediaTek LinkIt Develpment Btlader NVDM buffer 32kB 12kB N9 RAM Cde 452kB 2MB Serial Flash ARM Crtex-M4 fireware 764kB FOTA buffer 764kB NVDM buffer 24kB Executin view Figure 1. The lad view f the MT76x7 memry layut Executin view describes where the cde and data are lcated during the prgram executin. The executin view is based n the Serial Flash, SYSRAM and TCM, as described belw: Serial Flash. The cde and read-nly (RO) data are lcated in the flash memry during runtime. SYSRAM. Vectr table, read-write (RW) data, zer initialized (ZI) data will be mved t SYSRAM during runtime. TCM. Sme special cde and ZI data can be placed int the TCM during runtime, see sectin 2.2, Prgramming fr mre details abut placing the cde and the data int the TCM. The detailed executin view f the memry layut is shwn in Figure 2. Btlader NVDM buffer Vectr table RW data 64kB TCM TCM cde TCM ZI data 2MB Serial Flash N9 RAM Cde ARM Crtex-M4 RTOS cde, RO data 256kB SYSRAM ZI data heap stack FOTA buffer NVDM buffer Figure 2. The executin view f the MT76x7 memry layut MediaTek Inc. Page 3 f 17

8 MediaTek LinkIt Develpment The size and address f the flash layut are nt cnfigurable. A user defined memry layut culd be created by mdifying r custmizing the flash layut with tw restrictins applied as fllws: Lad view: The btlader must be lcated at the beginning f the flash. Executin view: Vectr table must be lcated at the beginning f the SYSRAM Prgramming guide This prgramming guide is based n the memry layut described in sectin 2.1, Memry layut viewmemry layut. The fllwing recmmendatins allw the develpers t successfully place the cde t the desired memry lcatin during runtime. 1) Place the cde r the RO data t the Serial Flash at runtime. By default, the cde r the RO data is placed in the flash (XIP - Execute in Place). N need t mdify. 2) Place the cde r RO data t TCM at run time. T run the cde r access the data in the TCM with better perfrmance, specify the attribute explicitly in yur cde, as shwn in the example belw. //cde: The functin func will be put int TCM by linker. int func(int par) attribute ((sectin(".ramtext"))); r attribute ((sectin(".ramtext "))) int func(int par) { int s; s = par; //... } //r-data: The variable b will be put int TCM by linker. cnst int b attribute ((sectin(".ramtext "))) = 8; Fr cmparisn, if the attribute is nt explicitly defined, during the functin call the cde will be placed in the SYSRAM instead f the TCM. //cde: The functin func will NOT be put int TCM by linker. It will be put //int FLASH. int func(int par); r int func(int par) { int s; s = par; //... } //r-data: The variable b will NOT be placed int TCM by linker. It will be placed //int the SYSRAM. cnst int = 8; 3) Place ZI data t TCM at runtime. The cde belw declares an attribute t place the ZI data int the TCM. // zi-data: The variable b will be put int TCM by linker. int b attribute ((sectin(".tcmbss"))); MediaTek Inc. Page 4 f 17

9 MediaTek LinkIt Develpment Fr cmparisn, if the attribute is nt explicitly defined, during the functin call the ZI data will be placed in the SYSRAM instead f the TCM. // zi-data: The variable b will NOT be put int TCM by linker. It will be put //int SYSRAM. int b; 2.3. Memry layut adjustment with a linker script The memry layut can be cnfigured with different tlchains. When the cde is built based n the GCC tlchain, the memry layut descriptin file called a linker script is required. When the cde is built based n the ARMCC tlchain, the memry layut descriptin file called a scatter file is used. This sectin describes hw t use the linker script prvided by MediaTek and hw t cnfigure the linker script when building cde with GCC tlchain. The scatter file will be intrduced in see sectin 2.4.1, Adjusting the memry layut. The linker script is lcated under /prject/<bard>/apps/<prject>/gcc/. Each applicatin has its wn linker script and is based n the preferred memry layut Memry layut cnfiguratin By default, there is n need t mdify the linker script. T create a new memry layut, a new linker script shuld be written. The layut cnfiguratin infrmatin yu can use in the mdules is shwn in Table 1. Table 1. Tips fr changing the memry layut f MT76x7 platfrm Mdules Btlader N9 RAM ARM Crtex-M4 firmware FOTA buffer NVDM buffer Tips The starting address and size f the btlader are fixed and shuldn t be mdified. The starting address and size f the N9 RAM are fixed and shuldn t be mdified. The starting address f the ARM Crtex-M4 firmware is fixed, but the size is cnfigurable. The starting address and size f the FOTA buffer are cnfigurable. The first NVDM buffer lcated after the Btlader isn t cnfigurable and shuldn t be mdified. The secnd NVDM buffer starting address and size are cnfigurable (see Figure 1) Rules t adjust the memry layut Adjusting the layut fr ARM Crtex-M4 firmware If the FOTA feature is nt in use, yu can increase the size f the ARM Crtex-M4 firmware fr yur applicatin usage. The steps t increase the size f the ARM Crtex-M4 firmware are shwn belw: 1) Mdify the XIP_CODE length in the MT76x7_flash.ld. MEMORY { MediaTek Inc. Page 5 f 17

10 MediaTek LinkIt Develpment XIP_CODE (arx) : ORIGIN = 0x1007C000, LENGTH = 0x000BF } 2) Mdify the macr definitin FLASH_CM4_XIP_CODE_SIZE in prject\<bard>\apps\<applicatin>\inc\flash_map.h. 3) Rebuild the btlader and the ARM Crtex-M4 firmware Adjusting the FOTA buffer size The steps t adjust the FOTA buffer are shwn belw: 1) Mdify the size f the ARM Crtex-M4 firmware if necessary, see sectin , Adjusting the layut fr ARM Crtex-M4 firmware. 2) Mdify the macr definitin fr FOTA buffer size FLASH_TMP_SIZE in prject\<bard>\apps\<applicatin>\inc\flash_map.h. Nte: Fr mre infrmatin abut FOTA buffer, please refer t MediaTek LinkIt Develpment Platfrm fr RTOS Firmware Update lcated under the SDK /dc flder Adjusting the NVDM buffer size The steps t adjust NVDM buffer size are shwn belw; 1) Mdify size f the ARM Crtex-M4 firmware if necessary. Please see sectin , Adjusting the layut fr ARM Crtex-M4 firmware. 2) Mdify FOTA buffer size if necessary. Please see sectin , Adjusting the FOTA buffer size. 3) Mdify the macr definitin fr the NVDM buffer size FLASH_USR_CONF_SIZE in the prject\<bard>\apps\<applicatin>\inc\flash_map.h. This macr represents the NVDM buffer size. Fr mre details, please refer t the NVDM mdule f HAL in the MediaTek LinkIt Develpment Platfrm fr RTOS API reference Memry layut adjustment with a scatter File The scatter file is lcated under /prject/<bard>/apps/<prject>/mdk-arm/. Each applicatin has its wn scatter file and each scatter file can have different memry layut based n the specific applicatin, see sectin 2.3, Memry layut adjustment with a linker scriptmemry layut adjustment with a linker script fr a difference between the linker script and the scatter file Adjusting the memry layut By default, there is n need t mdify the scatter file. T create a new memry layut, a new scatter files shuld be written. Fr mre infrmatin abut writing a scatter file, please refer t chapter 5 f the RealView Cmpilatin Tls, Linker and Utilities Guide. Fr mre details abut hw t adjust the memry layut, see sectin 2.3.2, Rules t adjust the memry layut MediaTek Inc. Page 6 f 17

11 3. Memry Layut and Cnfiguratin fr MT2523x MediaTek LinkIt Develpment The MT2523x chipsets supprt three types f physical memry, Serial Flash, Pseud Static Randm Access Memry (PSRAM) and Tightly Cupled Memry (TCM). The memry layuts are designed based n the three types f memry. The virtual memry n the MT2523x is prvided fr cacheable memry and is implemented based n the memry mapping mechanism f ARM Crtex-M4. The virtual address range frm 0x t 0x is mapped t the PSRAM address range frm 0x t 0x , as shwn in Figure 3. The virtual memry regin (0x ~ 0x ) is used as cacheable memry. All read-write (RW) data is stred in this regin by default. Figure 3. MT2523x virtual memry mapping Nte, that the address 0x desn t limit the PSRAM size t 64MB. It nly specifies the maximum range f the PSRAM regin supprted by the LinkIt 2523 HDK. The memry layut can be defined with the firmware update ver the air (FOTA) and withut FOTA. Each f the layuts has tw views described abve. This sectin guides yu thrugh: Types f the memry layut. Prgramming guide. Memry Layut Adjustment with a Linker Script Scatter File MediaTek Inc. Page 7 f 17

12 3.1. Memry layut MediaTek LinkIt Develpment Memry layut withut FOTA Lad view MT2523x has 4MB internal serial flash memry. The lad view n the flash memry with disabled FOTA is shwn in Figure 4. Btlader. The btlader binary is always lcated at the very beginning f the flash memry. The size f the btlader is nt cnfigurable and is fixed t 64kB size. ARM Crtex-M4 firmware. This sectin f the memry is reserved fr the RTOS binary. The end f the flash is a reserved buffer fr Nne Vlatile Data Management (NVDM) buffer and Extended Predictin Orbit (EPO) buffer. Fr mre infrmatin abut the EPO, please refer t MediaTek LinkIt Develpment Platfrm fr RTOS GNSS Develpers Guide under SDK/dc flder. The size f the NVDM is cnfigurable, but the size f the EPO buffer is nt cnfigurable. The start address and the maximum size f each binary and reserved buffer are cnfigurable, see sectin 3.3, Memry layut adjustment with a linker script fr mre details. Figure 4. Lad view f the MT2523x memry layut withut FOTA Fr mre infrmatin abut FOTA, NVDM and EPO, please refer t MediaTek LinkIt Develpment Platfrm fr RTOS Firmware Update lcated under SDK/dc flder fr FOTA, refer t NVDM at MediaTek LinkIt Develpment Platfrm fr RTOS API reference and refer t the MediaTek LinkIt Develpment Platfrm fr RTOS GNSS Develpers Guide under SDK/dc flder fr mre infrmatin n the EPO Executin view Executin view describes where the cde and data are lcated during the prgram runtime, as shwn in Figure 5. The executin view is based n the Serial Flash, PSRAM and TCM, as described belw: Serial Flash. The cde and read-nly (RO) data are lcated in the flash memry during runtime. PSRAM. Vectr table, single bank cde, and sme high-perfrmance cde and data are stred at the beginning f PSRAM. Nn-cacheable read-write (RW) data and zer-initialized (ZI) data MediaTek Inc. Page 8 f 17

13 Cacheable RW data and ZI data. MediaTek LinkIt Develpment TCM. Sme critical and high-perfrmance cde r data can be stred int the TCM. See sectin 3.2, Prgramming guide t learn hw t put cde r data t the TCM. Cde and RO data. RW data and ZI data. The system stack. Figure 5. Executin view f the MT2523x memry layut withut FOTA Memry layut f FOTA full binary update Lad view If FOTA is enabled, the memry flash layut s lad view is, as shwn in Figure 6. A FOTA buffer is added fr temprary strage f the binary that will be used t update the current ARM Crtex-M4 firmware. The start address and maximum size f each binary and the reserved space f certain memry layuts are cnfigurable, see sectin 3.3, Memry layut adjustment with a linker script fr mre details. T enable FOTA, please refer t the MediaTek LinkIt Develpment Platfrm fr RTOS Firmware Update lcated under the SDK /dc flder Executin view Figure 6. Lad view f the MT2523x memry layut with full binary FOTA The executin view (see Figure 7) at runtime is described belw MediaTek Inc. Page 9 f 17

14 MediaTek LinkIt Develpment Serial Flash. The cde and RO data are lcated in the flash memry during runtime. PSRAM. Vectr table, single bank cde, and sme high-perfrmance cde and data are stred at the beginning f the PSRAM. Nn-cacheable RW data. Cacheable RW data. TCM. Sme critical and high-perfrmance cde and data can be stred in the TCM. See sectin 3.2, Prgramming guide t learn hw t put cde r data t the TCM. Cde and RO data. RW data, ZI data. The system stack. Figure 7. Executin view f the MT2523x memry layut with full binary FOTA 3.2. Prgramming guide This prgramming guide is based n the memry layut described in see sectin 3.1, Memry layut. The fllwing recmmendatins allw the develpers t successfully place the cde t the desired memry lcatin during runtime. 1) Place the cde r RO data t the Serial Flash at runtime. By default, the cde r RO data is placed in the flash, execute in place (XIP). N need t mdify. 2) Place the cde r RO data t the PSRAM at runtime. T run the cde r access RO data in the PSRAM with better perfrmance, specify the attribute explicitly in yur cde, as shwn in the example belw. //cde int func(int par) attribute ((sectin(".ram_cde"))); r attribute ((sectin(".ram_cde"))) int func(int par) { int s; MediaTek Inc. Page 10 f 17

15 s = par; //... } //RO data cnst int b attribute ((sectin(".ram_rdata"))) = 8; MediaTek LinkIt Develpment Fr cmparisn, if the attribute is nt explicitly defined, during the functin call the cde will be placed in the Serial Flash instead f the PSRAM. //cde int func(int par); r int func(int par) { int s; s = par; //... } //RO data cnst int b = 8; 3) Place RW data r ZI data t nn-cacheable memry at runtime. T access RW data and ZI data in the nn-cacheable memry with special purpse such as direct memry access (DMA) buffer, specify the attribute explicitly in yur cde, as shwn in the example belw. //RW data int b attribute ((sectin(".nncached_rwdata"))) = 8; //ZI data int b attribute ((sectin(".nncached_zidata"))); Fr cmparisn, if the attribute is nt explicitly defined, the data will be placed in the cacheable memry instead f the nn-cacheable memry. //RW data int b = 8; //ZI data int b; 4) Place RW data r ZI data t cacheable memry at runtime. By default, RW data/zi data are placed in the cacheable memry. N need t mdify. 5) Place cde r RO data t the TCM at runtime. T run the cde r access RO data in the TCM with better perfrmance, specify the attribute explicitly in yur cde, as shwn in the example belw. //cde int func(int par) attribute ((sectin(".tcm_cde"))); r attribute ((sectin(".tcm_cde"))) int func(int par) { int s; s = par; //... } //RO data MediaTek Inc. Page 11 f 17

16 MediaTek LinkIt Develpment cnst int b attribute ((sectin(".tcm_rdata"))) = 8; Fr cmparisn, if the attribute is nt explicitly defined, during the functin call the cde will be placed in the Serial Flash instead f the TCM. //cde int func(int par); r int func(int par) { int s; s = par; //... } //RO data cnst int b = 8; 6) Put RW data/zi data t TCM at runtime. T access RW data and ZI data in the TCM with better perfrmance, yu shuld specify the attribute explicitly in yur cde, as shwn in the example belw. //rw-data int b attribute ((sectin(".tcm_rwdata"))) = 8; //zi-data int b attribute ((sectin(".tcm_zidata"))); Fr cmparisn, if the attribute is nt explicitly defined, the data will be placed in the PSRAM instead f the TCM. //RW data int b = 8; //ZI data int b; 3.3. Memry layut adjustment with a linker script The memry layut can be cnfigured with different tlchains. When the cde is built based n the GCC tlchain, the memry layut descriptin file called a linker script is required. When the cde is built based n ARMCC tlchain, the memry layut descriptin file called a scatter file is used. This sectin describes hw t use the linker script prvided by MediaTek and hw t cnfigure the linker script when building cde with the GCC tlchain. The scatter file will be intrduced in see sectin 3.4, Memry layut adjustment with a scatter file Types f linker scripts Tw kinds f linker scripts are prvided: Template linker script every applicatin linker script shuld be based n the template linker script. Applicatin linker script every applicatin has its particular linker script. This linker script is passed t the linker during linking stage Template linker script Template linker scripts are based n the memry layut see sectin 3.1, Memry layut. If the memry layut is mdified, the linker script shuld als be mdified manually. It s recmmended t use the layut and linker scripts prvided by MediaTek as a reference fr yur custmizatins MediaTek Inc. Page 12 f 17

17 MediaTek LinkIt Develpment The template linker scripts are lcated under /driver/cmsis/device/mtk/<chip>/linkerscript/gcc/ flder. The flder includes: default. This flder cntains a template linker script t build a prject withut FOTA memry layut, see sectin 3.1.1, Memry layut withut FOTA. full_bin_fta. This flder cntains a template linker script t build a prject with full binary FOTA memry layut, see sectin 3.1.2, Memry layut f FOTA full binary update ram. This flder cntains a template linker script t enable RAM debugging. T place all yur cde int PSRAM, use this linker script as a reference Applicatin linker script The applicatin linker script is lcated under /prject/<bard>/apps/<prject>/gcc/ flder. Each applicatin has its wn linker script and each linker script can have a different memry layut cnfiguratin based n the applicatin requirements Hw t use the linker script T create a new linker script file fr yur applicatin: Clne a linker script frm the template flder. Create a new linker script manually. The memry layut in this case shuld als be user-defined t match yur linker script Clning the linker script T clne a linker script frm the template: Specify the memry layut feature fr yur applicatin develpment, such as withut FOTA, full binary FOTA see sectin 3.1, Memry layut. Cpy the template linker script frm template flder t yur applicatin prject s flder, see sectin 3.3.1, Types f linker scripts. Memry layut withut FOTA. Cpy /driver/cmsis/device/mtk/<chip>/linkerscript/gcc/default t /prject/<bard>/apps/<prject>/gcc/. Memry layut with FOTA full binary update. Cpy /driver/cmsis/device/mtk/<chip>/linkerscript/gcc/full_bin_fta t /prject/<bard>/apps/<prject>/gcc/. Memry layut with RAM debugging. Cpy /driver/cmsis/device/mtk/<chip>/linkerscript/gcc/ram t /prject/<bard>/apps/<prject>/gcc/. Mdify the linker script accrding t the applicatin requirements MediaTek Inc. Page 13 f 17

18 Rules t adjust the memry layut MediaTek LinkIt Develpment The memry layut can be custmized t fit the applicatin requirements. Hwever, the btlader and EPO buffer is nt cnfigurable. The rest f the memry layut can be adjusted as fllws. Cmmn rules fr different memry layut adjustment settings are described belw. 1) The address and size must be blck aligned. The default blck size is 4kB and is defined in driver/chip/<chip>/inc/flash_pt_gen.h header file. 2) T cnfigure the size r the address, make sure there is n verlap between tw adjacent memry regins. The ttal size f all the regins shuld nt exceed the physical flash size Adjusting the layut fr ARM Crtex-M4 firmware T adjust the memry assigned t ARM Crtex-M4 firmware: 4) Mdify the ROM_RTOS length and starting address in the flash.ld linker script under the GCC flder f the prject. MEMORY {... ROM_RTOS(rx)... } : ORIGIN = 0x , LENGTH = 3072K 5) Mdify the macr definitins fr RTOS_BASE and RTOS_LENGTH in prject\<bard>\apps\<applicatin>\inc\memry_map.h header file. 6) Rebuild the btlader and the ARM Crtex-M4 firmware. Execute the fllwing cmmand under the rt flder f the SDK../build.sh prject_bard example_name BL The prject_bard is the prject flder f a specific hardware bard and example_name is the name f the example. Fr example, t build the hal_adc f mt2523_hdk, the cmmand will be:./build.sh mt2523_hdk hal_adc BL 7) Make sure all the ROM regins length desn t exceed the flash size f the system and fr MT2523 the internal flash is 4MB Adjusting the memry layut with FOTA full binary update 1) Mdify ARM Crtex-M4 firmware size if needed see sectin , Adjusting the layut fr ARM Crtex- M4 firmware. 2) Mdify the ROM_FOTA_RESERVED length and starting address in the flash.ld linker script under the GCC flder f a prject. MEMORY { MediaTek Inc. Page 14 f 17

19 MediaTek LinkIt Develpment ROM_FOTA_RESERVED(rx) : ORIGIN = 0x , LENGTH = 1920K... } 3) Mdify the macr definitins fr FOTA_RESERVED_BASE and FOTA_RESERVED_LENGTH in prject\<bard>\apps\<applicatin>\inc\memry_map.h header file. Nte, refer t the SDK Firmware Upgrade Develper s Guide lcated under SDK /dc flder fr mre details abut hw t adjust the FOTA buffer Adjusting the NVDM buffer T adjust the NVDM buffer layut: 1) Mdify size f the ARM Crtex-M4 firmware if needed see sectin , Adjusting the layut fr ARM Crtex-M4 firmware. 2) Mdify FOTA buffer size if needed see sectin , Adjusting the memry layut with FOTA full binary update. 3) Mdify the ROM_NVDM_RESERVED length and starting address in the flash.ld if n FOTA r full binary FOTA feature is enabled MEMORY {... ROM_NVDM_RESERVED(rx) : ORIGIN = 0x083E0000, LENGTH = 64K... } 4) Mdify the macr definitins fr ROM_NVDM_BASE, ROM_NVDM_LENGTH in prject\<bard>\apps\<applicatin>\inc\memry_map.h header file. Nte, t adjust the NVDM buffer, please refer t the NVDM mdule f HAL in the MediaTek LinkIt develpment platfrm fr RTOS API reference Memry layut adjustment with a scatter file Types f scatter files Tw types f scatter files are prvided: Template scatter file every applicatin scatter file shuld be based n the template scatter file. Applicatin scatter file every applicatin has its particular scatter file. This scatter file will be passed t the linker during linking stage Template scatter file Template scatter files are based n the memry layut, see sectin 3.1, Memry layut. If yu ve changed the memry layut, yu shuld als mdify the scatter file manually. It s recmmended t use the layut and scatter files prvided by MediaTek as a reference fr yur custmizatins MediaTek Inc. Page 15 f 17

20 MediaTek LinkIt Develpment The template scatter files are lcated under /driver/cmsis/device/mtk/<chip>/linkerscript/rvct/ flder. The flder includes: default. This flder cntains a template scatter file t build a prject withut FOTA memry layut, see sectin 3.1.1, Memry layut withut FOTA. full_bin_fta. This flder cntains a template scatter file t build a prject with full binary FOTA memry layut, see sectin 3.1.2, Memry layut f FOTA full binary update ram. This flder cntains a template scatter file t enable RAM debugging. T place all yur cde int PSRAM, yu can use this scatter file as a reference Applicatin scatter file The applicatin scatter file is lcated under /prject/<bard>/apps/<prject>/mdk-arm/ flder. Each applicatin has its wn scatter file and each scatter file can have a different memry layut cnfiguratin based n the applicatin requirements Hw t use the scatter file T create a new scatter file fr yur applicatin: Clne a scatter file frm the MDK-ARM flder f the template flder. Create a new scatter file manually. The memry layut in this case shuld als be user-defined t match yur scatter file Clning the scatter file T clne a scatter file frm the template: Specify the memry layut feature fr yur applicatin develpment, such as withut FOTA, full binary FOTA see sectin 3.1, Memry layut. Cpy the template scatter file frm template flder t yur applicatin prject s flder, see sectin 3.4.1, Types f scatter files. Memry layut withut FOTA. Cpy /driver/cmsis/device/mtk/<chip>/linkerscript/rvct/default t /prject/<bard>/apps/<prject>/mdk-arm/. Memry layut with FOTA full binary update. Cpy /driver/cmsis/device/mtk/<chip>/linkerscript/rvct/full_bin_fta t /prject/<bard>/apps/<prject>/mdk-arm/. Memry layut with RAM debugging. Cpy /driver/cmsis/device/mtk/<chip>/linkerscript/rvct/ram t /prject/<bard>/apps/<prject>/mdk-arm/. Mdify the scatter file accrding t the applicatin requirements MediaTek Inc. Page 16 f 17

21 Hw t cnfigure the scatter file MediaTek LinkIt Develpment The cnfiguratin is the same; see sectin 3.3.3, Rules t adjust the memry layut MediaTek Inc. Page 17 f 17