Figurewww.165aa.com

RF-IB-RS02AAwww.
szrfstar.
comV1.
0-Jul.
,2020ShenzhenRF-starTechnologyCo.
,Ltd.
Page1of16RF-IB-RS02AABLEBeaconUserGuideVersion1.
0ShenzhenRF-starTechnologyCo.
,Ltd.
July15th,2020RF-IB-RS02AAwww.
szrfstar.
comV1.
0-Jul.
,2020ShenzhenRF-starTechnologyCo.
,Ltd.
Page2of16TableofContentsTableofContents.
21DeviceOverview.
32BeaconParameters.
43ParametersConfiguration54BLEProtocolSpecification(APPInterface)6ServiceUUID6EnterAnti-hijackingKeyUUID6ATCommandOperationUUID.
65ATCommands7ATCommandList.
7DeviceName.
8BroadcastParameter.
8WorkingMode.
9BeaconParameters.
9EddystoneParameters.
10TXPower.
12UserAuthentication13FirmwareVersionNumber.
14RestoreFactorySettings.
146RevisionHistory157ContactUs.
16RF-IB-RS02AAwww.
szrfstar.
comV1.
0-Jul.
,2020ShenzhenRF-starTechnologyCo.
,Ltd.
Page3of161DeviceOverviewTherearetwomodesofBeaconbroadcasting:connectablemodeandunconnectablemode.
Connectablemode:TheusercanusetheAPPtoconnecttheBeacon(enteraspecifickeywhenuserauthenticationfunctionisenabled).
Aftertheconnection,aspecificcommandisissuedtomodifythebeaconparametersonthecorrespondingchannel.
Un-connectablemode:TheBeaconbroadcastsaccordingtothedatasetbytheuser.
Thedefaultisconnectablemode,anditcanbeconfiguredformodeswitchingthroughserialATcommands.
BluetoothLowEnergyBeaconcanbeappliedtoindoorpositioning,activitydetection,assettracking,etc.
Itcanrealizeremotedatamanagement,andItcanalsoconfiguretheBeaconwithdifferentparametersthroughthemobileAPPandtheserialportrespectively,soastomeetdifferentapplications.
RF-IB-RS02AAwww.
szrfstar.
comV1.
0-Jul.
,2020ShenzhenRF-starTechnologyCo.
,Ltd.
Page4of162BeaconParametersTable1.
TableofParametersItemValueRemarksModelRF-IB-RS02AAWhiteenclosureOperatingVoltage1.
6V~3.
6VBatteryCR2477Servicelifecanlastfor2.
6yearsunder1sbroadcastinterval.
BroadcastInterval1sTXPower-15dBm~+7dBm0dBmisbydefault.
TransmissionDistance50mInanopenairandsunnyweather,0dBmAveragePowerConsumption41.
99μAUnder1sbroadcastinterval.
Dimension45mm45mm17.
5mmWaterproofRateIP67Splash-proofWeight29gIncludingthebatteryOperatingTemperature-10℃~+50℃AffectedbytheenclosureStorageTemperature-10℃~+55℃AffectedbytheenclosurePowerconsumptiontestisshownasbelow:Figure1.
PowerConsumptionTestRF-IB-RS02AAwww.
szrfstar.
comV1.
0-Jul.
,2020ShenzhenRF-starTechnologyCo.
,Ltd.
Page5of163ParametersConfigurationTable2.
TableofParameterConfigurationItemDefaultSettingsUUID(16Bytes)0112233445566778899AABBCCDDEEFF0MajorUUID(2Bytes)0708MinorUUID(2Bytes)0506CompanyID(2Bytes)4C00RSSI(2Bytes)-48dBmTXPower0dBmBroadcastInterval1sBroadcastNameRFstar_XXXX(thesuffixXXXXisthelasttwobytesoftheMACaddress)Anti-hijackingKey(UserAuthentication)OffbydefaultConnectableModeConnectableRF-IB-RS02AAwww.
szrfstar.
comV1.
0-Jul.
,2020ShenzhenRF-starTechnologyCo.
,Ltd.
Page6of164BLEProtocolSpecification(APPInterface)ServiceUUID6E400001B5A3F393E0A9E50E24DCCA9EEnterAnti-hijackingKeyUUIDCharacteristicsUUID6E400002B5A3F393E0A9E50E24DCCA9EExecutableoperationsWriteRemarksWhentheuserauthenticationfunctionisenabled,ananti-hijackingkeyisrequired,andthereisnoreturnvalue.
Ifthekeyisenteredincorrectlyorthetimeoutperiodisreached,theconnectionisautomaticallydisconnected.
Ifthepasswordisenteredcorrectly,itwillreturnOK\r\n.
ThetimeoutperiodcanbeconfiguredbyATcommand,andthedefaultvalueis10s.
ATCommandOperationUUIDCharacteristicsUUID6E400004B5A3F393E0A9E50E24DCCA9EExecutableoperationsWrite/NotifyRemarksInputATcommandsandthenoutputcommandreturnsthroughthischannel.
SupportallthecommandsintheATcommandlist,andanydatawithoutCRLFwillbetreatedascommands.
RF-IB-RS02AAwww.
szrfstar.
comV1.
0-Jul.
,2020ShenzhenRF-starTechnologyCo.
,Ltd.
Page7of165ATCommandsATcommandscanbesubdividedintotwotypes:TypeCommandFormatDescriptionQuerycommandAT+[x]Thiscommandisusedtoquerythecurrentvalueofthereturnedparameter.
SettingcommandAT+[x]=Thiscommandisusedtosetuser-definedparametervalue.
Note:1.
ThiscommandcanbesentthroughAPPandserialport.
PulldowntheRTSpin,beforesendingATcommandsthroughtheserialport.
SerialportRX(correspondingIO:P28),TX(correspondingIO:P27),RTS(correspondingIO:P16).
2.
Thedefaultbaudrateoftheserialportis115200,8bitdatabit,1stopbit,noparity.
3.
Noteverycommandhastheabovetwotypesofcommands.
4.
TheATcommandmustbecapitalizedandendedwithacarriagereturnandlinefeed(CRLF).
5.
ThereturnedinthequeryATcommandindicatestheoptionalparameters,and[]indicatestherequiredparameters.
Ifallparametersofthecommandareoptionalparameters,atleastoneparameterisneededtobefilled,otherwiseitisalsoregardedasacommanderror.
Example:AT+ADS=,,,youcanfillinAT+ADS=,,500.
6.
Theparameterpositionsthatarenotfilledintheoptionalparametercommandmustbereserved.
Refertothepreviousexample.
7.
Exceptfortheuserauthenticationfunction,allothersettingcommandsareeffectiveimmediatelyandsavedafterpower-off.
ATCommandListTable3.
ATCommandListCommandFunctionAT+NAMEQuery/setdevicenameAT+ADSQuery/setbroadcastparametersAT+MODEQuery/setworkingmodeAT+BEACONQuery/setbeaconrelatedparametersAT+ESQuery/setEddystonerelatedparametersAT+POWERQuery/setdevicetransmitpowerAT+AUTHQuery/setuserauthenticationRF-IB-RS02AAwww.
szrfstar.
comV1.
0-Jul.
,2020ShenzhenRF-starTechnologyCo.
,Ltd.
Page8of16AT+VERSIONQuerydevicefirmwareversionnumberAT+RESETRestoredeviceparameterstofactorysettingsandrestartCommandReturnValueOKSuccessfulcommandFAILFailedcommandERRORErrorcommandBUSYBusycommand,pleasewaitforthepreviousoperationDeviceNameAT+NAMEFunctionQuerydevicename.
ExampleAT+NAMEReturnValueAT+NAME=RFstar_XXXXOKRemarkThecommandreturnsthedevicenamecorrectly,thedefaultis"RFstar_XXXX",XXXXisthelasttwobytesoftheMACaddress.
AT+NAME=FunctionSetdevicename.
ExampleAT+NAME=TEST-NAMEReturnValueOKRemarkThemaximumsettinglengthcannotexceed11bytes.
BroadcastParameterAT+ADSFunctionQuerybroadcastparameters.
ExampleAT+ADSReturnValueAT+ADS=,1,200OKRemarkParameter1:ReservedParameter2:Devicebroadcastmodesetting(0,un-connectable.
1,connectable).
Parameter3:Devicebroadcastintervalinms,thesettingrange:100ms~10240ms.
RF-IB-RS02AAwww.
szrfstar.
comV1.
0-Jul.
,2020ShenzhenRF-starTechnologyCo.
,Ltd.
Page9of16AT+ADS=FunctionSetbroadcastparameters.
ExampleAT+ADS=,0,500ReturnValueOKRemarkSettoenableunconnectablebroadcastwith500msinterval,1000msisbydefault.
Note:Pleasebesuretosetthisparametercarefully,onceitissettoun-connectablemodebroadcast,anyparameterisnotallowedtobemodified.
WorkingModeAT+MODEFunctionQueryworkingmode.
ExampleAT+MODEReturnValueAT+MODE=0OKRemark0:iBeaconmode.
1:Eddystonemode.
AT+MODE=FunctionSetworkingmode.
ExampleAT+MODE=1ReturnValueOKRemarkSetthebroadcasttoEddystonemode,iBeaconmodeisbydefault.
BeaconParametersAT+BEACONFunctionQueryBeaconparameters.
ExampleAT+BEACONReturnValueAT+BEACON=4C00,0708,0506,D0,0112233445566778899AABBCCDDEEFF0OKRemarkParameter1:CompanyIDRF-IB-RS02AAwww.
szrfstar.
comV1.
0-Jul.
,2020ShenzhenRF-starTechnologyCo.
,Ltd.
Page10of16Parameter2:MajorParameter3:MinorParameter4:ReferenceRSSIat1m.
Thisvalueisasignedtype,andthenegativevaluescanberestoredcorrectlybyadding1afterthereverse.
Parameter5:User-definedUUIDdataAT+BEACON=FunctionSetBeaconparameters.
ExampleAT+BEACON=4546,0102,0304,C2,0102030405060708090A0B0C0D0EF010ReturnValueOKRemarkParameter1:SetCompanyIDto4546Parameter2:SetMajorto0102Parameter3:SetMinorto0304Parameter4:ReferenceRSSIat1mis-62dBmParameter5:User-definedUUIDdatais0102030405060708090A0B0C0D0EF010Note:Thezeroparametercannotbeomitted.
Forexample,Majorissetto1,"1"or"01"cannotbefilledin,but"0001",otherwiseERRORwillbereturned.
EddystoneParametersAT+ESFunctionQueryEddystoneparameters.
ExampleAT+ESReturnValueUIDType:AT+ES=00,D0,11223344556677889900112233445566,0000OKURLType:AT+ES=10,C2,01,baidu,00OKTLMType:AT+ES=20,00,0D08,1AC0,0000003E,0000023AOKRemarkEddystone'sthreeframeformatshavedifferentreturns.
Fordetails,seethefollowinganalysis:RF-IB-RS02AAwww.
szrfstar.
comV1.
0-Jul.
,2020ShenzhenRF-starTechnologyCo.
,Ltd.
Page11of16UIDType:Parameter1:UIDframefixedvalue,0x00Parameter2:ThereferenceRSSIat1m,whichhasbeencompensatedby-41dBmbasedontheRSSIat0m,range:-100dBm~-7dBm.
Thisvalueisasignedtype,andthenegativevaluescanberestoredcorrectlybyadding1afterthereverse.
Parameter3:16-byteUUID(Namespace+Instance)valueParameter4:Reservedbytes,usercanmodifyit.
URLType:Parameter1:URLframefixedvalue,0x10Parameter2:ThereferenceRSSIat1m,whichhasbeencompensatedby-41dBmbasedontheRSSIat0m,range:-100dBm~-7dBm.
Thisvalueisasignedtype,andthenegativevaluescanberestoredcorrectlybyadding1afterthereverse.
Parameter3:URLprefixrange0x00~0x03Parameter4:URLcontent,userscandirectlyaccesstheURLbybroadcastingtheURLinaspecificAPP.
Parameter5:URLsuffix,range0x00~0x0DTLMType:Parameter1:TLMframefixedvalue,0x20Parameter2:Versionnumber,mustbe0x00Parameter3:Voltagedata,thedefaultisautomaticallyobtainedbythedevice,theunitismv(whenitis0,itmeansthatthevoltagedataisautomaticallyobtainedbythedevice;whenitis1,itmeansthatthevoltageisuser-defineddata).
Parameter4:Temperaturedata,in℃(whenitis0,thetemperaturedataisautomaticallyobtainedbythedevice,ifitdoesnotsupportthevalue,itis0x8000;whenitis1,itmeansthatthetemperatureisuser-defineddata).
Parameter5:Broadcastcountvalue,countingstartsafterpoweron,resetcanrestorethecountvalue.
Parameter6:Timecountingsincepoweron,resolvingpoweris100ms,whenthedeviceisswitchedfromthedefaultiBeaconmodetoEddystonemode,thedevicewillstartcountingfromzero.
Resetcanrestorethecountvalue.
AT+ES=RF-IB-RS02AAwww.
szrfstar.
comV1.
0-Jul.
,2020ShenzhenRF-starTechnologyCo.
,Ltd.
Page12of16FunctionSetEddystoneparameters.
ExampleDifferentframetypesofEddystonehavedifferentformats,whicharedividedintothefollowingthreetypes:UIDType:AT+ES=00,D0,11223344556677889900112233445566,FFURLType:AT+ES=10,D0,01,baidu,00TLMType:AT+ES=20,00,0EC4,00,1BD0ReturnValueOKRemarkUIDType:SettheRSSIreferencevalueoftheUIDframeto-48dBm,theNamespaceIDandInstanceIDaresettogether,andsetthereservedvalueto0xFF.
URLType:SettheRSSIreferencevalueoftheURLframeto-48dBm,theURLprefixis0x01,baiduisthesetURLcontent,and00istheURLsuffixwhichcanbeencodedas.
com/.
Forothersuffixformatcodesandprefixcodes,pleaseseetheofficialURLencodingtableasbelow.
https://github.
com/google/eddystone/tree/master/eddystone-urlTLMType:Parameter2:"00"meansthatthevoltageparameteroftheTLMframeisautomaticallyobtainedbythedevice,thentheparameter0EC4isconsideredinvalid.
Parameter4:"01"meanssettingthetemperaturedataasuser-defineddata,thenparameter0A5Aisconsideredvalid.
Theparameter0A5Aistheparameterafter100timesmagnification,so26.
50℃istheuser-definedtemperature.
Note:1.
YoucanswitchbetweenthethreeEddystonemodesonlybysettingtheframetype,forexample:Sendthecommand"AT+ES=20,,,,,"candirectlyswitchtoTLMmode,andsendthecommand"AT+ES=00,,,,"candirectlyswitchtoUIDmode.
2.
Thezeroparametercannotbeomitted.
Forexample,setthereservedbyteoftheUIDframeto000A,and"0A"or"A"cannotbefilledin,but"000A",andthedevicemustbeinEddystonemodetoquery,otherwiseitwillreturnERROR.
TXPowerAT+POWERFunctionQuerycurrenttransmitpower.
RF-IB-RS02AAwww.
szrfstar.
comV1.
0-Jul.
,2020ShenzhenRF-starTechnologyCo.
,Ltd.
Page13of16ExampleAT+POWERReturnValueAT+POWER=4OKRemarkThecurrenttransmitpowerofthedeviceis4dBm.
AT+POWER=FunctionSettransmitpower.
ExampleAT+POWER=-12ReturnValueOKRemarkThecurrenttransmitpowerofthedeviceis-12dBm.
Thedeviceonlysupportsfollowing8levelsoftransmitpower:[-15,-12,-10,-5,-2,0,4,7].
Thedefaulttransmitpoweris0dBm.
UserAuthenticationAT+AUTHFunctionQuerythecurrentstatusoftheuserauthenticationfunction.
ExampleAT+AUTHReturnValueAT+AUTH=0,0000,10OKRemarkParameter1:Enable/disabletheuserauthenticationfunction.
0,disabled.
1,enabled.
Parameter2:Key,thekeylengthcannotexceed16bytes.
Thedefaultis"0000".
Parameter3:Authenticationvalidtime(ins),10sisbydefault.
Note:Itwilltakeeffectafterdisconnectionwhenenabled,andBluetoothwillbeautomaticallydisconnectediftheauthenticationkeyisnotreceivedwithinthevalidtime.
Whentheauthenticationtakeseffect,thepasswordneedstobefilledinforverificationaftereachconnection.
AT+AUTH=FunctionSetuserauthenticationfunction.
ExampleAT+AUTH=1,123456,10ReturnValueOKRF-IB-RS02AAwww.
szrfstar.
comV1.
0-Jul.
,2020ShenzhenRF-starTechnologyCo.
,Ltd.
Page14of16RemarkEnableuserauthenticationfunction,setthekeyto"123456",andtheeffectivetimeis10s.
Thesettingrangeofthevalidtimeis1s~65535s.
Theserialportsettingtakeseffectimmediately,andtheAPPsettingtakeseffectafterdisconnection.
Oncetheuserauthenticationisenabled,akeyisrequiredforeachconnection,otherwisetheuserauthenticationfailsandallcommandsareinvalid,FAILinformationpromptwillbereturned.
Therecommendedvalueshouldbe10sormore,otherwiseitwillcausetheauthenticationtimetobetooshortandcauseauthenticationfailure.
FirmwareVersionNumberAT+VERSIONFunctionQueryfirmwareversionnumber.
ExampleAT+VERSIONReturnValueAT+VERSION=V0.
1.
0OKRestoreFactorySettingsAT+RESETFunctionRestorefactorysettings.
ExampleAT+RESETReturnValueOKRemarkThedevicerestartsimmediatelyafterthesettingissuccessful.
Thefactorysettingcanalsoberestoredbypullingdownthe18thpinofthemodule(correspondingIO:P03)for5s,andcanbepulledoutbythebuttonS1.
RF-IB-RS02AAwww.
szrfstar.
comV1.
0-Jul.
,2020ShenzhenRF-starTechnologyCo.
,Ltd.
Page15of166RevisionHistoryDateVersionNo.
Description2020.
07.
15V1.
0Theinitialversionisreleased.
Note:1.
Thedocumentwillbeoptimizedandupdatedfromtimetotime.
Beforeusingthisdocument,pleasemakesureitisthelatestversion.
2.
Toobtainthelatestdocument,pleasedownloaditfromtheofficialwebsite:www.
szrfstar.
com.
RF-IB-RS02AAwww.
szrfstar.
comV1.
0-Jul.
,2020ShenzhenRF-starTechnologyCo.
,Ltd.
Page16of167ContactUsSHENZHENRF-STARTECHNOLOGYCO.
,LTD.
ShenzhenHQ:Add.
:Room601,BlockC,SkyworthBuilding,High-techPark,NanshanDistrict,Shenzhen,Guangdong,ChinaTel.
:86-755-36953756ChengduBranch:Add.
:No.
B3-03,BuildingNo.
1,IncubationPark,High-TechDistrict,Chengdu,Sichuan,China,610000Tel.
:86-28-65775970Email:sunny@szrfstar.
com,sales@szrfstar.
comWeb.
:www.
szrfstar.
com