北斗手持机开发接口

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

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

3、是否正确，再根据实际有效的数据长度 报文容。3.3请求读取北斗卡信息参数 :无示例代码 :private LocationManager mlocation; mlocation.sendExtraCommand(LocationManager.GPS_PROVIDER,"request_bd_info", null); 备注 :详细见 app 工程中的源码的处理3.4请求获取北斗IC卡号备注 :此功能暂时未做3.5接受北斗 IC 号接收广播： Bundle 数据 ic_number : String 类型示例代码 :bundle = intent.getExtras();

4、String number = bundle.getString("ic_number"); tempStr = " 北斗号 :" + number; txt_sim_num_info.setText(tempStr);3.6短报文发送状态接受广播： ent.action.beidou.feedbackinfo.received"Bundle 数据 ： FeedBackTag ： String 类型 FKXX 中返回的数据指令执行结果代码 （标准 4.0 协议的返 回）FeedBackExtraInfo: String 类

5、型 FKXX 中附加信息详细使用方式见 :示例 app 源码中 ACTION_MSG_BD_FKXX_RECEIVED 事件的处理源码3.7北斗模块信息接受系统广播： .received Bundle 数据： service_frequency ：服务频度communication_level：北斗卫星的通信等级number北斗模块 ICmodule_state ：导航模块硬件信息1 仅有 GPS2 仅有北斗4 双模service_number ：北斗服务中心version ：北斗模块版本号3.8北斗功率请求and

6、.request_bd_power 参数 : 无示例代码 :<A href=" 手持终端 </A>Intent powIntent = new Intent(ACTION_MSG_BD_POWER_INFO_REQUEST); sendBroadcast(powIntent);3.9北斗功率接收接受系统广播：Bundle 数据 ： m_p0 int 类型，波束 1 功率值m_p1 int 类型 m_p2 int 类型 m_p3 int 类型 m_p4 int 类型 m_p5 int 类型波束

7、2 功率值 波束 3 功率值 波束 4 功率值 波束 5 功率值 波束 6 功率值3.10允 许发送短信：允许发送消息：命令 bd_msg_enable Bundle bundle = new Bundle();bundle.putBoolean("op", enable);mlocation.sendExtraCommand(LocationManager.GPS_PROVIDER, "bd_msg_enable", bundle);获取允许发送北斗信息的接口：boolean msgEnable = Settings.System.getInt(get

8、ContentResolver(),BD_MSG_ENABLE, 1) > 03.11设置服务中心：命令： set_service_numberBundle bundleSet = new Bundle();bundleSet.putString("set_service_number", edt_service_num.getText().toString() mlocation.sendExtraCommand(LocationManager.GPS_PROVIDER, "set_service_number", bundleSet); 上述的

9、接口的例子可见 TestBDReceiver 例子3.12定 位申请 (DWSQ)申请发送广播： Bundle 参数 ： <A href=" 手持机 </A>freq Int 类型 定位频度 示例代码 :Intent dwIntent = new Intent(ACTION_MSG_BD_DWSQ_REQUEST); / 申请一个 IntentBundle dwBundle = new Bundle();/ 申请 bundle60 分钟dwBundle.putInt("DWSQ_FREQ", freq); / 设置定位频度 0 单次定位。 根据北

10、斗卡设置， 卡 ， freq 请设置大于 60dwIntent.putExtras(dwBundle);/ 广播参数sendBroadcast(dwIntent);/ 启动定位申请3.12.2 定位信息接收 (DWXX)事件 : Bundle 参数 ： m_Type byte 类型 m_byHeightData short 类型 m_byHeightSymbol byte 类型 m_byHour int 类型 m_byMinute int 类型 m_bySecond1 int 类型 m_byLonDegree int 类型 m_byLonMinute int 类型 m_byLonSecond1

11、 int 类型 m_byLonSecond2 int 类型 m_byLatDegree int 类型 m_byLatMinute int 类型 m_byLatSecond1 int 类型 m_byLatSecond2 int 类型高程值高程符号位 : 0 为正 非零 为负 时间信息 : 小时 时间信息 :分钟时间信息 :秒经度信息 :度经度信息 : 分经度信息 :秒经度信息 : 小秒纬度信息 : 度纬度信息 : 分纬度信息 : 秒 纬度信息 : 小秒示例代码 : 由于示例代码较长，请参考 app 源码中ACTION_MSG_BD_DWXX_RECEIVED.equals(action) 事件处

12、理的源代码3.13”北斗报文 ”中”获取坐标信息 ”使用 "ent.action.beidou.msg.dwxx.received 示例代码 :hortm_byHeightData = bundle.getShort("m_byHeightData");bytem_byHeightSymbol = bundle.getByte("m_byHeightSymbol")inttime_hour =(int)bundle.getByte("m_byHour");inttime_minute =bundle.g

13、etByte("m_byMinute");inttime_second =bundle.getByte("m_bySecond1");inttime_minsecond= bundle.getByte("m_bySecond2");intlonDegree =bundle.getByte("m_byLonDegree");intlonMinute =bundle.getByte("m_byLonMinute");intlonSecond =bundle.getByte("m_byLon

14、Second1");intlonminSecond= bundle.getByte("m_byLonSecond2");intlatDegree =bundle.getByte("m_byLatDegree");intlatMinute =bundle.getByte("m_byLatMinute");intlatSecond =bundle.getByte("m_byLatSecond1");intlatminSecond= bundle.getByte("m_byLatSecond2&quo

15、t;);3.14管 信注入 (ZBZR)请求 : 参数 : GXZR_Content 类型 String 管信注入的管理信息 示例代码 :<A href=" 工业 PDA</A> byte content = "abcdefghabcdefghabcdefghabcdefgh".getBytes();Bundle gxbundle = new Bundle(); gxbundle.putByteArray("GXZR_Content", content); Intent gxIntent = new Intent(ACTION

16、_MSG_BD_GXZR_REQUEST); gxIntent.putExtras(gxbundle); sendBroadcast(gxIntent);3.15管 信读取 (GXDQ)请求 : ent.action.beidou.msg.gxdq.request 参数:无 示例代码 :Intent gxdqIntent = new Intent(ACTION_MSG_BD_GXDQ_REQUEST); sendBroadcast(gxdqIntent);3.16管 理信息 (GLXX)事件 : 参数: GLXXInfo类型 String 管理信息示例代码 :Bundle

17、 bundleglxx = intent.getExtras();byte glxxInfo = bundleglxx.getByteArray("GLXXInfo");3.17坐 标转换 (ZBZH)请求 : ent.action.beidou.msg.zbzh.request 参数 :ZBZH_LongitudeZBZH_Lat类型 String 类型 String经度数据纬度数据ZBZH_Heigth类型String高程值ZBZH_HeigthAnomaly类型String高程异常值ZBZH_ChangeMode类型String坐标转换方式ZBZ

18、H_ChangeMode 取值: 0x01 表示将坐标转换为空间直角坐标，0x02 表示将坐标转换为高斯平面直角坐标，0x03 表示将坐标转换为麦卡托平面直角坐标示例代码 :byte Longitude = "12345678".getBytes();/ Longitude0对应经度数据中的 ”度”。/ Longitude1对应经度数据中的 ”分”。/ Longitude2对应经度数据中的 ”秒”。/ Longitude3对应经度数据中的 ”0.1秒”。byte Lat = "12345678".getBytes();/ Lat 0对应纬度数据中的 ”度

19、”。/ Lat 1对应纬度数据中的 ”分 ”。/ Lat 2对应纬度数据中的 ”秒 ”。/ Lat 3对应纬度数据中的 ”0.1秒”。int changeMode = 2;int height = 100;int heightAnomaly = 10;Bundle zbbundle = new Bundle();zbbundle.putByteArray("ZBZH_Longitude", Longitude); zbbundle.putByteArray("ZBZH_Lat", Lat);zbbundle.putInt("ZBZH_Chang

20、eMode", changeMode);zbbundle.putInt("ZBZH_Heigth", height); zbbundle.putInt("ZBZH_HeigthAnomaly", heightAnomaly); Intent zbIntent = new Intent(ACTION_MSG_BD_ZBZH_REQUEST); zbIntent.putExtras(zbbundle);sendBroadcast(zbIntent);备注 :在使用该接口时一定要保证经纬度信息中 “度”“分”秒”,”0.1秒”在数组中的对应位置 (参

21、见示例代码中红色注释部分 )3.18坐 标输出 (ZBSC)事件 : 参数 ： ZBSC_X类型StringZBSC_Y类型StringZBSC_Z类型StringZBSC_ChangeMode类型 String备注：ZBSC_ChangeMode =0x01.以空间直角坐标输出位置数据，ZBSC_X , ZBSC_Y ,ZBSC_Z为坐标ZBSC_ChangeMode =0x02. 以高斯平面直角坐标输出位置数据 ,此时ZBSC_X , ZBSC_Y为坐标,ZBSC_Z为高度值（int类型，带符号）ZBSC_ChangeMode =0x02. 以麦卡托平面直角坐标输出位置数据 ,此时ZBSC

22、_X , ZBSC_Y为坐标,ZBSC_Z为高度值（int类型，带符号）示例程序Bundle bundlezbsc = intent.getExtras(); int x = bundlezbsc.getInt("ZBSC_X"); int y = bundlezbsc.getInt("ZBSC_Y"); int z = bundlezbsc.getInt("ZBSC_Z");int changeMode = bundlezbsc.getInt("ZBSC_ChangeMode");4 北斗 2 代相关接口北斗 2

23、 代的定位数据已经置到 android 自带 GPS 相关接口函数中。 通过请求 android GPS 相关服务和调 用相关函数即可获取相关定位数据。 说明 : 在相关数据中，北斗卫星的编号为 160-197 ,GPS 卫星编号 为:0-324.1获取导航位置数据北斗导航系统设计之初就考虑了兼容现有的 android 地图和位置服务应用程序。故 导航编程接口和 google 位置服务编程接口几乎一样，只有稍许不同。以下代码片段例示了 如何通过 LocationManager 来获取北斗导航系统的位置信息。LocationManager locationManager = (LocationM

24、anager) this.getSystemService(Context.LOCATION_SERVICE);LocationListener locationListener = new LocationListener() / Define a listener that responds to location updatespublic void onLocationChanged(Location location) / Called when a new location is found by the gps location provider. makeUseOfNewLoc

25、ation(location);public void onStatusChanged(String provider, int status, Bundle extras)public void onProviderEnabled(String provider) public void onProviderDisabled(String provider) ;/ Register the listener with the Location Manager to receive location updates locationManager.requestLocationUpdates(

26、LocationManager.GPS_PROVIDER, 0, 0, locationListener);上述代码和 android 系统通过 GPS 导航是一致的。注意的是，北斗导航系统同样使用了 LocationManager.GPS_PROVIDER 。这是为了兼容于现有的 android 地图和位置服务程序。 北斗位置导航编程接口和 Android 的 GPS 导航接口是一样的。不同的地方在于GPS卫星和北斗卫星编号的不同，GPS卫星编号为1-32,现有的北斗卫星为 41-46 (或者160-197),以下代码片段例示了这种不同Overridepublic void onGpsSta

27、tusChanged(int event) GpsStatus gpsStatus = mLocationManager.getGpsStatus(null);case GpsStatus.GPS_EVENT_STARTED:mLocationManager.sendExtraCommand(LocationManager.GPS_PROVIDER, "request_module_info", null);break;case GpsStatus.GPS_EVENT_STOPPED: break;case GpsStatus.GPS_EVENT_FIRST_FIX: br

28、eak;case GpsStatus.GPS_EVENT_SATELLITE_STATUS: updateSatelliteStatus(gpsStatus);break; default: break;private void updateSatelliteStatus(GpsStatus gpsStatus) / 更新卫星视图 int maxSatellites = gpsStatus.getMaxSatellites();/ Log.d(TAG , "maxSatellites = " + maxSatellites);Iterator<GpsSatellite> statellites = gpsStatus.getSatellites() .iterator();int count = 0; mGpsStatusLayout.removeAllViews(); mBdStatusLayout.removeAllViews();while (statellites.hasNext()