background image

                                                                                                                                                                          Ameba-D Application Note 

 Application Note                                                                                                                  All information provided in this document is subject to legal disclaimers.                                                            © REALTEK 2020. All rights reserved.

 

km4_application - is (mp

3

km4_application - tz (mp) 

km4_secure 

km4_secure - tz 

km4_secure - tz (mp) 

Note: 

1.

 

The configuration items with “-is” are ignore secure configuration, which are designed for applications that do not use TrustZone. 

2.

 

The configuration items with “-tz” are TrustZone configuration, which are designed for applications that use TrustZone. 

3.

 

The configuration items with “mp” are mass production configuration, which are designed for generating MP image. 

 

 

For applications that do not use TrustZone, users should apply ignore secure configurations as Table 1-2 shows. The km4_secure project 
which contains Trustzone-protected code, is not used. 

 

For applications that use TrustZone, users should apply TrustZone configurations as Table 1-2 shows. 

Table 1-2 Configurations for project with/without TrustZone 

Project 

TrustZone 

Normal Image 

MP Image 

km4_bootloader 

km4_bootloader - is 

km4_bootloader - is 

km4_bootloader - tz 

km4_bootloader - tz 

km4_application 

km4_application - is 

km4_application - is (mp) 

km4_application - tz 

km4_application - tz (mp) 

km4_secure 

km4_secure - tz 

km4_secure - tz (mp) 

 
At the top of the Workspace window, there is a drop-down list where you can choose a build configuration for a specific project. 
 

Configuration 

drop-down menu

 

 

 

 

Fig 1-6 How to choose a build configuration 

1.3.2

 

IAR Build 

When building SDK for the first time, you should build both KM0 project and KM4 project. Other times, you only need to rebuild the modified 
project. 

1.3.2.1

 

Building KM0 Project 

The following steps show how to build KM0 project: 
(1)

 

Open 

project\realtek_amebaD_va0_example\EWARM-RELEASE\Project_lp_release.eww

(2)

 

Make sure km0_bootloader and km0_application are in Workspace. Click 

Project

 > 

Options

General Options

 > 

Target

 > 

Processor 

Variant

 > 

Core

, verify the CPU configurations according to Fig 1-7. 

(3)

 

Right click the project and choose “Rebuild All”, as Fig 1-8 shows. The km0_bootloader and km0_application should compile in order.

 

 

Summary of Contents for RTL8722DM

Page 1: ...formation provided in this document is subject to legal disclaimers REALTEK 2020 All rights reserved 1 RTL8722DM Build and Debug Environment Setup IAR This document illustrates how to build Realtek lo...

Page 2: ...com and a trail version is available for 30 days Note To support ARMv8 M with Security Extension Ameba D HS CPU also called KM4 IAR version must be 8 30 or higher 1 1 2 J Link or RLX Probe If you nee...

Page 3: ...are connected with module by IPEX 1 PCB Onboard Antenna 2 4G peak gain 4 1dbi 5G peak gain 3 9dbi 2 PIFA Antenna 2 4G peak gain 3 5dbi 5G peak gain 5dbi 3 Dipole Antenna 2 4G peak gain 3dbi 5G peak ga...

Page 4: ...spaces are provided to build for each core in project realtek_amebaD_va0_example EWARM RELEASE Project_lp_release eww KM0 workspace contains the following projects km0_bootloader km0_application Proje...

Page 5: ...ct with without TrustZone Project TrustZone Normal Image MP Image km4_bootloader N km4_bootloader is km4_bootloader is Y km4_bootloader tz km4_bootloader tz km4_application N km4_application is km4_ap...

Page 6: ...D Application Note Application Note All information provided in this document is subject to legal disclaimers REALTEK 2020 All rights reserved 6 Fig 1 7 KM0 processor options Fig 1 8 Building KM0 pro...

Page 7: ...the window would disappear automatically 4 After compile the images km0_boot_all bin and km0_image2_all bin can be seen in project realtek_amebaD_va0_example EWARM RELEASE Debug Exe km0_image 1 3 2 2...

Page 8: ...ject When TrustZone is not used there is no need to compile the km4_secure project After building each project IAR will pop up a command prompt window shown in the figure below to execute post build a...

Page 9: ...1 J Link cannot find KM4 As a result if the Flash memory is empty the sequence to download images is 1 Download for km0_bootloader and km0_application projects 2 Click Reset button on demo board to ma...

Page 10: ...ation Note Application Note All information provided in this document is subject to legal disclaimers REALTEK 2020 All rights reserved 10 Fig 1 12 Switching to the target project view Fig 1 13 J Link...

Page 11: ...d put correct value in TCP IP address or hostname as Fig 1 16 shows The value should be localhost port number KM4 The default port numbers is 3333 which is set in project realtek_amebaD_va0_example EW...

Page 12: ...l disclaimers REALTEK 2020 All rights reserved 12 Fig 1 16 RLX Probe interface setup Fig 1 17 RLX Probe window 4 Click Project Download Download active application image downloading starts When downlo...

Page 13: ...u can also erase all parts of the Flash memory if necessary Fig 1 19 Erasing Flash memory 1 3 4 IAR Debug You can debug or trace KM0 and KM4 system individually with J Link or RLX Probe SWD Note Consi...

Page 14: ...ebug without Downloading Download and Debug downloads the application and debug the project object file If necessary a make will be performed before download to ensure the project is up to date Debug...

Page 15: ...et project with IAR by RLX Probe 1 Set the target project as active project and verify the debugger configurations as step 1 and step 3 2 Click Project Attach to Running Target 3 Set the target addres...

Page 16: ...near the cursor in the source window The Toggle Breakpoint button is on the debug toolbar as Fig 1 21 shows 5 You can trace code step by step with Step Into or Go until triggering a breakpoint These...

Page 17: ...document is subject to legal disclaimers REALTEK 2020 All rights reserved 17 Fig 1 24 IAR debug or download error To avoid this error you should build manually before debug or download and disable aut...

Page 18: ...y there are some configurations to put some code into certain memory region In IAR workspace there are PSRAM and SRAM group The code in PSRAM group would be linked and loaded into PSRAM and the code i...

Page 19: ...or ignore secure project project realtek_amebaD_va0_example EWARM RELEASE rtl8721dhp_image2_tz icf for TrustZone project If having a good understand of the format of ICF users can modify the section l...

Page 20: ...ers in IAR project whose version is IAR 8 30 1 or higher You can refer to km4_application map to observe them after project build This file can be found in the following folders Project folder project...

Page 21: ...x17ad7 0x5dfc8 470K bytes memory in SRAM is used The total SRAM space is defined in project realtek_amebaD_va0_example EWARM RELEASE rtl8721d_memory_layout_is icf define symbol __ICFEDIT_region_HS_BD_...

Page 22: ...3 384968 5473 bytes Available heap 56096 bytes Totally free SRAM memory and heap 5473 56096 61569 bytes Totally free PSRAM memory 4 1024 1024 338 1024 A7 3848192 bytes 1 6 warning 1 6 1 Federal Commun...

Page 23: ...ule parts i e FCC transmitter rules listed on the grant and that the host product manufacturer is responsible for compliance to any other FCC rules that apply to the host not covered by the modular tr...

Page 24: ...odes r p titifs lorsque cela est requis par la technologie Le dispositif utilis dans la bande 5150 5250 MHz est r serv une utilisation en int rieur afin de r duire le risque de brouillage pr judiciabl...

Page 25: ...pour une utilisation dans un dispositif o l antenne peut tre install e de telle sorte qu une distance de 20cm peut tre maintenue entre l antenne et les utilisateurs Le produit final doit tre tiquet d...

Reviews: