北斗手持机开发接口(北斗模块-2015.0421).doc

《北斗手持机开发接口(北斗模块-2015.0421).doc》由会员上传分享，免费在线阅读，更多相关内容在教育资源-天天文库。

1、北斗手持机函数接口说明1北斗1代接口机制说明北斗短信接口主要是采用android的广播机制。2北斗1代接口适用版本。3北斗1代接口函数说明3.1发送北斗信息android.intent.action.beidou.msg.sendBundle数据：number：String类型北斗报文发送的目的卡号msgcontent：byte[]类型，信息内容。type:int类型:编码方式0混发1汉字2代码bitLen:int类型:报文有效数据位数(bit总数)备注:1.北斗4.0协议规范中规定，北斗报文长度以bit计算。“传输方式”为代码且“电文内容”不满整字节，传输时在电文最后补“0”2.在“代码

2、方式”发送和解码北斗报文时，需要注意实际有效的bit位数是否是满字节不是满字节。示例代码：由于示例代码较长，请查考app源代码中caseR.id.btn_send事件响应处理函数3.2接受北斗信息android.intent.action.beidou.msg.receivedBundle数据：number：String类型报文发送方号码msgcontent：byte[]类型，信息内容。msgtype：：int类型编码方式：0混发1汉字2代码crcFlag：int类型校验位0:报文校验正确1:报文校验错误bitLen:北斗报文中实际传输有效bit数北斗报文解析步骤:确定报文校验是否正确，再

3、根据实际有效的数据长度bitLen在msgContent中获取报文内容。1.1请求读取北斗卡信息参数:无示例代码:privateLocationManagermlocation;mlocation.sendExtraCommand(LocationManager.GPS_PROVIDER,"request_bd_info",null);备注:详细见app工程中的源码的处理1.2请求获取北斗IC卡号android.intent.action.beidou.msg.number.request备注:此功能暂时未做1.3接受北斗IC号接收广播：android.intent.action.beid

4、ou.msg.number.receivedBundle数据ic_number:String类型示例代码:bundle=intent.getExtras();Stringnumber=bundle.getString("ic_number");tempStr="北斗号:"+number;txt_sim_num_info.setText(tempStr);1.4短报文发送状态接受广播：android.intent.action.beidou.feedbackinfo.received";Bundle数据：FeedBackTag：String类型FKXX中返回的数据指令执行结果代码(标准4.0

5、协议的返回)FeedBackExtraInfo:String类型FKXX中附加信息详细使用方式见:示例app源码中ACTION_MSG_BD_FKXX_RECEIVED事件的处理源码1.1北斗模块信息接受系统广播：android.intent.action.beidou.msg.bd.info.receivedBundle数据：service_frequency：服务频度communication_level：北斗卫星的通信等级number北斗模块IC号码module_state：导航模块硬件信息1仅有GPS2仅有北斗4双模service_number：北斗服务中心号码version：北斗

6、模块版本号1.2北斗功率请求android.intent.action.beidou.msg.bd.info.request_bd_power参数:无示例代码:手持终端IntentpowIntent=newIntent(ACTION_MSG_BD_POWER_INFO_REQUEST);sendBroadcast(powIntent);1.3北斗功率接收接受系统广播：android.intent.action.beidou.powerinfo.receivedBundle数据：m_p0int类型，波束1功率值m_p1

7、int类型波束2功率值m_p2int类型波束3功率值m_p3int类型波束4功率值m_p4int类型波束5功率值m_p5int类型波束6功率值1.4允许发送短信：允许发送消息：命令bd_msg_enableBundlebundle=newBundle();bundle.putBoolean("op",enable);mlocation.sendExtraCommand(LocationManager.GPS_PROVID