CH341PAR_Android 库接口说明.docx

CH341PARAndroid JAR 库接口说明版本： V1.00CH341PAR Android JAR 库接口说明１CH341PAR Android JAR 库接口说明版本： 1简介CH341 是一个 USB 总线的转接芯片，通过 USB 总线提供异步 UART、并口、常用的 2 线和 4 线同步 串行接口等方式。并口方式下，提供了 EPP/MEM 8 位并行接口，而常用的同步串行接口主要包含 2 线 IIC、4 线 SPI 等。本文档主要介绍 CH341USB 转 EPP、MEM、IIC、SPI 模式（以下简称 CH341PAR）操作的 Java Driver 库,以及 Android 下如何使用 APK 操作 CH341PAR 实现数据通讯。该驱动基于 Android USB Host 协议 完成，用户可调用所提供的相关接口 API 实现与 Android USB Host 的通讯。Android Host、CH341 转接芯片的功能示意图如下：异步串口/RS232/RS485/RS422AndroidD+CH341转换并口打印机为 USB 打印机USB HostD-转接（OTG）芯片EPP 并口和 MEM 并口常用的 2 线和 4 线同步串口CH341PAR 提供的库需要满足以下两个条件方可实现数据通讯：1、Android 3.1 及以上系统版本；2、Android 端具有 USB Host 或 OTG 接口。本文档将会重点说明 Android USB Host 与 CH341 建立通讯机制的 Java 包 API 以及我司提供的演 示程序的操作说明。关于 Android USB Host 协议说明，可以参考 Google 官方文档。CH341PAR Android JAR 库接口说明２1、Android USB Host本文档所描述的演示程序皆是针对 Android 3.1 及以上版本系统。Android 应用程序的启动参数 是定义在 device_filter.xml 文件中的 product-id 和 vendor-id。基于 CH341PAR 开发的 Android 应用程序主要分为两个部分，如下图：User LayoutCH341PARApplicationsCH341PAR.jar(lib)内 核图 1.1 CH341PAR Android ApplicationUser Layout：主要是由用户根据自己的需求完成相关的代码，通过调用 CH341PAR 相关的接口函 数实现 EPP、MEM、IIC、SPI 的通讯方式。我司所提供的例程基于 Fragment 结构设计，在 Android 手 机或平板上会呈现出不同的主界面。对比效果图如下：图 1.2 平板效果图图 1.3 手机效果图注：以下的演示内容均是针对手机每一个功能子界面来阐述，用户只需要根据相应的功能模块涉 及的接口函数实现自己的功能及 UI。CH341PAR.jar：实现 EPP、MEM、IIC、SPI 通讯方式的 Java 包，提供 API 给 User Layout 调用，相关 的接口 API 内容参考后续说明。CH341PAR Android JAR 库接口说明３2、CH341PAR 设备信息2.1 说明针对 CH341PAR 基本信息的获取及设置操作提供了 CH341SystemInit、CH341GetBufSizeValue、 CH341TransPackageSize、CH341GetPIDVID 等方法，在获取信息之前都进行了设备是否连接的判断， 调用 isConnected 方法即可，库中还提供操作 CH341 IO 口的方法，如 CH341GetInput、CH341SetOutput、 CH341Set_D5_D0。下图为 CH341PAR 演示界面：图 2.1 Information Activity2.2 设备信息接口CH341SystemInit ：CH341PAR 的初始化操作。 函数原型：public int CH341SystemInit()若初始化成功，则返回 0，失败则返回负值。CH341GetPIDVID：获取 CH341PAR 设备的 PIDVID。函数原型：public int[][] CH341getPIDVID()返回二维数组类型：int[0][n]为 CH341PAR 设备的 VID； int[1][n]为 CH341PAR 设备的 PID。其中n 为CH341PAR 的并口及同步串行接口的VIDPID 数目，最多可读出两组，否则设备与CH341PAR 驱动不匹配。CH341GetInput：通过 CH341 直接获取引脚状态 函数原型：public boolean CH341GetInput