RN用蓝牙接入热敏打印机和智能电子秤
最近要为app用蓝牙接入便携热敏打印机和读蓝牙电子秤。作为一名前端,能涉及到硬件的开发让我觉得兴奋不已,所以我立刻着手开始相应的预研。并把遇到的知识点和问题记录下来。
btw,大部分知识点未深入可能有错,欢迎指正。
需求简单来说是:app内通过蓝牙来打印和读蓝牙电子秤。
拆解
从需求中可以分为三块,蓝牙通信层 和 打印机协议 和 电子秤协议。
蓝牙
通信
类似http,传输层而已,传输二进制内容,有读有写。 读写都会有buffer。
RN库
看了两个库 react-native-ble-manager react-native-bluetooth-serial,前者的api感觉太繁琐,看不懂,哭。 我用的是后者,but不要用其npm上的版本,用其最新的github代码库,因为接口比较多且稳定。
react-native-bluetooth-serial是单例的,我需要连蓝牙打印和蓝牙电子秤,所以我需要两个这样的库,fork下来改改就ok,不会太难。这是我改的react-native-gm-bluetooth
react-native-bluetooth-serial有个方法list
获取设备列表,在Android上是获取已经配对的设备(预先在系统界面上匹配好),在iOS上是以扫描的形式把列表返回。
有个listener能监听数据的回调,不建议使用,因为回调可能很频繁,容易导致应用奔溃。 推荐主动去读。
btw建议大家多看下源码加深理解。java代码还是比较容易懂的,而Object-C就难点。
react-native-gm-bluetooth
基于业务上的需要,增加了些功能。
writeHexToDevice 把16进制转成bytes写进蓝牙设备
writeTextToDevice 把文本转成bytes写进蓝牙设备
和一些打印辅助Util
蓝牙3.x、蓝牙4.x、BLE?
了解不多,未深入。
蓝牙4.x是3.x的升级版,并增加了低功耗(BLE)。BLE支持的安全级别中有些是不需要匹配的。
Android/iOS
了解不多,未深入。
Android是需要用mac id去连接设备。而iOS需要用uuids(多个,可能是server uuid, read uuid, write uuid)
你会发现在系统界面,iOS搜不到蓝牙设备,而Android可以,还搜出来很多。个人感觉是iOS指把有记录(貌似需要在某网站申请注册)的蓝牙设备放出来,其他的隐藏。
然而通过api搜索还是能找出来的。
其他
自动连接。没做,目前是通过人工介入链接,成功之后id保存起来,下次启动尝试连接。但没有做设备离开了之后又回来等情况的自动连接。
耗电。接入了两个蓝牙设备,都是高频的工作,貌似耗电还是挺大的,得一直充电。
热敏打印机
热敏打印机分两种,小票和标签。小票即商场购物买单的小票,标签即包装盒上的标签。
小票用的是TSC指令集,标签用的ESC指令集。文档在这里ESC TSC文档
打印demo可参考这里gmrnbt
TSC
一般流程:初始化(纸张宽度)-》初始化(还原)-》设置(对齐、字体大小等)-》 打印内容 -》打印 -》蜂鸣(提示打印完成)。
其中 1 初始化可能多次调用,2 字体大小有几种尺寸:倍高、倍宽、倍高宽 3 调打印命令后才打印出来 4 文本可自动换行 5 能识别符号(\t \n 等)6 比较特别的打印样式如表格则需要自己根据打印内容计算了
ESC
一般流程:初始化(标签宽度、标签间隔、起始位置、出纸方向等等) -》 初始化 -》 打印坐标和内容 -》 打印 -》 蜂鸣。
其中 1 和TSC不一样,ESC是按坐标打印的,超出纸张部分不会打印 2 字体大小有 1 2 3规格,可分别设置高宽 3 一次打印命令一张标签 4 可打二维码一维码等等 5 注重对打印内容的计算,以便打印在正确的位置
注意:由于每个设备不一样,其实位置可能并非是0,0。 比如我测试用的坐标是30,32。 坑。
电子秤
电子秤就简单多了,读电子秤发过来的数据即可。 麻烦的地方是每个称的数据格式不一样,需要写逻辑去解。
花絮八卦
整个过程中组内进行了很多讨论和实践:
打印机供应商有提供SDK,直接使用就好。
之前做Android的同事开发过一版Android的小票打印,用的佳博软件提供的打印机,也是费了很多心思才找到他们提供SDK,但提供的api很奇怪,打印需要指定坐标。(当然和我们的认知窄有关)
and 既然用了佳博的SDK,猜测会绑定了了佳博供应的打印设备,还没有iOS的,于是就放弃了SDK的方案。
打印就像画图,设个坐标,调画图api画。
另一位同事开发过win(c#)的票据打印,是通过类画图形式调用。
打印的本质是否pdf,用电脑打印的时候都可以另存为pdf的
从上面来方案来看都感觉略不靠谱,是否麻烦了点!
继续体验了很多打印的功能,发现在打印的时候都可以把打印的内容存为pdf,比如网页打印,比如excel、doc、ppt都可以存为pdf。
翻了下PDF的定义“便携式文档格式(英语:Portable Document Format,简称PDF)”。
同时也在github上找了个库 react-native-print,它把html -> pdf。
此时略兴奋,感觉要接近真相了。
于是疯狂的往pdf靠,然而并没有更多的资料支撑pdf这个想法。
打印的本质是图片。
同上,没有进展。可能不使用在热敏打印机上
就做android好了,iOS太封闭
应该没啥好解释的,确实很多厂商有可能不会对iOS做适配。 就拿iOS蓝牙来说,就有很多人在抱怨搜不到设备。
外卖软件能做到接入各种厂商,能Android,iOS哦。
是的,在jd搜索下热敏打印机,发现能接入各种供应商和手机系统。
基于最后一点,我们坚信也可以做到。
。。。省略艰辛的查资料过程
直到和一位同行交流中了解到 TSC ESC 指令集,才突然豁然开朗。
资源总结
github,找到相关的库,一个一个拜读。 必要时发issue联系作者交流。
找打印机供应商客服,他们能提供很专业的意见,有必要还可以和他们的技术对接。
读代码,分析SDK,少不了。要向了解细节,心石放下就得读代码。 Java、Object-C不懂就问呗。
蓝牙模块应该会有官方的使用案例的,Android,iOS。