扫码底座

扫码底座

功能介绍

  1. USB接口扩展
  2. 充电
  3. 扫码

使用demo下载

扫码头引擎(红外线扫码)

扫码头引擎(红外扫码)

软件编程请参考:   用户指南

1.      可识别的码

不同的扫码头支持的码类型不同

新大陆二维扫码头支持的码类型:

code128,uccean128,ean8,ean13,upce,upca,itf,matrix,code39,codabar,code93,isbn,

industrial25,standard25,Plessey,code11,msiplessey,pdf417,qr,datamatrix,hanxin

斑马二维扫码头支持的码类型:

auspostal,Aztec,chinese25,codabar,code11,code128,code39,code93, itf, pdf417,

compositeab,composite,uccean128,ean8,ean13,issnean,isbn,upca,upce,upce1,

 matrix,discrete25,msiplessey,gs1databar, qr,datamatrix,hanxin,maxi, isbt128,korea35,uspostnet,usplanet,ukpostal,japanpostal

新大陆/鹰捷支持的码类型:

ISSN EAN,MIS-Plessey,Standard 2 of 5,Industrial 2 of 5,ISBN,Code 11,Code 93,Codabar,Code 39,Matrix 2 of 5,Interleaved 2 of 5(ITF),UPC-A,UPC-E,EAN13,EAN8,UCC-EAN128,Code128

选择可识别的码:

用户可在设置界面中选择开启或关闭制定识别码,默认开启全部识别码。

        

2.      编码方式

用户可在设置中进行输出编码的设置

默认utf8

可选UTF-8,GBK,ISO-8859-1,SHITF-JIS

3.      提示方式

用户可在设置中进行提示方式设置

默认打开声音提示和震动提示

4.      输出方式

用户可在设置中进行扫码结果的输出方式设置

默认选中模拟键盘方式输出,默认自动补回车

默认开启广播输出

5.      触发模式

用户可在设置中选择触发模式

默认短按触发扫码,扫码成功后扫码头自动熄灭

新大陆扫码头和斑马扫码头在短按触发,连续扫码选项表现的现象不同

当机器为新大陆扫码头,并且选中了短按触发,连续扫码后,扫码头会自动进入连续扫码模式,扫码头会常亮一段时间后熄灭,然后又重新亮起开始扫描,如此循环

当机器为斑马扫码头,并且选中了短按触发,连续扫码后,机器会自动进入连续扫码模式,扫码头会常亮,除非再次按下扫码键,否则扫码头灯光不会熄灭,且相同的码只会输出一次。

—————————————————————————————————————-

6.     Q&A

常见问题:

1,问:如何对接扫码头

答:为了方便开发者,商米把扫码头做成了一个免开发的设备。一般用户无需针对扫码头做开发即可获取扫码内容

2,问:如何获取扫码结果

答:商米提供了3中数据输出方式,

1),模拟键盘:会把扫码结果模拟成按键事件,会自动输出到焦点框文本,用户可以通过获取焦点框内容或者监听按键事件来获取扫码结果;2),直接填充:会把扫码结果拷贝到粘贴版,会自动输出到焦点框文本,相比较与模拟键盘输出方式,直接填充的输出速度更快;3),广播输出:会把扫码结果作为广播发送,用户可以监听广播来获取扫码结果。

3,问:连续扫码结果不一致

答:输入法会影响扫码输入结果,已知百度小米版输入法会影响扫码结果输出,可更换谷歌拼音输入法。

4,问:扫码结果比较慢

答:如果选择了模拟按键输出模式,按键间隔时间会影响输出速度,设置为0为最快速度。(默认0)

5,问:需要兼容摄像头扫码和扫码头扫码

答:L2斑马扫码头与摄像头不可同时开启,用户可以判断机型来区分商米设备和其他设备,在商米设备上使用侧键扫码

6,问:软件触发扫码

答:可参考L2用户指南 中的aidl接口,扫码服务提供了软触发的接口。

7,问:扫描中文二维码出现乱码

答:解析带中文的二维码需要把 输出编码 匹配 二维码中中文的编码格式,比如二维码的中文“你好”的编号格式为UTF-8,扫码头输出编码也需要设置UTF-8才能正确输出“你好”,否则将会输出乱码。

外接USB串口设备

USB、串口设备使用说明文档

1. 简介:

外设接口 LAN 口,钱箱口, usb2.0 口,串口,耳机孔等通用通信接口。
本文主要介绍钱箱口,usb 口和串口的使用方式。

图片 2

2.接口说明

1)钱箱口:钱箱口使用RJ12接口。 开发者可以通过向钱箱口发送数据来控制钱箱。
钱箱开发者文档及资源文件
2)串口: 串口使用 RJ11 接口。 开发者可以通过串口的数据发送来控制外设。 商米设备的RJ11为四线,不支持硬流控(部分外设默认开启硬件流控,这些设备无法通过RJ11连接商米主机)。
由于安全考虑,不支持串口节点遍历,但可以直接打开端口进行通信 (
T1,T1mini:机器底座串口的节点路径/dev/ttyHSL1,
T2:/dev/ttyHSL3,
T2mini:/dev/ttyHSL3,
T2lite:/dev/ttyHSL3,
N1、D2、D1s单屏:/dev/ttyS1,
N1、D2、D1s双屏:/dev/ttyS3) 
串口参考demo ,JNI参考

16001521077720_

通信文档事例:Jaynes 串口电子秤通信文档(不同电子秤通信协议需参考每家厂商提供的 文档)
3) USB 口: 支持 USB2.0 协议的 USB 设备。
USB 通信开发者文档   

SunmiOS支持的USB转串口芯片列表

目前支持的USB转串口芯片有:CH341、FT系列、PL2303、CP210X系列

插入USB转串口线或者板子会生成:/dev/ttyUSERx节点,其中x:表示序号0,1,2,3…..

使用USB转串口时请勿使用USB调试线,二者互斥,只能同时使用一个功能 
3.1 获取 USB 设备的 PID/VID:
方法1:java代码
try {
//获得外接USB输入设备的信息
Process p=Runtime.getRuntime().exec(“cat /proc/bus/input/devices”);
BufferedReader in = new BufferedReader(new
InputStreamReader(p.getInputStream()));
String line = null;
while((line = in.readLine())!= null){
}
String deviceInfo = line.trim();
//对获取的每行的设备信息进行过滤,获得自己想要的。
} catch (Exception e) {
// TODO: handle exception
e.printStackTrace();
}
*deviceinfo中包含每个设备的pid和vid*
方法2:adb命令
 adb shell cat /proc/bus/input/devices 图片 1
3.2 通用 USB 外设HID设备默认支持 HID 协议设备(鼠标键盘扫码枪等),可即插即用。 
HID 扫码枪
HID扫码枪可即插即用:连接商米设备,在商米设备上打开一个可编辑框并获取焦点,扫码。此时编辑框应该被输入条码或者二维码内容。
从代码获取扫码内容可参考USB 外设通信谷歌开发者文档
U盘
支持的U盘格式: FAT32:可读可写;NTFS:可读不可写 ;exFAT:不支持
摄像头
商米支持 USB UVC 摄像头 (如LogitechC170)

Demo

源码
商米读写器侧边栏可接入商米读卡器(刷卡槽接口)
66D031F8-2666-49ED-8E7A-A6C88572BEE7
商米读卡器包含两部分,一部分为磁条卡刷卡,磁条卡刷卡可参考商米读卡器开发包和读卡器demo。另一部分为nfc,nfc为android原生接口,可参考android nfc开发文档
商米读卡器开发包
商米读卡器demo
商米读卡器demo源码
第三方通用读写器商米目前已经支持四款第三方usb通用读写器,开发者可参考商米提供的demo做读卡写卡操作。上海亿矽智能科技有限公司UM002读卡器深圳市德卡科技有限公司T10读写器(需支持android版本,电源充电版)香港龙杰智能卡有限公司ACR1281U-C1读写器香港龙杰智能卡有限公司ACR1281U-K1读写器

开发文档2.0

通用读写器demo

通用读写器demo源码

打印和客显

内置打印机,客显

打印简介

连接方式:蓝牙(蓝牙设备名:InnerPrinter),AIDL、JS桥。第三方APP可以通过连接内置打印机进行打印业务。商米打印机包含的功能:58和80mm两种打印规格的热敏打印机,切刀(部分机器),钱箱(部分机器),客显(部分机器)

1.打印开发文档

  • 商米打印机

商米的打印功能接口基本都是复用的,根据机型不同会略有区别文档适用的机型:V系列(V1),P系列(P1,P1-4G等),V1S系列,T系列(T1,T2等),S系列(S2等),Mini系列(T1mini等)

打印机兼容ESC&POS指令,但与标准ESC&POS指令有略微区别

开发者可以参考内置打印机开发文档来了解打印机的工作模式和接口调用方式,通过指令文档了解商米支持的escpos指令集

内置打印机开发文档 | ESCPOS指令文档 | 
P系列和V1S和V2 AIDL文档资源T系列和S系列AIDL文档资源Mini系列AIDL文档资源V系列AIDL文档资源

如果需要对不同机型的打印功能做兼容,我们提供了一种远程导入的方案,用户无需在项目中放入AIDL资源,仅需在gradle中增加依赖即可在不同机型上使用同样的代码实现打印。具体细节可参考打印服务兼容方案说明文档

开发demo

商米提供打印demo和源码,支持常用打印功能,如:打印二维码,打印条码,打印图片,打印各国语言的文字,打印表格等。demo支持蓝牙和aidl两种连接方式。开发者在开发打印功能时需要对不同的商米设备适配不同的AIDL文件。

PS:demo现仅支持商米内置打印机,外部蓝牙串口网络USB打印机不适用此demo,自助机打印方式请参考本文下方《自助机打印文档》

内置打印demo: 打印Demo 源码

商米提供一个简易版的通过JS的方式调用打印机的demo,开发者可参考demo来通过网络调用打印机。

JS打印demo: eclipse Demo  |  Android Studio Demo

如果用户需要把网页端的内容通过商米打印机打印出来,除了通过js的方式,还可以通过android原生打印功能实现,商米提供了一个打印插件支持。

用户可以通过商米应用市场搜索Sunmiprinterplugin,下载并安装后,即可通过浏览器的打印功能来打印网页内容。

从应用市场下载随印,可支持屏幕截图打印和相机拍摄打印,有黑白和抖动灰度两种打印方式可选(现已支持V1设备)。

  • 自助机打印文档

自助机打印文档适用于SunmiK1

自助机打印开发文档|自助机打印AIDL文档资源

2.客显

客显sunmiT1mini有顾客显示器,开发者可以参考客显开发文档来使用客显。

客显开发文档 | 客显DEMO

摄像头扫码

扫码

针对商米设备,商米提供了扫码组件和SO库,能够更快的识别二维码和条形码。

目前支持的扫码类型包括如下:

1. 一维码:EAN-8, EAN-13, UPC-A, UPC-E, Codabar, Code39, Code93, Code128, ISBN10, ISBN13, DataBar, DataBar Expanded, Interleaved 2 of 5

2. 二维码:QR Code , PDF417

商米的扫码组件和so库仅支持在商米设备上使用。

T1mini/T2mini摄像头的调用方式:用户可直接使用android提供的摄像头调用api对摄像头进行操作。

T1mini/T2mini摄像头(如果用户把手持机器的扫码功能移植到T1mini/T2mini上,需要调整分辨率和显示界面的大小)

商米提供了一个简单的demo来演示如何在chrome中打开摄像头

网页调用摄像头demo

电子秤

电子秤

主机型

S2

量程

15Kg

分度数(精度等级)

3000(C3)

检定分度值

e=d=2/5g

蠕变(%FS/30min)

±0.0167

安全过载(%FS)

150

破坏过载(%FS)

300

工作温度(℃)

0-40℃

电子水平校准

支持

精度

<6Kg 精度0.002Kg;6Kg到15Kg精度 0.005Kg

电子秤使用指南

Sunmi收银demo来展示如何使用副屏,扫码,打印,电子秤,人脸支付等功能

小闪

小闪是一款即插即用的扫码设备,使用方式类似扫码枪。

把小闪插入主机设备,通过小闪扫码后,小闪将会把扫码内容通过按键键值的方式传输给系统,系统的焦点输入框会自动输入扫码结果。