平台softradio用户指南

您的产品、服务或特性等应受公司商业合同和条款的约束，本文档中描述的全部或部分产品、服务或特性可能不在您的或使用范围之内。除非合同另有约定，公司对本文档内容不做任何明示或默示的或保证。 市龙岗区坂田总部办公楼 使用SoftRadio进行调 查看信令............................................................................................................................................................信令类 使用SoftRadio进行信令管 在IoT平台上创建应 NeulSendMessageCommand NeulGetMessageCommand NeulNewMessageIndications NeulSendmessageIndications NeulQueryMessagesReceived NeulQueryMessagesSent NeulReboot ConfigureandQueryCDPServerSettings

此版本是SoftRadioV100R001C02第一次初稿发布，对应SoftRadioSoftRadio是一款PC软件，用来模拟NB-IoTChipset/Module，同时NBIoTAirInterface，提供一条通路直接到IoT平台。在测试场景下，合伙伙伴在不需要/模组、NB-IoT和网的情况下，借助PC端的SoftRadio软件，任何时候都可通过互联网连接到IOT平台和APP应用，用于NB-IoT终端设备到APPServer端NB-IoTUE：NB-IoT终端（如智能水表、智能气表等）通过空口连接到eNodeB。IoT网进行连接，将非接入层数据转发给网元处理。IoT平台：IoT联接管理平台（IoT平台）汇聚从各种接入网得到的持与IoT平台对接。在使用SoftRadio之前，为保证软件顺利配置、业务正常调试，需要提前准备或者执行在申请使用SoftRadio工具前，必须要先获取IoT平台资源，并且在IoT平台上APP应用创建以及基于IoTAPPDemo IoT在使用SoftRadio之前，为保证SoftRadio与IoT平台顺利对接，需要提前准备或者执进行SoftRadio配置前，NB-IoT终端厂商必须提前在IoTAPP应用，具体操作参考IoT平台相应的帮助文档。11.1在IoT平台上创建应用仅以IoT平台为例，对如何创建APP应用做了简IoT平台的IP8.1配置IoT8.2添加并NB-IoT终端设备中使设备的ProfileManufactuerId、DeviceType、Model安装SoftRadio4-2Edge .NETFramework3.5安装SoftRadio时若提示需要安装“.NETFramework”请安装3.5版本，路径：/en-SoftRadio请按照如下操作流程申请并获取SoftRadio1、填写SoftRadio工具申请表，并将MAR流程中“业务合作通过邮件”一起发送到so /ict/）*Use NodeId*Manufactuer*Device要根据自己使用的IoT平台进行确认，获取与8080端口对应的映射端“NodeID”为从IoT平台获取的verifyCode，verifyCode并且必须使用TEST$_UUID的格式传入参数。verifyCode由NB-IoT终端厂商通过APP应用与IoT平台之间的通口设备“ManufactuerId”DeviceType”Model”信息需要与IoTAPP息保持一致，由NB-IoTProfileManufactuerId、DeviceType、Model。2、so 公共邮箱收到申请信息后，将开通对应账号的权限，并在1—2个工作日内邮件反馈申请结果。3、使用MAR账号/开发者社区账号登陆开发者社区，SoftRadio软件，解压可得到安装包与用户操作指导书。参考指导书进行工具安装以及License申请。 中文： /resource/tool英文：在SoftRadio安装包 下，双击“SoftRadio_Setupmsi”安装文件，弹出如图5-1所示界面。图5-1开发者安装SoftRadio软件后，需要根据ESN信息申请License，并激活软件后才可以PC桌面上双击SoftRadio在浏览器URL中输入，进入SoftRadio界面”，进入图6-1将获取到的ESN号按表6-1反馈到邮箱so ，来申请SoftRadio软件License。1个工作日内将得到邮件反馈的“softradio.license”文件。Use（>软件多个ESN6-2所示界面中上传获取到的“softradio.licenseActivateSoftRadio激活成功。图6-2771中英文切换（英文72中英文切换（中文用户设置的中英文信息在本地s中，关闭浏览器或者重启服务，再次打开程序首页会显示用户先前设置的语言环境，清除浏览器s缓存，刷新页面或者关闭浏览页面再次配置IoT

URL中输入SoftRadioUI界面地在左侧导航栏单击 tformConfig”，进 tformConfig界面填写与SoftRadio对接的IoT平台的IP和端，单击“Submit”，完成IoT平台的地址配置。添加并NB-IoT终端设在SoftRadio左侧导航栏单击“Dashboard”，进入Dashboard在Dashboard界面上单击Devices标识旁边的“”，展开AddDevice界面。如图8-2所示。AddDevice界面的DeviceInfo8-3−“NodeID”为从IoT平台获取的verifyCode，verifyCode并且必须使TEST$_UUID的格式传入参数。verifyCode由NB-IoTAPP应用与IoT平台之间的通口获取。“ManufactuerIdDeviceTypeModelIoT平台上创建APPNB-IoT终端厂商提供。。−“ProtocolTypeCoAPNB-IoT终端设备信息，且设备状态显示为“Registered”。绑定NB-IoT 成功后，在Dashboard界面单击绑定按钮“”，完成设备绑定。绑定按钮的位置如图8-5所示。地址中配置的IoT平台IP地址和端口是否正确、8.2添加并NB-IoT终端设备中输入的设备在SoftRadio左侧导航栏单击“COMConfig”，进入COMConfig在COMConfigCOM8-7图8-7COM 串 NB-IoT终端的配置保持一致。单击“Submit”按钮，完成COM信息提交。COM信息提交完成后，在至此SoftRadio配置完成。配置完COM口之后，Actions栏中会出现操作COM口的按钮，如下图所示，当COMActive状态时，显示关闭按钮，点击关闭COMCOM口为Inactive时，显示打开按钮，点击打开COM口。89COM810COM

在配置完成的SoftRadio左侧导航栏单击“Dashboard”，进入Dashboard在Dashboard界面上，单击信 在弹出的SignalTracking界面查看信令结果，如图9-2所示使用SoftRadio进行调试时主要依据就是SignalTracking界面上的信息。调试过程中可以在的回复以及SoftRadio发给IoT平台的请求。NB-IoT终端发给SoftRadioATSoftRadio发给IoTIoT平台给SoftRadio请确认NB-IoT终端和SoftRadio是否使用的是同一个串口。如果是同一个串口，请确SoftRadio自检NB-IoT终端相应软硬件。这种情况是由于NB-IoTAT命令不能被SoftRadio所识别。SoftRadioAT命令及格式请参考11.2SoftRadioAT命令。“”，将会清空历史信令 典型MO/MT以一款水表为例，介绍 SoftRadio发送MOIoT平台，收到IoT平台的MO回复后，SoftRadio开始向IoT平台发送多次MT请求，将IoT平台要下发给水表的数据全部到SoftRadio的缓存中。AT+NMGRSoftRadio中缓存中的下行数据；SoftRadio23的数据以+NMGR的形式回复给水表。水表再ATAT+NMGR发送请求，SoftRadio21的数据发送给AT+NMGSSoftRadio17IoTSoftRadio发送MO请求将数据发送给IoT平台，之后发送MT请求给IoT平台，请求要发给水表的下行数据。101选择设备NodeID10-2，即可完成数据查询，如图10-3所示。103AT输入框支持大部分时间格式，输入任意格式的有效时间，SoftRadio会自动转换成固定格式时间。如图10-4所示。104息，如图10-5所示。在IoT平台上创建应

11NB-IoT终端厂商在IoT平台创建应用，请参考相应的帮助文档，本章仅以IoT平 oceanconnect/devcenter

已获取IoT平台门户用户账号和

IoT平台门户，URL： 。其中，server和port分别是IoT平台门户的和 “基础API包”创建应用。框内的内容全部另存以便取用。获取verifyCodeNB-IoT终端厂商使用APP应用调用IoT平台第应用鉴权登录接口，完成APP应用调用IoT平台设备接口获取verifyCode，便于在SoftRadio上注NB-IoT设备时使用。APP应用开发可以参考《 获取“ManufactuerIdDeviceTypeModelIoTprofile文件导入IoT平台，完成“ManufactuerId“DeviceType”、“Model”在IoT平台上的。这些信息将会用于在SoftRadio上设备使用。SoftRadio支持的ATATNeulSendMessage发送MO数据到IoTNeulGetMessage获取SoftRadioNeulNewMessageNeulSendMessageNeulQueryMessages查询MTNeulRebootServerSettings(+NCDP)设置查询当前IPNeulSendMessageCommandThesendmessagecommandisusedtosendamessagefromtheTerminaltothenetworkviatheCDPserver.Thiscommandwillgivean<err>codeanddescriptionasanintermediatemessageifitcan’tsendthemessage.Referto:ErrorValuesforpossible<err>values.<length>Decimallengthofmessage.Theumdatalengthof512<data>DatatobetransmittedinstringhexNeulGetMessageCommandTheGetMessagecommandreturnstheoldestbufferedmessageanddeletesfromthebuffer.Iftherearenomessagesthennocommandresponsewillbegiven.Ifnewmessageindications(+NNMI)areturnedonthenreceivedmessageswillnotbeavailableviathiscommand.Referto:ErrorValuesforpossible<err>values.<length>Decimallengthofmessage.Theumdatalengthof512<data>DatatobetransmittedinstringhexNeulNewMessageIndications0,No2,IndicationsThiscommandsetsorgetswhethernewmessageindicationsaresent.NewmessageindicationscanbesentwhenadownstreammessageisreceivedbytheterminalfromtheCDPserver.Referto:ErrorValuesforpossible<err>values.Whennewmessageindicationsandmessagesareenabled(NNMI=1),allcurrentlybufferedmessageswillbereturned.Ifindicationsaloneareturnedon(NNMI=2),eachnewlyreceivedmessagetriggersanindicationthatanewdatagramiswaitingusingtheunsolicitedinformationalresponse.Thebufferedmessagescanbecollectedusing+NMGR.Thedefaultsettingis0:noindicationsare0,No2,Indicationsonly<length>Decimallengthof<data>DatatobetransmittedinstringhexNeulSendmessageIndications<0,No1,IndicationswillbeIfsentmessageindicationsareturnedon,thefollowingunsolicitedinformationalresponsewillbeissuedwhenanewmessageissentintoNB-IoTstack.Referto:ErrorValuesforpossible<err>values.Thedefaultsettingis0:noindicationsare0,No1,IndicationswillbeNeulQueryMessagesReceivedThiscommandqueriesthestatusofthereceiveddownstreammessagesreceivedfromtheCDPserver.Referto:ErrorValuesforpossible<err>values.<buffered>Thenumberofmessageswaitingtobereadinthedownstreambuffer.Themaxnumberofbufferedmessagesis3.<received>ThetotalnumberofmessagesreceivedbytheSoftRadiosinceit<dropped>ThenumberofmessagesdroppedbytheSoftRadiosinceitNeulQueryMessagesSentThiscommandqueriesthestatusoftheupstreammessagessenttotheCDPserver.Referto:ErrorValuesforpossible<err>values.<pending>Thenumberofmessageswaitingtobesentintheupstreambuffer.NotethesoftRadionowcanonlybuffer1messageatmost.<sent>Thetotalnumberofupstreammessagessenttothenetworksinceterminal<error>Thenumberofmessagesthatcouldnotbesentbytheterminalduetoanerrorsinceterminalboot.NeulRebootNeulREBOOTINGOKNeulThiscommandrebootstheterminal.Thereisashortdelayafterissuingthiscommandbeforetheterminalreboots.NofurtherATcommandswillbeprocessed.Referto:ErrorValuesforpossible<err>values.TherebootingoperationwillcleartheATparametervaluesanddownstream/upstreammessagesbufferedbytheSoftRadio.ConfigureandQueryCDPServerSettingsOKor+CME168.5.1,5683OKTSetandquerytheserver