147 lines
5.5 KiB
Markdown
147 lines
5.5 KiB
Markdown
|
# bdxt_sdk v1.2
|
|||
|
|
|
|||
|
|
#### 介绍
|
|||
|
|
Android SDK
|
|||
|
|
本SDK支持蓝牙连接H10、H11、H20、C20，差分支持设备自带网络差分，同时也支持手机的网络差分。
|
|||
|
|
|
|||
|
|
#### 安装教程
|
|||
|
|
|
|||
|
|
1. 程序目录新建libs文件夹，将文件
|
|||
|
|
rtklib_v1.0.1.aar
|
|||
|
|
libqxwz_release_v1.8.0.aar
|
|||
|
|
拷贝至目录下
|
|||
|
|
2. 增加
|
|||
|
|
import com.mijia.rtk.LocationListener;
|
|||
|
|
import com.mijia.rtk.handevice;
|
|||
|
|
import com.mijia.rtk.ConfigDeviceInfoListener;
|
|||
|
|
import com.mijia.rtk.ntripService;
|
|||
|
|
3. 调用接口参考demo code
|
|||
|
|
|
|||
|
|
#### 使用说明
|
|||
|
|
|
|||
|
|
1. 连接设备
|
|||
|
|
handevice.connect(adrress);
|
|||
|
|
handevice.disconnect();
|
|||
|
|
handevice.getConnectState();
|
|||
|
|
2. 设备cors设置
|
|||
|
|
handevice.getAccount();
|
|||
|
|
handevice.setAccount(String ip,String port,String user,String password,String source);
|
|||
|
|
3. 手机网络cors设置
|
|||
|
|
handevice.setPhoneAccount(String ip,String port,String user,String password,String source);
|
|||
|
|
4. 回调
|
|||
|
|
```
|
|||
|
|
//和定位有关的回调函数
|
|||
|
|
handevice.setLocationListener(new LocationListener() {
|
|||
|
|
@Override
|
|||
|
|
public void onLocationChanged() {
|
|||
|
|
//位置（经纬度）发生了变化
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
@Override[README.md](..%2Fbdxt_sdk%2Fbdxt%2FREADME.md)
|
|||
|
|
public void onRead(@NonNull String msg) {
|
|||
|
|
//读到新的数据
|
|||
|
|
}
|
|||
|
|
@Override
|
|||
|
|
public void onReceiveSatellite(List<SatelliteInfo> list) {
|
|||
|
|
/*
|
|||
|
|
卫星的信息更新
|
|||
|
|
SatelliteInfo
|
|||
|
|
satType 卫星类型 1:GP 2:GL 3:GA 4:BD 6:GI
|
|||
|
|
signalid 卫星频点
|
|||
|
|
prn 卫星编号
|
|||
|
|
elev 高度角，度
|
|||
|
|
azi 方位角，度
|
|||
|
|
snr 信噪比，00-99dB，不跟踪时为空
|
|||
|
|
*/
|
|||
|
|
}
|
|||
|
|
@Override
|
|||
|
|
public void onBluetoothConnStatusChange(int state) {
|
|||
|
|
/*蓝牙的状态发生了变化
|
|||
|
|
state
|
|||
|
|
0:初始状态，没有连接
|
|||
|
|
1:正在连接
|
|||
|
|
2:成功连接
|
|||
|
|
*/
|
|||
|
|
}
|
|||
|
|
});
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
//和配置相关的回调函数
|
|||
|
|
handevice.setConfigListener(new ConfigDeviceInfoListener() {
|
|||
|
|
@Override//获取设备内部的cors配置参数的回调
|
|||
|
|
public void onGetCorsParaSuccess(@NonNull String ip, @NonNull String port, @NonNull String user, @NonNull String password, @NonNull String source) {
|
|||
|
|
|
|||
|
|
Log.d(TAG, "ip:"+ip+",port:"+port+",user:"+user+",password:"+password+",source:"+source);
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
@Override //配置设备内部的cors账号的回调
|
|||
|
|
public void onSetCorsParaAck(int state){
|
|||
|
|
/*state:
|
|||
|
|
1 CORS设置成功 0 CORS设置失败
|
|||
|
|
* */
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
@Override //手机网络cors的设置回调函数
|
|||
|
|
public void onSetPhoneCorsParaAck(int state){
|
|||
|
|
/*
|
|||
|
|
state:
|
|||
|
|
0 手机网络连接CORS成功
|
|||
|
|
1 手机网络失败：用户名、密码、挂载点 错误，验证未通过
|
|||
|
|
2 手机网络失败：IP、PORT 错误，socket连接不到对方
|
|||
|
|
3 手机网络失败：其他异常，比如手机无sim卡等
|
|||
|
|
* */
|
|||
|
|
Log.d("onSetPhoneCorsParaAck", "onSetPhoneCorsParaAck:"+state);
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
});
|
|||
|
|
```
|
|||
|
|
5. 定制化需求：
|
|||
|
|
蓝牙信号强度和距离接口
|
|||
|
|
|
|||
|
|
A.函数名称 int handevice.getRssi();
|
|||
|
|
手机连接H11后，调用此接口，返回一个int值，表示蓝牙的信号强度，单位为dB.
|
|||
|
|
如：
|
|||
|
|
距离1米：-15dB
|
|||
|
|
距离2米：-29dB
|
|||
|
|
A.函数名称 double handevice.getDistance();
|
|||
|
|
手机连接H11后，调用此接口，返回一个double值，距离，单位为米.
|
|||
|
|
因为环境等原因，可能不准，只供参考，也可以自行修改A_Value、n_Value常量取重新计算
|
|||
|
|
参考代码如下：
|
|||
|
|
public static double getDistance(){
|
|||
|
|
/*
|
|||
|
|
A和n的值，需要根据实际环境进行检测得出
|
|||
|
|
https://www.cnblogs.com/b-ben/p/11113000.html
|
|||
|
|
*/
|
|||
|
|
double A_Value=15;/**A - 发射端和接收端相隔1米时的信号强度*/
|
|||
|
|
double n_Value=2.5;/** n - 环境衰减因子*/
|
|||
|
|
double power = (Math.abs(getRssi())-A_Value)/(10*n_Value);
|
|||
|
|
return Math.pow(10,power);
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
6. 接口说明
|
|||
|
|
<div align="center">
|
|||
|
|
<img src="https://gitee.com/elygg/bdxt/raw/master/help/fun.png" width=600>
|
|||
|
|
</div>
|
|||
|
|
#### Demo程序截图
|
|||
|
|
<div align="center">
|
|||
|
|
<img src="https://gitee.com/elygg/bdxt/raw/master/help/demo.png" width=600>
|
|||
|
|
</div>
|
|||
|
|
|
|||
|
|
#### 参与贡献
|
|||
|
|
|
|||
|
|
1. Fork 本仓库
|
|||
|
|
2. 新建 Feat_xxx 分支
|
|||
|
|
3. 提交代码
|
|||
|
|
4. 新建 Pull Request
|
|||
|
|
|
|||
|
|
|
|||
|
|
#### 特技
|
|||
|
|
|
|||
|
|
1. 使用 Readme\_XXX.md 来支持不同的语言，例如 Readme\_en.md, Readme\_zh.md
|
|||
|
|
2. Gitee 官方博客 [blog.gitee.com](https://blog.gitee.com)
|
|||
|
|
3. 你可以 [https://gitee.com/explore](https://gitee.com/explore) 这个地址来了解 Gitee 上的优秀开源项目
|
|||
|
|
4. [GVP](https://gitee.com/gvp) 全称是 Gitee 最有价值开源项目，是综合评定出的优秀开源项目
|
|||
|
|
5. Gitee 官方提供的使用手册 [https://gitee.com/help](https://gitee.com/help)
|
|||
|
|
6. Gitee 封面人物是一档用来展示 Gitee 会员风采的栏目 [https://gitee.com/gitee-stars/](https://gitee.com/gitee-stars/)
|