设备数据对接说明
一、对接设备必读：
本说明涵盖了欧孚通信每款设备的详细”通信协议“和”对接说明“。包括：运营商网络（4G，NBIoT，Cat.M等），LoRaWAN（LoRa），UWB和蓝牙通信等终端设备：
a、4G设备：欧孚通信4G设备采用业界最低功耗，超低功耗4G Cat.1 Bis芯片和模组。推荐免费的“设备直接对接客户平台”对接；也支持收费的“欧孚平台API数据推送"对接模式
b、LoRaWAN（LoRa）设备：可以采用Chipstack开源构架，或TTN平台对接。（欧孚通信LoRaWAN设备支持所有厂商LoRaWAN网关；欧孚通信也提供LoRaWAN和LoRa网关）
c、NBIoT设备：推荐“电信平台AEP数据对接”；也支持收费的“欧孚平台API数据推送"d、蓝牙设备：欧孚通信所有产品支持超低功耗蓝牙BLE5.1。支持对接蓝牙网关、蓝牙AoA高精度网关（芯物联、蓝策等主流网关）；连接蓝牙设备；扫描信标等所有蓝牙协议和功能。
e、UWB设备：欧孚通信UWB终端产品有手表、胸卡、安全帽模块等多种型态（支持4G/LoRa+UWB+GPS北斗 +BLE室内外融合定位）。支持免部署的UWB信标、UWB TDoA、UWB AoA单基站。支持开放UWB模组和UWB芯片SDK，对接第三方UWB基站和UWB信标。（UWB产品和方案详情，match请点击查看： UWB产品和解决方案_上海欧孚通信 (oviphone.cn)
f、4G设备短连接模式：在需要传输数据时建立连接，完成传输数据就断开连接，短连接模式终端功耗低。合适终端主动上报数据，传输数据间隔在5分钟以上的场景。对应LoRa-Class A模式，NBIoT Idle模式
4G设备长连接模式：终端和网络始终保持在建立连接模式，长连接模式终端功耗比较高。合适终端需要随时接受网络消息，或数据传输密集的场景。对应的LoRa-Class C模式
g、若有特殊协议、数据格式、产品功能等要求和建议，请联系欧孚通信
h、通信协议位置移动，可访问上方选项卡选择，也可访问以下网址
4g 设备对接及通信协议，请访问：https://www.oviphone.cn/4G-Cat1/
lora 设备对接及通信协议, 请访问：https://www.oviphone.cn/LoRaApplication/
蓝牙设备对接及通信协议，请访问：https://www.oviphone.cn/BLE_API/
UWB设备对接，请访问：https://www.oviphone.cn/UWB-Solution/
NBIOT设备对接及通信协议，请访问：https://www.oviphone.cn/NBIOT_API/
二、定位原理说明：
1、Wifi定位：
Wifi定位是穿戴设备最常用定位技术，若非完全空旷场景，请务必开启Wifi定位的选项（GPS北斗-卫星定位必须在空旷场景，设备的天线至少要能“看到”1/4的天空）。常规应用：在欧孚平台和手机客户端推荐使用“Wifi(基站)->卫星"的定位模式（也包括了基站定位模式）。
只要周边有Wifi信号就可以使用Wifi定位，设备扫描到周边的Wifi热点（并不需要连接），然后通过设备内置的物联网卡传输到后台，后台去Wifi数据库查询，并返还位置描述和经纬度，实现定位（1、目前国内通用的Wifi数据库是：高德和百度，目前都是需5万元/年收费授权才能使用；若想节省授权费用请联系欧孚通信。2、也可以通过欧孚通信平台API推送，解析好Wifi定位，再推送给对接平台，具体请查看：欧孚平台API数据推送）
如下信息摘录百度搜索
WiFi定位的原理是通过收集周围Wi-Fi热点的信息，结合信号强度和位置服务器的数据库，计算出设备的地理位置。具体步骤如下：
收集Wi-Fi信息：当设备开启Wi-Fi功能时，会扫描并收集周围Wi-Fi热点的信息，包括热点的MAC地址和信号强度。这些信息会被上传到位置服务器。
数据库匹配：位置服务器会根据上传的Wi-Fi热点信息，查找这些热点的地理位置。这些位置信息通常来自于用户的使用数据和位置服务提供商的数据库。
计算位置：服务器结合每个热点的地理位置和信号强度，使用三点定位或多点定位技术计算出设备的大致位置。三点定位是通过三个或更多的热点来确定设备的位置，而多点定位则是通过更多的热点来提高定位的准确性。
返回位置信息：计算完成后，服务器会将计算出的位置信息返回给设备，通常是以经纬度形式表示
2、GPS北斗定位：统称卫星定位，我们目前用的是国产GPS+北斗双星定位芯片。
3、单北斗定位
针对目前中石化、中石油等一些行业需要国产单北斗的需求
a、我们的工牌、手表、安全帽模块都采用国产北斗+GPS双模芯片。有兼容的单北斗芯片。
b、但是北斗的卫星数量目前覆盖不多，特别是手表天线面积比较小，单北斗输出效果不佳。GPS和北斗只是接收机，并不存在数据风险问题
c、若需要单认证，需要看具体的认证机构
i、有的机构：接受GPS+北斗芯片的终端固件输出单北斗
ii、有的机构：接受芯片原厂单北斗的认证报告
ii、有的机构：需要提供单北斗芯片的整机进行认证
4、北斗RTK定位
a、RTK需要的天线面积特别大（还需要特别空旷的场景），穿戴设备普通使用FPC或LDS等超小尺寸线，并不合适RTK天线要求。
b、RTK的功耗巨大，2000mAh的电池支持不了8个小时（市面上有3000mAh电池的新设备也勉强8小时，每天充放电，半年后电池容量变小只有5-6小时了，这个也是很难达到工业场景使用的）。
c、RTK的运营成本极其贵，RTK基站服务器4-500元以上（每年每张卡）。另外4G的流量也需要特别大，费用也高（每年每张卡100元左右）。
d、穿戴设备：若需要卫星高精度定位，我们推荐双频卫星定位，例如：G808的双频北斗L1+L5兼顾了功耗和定位精度1-5米。若需要高精度定位可以采用蓝牙信标，UWB等其他稳定、对环境没有特别要求的技术。
5、精准定位：具体可以查看智能穿戴、室内外融合定位产品和方案_上海欧孚通信 第四部分；和解决方案 相关内容
a、最低成本的精准定位方案：采用蓝牙信标，可以定位到门洞，楼层，卫生间和房间。1个信标可以做存在定位；3个信标可以实现3-5米定位精度。（有蓝牙信标的室内外定位逻辑，建议是“蓝牙->Wifi(基站)->卫星"的定位模式。部署蓝牙信标或UWB信标，可以参考欧孚平台）
b、若要达到米级的定位精度：请使用蓝牙AoA高精度定位，或UWB定位
备注：室内蓝牙定位和UWB定位的原理可以查看本网站“解决方案”（也可以自行百度查询），具体案例可以点击参考欧孚平台介绍：平台使用说明
三、欧孚平台API数据推送（收费）：欧孚平台数据明文推送。欧孚云平台、APP和小程序还可以继续“免费”使用
欧孚云平台、APP和小程序相关介绍，请点击 云平台,客户端简介_上海欧孚通信 (oviphone.cn)
欧孚支持HTTP和HHTPS推送，使用正版高德授权Wifi、基站定位数据库，API对接推送已解析的数据（用户可以节省5万/年的授权费用）
API推送对所有云端设备都通用，仅需要对接一次，可以通用所有设备。（设备有数据就会推送，不支持接口调用数据；LoRa和单蓝牙设备等具体咨询欧孚通信）
数据推送需要占有欧孚平台更多资源-服务器、数据库和接口，所以会收取相应的平台资源占用费（若遇到欧孚平台升级、平台故障、设备容量瓶颈等特殊情况，数据推送会延迟或中断，请谅解）
1. 非高频业务设备： 推送服务费：每台设备10元。
2. 高频业务设备： 秒级（小于1分钟）的业务推送，推送服务费：每台设备50元/年。（高频资源使用费）
3. 已经成功推送的设备若需要更新推送地址，收取再次更改推送地址手续费：
a）10台以下：10元/次 b）10台或以上：20元/次 c）100台或以上：50元/次 d）1000台或以上：100元/次
注明1：API对接模式，Wifi定位数据默认推送的是经纬度和位置描述（解析过的Wifi定位数据）。若需要Wifi原始数据推送，请联系欧孚通信。
（高德和百度的地图、Wifi定位数据库等目前都是需5万元/收费授权才能使用。若想节省授权费用请联系欧孚通信）
注明2：文档已经详细说明，仔细阅读就可以完成对接（原则上不需要欧孚提供对接技术支持）
注明3：设备蓝牙扫描的低成本精准室内定位版本，请按照API文档客户自行修改蓝牙信标UUID或从欧孚通信购买信标。
若需要定制客户指定蓝牙信标UUID，或客户指定协议的设备，请联系欧孚通信
四、4G Cat.1设备：推荐免费的“设备直接对接模式”（客户平台直接对接设备：数据传输更实时，更稳定)
a、对接中会涉及到：高德或百度的地图、Wifi定位数据库等。目前高德和百度都是需收费授权才能使用（5万元/年）。若想节省授权费用请联系欧孚通信
b、文档已经详细说明，仔细阅读就可以完成对接（原则上不需要欧孚提供对接技术支持）
2.1. 设备对接的IP地址和端口修改方法：
a、设备若对接到欧孚通信云平台，在欧孚云平台支持批量或单个设备修改上报IP(域名-不带中文)和端口。若需要修改请联系欧孚通信。
b、若批量订单需要对接到第三方平台，请在订单中注明（欧孚通信会在生产时下载指定IP(域名-不带中文)和端口的固件版本）
c、若已经对接到第三方平台，则无法在欧孚平台进行在线修改IP地址，可以通过如下2种方法进行设置：
i、可以通过蓝牙手动修改IP和端口（适合测试情况下，设备数量不多的情况 ），具体请参考如下
ii、或第三方平台开发在线修改IP地址功能
