介紹 USB、jUSB 和 JSR-80
Java 平臺一直都以其平臺無關性自豪。雖然這種無關性有許多好處，但是它也使得編寫與硬件交互的 Java 應用程序的過程變得相當複雜。在本文中，研究科學家蔣清野討論了兩個項目，它們通過提供使Java 應用程序可以使用 USB 設備的 API 而使這個過程變得更容易。雖然這兩個項目仍然處於萌芽狀態，但是它們都顯示了良好的前景，並已經成爲一些實用應用程序的基礎。
1
評論：
2003 年 10 月 25 日
-
![+]()
內容
在 IBM Bluemix 雲平臺上開發並部署您的下一個應用。
通用串行總線(Universal Serial Bus USB)規範的第一個版本發表於 1996年 1月。因爲它的低成本、高數據傳輸率、使用容易和靈活性，USB 在計算機行業裏獲得了廣泛接受。今天，許多周邊設備和裝置都是通過 USB 接口連接到計算機上的。目前，大多數一般用途的操作系統都提供了對 USB 設備的支持，並且用 C 或者 C++ 可以相對容易地開發訪問這些外設的應用程序。不過，Java 編程語言在設計上對硬件訪問提供的支持很少，所以編寫與 USB 設備交互的應用程序是相當困難的。
IBM 的 Dan Streetman 最早開始了在 Java 語言中提供對 USB 設備的訪問的努力。2001年，他的項目通過 Java 規範請求(Java Specification Request，JSR)過程被接受爲 Java 語言的候選擴展標準。這個項目現在稱爲 JSR-80 並且指定了官方包 javax.usb 。同時，在 2000年 6月，Mojo Jojo 和 David Brownell 在 SourceForge 開始了 jUSB 項目。這兩個項目都開發出了 Linux 開發人員可以使用的包，儘管它們都還很不完善。這兩個項目也都開始試圖向其他操作系統上的 Java 應用程序提供對 USB 設備的訪問，儘管它們都還沒有開發出可以使用的包(參閱 參考資料 中有關本文中討論的這兩個項目及其他項目的資料)。
在本文中，將對 jUSB 和 JSR-80 項目作一個簡要介紹，不過，我們首先要看一下 USB 協議的具體細節，這樣您就可以理解這兩個項目是如何與 USB 設備交互的。我們還將提供代碼片段以展示如何用這兩個項目的 API 訪問 USB 設備。
USB 介紹
1994年，一個由四個行業夥伴(Compaq、Intel、Microsoft 和 NEC)組成的聯盟開始制定 USB 協議。該協議最初的目的是將 PC 與電話相連並提供容易擴展和重新配置的 I/O 接口。1996年 1月，發表了 USB 規範的第一個版本，1998年 9月發表了後續版本(版本 1.1)。這個規範允許 127臺設備同時連接到一起，總的通信帶寬限制爲 12 Mbps。後來，又有三個成員(Hewlett-Packard、Lucent 和 Philips)加入了這個聯盟。2000年 4月，發表了 USB 規範的 2.0版本，它支持高達 480 Mbps 的傳輸率。今天，USB 在高速(視頻、圖像、儲存)和全速(音頻、寬帶、麥克風)數據傳輸應用中起了關鍵作用。它還使各種低速設備(鍵盤、鼠標、遊戲外設、虛擬現實外設)連接到 PC 上。
USB 協議有嚴格的層次結構。在所有 USB 系統中，只有一個主設備，到主計算機的的 USB 接口稱爲 主控器(host controller)。主控器有兩個標準――開放主控器接口(Compaq 的 Open Host Controller Interface，OHCI)和通用主控器接口(Intel 的 Universal Host Controller Interface，UHCI)。這兩個標準提供了同樣的能力，並可用於所有的 USB 設備，UHCI 的硬件實現更簡單一些，但是需要更復雜的設備驅動程序(因而 CPU 的負荷更大一些)。
USB 物理互連是分層的星形拓樸，最多有七層。一個 hub 是每個星形的中心，USB 主機被認爲是 root hub。每一段連線都是 hub 與 USB 設備的點對點連接，後者可以是爲系統提供更多附加點的另一個 hub，也可以是一個提供功能的某種設備。主機使用主/從協議與 USB 設備通信。這種方式解決了包衝突的問題，但是同時也阻止了附加的設備彼此建立直接通信。
所有傳輸的數據都是由主控器發起的。數據從主機流向設備稱爲 下行(downstream)或者 輸出(out)傳輸，數據從設備流向主機稱爲 上 行(upstream)或者 輸入(in)傳輸。數據傳輸發生在主機和 USB 設備上特定的 端點(endpoint) 之間，主機與端點之間的數據鏈接稱爲 管道(pipe)。 一個給定的 USB 設備可以有許多個端點，主機與設備之間數據管道的數量與該設備上端點的數量相同。一個管道可以是單向或者是雙向的，一個管道中的數據流與所有其他管道中的數據流無關。
USB 網絡中的通信可以使用下面四種數據傳輸類型中的任意一種：
- 控制傳輸：這些是一些短的數據包，用於設備控制和配置，特別是在設備附加到主機上時。
- 批量傳輸：這些是數量相對大的數據包。像掃描儀或者 SCSI 適配器這樣的設備使用這種傳輸類型。
- 中斷傳輸：這些是定期輪詢的數據包。主控器會以特定的間隔自動發出一箇中斷。
- 等時傳輸：這些是實時的數據流，它們對帶寬的要求高於可靠性要求。音頻和視頻設備一般使用這種傳輸類型。
像串行端口一樣，計算機上每一個 USB 端口都由 USB 控制器指定了一個惟一的標識數字(端口 ID)。當 USB 設備附加到 USB 端口上時，就將這個 惟一端口 ID 分配給這臺設備，並且 USB 控制器會讀取 設備描述符。設備描述符包括適用於該設備的全局信息、以及設備的 配置信息。配置定義了一臺 USB 設備的功能和 I/O 行爲。一臺 USB 設備可以有一個或者多個配置，這由它們相應的配置描述符所描述。每一個配置都有一個或者多個 接口，它可以視爲一個物理通信渠道 ；每一個接口有零個或者多個端點，它可以是數據提供者或者數據消費者，或者同時具有這兩種身份。接口由接口描述符描述，端點由端點描述符描述。並且一臺 USB 設備可能還有字符串描述符以提供像廠商名、設備名或者序列號這樣的附加信息。
正如您所看到的，像 USB 這樣的協議爲使用 Java 這種強調平臺和硬件無關性的語言的開發人員提出了挑戰。現在讓我們看兩個試圖解決這個問題的項目。
jUSB API
jUSB 項目是由 Mojo Jojo 和 David Brownell 於 2000年 6月創立的。其目標是提供一組免費的、在 Linux 平臺上訪問 USB 設備的 Java API。這個 API 是按照 Lesser GPL (LGPL)條款發表的，這意味着您可以在專有和免費軟件項目中使用它。這個 API 提供了對多個物理 USB 設備的多線程訪問，並支持本機和遠程設備。具有多個接口的設備可以同時被多個應用程序(或者設備驅動程序)所訪問，其中每一個應用程序(或者設備驅動程序)都佔據一個不同的接口。該 API 支持控制傳輸、批量傳輸和中斷傳輸，不支持等時傳輸，因爲等時傳輸用於媒體數據(如音頻和視頻)，JMF API 已經在其他標準設備驅動程序上對此提供了很好的支持(參閱 參考資料)。當前，該 API 可以在具有 Linux 2.4 核心或者以前的 2.2.18 核心的 GNU/Linux 版本上工作。因此可支持大多數最新的版本，例如，該 API 可以在沒有任何補丁或者升級的 Red Hat 7.2 和 9.0 上工作。
jUSB API 包括以下包：
-
usb.core: 這個包是 jUSB API 的核心部分。它使得 Java 應用程序可以從 USB 主機訪問 USB 設備。 -
usb.linux: 這個包包含usb.core.Host對象的 Linux 實現、bootstrapping 支持和其他可以提升 Linux USB 支持的類。這個實現通過虛擬 USB 文件系統(usbdevfs)訪問 USB 設備。 -
usb.windows: 這個包包含usb.core.Host對象的 Windows 實現、bootstrapping 支持和其他可以提升 Windows USB 支持的類。這個實現仍然處於非常初級的階段。 -
usb.remote: 這個包是usb.coreAPI 的遠程版本。它包括一個 RMI proxy 和一個 daemon 應用程序，它讓 Java 應用程序可以訪問遠程計算機上的 USB 設備。 -
usb.util: 這個包提供了一些有用的實用程序，可以將 firmware下載到 USB 設備上、將 USB 系統的內容轉儲到 XML 中、以及將只有 bulk I/O 的 USB 設備工具轉換成一個套接字(socket)。 -
usb.devices: 這個可選包收集了用 jUSB API 訪問不同 USB 設備的 Java 代碼，包括柯達數碼相機和 Rio 500 MP3 播放器。這些 API 經過特別編寫以簡化訪問特定 USB 設備的過程，並且不能用於訪問其他設備。這些 API 是在usb.coreAPI 之上構建的，它們可以工作在所有支持 jUSB 的操作系統上。 -
usb.view: 這個可選包提供了基於 Swing 的 USB 樹簡單瀏覽器。它是一個展示 jUSB API 應用的很好的示例程序。
儘管 usb.core.Host 對象的實現對於不同的操作系統是不同的，但是 Java 程序員只需要理解 usb.core 包就可以用 jUSB API 開始應用程序的開發。表 1 列出了 usb.core 的接口和類，Java 程序員應該熟悉它們：
表 1. jUSB 中的接口和類
| 接口 | 說明 |
|---|---|
Bus |
將一組 USB 設備連接到 Host 上 |
Host |
表示具有一個或者多個 Bus 的 USB 控制器 |
| 類 | 說明 |
Configuration |
提供對設備所支持的 USB 配置的訪問，以及對與該配置關聯的接口的訪問 |
Descriptor |
具有 USB 類型的描述符的實體的基類 |
Device |
提供對 USB 設備的訪問 |
DeviceDescriptor |
提供對 USB 設備描述符的訪問 |
EndPoint |
提供對 USB 端點描述符的訪問、在給定設備配置中構造設備數據輸入或者輸出 |
HostFactory |
包含 bootstrapping 方法 |
Hub |
提供對 USB hub 描述符以及一些 hub 操作的訪問 |
Interface |
描述一組端點，並與一個特定設備配置相關聯 |
PortIdentifier |
爲 USB 設備提供穩定的字符串標識符，以便在操作和故障診斷時使用 |
用 jUSB API 訪問一臺 USB 設備的正常過程如下：
- 通過從
HostFactory得到 USBHost進行 Bootstrap。 - 從
Host訪問 USBBus，然後從這個Bus訪問 USB root hub(即 USBDevice)。 - 得到 hub 上可用的 USB 端口數量，遍歷所有端口以找到正確的
Device。 - 訪問附加到特定端口上的 USB
Device。可以用一臺Device的PortIdentifier直接從Host訪問它，也可以通過從 root hub 開始遍歷 USBBus找到它。 - 用
ControlMessage與該Device直接交互，或者從該Device的當前Configuration中要求一個Interface，並與該Interface上可用的Endpoint進行 I/O 。
清單 1 展示瞭如何用 jUSB API 獲得 USB 系統中的內容。這個程序編寫爲只是查看 root hub 上可用的 USB 設備，但是很容易將它改爲遍歷整個 USB 樹。這裏的邏輯對應於上述步驟 1 到步驟 4。
清單 1. 用 jUSB API 獲得 USB 系統的內容
import usb.core.*;
public class ListUSB
{
public static void main(String[] args)
{
try
{
// Bootstrap by getting the USB Host from the HostFactory.
Host host = HostFactory.getHost();
// Obtain a list of the USB buses available on the Host.
Bus[] bus = host.getBusses();
int total_bus = bus.length;
// Traverse through all the USB buses.
for (int i=0; i<total_bus; i++)
{
// Access the root hub on the USB bus and obtain the
// number of USB ports available on the root hub.
Device root = bus[i].getRootHub();
int total_port = root.getNumPorts();
// Traverse through all the USB ports available on the
// root hub. It should be mentioned that the numbering
// starts from 1, not 0.
for (int j=1; j<=total_port; j++)
{
// Obtain the Device connected to the port.
Device device = root.getChild(j);
if (device != null)
{
// USB device available, do something here.
}
}
}
} catch (Exception e)
{
System.out.println(e.getMessage());
}
}
清單 2 展示了在應用程序成功地找到了 Device 的條件下，如何與 Interface 和 EndPoint 進行批量 I/O。 這個代碼段也可以修改爲執行控制或者中斷 I/O。它對應於上述步驟 5。
清單 2. 用 jUSB API 執行批量 I/O
if (device != null)
{
// Obtain the current Configuration of the device and the number of
// Interfaces available under the current Configuration.
Configuration config = device.getConfiguration();
int total_interface = config.getNumInterfaces();
// Traverse through the Interfaces
for (int k=0; k<total_interface; k++)
{
// Access the currently Interface and obtain the number of
// endpoints available on the Interface.
Interface itf = config.getInterface(k, 0);
int total_ep = itf.getNumEndpoints();
// Traverse through all the endpoints.
for (int l=0; l<total_ep; l++)
{
// Access the endpoint, and obtain its I/O type.
Endpoint ep = itf.getEndpoint(l);
String io_type = ep.getType();
boolean input = ep.isInput();
// If the endpoint is an input endpoint, obtain its
// InputStream and read in data.
if (input)
{
InputStream in;
in = ep.getInputStream();
// Read in data here
in.close();
}
// If the Endpoint is and output Endpoint, obtain its
// OutputStream and write out data.
else
{
OutputStream out;
out = ep.getOutputStream();
// Write out data here.
out.close();
}
}
}
}
jUSB 項目在 2000年 6月到 2001年 2月期間非常活躍。該 API 的最新的版本 0.4.4發表於 2001年 2月 14日。從那以後只提出了很少的改進，原因可能是 IBM 小組成功地成爲了 Java 語言的候選擴展標準。不過，基於 jUSB 已經開發出一些第三方應用程序，包括 JPhoto 項目(這是一個用 jUSB 連接到數碼照相機的應用程序)和 jSyncManager 項目(這是一個用 jUSB 與使用 Palm 操作系統的 PDA 同步的應用程序)。
JSR-80 API (javax.usb)
正如前面提到的，JSR-80 項目是由 IBM 的 Dan Streetman 於 1999年創立的。2001年，這個項目通過 Java 規範請求(JSR)過程被接受爲 Java 語言的候選擴展標準。這個項目現在稱爲 JSR-80 並且被正式分派了 Java 包 javax.usb 。這個項目使用 Common Public License 的許可證形式，並通過 Java Community Process 進行開發。這個項目的目標是爲 Java 平臺開發一個 USB 接口，可以從任何 Java 應用程序中完全訪問 USB 系統。JSR-80 API 支持 USB 規範所定義的全部四種傳輸類型。目前，該 API 的 Linux 實現可以在支持 2.4 核心的大多數最新 GNU/Linux 版本上工作，如 Red Hat 7.2 和 9.0。
JSR-80 項目包括三個包： javax-usb ( javax.usb API)、 javax-usb-ri (操作系統無關的基準實現的公共部分)以及 javax-usb-ri-linux(Linux 平臺的基準實現，它將公共基準實現鏈接到 Linux USB 堆棧)。所有這三個部分都是構成 Linux 平臺上 java.usb API 完整功能所必需的。在該項目的電子郵件列表中可以看到有人正在致力於將這個 API 移植到其他操作系統上(主要是 Microsoft Windows)，但是還沒有可以工作的版本發表。
儘管 JSR-80 API 的操作系統無關的實現在不同的操作系統上是不同的，但是 Java 程序員只需要理解 javax.usb 包就可以開始開發應用程序了。表 2 列出了 javax.usb 中的接口和類， Java 程序員應該熟悉它們：
表 2. JSR-80 API 中的接口和類
| 接口 | 說明 |
|---|---|
UsbConfiguration |
表示 USB 設備的配置 |
UsbConfigurationDescriptor |
USB 配置描述符的接口 |
UsbDevice |
USB 設備的接口 |
UsbDeviceDescriptor |
USB 設備描述符的接口 |
UsbEndpoint |
USB 端點的接口 |
UsbEndpointDescriptor |
USB 端點描述符的接口 |
UsbHub |
USB hub 的接口 |
UsbInterface |
USB 接口的接口 |
UsbInterfaceDescriptor |
USB 接口描述符的接口 |
UsbPipe |
USB 管道的接口 |
UsbPort |
USB 端口的接口 |
UsbServices |
javax.usb 實現的接口 |
| 類 | 說明 |
UsbHostManager |
javax.usb 的入口點 |
用 JSR-80 API 訪問 USB 設備的正常過程如下：
- 通過從
UsbHostManager得到相應的UsbServices進行 Bootstrap。 - 通過
UsbServices訪問 root hub。在應用程序中 root hub 就是一個UsbHub。 - 獲得連接到 root hub 的
UsbDevices 清單。遍歷所有低級 hub 以找到正確的UsbDevice。 - 用控制消息(
UsbControlIrp)與UsbDevice直接交互，或者從UsbDevice的相應UsbConfiguration中要求一個UsbInterface並與該UsbInterface上可用的UsbEndpoint進行 I/O。 - 如果一個
UsbEndpoint用於進行 I/O，那麼打開與它關聯的UsbPipe。通過這個UsbPipe可以同步或者異步提交上行數據(從 USB 設備到主計算機)和下行數據(從主計算機到 USB 設備)。 - 當應用程序不再需要訪問該
UsbDevice時，關閉這個UsbPipe並釋放相應的UsbInterface。
在清單 3 中，我們用 JSR-80 API 獲得 USB 系統的內容。這個程序遞歸地遍歷 USB 系統上的所有 USB hub 並找出連接到主機計算機上的所有 USB 設備。這段代碼對應於上述步驟 1 到步驟 3。
清單 3. 用 JSR-80 API 獲得 USB 系統的內容
import javax.usb.*;
import java.util.List;
public class TraverseUSB
{
public static void main(String argv[])
{
try
{
// Access the system USB services, and access to the root
// hub. Then traverse through the root hub.
UsbServices services = UsbHostManager.getUsbServices();
UsbHub rootHub = services.getRootUsbHub();
traverse(rootHub);
} catch (Exception e) {}
}
public static void traverse(UsbDevice device)
{
if (device.isUsbHub())
{
// This is a USB Hub, traverse through the hub.
List attachedDevices =
((UsbHub) device).getAttachedUsbDevices();
for (int i=0; i<attachedDevices.size(); i++)
{
traverse((UsbDevice) attachedDevices.get(i));
}
}
else
{
// This is a USB function, not a hub.
// Do something.
}
}
}
清單 4 展示了在應用程序成功地找到 Device 後，如何與 Interface 和 EndPoint 進行 I/O。這段代碼還可以修改爲進行所有四種數據傳輸類型的 I/O。它對應於上述步驟 4 到步驟 6。
清單 4. 用 JSR-80 API 進行 I/O
public static void testIO(UsbDevice device)
{
try
{
// Access to the active configuration of the USB device, obtain
// all the interfaces available in that configuration.
UsbConfiguration config = device.getActiveUsbConfiguration();
List totalInterfaces = config.getUsbInterfaces();
// Traverse through all the interfaces, and access the endpoints
// available to that interface for I/O.
for (int i=0; i<totalInterfaces.size(); i++)
{
UsbInterface interf = (UsbInterface) totalInterfaces.get(i);
interf.claim();
List totalEndpoints = interf.getUsbEndpoints();
for (int j=0; j<totalEndpoints.size(); j++)
{
// Access the particular endpoint, determine the direction
// of its data flow, and type of data transfer, and open the
// data pipe for I/O.
UsbEndpoint ep = (UsbEndpoint) totalEndpoints.get(i);
int direction = ep.getDirection();
int type = ep.getType();
UsbPipe pipe = ep.getUsbPipe();
pipe.open();
// Perform I/O through the USB pipe here.
pipe.close();
}
interf.release();
}
} catch (Exception e) {}
}
JSR-80 項目從一開始就非常活躍。2003年 2月發表了 javax.usb API、RI 和 RI 的 0.10.0 版本。看起來這一版本會提交給 JSR-80 委員會做最終批准。預計正式成爲 Java 語言的擴展標準後，其他操作系統上的實現會很快出現。Linux 開發者團體看來對 JSR-80 項目的興趣比 jUSB 項目更大，使用 Linux 平臺的 javax.usb API 的項目數量在不斷地增加。
結束語
jUSB API 和 JSR-80 API 都爲應用程序提供了從運行 Linux 操作系統的計算機中訪問 USB 設備的能力。JSR-80 API 提供了比 jUSB API 更多的功能，很有可能成爲 Java 語言的擴展標準。目前，只有 Linux 開發人員可以利用 jUSB 和 JSR-80 API 的功能。不過，有人正在積極地將這兩種 API 移植到其他操作系統上。Java 開發人員應該在不久就可以在其他操作系統上訪問 USB 設備。從現在起就熟悉這些 API，當這些項目可以在多個平臺上發揮作用時，您就可以在自己的應用程序中加入 USB 功能了。
參考資料
- 您可以參閱本文在 developerWorks 全球站點上的 英文原文.
- 有關 USB 規範的更多信息，請訪問 USB.org。
- 訪問 SourceForge 上的 jUSB 項目主頁。
- 有關 JSR-80 項目的更多信息，請訪問其 主頁或者其 在 Java Community Process 中的頁面。
- 查找更多有關 jPhoto 項目的內容。
- 瞭解 jSyncManager項目。
- 有關 JMF 項目的更多內容，參閱 Eric Olson 的全面性的“ Java Media Framework 基礎”教程(developerWorks，2002年 5月)。
- 可以在 developerWorks Java 技術專區 中找到關於 Java 編程各個方面的數百篇文章。
- 加入 developerWorks 中文社區，查看開發人員推動的博客、論壇、組和維基，並與其他 developerWorks 用戶交流。
================================================================