Realtek RTL8710BN Manual




RTL8710BN

BuildandDebugEnvironmentSetup–IAR

ThisdocumentillustrateshowtobuildRealteklowpowerWi‐FisoftwareunderIARSDK
environment.

RTL8710BN
2017‐12‐262

TableofContents

1.Introduction .................................................................................................................................3
2.HowtogetIAR .............................................................................................................................3
3.Ameba‐ZHardwareConfiguration ...............................................................................................3
4.Howtobuildanddownloadcode ................................................................................................4
4.1IARbuild .................................................................................................................................4
4.2IARdownload .........................................................................................................................8
4.3IARdebug .............................................................................................................................10
5.Imagetooldownload .................................................................................................................13
6.Howtouseperipheralsamplecode ..........................................................................................14
7.Warning......................................................................................................................................15

.

RTL8710BN
2017‐12‐263

1.Introduction
ThisdocumentillustrateshowtobuildRealteklowpowerWi‐FisoftwareunderIARSDK
environment.
2.HowtogetIAR
IARprovidesanIDEenvironmentforcodebuilding,downloading,anddebugging.Pleasecheck
“IAREmbeddedWorkbench”onhttp://www.iar.com/,andtrailversionisavailable.
3.Ameba‐ZHardwareConfiguration
HardwareblockdiagramisshowninFigure3‐1Hardwareblockdiagram.TheblockUSBUARTis
usedtosupplypowerandcatchlogs,UARTbaudis115200.SWDmeansJ‐LinkSWDinterface,
whenitisconnectedtoJ‐LinkAdaptercorrectly,youcandownloadimagestoAmeba‐ZfromIAR
flashdownloader.ResetbuttonisusedtoresetAmeba‐ZtorunfirmwareafterIARcompletes
downloading.

Figure3‐1Hardwareblockdiagram
TheDupontLinediagrambetweenJ‐LinkAdapterandAmeba‐ZSWDisasfollows:

RTL8710BN
2017‐12‐264
3.3VGND
DATACLK
SWD

Figure3‐2J‐LinkSWDconnection
PleasenoticethatDAPchipisnotweldingontheAmeba‐ZdemoboardandsoDAPfunctionisnot
enabledwhichmeansMBEDudiskcopyisdisabled.
Physicalconnectionasshownbelow:

Figure3‐3Physicalconnection
4.Howtobuildanddownloadcode
PleasemakesureUSBUARTisconnectedtoPCwithUSBlineandSWDisconnecttoJ‐LinkAdapter
withDupontLinebeforedownloadcode.
4.1IARbuild
Step1:OpenIARWorkbench
Step2:Toopenproject,clickFileOpenWorkspace

RTL8710BN
2017‐12‐265

Step3:SelectProject.ewwinproject\realtek_amebaz_va0_example\EWARM‐RELEASE
ClickProjectOptions,GeneralOptions‐>Target‐>ProcessorVariant‐>Core,makesureyouhave
chosenCortex‐M4f.IfyourIARnotsupportthiscore,PleasechooseCortex‐M4andFloatingpoint
settings‐>FPUissetto“VFPv4singleprecision”.

Step4:Tobuildproject,clickProjectRebuildAll

RTL8710BN
2017‐12‐266
Thenyouwillgetboot_all.binandimage2_all_ota1.binin
project\realtek_amebaz_va0_example\EWARM‐RELEASE\Debug\Exe.

Step5:Tobuildimage2_all_ota2.binforOTA,clickProject‐>Options‐>BuildActions‐>BuildActions
Configuration‐>Pre‐buildcommandline,changethesecondaryparameter“1”to“2”shownas
follows,thenClickOKandmakeproject“RebuildAll”.
Thenyouwillgetimage2_all_ota2.bininproject\realtek_amebaz_va0_example\EWARM‐RELEASE
\Debug\Exe.

RTL8710BN
2017‐12‐267

Bytheway,thembedAPIsincludeCfilesandHeaderfilesusedbyAmeba‐Zislocatedin
component\soc\realtek\8711b\mbed\.Itwillalsobemergedtocomponent\common\mbed\in
nextversion.NowifyouuseAmeba‐1,pleasechoosefilesfromcomponent\common\mbed\andif
youuseAmeba‐Z,pleasechoosefilesfromcomponent\soc\realtek\8711b\mbed\.


RTL8710BN
2017‐12‐268
4.2IARdownload
TheAmeba‐ZdemoboardonlysupportsJLINKSWDdownloadanddebug.
PleasenotethatifyouwantuseIARdownloadimagetodebug,pleasesetthesecondary
parameterofprebuild.batto“1”andbuild.
Step1:PleasecheckJ‐linkdebuggerissettingcorrect.Click
Project‐>Options‐>Debugger‐>Setup‐>Driver,andchoose“J‐Link/J‐Trace”.ThenclickDebugger‐>
J‐Link/J‐Trace‐>Connection‐>Interfaceandchoose“SWD”.


RTL8710BN
2017‐12‐269

Step2:Todownloadcode,clickProject‐>Download‐>Downloadactiveapplication.

RTL8710BN
2017‐12‐2610

Afterfirmwaredownload,clickResetbuttontorebootthesystem.
4.3IARdebug
Todebugortracecodestepbystep,clickProjectDownloadandDebugorpressoneofthetwo
buttons  intheIARmenu.
Upperleftcornerofthetoolbarshowsstepbysteptrackingtools.