1 <!DOCTYPE HTML PUBLIC
"-//W3C//DTD HTML 4.01 Transitional//EN">
2 <html><head><meta http-equiv=
"Content-Type" content=
"text/html;charset=UTF-8">
3 <title>Barry: usbwrap.cc Source File
</title>
4 <link href=
"doxygen.css" rel=
"stylesheet" type=
"text/css">
5 <link href=
"tabs.css" rel=
"stylesheet" type=
"text/css">
7 <!-- Generated by Doxygen 1.5.6 -->
8 <div class=
"navigation" id=
"top">
11 <li><a href=
"index.html"><span>Main
Page
</span></a></li>
12 <li><a href=
"modules.html"><span>Modules
</span></a></li>
13 <li><a href=
"namespaces.html"><span>Namespaces
</span></a></li>
14 <li><a href=
"classes.html"><span>Classes
</span></a></li>
15 <li class=
"current"><a href=
"files.html"><span>Files
</span></a></li>
16 <li><a href=
"dirs.html"><span>Directories
</span></a></li>
19 <div class=
"navpath"><a class=
"el" href=
"dir_edc0f428e3eefcfdce9c25befd901c57.html">src
</a>
22 <div class=
"contents">
23 <h1>usbwrap.cc
</h1><a href=
"usbwrap_8cc.html">Go to the documentation of this file.
</a><div class=
"fragment"><pre class=
"fragment"><a name=
"l00001"></a>00001 <span class=
"comment">///
</span>
24 <a name=
"l00002"></a>00002 <span class=
"comment"></span><span class=
"comment">/// \file usbwrap.cc
</span>
25 <a name=
"l00003"></a>00003 <span class=
"comment"></span><span class=
"comment">/// USB API wrapper
</span>
26 <a name=
"l00004"></a>00004 <span class=
"comment"></span><span class=
"comment">///
</span>
27 <a name=
"l00005"></a>00005 <span class=
"comment"></span>
28 <a name=
"l00006"></a>00006 <span class=
"comment">/*
</span>
29 <a name=
"l00007"></a>00007 <span class=
"comment"> Copyright (C)
2005-
2009, Chris Frey
</span>
30 <a name=
"l00008"></a>00008 <span class=
"comment"></span>
31 <a name=
"l00009"></a>00009 <span class=
"comment"> This program is free software; you can redistribute it and/or modify
</span>
32 <a name=
"l00010"></a>00010 <span class=
"comment"> it under the terms of the GNU General Public License as published by
</span>
33 <a name=
"l00011"></a>00011 <span class=
"comment"> the Free Software Foundation; either version
2 of the License, or
</span>
34 <a name=
"l00012"></a>00012 <span class=
"comment"> (at your option) any later version.
</span>
35 <a name=
"l00013"></a>00013 <span class=
"comment"></span>
36 <a name=
"l00014"></a>00014 <span class=
"comment"> This program is distributed in the hope that it will be useful,
</span>
37 <a name=
"l00015"></a>00015 <span class=
"comment"> but WITHOUT ANY WARRANTY; without even the implied warranty of
</span>
38 <a name=
"l00016"></a>00016 <span class=
"comment"> MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
</span>
39 <a name=
"l00017"></a>00017 <span class=
"comment"></span>
40 <a name=
"l00018"></a>00018 <span class=
"comment"> See the GNU General Public License in the COPYING file at the
</span>
41 <a name=
"l00019"></a>00019 <span class=
"comment"> root directory of this project for more details.
</span>
42 <a name=
"l00020"></a>00020 <span class=
"comment">*/
</span>
43 <a name=
"l00021"></a>00021
44 <a name=
"l00022"></a>00022
45 <a name=
"l00023"></a>00023 <span class=
"preprocessor">#include
"<a class="code
" href="usbwrap_8h.html
" title="USB API wrapper.
">usbwrap.h</a>"</span>
46 <a name=
"l00024"></a>00024 <span class=
"preprocessor">#include
"<a class="code
" href="data_8h.html
" title="Class to deal with pre-saved data files.
">data.h</a>"</span>
47 <a name=
"l00025"></a>00025 <span class=
"preprocessor">#include
"<a class="code
" href="error_8h.html
" title="Common exception classes for the Barry library.
">error.h</a>"</span>
48 <a name=
"l00026"></a>00026 <span class=
"preprocessor">#include
"debug.h"</span>
49 <a name=
"l00027"></a>00027
50 <a name=
"l00028"></a>00028 <span class=
"preprocessor">#include
<iomanip
></span>
51 <a name=
"l00029"></a>00029 <span class=
"preprocessor">#include
<sstream
></span>
52 <a name=
"l00030"></a>00030 <span class=
"preprocessor">#include
<errno.h
></span>
53 <a name=
"l00031"></a>00031 <span class=
"preprocessor">#include
<string.h
></span>
54 <a name=
"l00032"></a>00032
55 <a name=
"l00033"></a>00033 <span class=
"preprocessor">#ifndef __DEBUG_MODE__
</span>
56 <a name=
"l00034"></a>00034 <span class=
"preprocessor"></span><span class=
"preprocessor">#define __DEBUG_MODE__
</span>
57 <a name=
"l00035"></a>00035 <span class=
"preprocessor"></span><span class=
"preprocessor">#endif
</span>
58 <a name=
"l00036"></a>00036 <span class=
"preprocessor"></span><span class=
"preprocessor">#include
"debug.h"</span>
59 <a name=
"l00037"></a>00037
60 <a name=
"l00038"></a>00038 <span class=
"keyword">namespace
</span>Usb {
61 <a name=
"l00039"></a>00039 <span class=
"comment"></span>
62 <a name=
"l00040"></a>00040 <span class=
"comment">///////////////////////////////////////////////////////////////////////////////
</span>
63 <a name=
"l00041"></a>00041 <span class=
"comment"></span><span class=
"comment">// Usb::Error exception class
</span>
64 <a name=
"l00042"></a>00042
65 <a name=
"l00043"></a>00043 <span class=
"keyword">static
</span> std::string GetErrorString(
<span class=
"keywordtype">int
</span> libusb_errcode,
<span class=
"keyword">const
</span> std::string
&str)
66 <a name=
"l00044"></a>00044 {
67 <a name=
"l00045"></a>00045 std::ostringstream oss;
68 <a name=
"l00046"></a>00046 oss
<< <span class=
"stringliteral">"("</span>;
69 <a name=
"l00047"></a>00047
70 <a name=
"l00048"></a>00048 <span class=
"keywordflow">if
</span>( libusb_errcode ) {
71 <a name=
"l00049"></a>00049 oss
<< std::setbase(
10)
<< libusb_errcode
<< <span class=
"stringliteral">", "</span>;
72 <a name=
"l00050"></a>00050 }
73 <a name=
"l00051"></a>00051
74 <a name=
"l00052"></a>00052 <span class=
"comment">// oss
<< strerror(-libusb_errno)
<< "): "</span>
75 <a name=
"l00053"></a>00053 oss
<< usb_strerror()
<< <span class=
"stringliteral">"): "</span>;
76 <a name=
"l00054"></a>00054 oss
<< str;
77 <a name=
"l00055"></a>00055 <span class=
"keywordflow">return
</span> oss.str();
78 <a name=
"l00056"></a>00056 }
79 <a name=
"l00057"></a>00057
80 <a name=
"l00058"></a>00058 Error::Error(
<span class=
"keyword">const
</span> std::string
&str)
81 <a name=
"l00059"></a>00059 : Barry::Error(GetErrorString(
0, str))
82 <a name=
"l00060"></a>00060 , m_libusb_errcode(
0)
83 <a name=
"l00061"></a>00061 {
84 <a name=
"l00062"></a>00062 }
85 <a name=
"l00063"></a>00063
86 <a name=
"l00064"></a>00064 Error::Error(
<span class=
"keywordtype">int
</span> libusb_errcode,
<span class=
"keyword">const
</span> std::string
&str)
87 <a name=
"l00065"></a>00065 : Barry::Error(GetErrorString(libusb_errcode, str))
88 <a name=
"l00066"></a>00066 , m_libusb_errcode(libusb_errcode)
89 <a name=
"l00067"></a>00067 {
90 <a name=
"l00068"></a>00068 }
91 <a name=
"l00069"></a>00069
92 <a name=
"l00070"></a>00070 <span class=
"comment"></span>
93 <a name=
"l00071"></a>00071 <span class=
"comment">///////////////////////////////////////////////////////////////////////////////
</span>
94 <a name=
"l00072"></a>00072 <span class=
"comment"></span><span class=
"comment">// Match
</span>
95 <a name=
"l00073"></a>00073
96 <a name=
"l00074"></a>00074 Match::Match(
<span class=
"keywordtype">int
</span> vendor,
<span class=
"keywordtype">int
</span> product,
97 <a name=
"l00075"></a>00075 <span class=
"keyword">const
</span> <span class=
"keywordtype">char
</span> *busname,
<span class=
"keyword">const
</span> <span class=
"keywordtype">char
</span> *devname)
98 <a name=
"l00076"></a>00076 : m_busses(
0)
99 <a name=
"l00077"></a>00077 , m_dev(
0)
100 <a name=
"l00078"></a>00078 , m_vendor(vendor)
101 <a name=
"l00079"></a>00079 , m_product(product)
102 <a name=
"l00080"></a>00080 , m_busname(busname)
103 <a name=
"l00081"></a>00081 , m_devname(devname)
104 <a name=
"l00082"></a>00082 {
105 <a name=
"l00083"></a>00083 usb_find_busses();
106 <a name=
"l00084"></a>00084 usb_find_devices();
107 <a name=
"l00085"></a>00085 m_busses = usb_get_busses();
108 <a name=
"l00086"></a>00086 }
109 <a name=
"l00087"></a>00087
110 <a name=
"l00088"></a>00088 Match::~Match()
111 <a name=
"l00089"></a>00089 {
112 <a name=
"l00090"></a>00090 }
113 <a name=
"l00091"></a>00091
114 <a name=
"l00092"></a>00092 <span class=
"keywordtype">bool
</span> Match::ToNum(
<span class=
"keyword">const
</span> <span class=
"keywordtype">char
</span> *str,
<span class=
"keywordtype">long
</span> &num)
115 <a name=
"l00093"></a>00093 {
116 <a name=
"l00094"></a>00094 <span class=
"keywordtype">char
</span> *end =
0;
117 <a name=
"l00095"></a>00095 num = strtol(str,
&end,
10);
118 <a name=
"l00096"></a>00096 <span class=
"keywordflow">return
</span> num
>=
0 && <span class=
"comment">// no negative numbers
</span>
119 <a name=
"l00097"></a>00097 num != LONG_MIN
&& num != LONG_MAX
&& <span class=
"comment">// no overflow
</span>
120 <a name=
"l00098"></a>00098 str != end
&& *end ==
<span class=
"charliteral">'\
0'
</span>;
<span class=
"comment">// whole string valid
</span>
121 <a name=
"l00099"></a>00099 }
122 <a name=
"l00100"></a>00100
123 <a name=
"l00101"></a>00101 <span class=
"comment">//
</span>
124 <a name=
"l00102"></a>00102 <span class=
"comment">// Linux treats bus and device path names as numbers, sometimes left
</span>
125 <a name=
"l00103"></a>00103 <span class=
"comment">// padded with zeros. Other platforms, such as Windows, use strings,
</span>
126 <a name=
"l00104"></a>00104 <span class=
"comment">// such as
"bus-1" or similar.
</span>
127 <a name=
"l00105"></a>00105 <span class=
"comment">//
</span>
128 <a name=
"l00106"></a>00106 <span class=
"comment">// Here we try to convert each string to a number, and if successful,
</span>
129 <a name=
"l00107"></a>00107 <span class=
"comment">// compare them. If unable to convert, then compare as strings.
</span>
130 <a name=
"l00108"></a>00108 <span class=
"comment">// This way,
"3" ==
"003" and
"bus-foobar" ==
"bus-foobar".
</span>
131 <a name=
"l00109"></a>00109 <span class=
"comment">//
</span>
132 <a name=
"l00110"></a>00110 <span class=
"keywordtype">bool
</span> Match::NameCompare(
<span class=
"keyword">const
</span> <span class=
"keywordtype">char
</span> *n1,
<span class=
"keyword">const
</span> <span class=
"keywordtype">char
</span> *n2)
133 <a name=
"l00111"></a>00111 {
134 <a name=
"l00112"></a>00112 <span class=
"keywordtype">long
</span> l1, l2;
135 <a name=
"l00113"></a>00113 <span class=
"keywordflow">if
</span>( ToNum(n1, l1)
&& ToNum(n2, l2) ) {
136 <a name=
"l00114"></a>00114 <span class=
"keywordflow">return
</span> l1 == l2;
137 <a name=
"l00115"></a>00115 }
138 <a name=
"l00116"></a>00116 <span class=
"keywordflow">else
</span> {
139 <a name=
"l00117"></a>00117 <span class=
"keywordflow">return
</span> strcmp(n1, n2) ==
0;
140 <a name=
"l00118"></a>00118 }
141 <a name=
"l00119"></a>00119 }
142 <a name=
"l00120"></a>00120
143 <a name=
"l00121"></a>00121 <span class=
"keywordtype">bool
</span> Match::next_device(
<a class=
"code" href=
"namespaceUsb.html#6d445b3f5ddb92da82207f62e7d9494f" title=
"Typedefs used by the wrapper class, in the hope to make it easier to switch from...">Usb::DeviceIDType
</a> *devid)
144 <a name=
"l00122"></a>00122 {
145 <a name=
"l00123"></a>00123 <span class=
"keywordflow">for
</span>( ; m_busses; m_busses = m_busses-
>next ) {
146 <a name=
"l00124"></a>00124
147 <a name=
"l00125"></a>00125 <span class=
"comment">// only search on given bus
</span>
148 <a name=
"l00126"></a>00126 <span class=
"keywordflow">if
</span>( m_busname
&& !NameCompare(m_busname, m_busses-
>dirname) )
149 <a name=
"l00127"></a>00127 <span class=
"keywordflow">continue
</span>;
150 <a name=
"l00128"></a>00128
151 <a name=
"l00129"></a>00129 <span class=
"keywordflow">if
</span>( !m_dev )
152 <a name=
"l00130"></a>00130 m_dev = m_busses-
>devices;
153 <a name=
"l00131"></a>00131
154 <a name=
"l00132"></a>00132 <span class=
"keywordflow">for
</span>( ; m_dev; m_dev = m_dev-
>next ) {
155 <a name=
"l00133"></a>00133
156 <a name=
"l00134"></a>00134 <span class=
"comment">// search for specific device
</span>
157 <a name=
"l00135"></a>00135 <span class=
"keywordflow">if
</span>( m_devname
&& !NameCompare(m_devname, m_dev-
>filename) )
158 <a name=
"l00136"></a>00136 <span class=
"keywordflow">continue
</span>;
159 <a name=
"l00137"></a>00137
160 <a name=
"l00138"></a>00138 <span class=
"comment">// is there a match?
</span>
161 <a name=
"l00139"></a>00139 <span class=
"keywordflow">if
</span>( m_dev-
>descriptor.idVendor == m_vendor
&&
162 <a name=
"l00140"></a>00140 m_dev-
>descriptor.idProduct == m_product ) {
163 <a name=
"l00141"></a>00141 <span class=
"comment">// found!
</span>
164 <a name=
"l00142"></a>00142 *devid = m_dev;
165 <a name=
"l00143"></a>00143
166 <a name=
"l00144"></a>00144 <span class=
"comment">// advance for next time
</span>
167 <a name=
"l00145"></a>00145 m_dev = m_dev-
>next;
168 <a name=
"l00146"></a>00146 <span class=
"keywordflow">if
</span>( !m_dev )
169 <a name=
"l00147"></a>00147 m_busses = m_busses-
>next;
170 <a name=
"l00148"></a>00148
171 <a name=
"l00149"></a>00149 <span class=
"comment">// done
</span>
172 <a name=
"l00150"></a>00150 <span class=
"keywordflow">return
</span> <span class=
"keyword">true
</span>;
173 <a name=
"l00151"></a>00151 }
174 <a name=
"l00152"></a>00152 }
175 <a name=
"l00153"></a>00153 }
176 <a name=
"l00154"></a>00154 <span class=
"keywordflow">return
</span> <span class=
"keyword">false
</span>;
177 <a name=
"l00155"></a>00155 }
178 <a name=
"l00156"></a>00156
179 <a name=
"l00157"></a>00157 <span class=
"comment"></span>
180 <a name=
"l00158"></a>00158 <span class=
"comment">///////////////////////////////////////////////////////////////////////////////
</span>
181 <a name=
"l00159"></a>00159 <span class=
"comment"></span><span class=
"comment">// Device
</span>
182 <a name=
"l00160"></a>00160
183 <a name=
"l00161"></a>00161 Device::Device(
<a class=
"code" href=
"namespaceUsb.html#6d445b3f5ddb92da82207f62e7d9494f" title=
"Typedefs used by the wrapper class, in the hope to make it easier to switch from...">Usb::DeviceIDType
</a> <span class=
"keywordtype">id
</span>,
<span class=
"keywordtype">int
</span> timeout)
184 <a name=
"l00162"></a>00162 : m_id(id),
185 <a name=
"l00163"></a>00163 m_timeout(timeout)
186 <a name=
"l00164"></a>00164 {
187 <a name=
"l00165"></a>00165 dout(
<span class=
"stringliteral">"usb_open("</span> << std::dec
<< <span class=
"keywordtype">id
</span> << <span class=
"stringliteral">")"</span>);
188 <a name=
"l00166"></a>00166 m_handle = usb_open(
<span class=
"keywordtype">id
</span>);
189 <a name=
"l00167"></a>00167 <span class=
"keywordflow">if
</span>( !m_handle )
190 <a name=
"l00168"></a>00168 <span class=
"keywordflow">throw
</span> Error(
<span class=
"stringliteral">"open failed"</span>);
191 <a name=
"l00169"></a>00169 }
192 <a name=
"l00170"></a>00170
193 <a name=
"l00171"></a>00171 Device::~Device()
194 <a name=
"l00172"></a>00172 {
195 <a name=
"l00173"></a>00173 dout(
<span class=
"stringliteral">"usb_close("</span> << std::dec
<< m_handle
<< <span class=
"stringliteral">")"</span>);
196 <a name=
"l00174"></a>00174 usb_close(m_handle);
197 <a name=
"l00175"></a>00175 }
198 <a name=
"l00176"></a>00176
199 <a name=
"l00177"></a>00177 <span class=
"keywordtype">bool
</span> Device::SetConfiguration(
<span class=
"keywordtype">unsigned
</span> <span class=
"keywordtype">char
</span> cfg)
200 <a name=
"l00178"></a>00178 {
201 <a name=
"l00179"></a>00179 dout(
<span class=
"stringliteral">"usb_set_configuration("</span> << std::dec
<< m_handle
<< <span class=
"stringliteral">","</span> << std::dec
<< (
<span class=
"keywordtype">unsigned
</span> <span class=
"keywordtype">int
</span>) cfg
<< <span class=
"stringliteral">")"</span>);
202 <a name=
"l00180"></a>00180 <span class=
"keywordtype">int
</span> ret = usb_set_configuration(m_handle, cfg);
203 <a name=
"l00181"></a>00181 m_lasterror = ret;
204 <a name=
"l00182"></a>00182 <span class=
"keywordflow">return
</span> ret
>=
0;
205 <a name=
"l00183"></a>00183 }
206 <a name=
"l00184"></a>00184
207 <a name=
"l00185"></a>00185 <span class=
"keywordtype">bool
</span> Device::ClearHalt(
<span class=
"keywordtype">int
</span> ep)
208 <a name=
"l00186"></a>00186 {
209 <a name=
"l00187"></a>00187 dout(
<span class=
"stringliteral">"usb_clear_halt("</span> << std::dec
<< m_handle
<< <span class=
"stringliteral">","</span> << std::dec
<< ep
<< <span class=
"stringliteral">")"</span>);
210 <a name=
"l00188"></a>00188 <span class=
"keywordtype">int
</span> ret = usb_clear_halt(m_handle, ep);
211 <a name=
"l00189"></a>00189 m_lasterror = ret;
212 <a name=
"l00190"></a>00190 <span class=
"keywordflow">return
</span> ret
>=
0;
213 <a name=
"l00191"></a>00191 }
214 <a name=
"l00192"></a>00192
215 <a name=
"l00193"></a>00193 <span class=
"keywordtype">bool
</span> Device::Reset()
216 <a name=
"l00194"></a>00194 {
217 <a name=
"l00195"></a>00195 dout(
<span class=
"stringliteral">"usb_reset("</span> << std::dec
<< m_handle
<< <span class=
"stringliteral">")"</span>);
218 <a name=
"l00196"></a>00196 <span class=
"keywordtype">int
</span> ret = usb_reset(m_handle);
219 <a name=
"l00197"></a>00197 m_lasterror = ret;
220 <a name=
"l00198"></a>00198 <span class=
"keywordflow">return
</span> ret ==
0;
221 <a name=
"l00199"></a>00199 }
222 <a name=
"l00200"></a>00200
223 <a name=
"l00201"></a>00201 <span class=
"keywordtype">bool
</span> Device::BulkRead(
<span class=
"keywordtype">int
</span> ep, Barry::Data
&data,
<span class=
"keywordtype">int
</span> timeout)
224 <a name=
"l00202"></a>00202 {
225 <a name=
"l00203"></a>00203 <span class=
"keywordtype">int
</span> ret;
226 <a name=
"l00204"></a>00204 <span class=
"keywordflow">do
</span> {
227 <a name=
"l00205"></a>00205 data.QuickZap();
228 <a name=
"l00206"></a>00206 ret = usb_bulk_read(m_handle, ep,
229 <a name=
"l00207"></a>00207 (
<span class=
"keywordtype">char
</span>*) data.GetBuffer(), data.GetBufSize(),
230 <a name=
"l00208"></a>00208 timeout == -
1 ? m_timeout : timeout);
231 <a name=
"l00209"></a>00209 <span class=
"keywordflow">if
</span>( ret
< 0 && ret != -EINTR
&& ret != -EAGAIN ) {
232 <a name=
"l00210"></a>00210 m_lasterror = ret;
233 <a name=
"l00211"></a>00211 <span class=
"keywordflow">if
</span>( ret == -ETIMEDOUT )
234 <a name=
"l00212"></a>00212 <span class=
"keywordflow">throw
</span> Timeout(ret,
<span class=
"stringliteral">"Timeout in usb_bulk_read"</span>);
235 <a name=
"l00213"></a>00213 <span class=
"keywordflow">else
</span>
236 <a name=
"l00214"></a>00214 <span class=
"keywordflow">throw
</span> Error(ret,
<span class=
"stringliteral">"Error in usb_bulk_read"</span>);
237 <a name=
"l00215"></a>00215 }
238 <a name=
"l00216"></a>00216 data.ReleaseBuffer(ret);
239 <a name=
"l00217"></a>00217 }
<span class=
"keywordflow">while
</span>( ret == -EINTR || ret == -EAGAIN );
240 <a name=
"l00218"></a>00218
241 <a name=
"l00219"></a>00219 <span class=
"keywordflow">return
</span> ret
>=
0;
242 <a name=
"l00220"></a>00220 }
243 <a name=
"l00221"></a>00221
244 <a name=
"l00222"></a>00222 <span class=
"keywordtype">bool
</span> Device::BulkWrite(
<span class=
"keywordtype">int
</span> ep,
<span class=
"keyword">const
</span> Barry::Data
&data,
<span class=
"keywordtype">int
</span> timeout)
245 <a name=
"l00223"></a>00223 {
246 <a name=
"l00224"></a>00224 ddout(
<span class=
"stringliteral">"BulkWrite to endpoint "</span> << std::dec
<< ep
<< <span class=
"stringliteral">":\n"</span> << data);
247 <a name=
"l00225"></a>00225 <span class=
"keywordtype">int
</span> ret;
248 <a name=
"l00226"></a>00226 <span class=
"keywordflow">do
</span> {
249 <a name=
"l00227"></a>00227 ret = usb_bulk_write(m_handle, ep,
250 <a name=
"l00228"></a>00228 (
<span class=
"keywordtype">char
</span>*) data.GetData(), data.GetSize(),
251 <a name=
"l00229"></a>00229 timeout == -
1 ? m_timeout : timeout);
252 <a name=
"l00230"></a>00230 <span class=
"keywordflow">if
</span>( ret
< 0 && ret != -EINTR
&& ret != -EAGAIN ) {
253 <a name=
"l00231"></a>00231 m_lasterror = ret;
254 <a name=
"l00232"></a>00232 <span class=
"keywordflow">if
</span>( ret == -ETIMEDOUT )
255 <a name=
"l00233"></a>00233 <span class=
"keywordflow">throw
</span> Timeout(ret,
<span class=
"stringliteral">"Timeout in usb_bulk_write (1)"</span>);
256 <a name=
"l00234"></a>00234 <span class=
"keywordflow">else
</span>
257 <a name=
"l00235"></a>00235 <span class=
"keywordflow">throw
</span> Error(ret,
<span class=
"stringliteral">"Error in usb_bulk_write (1)"</span>);
258 <a name=
"l00236"></a>00236 }
259 <a name=
"l00237"></a>00237 }
<span class=
"keywordflow">while
</span>( ret == -EINTR || ret == -EAGAIN );
260 <a name=
"l00238"></a>00238
261 <a name=
"l00239"></a>00239 <span class=
"keywordflow">return
</span> ret
>=
0;
262 <a name=
"l00240"></a>00240 }
263 <a name=
"l00241"></a>00241
264 <a name=
"l00242"></a>00242 <span class=
"keywordtype">bool
</span> Device::BulkWrite(
<span class=
"keywordtype">int
</span> ep,
<span class=
"keyword">const
</span> <span class=
"keywordtype">void
</span> *data,
<span class=
"keywordtype">size_t
</span> size,
<span class=
"keywordtype">int
</span> timeout)
265 <a name=
"l00243"></a>00243 {
266 <a name=
"l00244"></a>00244 <span class=
"preprocessor">#ifdef __DEBUG_MODE__
</span>
267 <a name=
"l00245"></a>00245 <span class=
"preprocessor"></span> Barry::Data dump(data, size);
268 <a name=
"l00246"></a>00246 ddout(
<span class=
"stringliteral">"BulkWrite to endpoint "</span> << std::dec
<< ep
<< <span class=
"stringliteral">":\n"</span> << dump);
269 <a name=
"l00247"></a>00247 <span class=
"preprocessor">#endif
</span>
270 <a name=
"l00248"></a>00248 <span class=
"preprocessor"></span>
271 <a name=
"l00249"></a>00249 <span class=
"keywordtype">int
</span> ret;
272 <a name=
"l00250"></a>00250 <span class=
"keywordflow">do
</span> {
273 <a name=
"l00251"></a>00251 ret = usb_bulk_write(m_handle, ep,
274 <a name=
"l00252"></a>00252 (
<span class=
"keywordtype">char
</span>*) data, size,
275 <a name=
"l00253"></a>00253 timeout == -
1 ? m_timeout : timeout);
276 <a name=
"l00254"></a>00254 <span class=
"keywordflow">if
</span>( ret
< 0 && ret != -EINTR
&& ret != -EAGAIN ) {
277 <a name=
"l00255"></a>00255 m_lasterror = ret;
278 <a name=
"l00256"></a>00256 <span class=
"keywordflow">if
</span>( ret == -ETIMEDOUT )
279 <a name=
"l00257"></a>00257 <span class=
"keywordflow">throw
</span> Timeout(ret,
<span class=
"stringliteral">"Timeout in usb_bulk_write (2)"</span>);
280 <a name=
"l00258"></a>00258 <span class=
"keywordflow">else
</span>
281 <a name=
"l00259"></a>00259 <span class=
"keywordflow">throw
</span> Error(ret,
<span class=
"stringliteral">"Error in usb_bulk_write (2)"</span>);
282 <a name=
"l00260"></a>00260 }
283 <a name=
"l00261"></a>00261 }
<span class=
"keywordflow">while
</span>( ret == -EINTR || ret == -EAGAIN );
284 <a name=
"l00262"></a>00262
285 <a name=
"l00263"></a>00263 <span class=
"keywordflow">return
</span> ret
>=
0;
286 <a name=
"l00264"></a>00264 }
287 <a name=
"l00265"></a>00265
288 <a name=
"l00266"></a>00266 <span class=
"keywordtype">bool
</span> Device::InterruptRead(
<span class=
"keywordtype">int
</span> ep, Barry::Data
&data,
<span class=
"keywordtype">int
</span> timeout)
289 <a name=
"l00267"></a>00267 {
290 <a name=
"l00268"></a>00268 <span class=
"keywordtype">int
</span> ret;
291 <a name=
"l00269"></a>00269 <span class=
"keywordflow">do
</span> {
292 <a name=
"l00270"></a>00270 data.QuickZap();
293 <a name=
"l00271"></a>00271 ret = usb_interrupt_read(m_handle, ep,
294 <a name=
"l00272"></a>00272 (
<span class=
"keywordtype">char
</span>*) data.GetBuffer(), data.GetBufSize(),
295 <a name=
"l00273"></a>00273 timeout == -
1 ? m_timeout : timeout);
296 <a name=
"l00274"></a>00274 <span class=
"keywordflow">if
</span>( ret
< 0 && ret != -EINTR
&& ret != -EAGAIN ) {
297 <a name=
"l00275"></a>00275 m_lasterror = ret;
298 <a name=
"l00276"></a>00276 <span class=
"keywordflow">if
</span>( ret == -ETIMEDOUT )
299 <a name=
"l00277"></a>00277 <span class=
"keywordflow">throw
</span> Timeout(ret,
<span class=
"stringliteral">"Timeout in usb_interrupt_read"</span>);
300 <a name=
"l00278"></a>00278 <span class=
"keywordflow">else
</span>
301 <a name=
"l00279"></a>00279 <span class=
"keywordflow">throw
</span> Error(ret,
<span class=
"stringliteral">"Error in usb_interrupt_read"</span>);
302 <a name=
"l00280"></a>00280 }
303 <a name=
"l00281"></a>00281 data.ReleaseBuffer(ret);
304 <a name=
"l00282"></a>00282 }
<span class=
"keywordflow">while
</span>( ret == -EINTR || ret == -EAGAIN );
305 <a name=
"l00283"></a>00283
306 <a name=
"l00284"></a>00284 <span class=
"keywordflow">return
</span> ret
>=
0;
307 <a name=
"l00285"></a>00285 }
308 <a name=
"l00286"></a>00286
309 <a name=
"l00287"></a>00287 <span class=
"keywordtype">bool
</span> Device::InterruptWrite(
<span class=
"keywordtype">int
</span> ep,
<span class=
"keyword">const
</span> Barry::Data
&data,
<span class=
"keywordtype">int
</span> timeout)
310 <a name=
"l00288"></a>00288 {
311 <a name=
"l00289"></a>00289 ddout(
<span class=
"stringliteral">"InterruptWrite to endpoint "</span> << std::dec
<< ep
<< <span class=
"stringliteral">":\n"</span> << data);
312 <a name=
"l00290"></a>00290
313 <a name=
"l00291"></a>00291 <span class=
"keywordtype">int
</span> ret;
314 <a name=
"l00292"></a>00292 <span class=
"keywordflow">do
</span> {
315 <a name=
"l00293"></a>00293 ret = usb_interrupt_write(m_handle, ep,
316 <a name=
"l00294"></a>00294 (
<span class=
"keywordtype">char
</span>*) data.GetData(), data.GetSize(),
317 <a name=
"l00295"></a>00295 timeout == -
1 ? m_timeout : timeout);
318 <a name=
"l00296"></a>00296 <span class=
"keywordflow">if
</span>( ret
< 0 && ret != -EINTR
&& ret != -EAGAIN ) {
319 <a name=
"l00297"></a>00297 m_lasterror = ret;
320 <a name=
"l00298"></a>00298 <span class=
"keywordflow">if
</span>( ret == -ETIMEDOUT )
321 <a name=
"l00299"></a>00299 <span class=
"keywordflow">throw
</span> Timeout(ret,
<span class=
"stringliteral">"Timeout in usb_interrupt_write"</span>);
322 <a name=
"l00300"></a>00300 <span class=
"keywordflow">else
</span>
323 <a name=
"l00301"></a>00301 <span class=
"keywordflow">throw
</span> Error(ret,
<span class=
"stringliteral">"Error in usb_interrupt_write"</span>);
324 <a name=
"l00302"></a>00302 }
325 <a name=
"l00303"></a>00303 }
<span class=
"keywordflow">while
</span>( ret == -EINTR || ret == -EAGAIN );
326 <a name=
"l00304"></a>00304
327 <a name=
"l00305"></a>00305 <span class=
"keywordflow">return
</span> ret
>=
0;
328 <a name=
"l00306"></a>00306 }
329 <a name=
"l00307"></a>00307
330 <a name=
"l00308"></a>00308 <span class=
"comment">//
</span>
331 <a name=
"l00309"></a>00309 <span class=
"comment">// BulkDrain
</span>
332 <a name=
"l00310"></a>00310 <span class=
"comment">//
</span><span class=
"comment"></span>
333 <a name=
"l00311"></a>00311 <span class=
"comment">/// Reads anything available on the given endpoint, with a low timeout,
</span>
334 <a name=
"l00312"></a>00312 <span class=
"comment">/// in order to clear any pending reads.
</span>
335 <a name=
"l00313"></a>00313 <span class=
"comment">///
</span>
336 <a name=
"l00314"></a>00314 <span class=
"comment"></span><span class=
"keywordtype">void
</span> Device::BulkDrain(
<span class=
"keywordtype">int
</span> ep,
<span class=
"keywordtype">int
</span> timeout)
337 <a name=
"l00315"></a>00315 {
338 <a name=
"l00316"></a>00316 <span class=
"keywordflow">try
</span> {
339 <a name=
"l00317"></a>00317 Barry::Data data;
340 <a name=
"l00318"></a>00318 <span class=
"keywordflow">while
</span>( BulkRead(ep, data, timeout) )
341 <a name=
"l00319"></a>00319 ;
342 <a name=
"l00320"></a>00320 }
343 <a name=
"l00321"></a>00321 <span class=
"keywordflow">catch
</span>(
<a class=
"code" href=
"classUsb_1_1Error.html" title=
"Thrown on low level USB errors.">Usb::Error
</a> & ) {}
344 <a name=
"l00322"></a>00322 }
345 <a name=
"l00323"></a>00323
346 <a name=
"l00324"></a>00324 <span class=
"comment">//
</span>
347 <a name=
"l00325"></a>00325 <span class=
"comment">// GetConfiguration
</span>
348 <a name=
"l00326"></a>00326 <span class=
"comment">//
</span><span class=
"comment"></span>
349 <a name=
"l00327"></a>00327 <span class=
"comment">/// Uses the GET_CONFIGURATION control message to determine the currently
</span>
350 <a name=
"l00328"></a>00328 <span class=
"comment">/// selected USB configuration, returning it in the cfg argument.
</span>
351 <a name=
"l00329"></a>00329 <span class=
"comment">/// If unsuccessful, returns false.
</span>
352 <a name=
"l00330"></a>00330 <span class=
"comment">///
</span>
353 <a name=
"l00331"></a>00331 <span class=
"comment"></span><span class=
"keywordtype">bool
</span> Device::GetConfiguration(
<span class=
"keywordtype">unsigned
</span> <span class=
"keywordtype">char
</span> &cfg)
354 <a name=
"l00332"></a>00332 {
355 <a name=
"l00333"></a>00333 <span class=
"keywordtype">int
</span> result = usb_control_msg(m_handle,
0x80, USB_REQ_GET_CONFIGURATION,
0,
0,
356 <a name=
"l00334"></a>00334 (
<span class=
"keywordtype">char
</span>*)
&cfg,
1, m_timeout);
357 <a name=
"l00335"></a>00335 m_lasterror = result;
358 <a name=
"l00336"></a>00336 <span class=
"keywordflow">return
</span> result
>=
0;
359 <a name=
"l00337"></a>00337 }
360 <a name=
"l00338"></a>00338
361 <a name=
"l00339"></a>00339
362 <a name=
"l00340"></a>00340 <span class=
"comment"></span>
363 <a name=
"l00341"></a>00341 <span class=
"comment">///////////////////////////////////////////////////////////////////////////////
</span>
364 <a name=
"l00342"></a>00342 <span class=
"comment"></span><span class=
"comment">// Interface
</span>
365 <a name=
"l00343"></a>00343
366 <a name=
"l00344"></a>00344 Interface::Interface(Device
&dev,
<span class=
"keywordtype">int
</span> iface)
367 <a name=
"l00345"></a>00345 : m_dev(dev), m_iface(iface)
368 <a name=
"l00346"></a>00346 {
369 <a name=
"l00347"></a>00347 dout(
<span class=
"stringliteral">"usb_claim_interface("</span> << dev.GetHandle()
<< <span class=
"stringliteral">","</span> << std::dec
<< iface
<< <span class=
"stringliteral">")"</span>);
370 <a name=
"l00348"></a>00348 <span class=
"keywordtype">int
</span> ret = usb_claim_interface(dev.GetHandle(), iface);
371 <a name=
"l00349"></a>00349 <span class=
"keywordflow">if
</span>( ret
< 0 )
372 <a name=
"l00350"></a>00350 <span class=
"keywordflow">throw
</span> Error(ret,
<span class=
"stringliteral">"claim interface failed"</span>);
373 <a name=
"l00351"></a>00351
374 <a name=
"l00352"></a>00352 <span class=
"comment">// kernels
>=
2.6.28 don't set the interface the same as
</span>
375 <a name=
"l00353"></a>00353 <span class=
"comment">// previous versions did, and the Blackberry gets confused
</span>
376 <a name=
"l00354"></a>00354 <span class=
"comment">// if it isn't explicitly set
</span>
377 <a name=
"l00355"></a>00355 ret = usb_set_altinterface(dev.GetHandle(), iface);
378 <a name=
"l00356"></a>00356 <span class=
"keywordflow">if
</span>( ret
< 0 )
379 <a name=
"l00357"></a>00357 <span class=
"keywordflow">throw
</span> Error(ret,
<span class=
"stringliteral">"set alt interface failed"</span>);
380 <a name=
"l00358"></a>00358 }
381 <a name=
"l00359"></a>00359
382 <a name=
"l00360"></a>00360 Interface::~Interface()
383 <a name=
"l00361"></a>00361 {
384 <a name=
"l00362"></a>00362 dout(
<span class=
"stringliteral">"usb_release_interface("</span> << m_dev.GetHandle()
<< <span class=
"stringliteral">","</span> << std::dec
<< m_iface
<< <span class=
"stringliteral">")"</span>);
385 <a name=
"l00363"></a>00363 usb_release_interface(m_dev.GetHandle(), m_iface);
386 <a name=
"l00364"></a>00364 }
387 <a name=
"l00365"></a>00365
388 <a name=
"l00366"></a>00366
389 <a name=
"l00367"></a>00367 <span class=
"comment"></span>
390 <a name=
"l00368"></a>00368 <span class=
"comment">///////////////////////////////////////////////////////////////////////////////
</span>
391 <a name=
"l00369"></a>00369 <span class=
"comment"></span><span class=
"comment">// EndpointDiscovery
</span>
392 <a name=
"l00370"></a>00370
393 <a name=
"l00371"></a>00371 <span class=
"keywordtype">bool
</span> EndpointDiscovery::Discover(
<span class=
"keyword">struct
</span> usb_interface_descriptor *interface,
<span class=
"keywordtype">int
</span> epcount)
394 <a name=
"l00372"></a>00372 {
395 <a name=
"l00373"></a>00373 <span class=
"comment">// start fresh
</span>
396 <a name=
"l00374"></a>00374 clear();
397 <a name=
"l00375"></a>00375 m_valid =
<span class=
"keyword">false
</span>;
398 <a name=
"l00376"></a>00376
399 <a name=
"l00377"></a>00377 EndpointPair pair;
400 <a name=
"l00378"></a>00378
401 <a name=
"l00379"></a>00379 <span class=
"keywordflow">if
</span>( !interface || !interface-
>endpoint ) {
402 <a name=
"l00380"></a>00380 dout(
<span class=
"stringliteral">"EndpointDiscovery::Discover: empty interface pointer"</span>);
403 <a name=
"l00381"></a>00381 <span class=
"keywordflow">return
</span> <span class=
"keyword">false
</span>;
404 <a name=
"l00382"></a>00382 }
405 <a name=
"l00383"></a>00383
406 <a name=
"l00384"></a>00384 <span class=
"keywordflow">for
</span>(
<span class=
"keywordtype">int
</span> i =
0; i
< epcount; i++ ) {
407 <a name=
"l00385"></a>00385 <span class=
"comment">// load descriptor
</span>
408 <a name=
"l00386"></a>00386 usb_endpoint_descriptor desc;
409 <a name=
"l00387"></a>00387 desc = interface-
>endpoint[i];
410 <a name=
"l00388"></a>00388 dout(
<span class=
"stringliteral">" endpoint_desc #"</span> << i
<< <span class=
"stringliteral">" loaded"</span>
411 <a name=
"l00389"></a>00389 << <span class=
"stringliteral">"\nbLength: "</span> << (
<span class=
"keywordtype">unsigned
</span> ) desc.bLength
412 <a name=
"l00390"></a>00390 << <span class=
"stringliteral">"\nbDescriptorType: "</span> << (
<span class=
"keywordtype">unsigned
</span> ) desc.bDescriptorType
413 <a name=
"l00391"></a>00391 << <span class=
"stringliteral">"\nbEndpointAddress: "</span> << (
<span class=
"keywordtype">unsigned
</span> ) desc.bEndpointAddress
414 <a name=
"l00392"></a>00392 << <span class=
"stringliteral">"\nbmAttributes: "</span> << (
<span class=
"keywordtype">unsigned
</span> ) desc.bmAttributes
415 <a name=
"l00393"></a>00393 << <span class=
"stringliteral">"\nwMaxPacketSize: "</span> << (
<span class=
"keywordtype">unsigned
</span> ) desc.wMaxPacketSize
416 <a name=
"l00394"></a>00394 << <span class=
"stringliteral">"\nbInterval: "</span> << (
<span class=
"keywordtype">unsigned
</span> ) desc.bInterval
417 <a name=
"l00395"></a>00395 << <span class=
"stringliteral">"\nbRefresh: "</span> << (
<span class=
"keywordtype">unsigned
</span> ) desc.bRefresh
418 <a name=
"l00396"></a>00396 << <span class=
"stringliteral">"\nbSynchAddress: "</span> << (
<span class=
"keywordtype">unsigned
</span> ) desc.bSynchAddress
419 <a name=
"l00397"></a>00397 << <span class=
"stringliteral">"\n"</span>
420 <a name=
"l00398"></a>00398 );
421 <a name=
"l00399"></a>00399
422 <a name=
"l00400"></a>00400 <span class=
"comment">// add to the map
</span>
423 <a name=
"l00401"></a>00401 (*this)[desc.bEndpointAddress] = desc;
424 <a name=
"l00402"></a>00402 dout(
<span class=
"stringliteral">" endpoint added to map with bEndpointAddress: "</span> << (
<span class=
"keywordtype">unsigned
</span> <span class=
"keywordtype">int
</span>)desc.bEndpointAddress);
425 <a name=
"l00403"></a>00403
426 <a name=
"l00404"></a>00404 <span class=
"comment">// parse the endpoint into read/write sets, if possible,
</span>
427 <a name=
"l00405"></a>00405 <span class=
"comment">// going in discovery order...
</span>
428 <a name=
"l00406"></a>00406 <span class=
"comment">// Assumptions:
</span>
429 <a name=
"l00407"></a>00407 <span class=
"comment">// - endpoints of related utility will be grouped
</span>
430 <a name=
"l00408"></a>00408 <span class=
"comment">// - endpoints with same type will be grouped
</span>
431 <a name=
"l00409"></a>00409 <span class=
"comment">// - endpoints that do not meet the above assumptions
</span>
432 <a name=
"l00410"></a>00410 <span class=
"comment">// do not belong in a pair
</span>
433 <a name=
"l00411"></a>00411 <span class=
"keywordtype">unsigned
</span> <span class=
"keywordtype">char
</span> type = desc.bmAttributes
& USB_ENDPOINT_TYPE_MASK;
434 <a name=
"l00412"></a>00412 <span class=
"keywordflow">if
</span>( desc.bEndpointAddress
& USB_ENDPOINT_DIR_MASK ) {
435 <a name=
"l00413"></a>00413 <span class=
"comment">// read endpoint
</span>
436 <a name=
"l00414"></a>00414 pair.read = desc.bEndpointAddress;
437 <a name=
"l00415"></a>00415 dout(
<span class=
"stringliteral">" pair.read = "</span> << (
<span class=
"keywordtype">unsigned
</span> <span class=
"keywordtype">int
</span>)pair.read);
438 <a name=
"l00416"></a>00416 <span class=
"keywordflow">if
</span>( pair.IsTypeSet()
&& pair.type != type ) {
439 <a name=
"l00417"></a>00417 <span class=
"comment">// if type is already set, we must start over
</span>
440 <a name=
"l00418"></a>00418 pair.write =
0;
441 <a name=
"l00419"></a>00419 }
442 <a name=
"l00420"></a>00420 }
443 <a name=
"l00421"></a>00421 <span class=
"keywordflow">else
</span> {
444 <a name=
"l00422"></a>00422 <span class=
"comment">// write endpoint
</span>
445 <a name=
"l00423"></a>00423 pair.write = desc.bEndpointAddress;
446 <a name=
"l00424"></a>00424 dout(
<span class=
"stringliteral">" pair.write = "</span> << (
<span class=
"keywordtype">unsigned
</span> <span class=
"keywordtype">int
</span>)pair.write);
447 <a name=
"l00425"></a>00425 <span class=
"keywordflow">if
</span>( pair.IsTypeSet()
&& pair.type != type ) {
448 <a name=
"l00426"></a>00426 <span class=
"comment">// if type is already set, we must start over
</span>
449 <a name=
"l00427"></a>00427 pair.read =
0;
450 <a name=
"l00428"></a>00428 }
451 <a name=
"l00429"></a>00429 }
452 <a name=
"l00430"></a>00430 <span class=
"comment">// save the type last
</span>
453 <a name=
"l00431"></a>00431 pair.type = type;
454 <a name=
"l00432"></a>00432 dout(
<span class=
"stringliteral">" pair.type = "</span> << (
<span class=
"keywordtype">unsigned
</span> <span class=
"keywordtype">int
</span>)pair.type);
455 <a name=
"l00433"></a>00433
456 <a name=
"l00434"></a>00434 <span class=
"comment">// if pair is complete, add to array
</span>
457 <a name=
"l00435"></a>00435 <span class=
"keywordflow">if
</span>( pair.IsComplete() ) {
458 <a name=
"l00436"></a>00436 m_endpoints.push_back(pair);
459 <a name=
"l00437"></a>00437 dout(
<span class=
"stringliteral">" pair added! ("</span>
460 <a name=
"l00438"></a>00438 << <span class=
"stringliteral">"read: "</span> << (
<span class=
"keywordtype">unsigned
</span> <span class=
"keywordtype">int
</span>)pair.read
<< <span class=
"stringliteral">","</span>
461 <a name=
"l00439"></a>00439 << <span class=
"stringliteral">"write: "</span> << (
<span class=
"keywordtype">unsigned
</span> <span class=
"keywordtype">int
</span>)pair.write
<< <span class=
"stringliteral">","</span>
462 <a name=
"l00440"></a>00440 << <span class=
"stringliteral">"type: "</span> << (
<span class=
"keywordtype">unsigned
</span> <span class=
"keywordtype">int
</span>)pair.type
<< <span class=
"stringliteral">")"</span>);
463 <a name=
"l00441"></a>00441 pair = EndpointPair();
<span class=
"comment">// clear
</span>
464 <a name=
"l00442"></a>00442 }
465 <a name=
"l00443"></a>00443 }
466 <a name=
"l00444"></a>00444
467 <a name=
"l00445"></a>00445 <span class=
"comment">// just for debugging purposes, check for extra descriptors, and
</span>
468 <a name=
"l00446"></a>00446 <span class=
"comment">// dump them to dout if they exist
</span>
469 <a name=
"l00447"></a>00447 <span class=
"keywordflow">if
</span>( interface-
>extra ) {
470 <a name=
"l00448"></a>00448 dout(
<span class=
"stringliteral">"while parsing endpoints, found a block of extra descriptors:"</span>);
471 <a name=
"l00449"></a>00449 Barry::Data data(interface-
>extra, interface-
>extralen);
472 <a name=
"l00450"></a>00450 dout(data);
473 <a name=
"l00451"></a>00451 }
474 <a name=
"l00452"></a>00452
475 <a name=
"l00453"></a>00453 <span class=
"keywordflow">return
</span> m_valid =
<span class=
"keyword">true
</span>;
476 <a name=
"l00454"></a>00454 }
477 <a name=
"l00455"></a>00455
478 <a name=
"l00456"></a>00456 <span class=
"comment"></span>
479 <a name=
"l00457"></a>00457 <span class=
"comment">///////////////////////////////////////////////////////////////////////////////
</span>
480 <a name=
"l00458"></a>00458 <span class=
"comment"></span><span class=
"comment">// InterfaceDiscovery
</span>
481 <a name=
"l00459"></a>00459
482 <a name=
"l00460"></a>00460 <span class=
"keywordtype">bool
</span> InterfaceDiscovery::DiscoverInterface(
<span class=
"keyword">struct
</span> usb_interface *interface)
483 <a name=
"l00461"></a>00461 {
484 <a name=
"l00462"></a>00462 <span class=
"keywordflow">if
</span>( !interface-
>altsetting ) {
485 <a name=
"l00463"></a>00463 dout(
<span class=
"stringliteral">"InterfaceDiscovery::DiscoverIterface: empty altsetting"</span>);
486 <a name=
"l00464"></a>00464 <span class=
"comment">// some devices are buggy and return a higher bNumInterfaces
</span>
487 <a name=
"l00465"></a>00465 <span class=
"comment">// than the number of interfaces available... in this case
</span>
488 <a name=
"l00466"></a>00466 <span class=
"comment">// we just skip and continue
</span>
489 <a name=
"l00467"></a>00467 <span class=
"keywordflow">return
</span> <span class=
"keyword">true
</span>;
490 <a name=
"l00468"></a>00468 }
491 <a name=
"l00469"></a>00469
492 <a name=
"l00470"></a>00470 <span class=
"keywordflow">for
</span>(
<span class=
"keywordtype">int
</span> i =
0; i
< interface-
>num_altsetting; i++ ) {
493 <a name=
"l00471"></a>00471 <span class=
"comment">// load descriptor
</span>
494 <a name=
"l00472"></a>00472 InterfaceDesc desc;
495 <a name=
"l00473"></a>00473 desc.desc = interface-
>altsetting[i];
496 <a name=
"l00474"></a>00474 dout(
<span class=
"stringliteral">" interface_desc #"</span> << i
<< <span class=
"stringliteral">" loaded"</span>
497 <a name=
"l00475"></a>00475 << <span class=
"stringliteral">"\nbLength: "</span> << (
<span class=
"keywordtype">unsigned
</span>) desc.desc.bLength
498 <a name=
"l00476"></a>00476 << <span class=
"stringliteral">"\nbDescriptorType: "</span> << (
<span class=
"keywordtype">unsigned
</span>) desc.desc.bDescriptorType
499 <a name=
"l00477"></a>00477 << <span class=
"stringliteral">"\nbInterfaceNumber: "</span> << (
<span class=
"keywordtype">unsigned
</span>) desc.desc.bInterfaceNumber
500 <a name=
"l00478"></a>00478 << <span class=
"stringliteral">"\nbAlternateSetting: "</span> << (
<span class=
"keywordtype">unsigned
</span>) desc.desc.bAlternateSetting
501 <a name=
"l00479"></a>00479 << <span class=
"stringliteral">"\nbNumEndpoints: "</span> << (
<span class=
"keywordtype">unsigned
</span>) desc.desc.bNumEndpoints
502 <a name=
"l00480"></a>00480 << <span class=
"stringliteral">"\nbInterfaceClass: "</span> << (
<span class=
"keywordtype">unsigned
</span>) desc.desc.bInterfaceClass
503 <a name=
"l00481"></a>00481 << <span class=
"stringliteral">"\nbInterfaceSubClass: "</span> << (
<span class=
"keywordtype">unsigned
</span>) desc.desc.bInterfaceSubClass
504 <a name=
"l00482"></a>00482 << <span class=
"stringliteral">"\nbInterfaceProtocol: "</span> << (
<span class=
"keywordtype">unsigned
</span>) desc.desc.bInterfaceProtocol
505 <a name=
"l00483"></a>00483 << <span class=
"stringliteral">"\niInterface: "</span> << (
<span class=
"keywordtype">unsigned
</span>) desc.desc.iInterface
506 <a name=
"l00484"></a>00484 << <span class=
"stringliteral">"\n"</span>
507 <a name=
"l00485"></a>00485 );
508 <a name=
"l00486"></a>00486
509 <a name=
"l00487"></a>00487 <span class=
"comment">// load all endpoints on this interface
</span>
510 <a name=
"l00488"></a>00488 <span class=
"keywordflow">if
</span>( !desc.endpoints.Discover(
&desc.desc, desc.desc.bNumEndpoints) ) {
511 <a name=
"l00489"></a>00489 dout(
<span class=
"stringliteral">" endpoint discovery failed for bInterfaceNumber: "</span> << (
<span class=
"keywordtype">unsigned
</span> <span class=
"keywordtype">int
</span>)desc.desc.bInterfaceNumber
<< <span class=
"stringliteral">", not added to map."</span>);
512 <a name=
"l00490"></a>00490 <span class=
"keywordflow">return
</span> <span class=
"keyword">false
</span>;
513 <a name=
"l00491"></a>00491 }
514 <a name=
"l00492"></a>00492
515 <a name=
"l00493"></a>00493 <span class=
"comment">// add to the map
</span>
516 <a name=
"l00494"></a>00494 (*this)[desc.desc.bInterfaceNumber] = desc;
517 <a name=
"l00495"></a>00495 dout(
<span class=
"stringliteral">" interface added to map with bInterfaceNumber: "</span> << (
<span class=
"keywordtype">unsigned
</span> <span class=
"keywordtype">int
</span>)desc.desc.bInterfaceNumber);
518 <a name=
"l00496"></a>00496 }
519 <a name=
"l00497"></a>00497 <span class=
"keywordflow">return
</span> <span class=
"keyword">true
</span>;
520 <a name=
"l00498"></a>00498 }
521 <a name=
"l00499"></a>00499
522 <a name=
"l00500"></a>00500 <span class=
"keywordtype">bool
</span> InterfaceDiscovery::Discover(
<a class=
"code" href=
"namespaceUsb.html#6d445b3f5ddb92da82207f62e7d9494f" title=
"Typedefs used by the wrapper class, in the hope to make it easier to switch from...">Usb::DeviceIDType
</a> devid,
<span class=
"keywordtype">int
</span> cfgidx,
<span class=
"keywordtype">int
</span> ifcount)
523 <a name=
"l00501"></a>00501 {
524 <a name=
"l00502"></a>00502 <span class=
"comment">// start fresh
</span>
525 <a name=
"l00503"></a>00503 clear();
526 <a name=
"l00504"></a>00504 m_valid =
<span class=
"keyword">false
</span>;
527 <a name=
"l00505"></a>00505
528 <a name=
"l00506"></a>00506 <span class=
"keywordflow">if
</span>( !devid || !devid-
>config || !devid-
>config[cfgidx].interface ) {
529 <a name=
"l00507"></a>00507 dout(
<span class=
"stringliteral">"InterfaceDiscovery::Discover: empty devid/config/interface"</span>);
530 <a name=
"l00508"></a>00508 <span class=
"keywordflow">return
</span> <span class=
"keyword">false
</span>;
531 <a name=
"l00509"></a>00509 }
532 <a name=
"l00510"></a>00510
533 <a name=
"l00511"></a>00511 <span class=
"keywordflow">for
</span>(
<span class=
"keywordtype">int
</span> i =
0; i
< ifcount; i++ ) {
534 <a name=
"l00512"></a>00512 <span class=
"keywordflow">if
</span>( !DiscoverInterface(
&devid-
>config[cfgidx].interface[i]) )
535 <a name=
"l00513"></a>00513 <span class=
"keywordflow">return
</span> <span class=
"keyword">false
</span>;
536 <a name=
"l00514"></a>00514 }
537 <a name=
"l00515"></a>00515
538 <a name=
"l00516"></a>00516 <span class=
"keywordflow">return
</span> m_valid =
<span class=
"keyword">true
</span>;
539 <a name=
"l00517"></a>00517 }
540 <a name=
"l00518"></a>00518
541 <a name=
"l00519"></a>00519 <span class=
"comment"></span>
542 <a name=
"l00520"></a>00520 <span class=
"comment">///////////////////////////////////////////////////////////////////////////////
</span>
543 <a name=
"l00521"></a>00521 <span class=
"comment"></span><span class=
"comment">// ConfigDiscovery
</span>
544 <a name=
"l00522"></a>00522
545 <a name=
"l00523"></a>00523 <span class=
"keywordtype">bool
</span> ConfigDiscovery::Discover(
<a class=
"code" href=
"namespaceUsb.html#6d445b3f5ddb92da82207f62e7d9494f" title=
"Typedefs used by the wrapper class, in the hope to make it easier to switch from...">Usb::DeviceIDType
</a> devid,
<span class=
"keywordtype">int
</span> cfgcount)
546 <a name=
"l00524"></a>00524 {
547 <a name=
"l00525"></a>00525 <span class=
"comment">// start fresh
</span>
548 <a name=
"l00526"></a>00526 clear();
549 <a name=
"l00527"></a>00527 m_valid =
<span class=
"keyword">false
</span>;
550 <a name=
"l00528"></a>00528
551 <a name=
"l00529"></a>00529 <span class=
"keywordflow">for
</span>(
<span class=
"keywordtype">int
</span> i =
0; i
< cfgcount; i++ ) {
552 <a name=
"l00530"></a>00530 <span class=
"comment">// load descriptor
</span>
553 <a name=
"l00531"></a>00531 ConfigDesc desc;
554 <a name=
"l00532"></a>00532 <span class=
"keywordflow">if
</span>( !devid || !devid-
>config ) {
555 <a name=
"l00533"></a>00533 dout(
<span class=
"stringliteral">"ConfigDiscovery::Discover: empty devid or config"</span>);
556 <a name=
"l00534"></a>00534 <span class=
"keywordflow">return
</span> <span class=
"keyword">false
</span>;
557 <a name=
"l00535"></a>00535 }
558 <a name=
"l00536"></a>00536 desc.desc = devid-
>config[i];
559 <a name=
"l00537"></a>00537 dout(
<span class=
"stringliteral">" config_desc #"</span> << i
<< <span class=
"stringliteral">" loaded"</span>
560 <a name=
"l00538"></a>00538 << <span class=
"stringliteral">"\nbLength: "</span> << (
<span class=
"keywordtype">unsigned
</span> <span class=
"keywordtype">int
</span>) desc.desc.bLength
561 <a name=
"l00539"></a>00539 << <span class=
"stringliteral">"\nbDescriptorType: "</span> << (
<span class=
"keywordtype">unsigned
</span> <span class=
"keywordtype">int
</span>) desc.desc.bDescriptorType
562 <a name=
"l00540"></a>00540 << <span class=
"stringliteral">"\nwTotalLength: "</span> << (
<span class=
"keywordtype">unsigned
</span> <span class=
"keywordtype">int
</span>) desc.desc.wTotalLength
563 <a name=
"l00541"></a>00541 << <span class=
"stringliteral">"\nbNumInterfaces: "</span> << (
<span class=
"keywordtype">unsigned
</span> <span class=
"keywordtype">int
</span>) desc.desc.bNumInterfaces
564 <a name=
"l00542"></a>00542 << <span class=
"stringliteral">"\nbConfigurationValue: "</span> << (
<span class=
"keywordtype">unsigned
</span> <span class=
"keywordtype">int
</span>) desc.desc.bConfigurationValue
565 <a name=
"l00543"></a>00543 << <span class=
"stringliteral">"\niConfiguration: "</span> << (
<span class=
"keywordtype">unsigned
</span> <span class=
"keywordtype">int
</span>) desc.desc.iConfiguration
566 <a name=
"l00544"></a>00544 << <span class=
"stringliteral">"\nbmAttributes: "</span> << (
<span class=
"keywordtype">unsigned
</span> <span class=
"keywordtype">int
</span>) desc.desc.bmAttributes
567 <a name=
"l00545"></a>00545 << <span class=
"stringliteral">"\nMaxPower: "</span> << (
<span class=
"keywordtype">unsigned
</span> <span class=
"keywordtype">int
</span>) desc.desc.MaxPower
568 <a name=
"l00546"></a>00546 << <span class=
"stringliteral">"\n"</span>
569 <a name=
"l00547"></a>00547 );
570 <a name=
"l00548"></a>00548
571 <a name=
"l00549"></a>00549 <span class=
"comment">// just for debugging purposes, check for extra descriptors, and
</span>
572 <a name=
"l00550"></a>00550 <span class=
"comment">// dump them to dout if they exist
</span>
573 <a name=
"l00551"></a>00551 <span class=
"keywordflow">if
</span>( desc.desc.extra ) {
574 <a name=
"l00552"></a>00552 dout(
<span class=
"stringliteral">"while parsing config descriptor, found a block of extra descriptors:"</span>);
575 <a name=
"l00553"></a>00553 Barry::Data data(desc.desc.extra, desc.desc.extralen);
576 <a name=
"l00554"></a>00554 dout(data);
577 <a name=
"l00555"></a>00555 }
578 <a name=
"l00556"></a>00556
579 <a name=
"l00557"></a>00557 <span class=
"comment">// load all interfaces on this configuration
</span>
580 <a name=
"l00558"></a>00558 <span class=
"keywordflow">if
</span>( !desc.interfaces.Discover(devid, i, desc.desc.bNumInterfaces) ) {
581 <a name=
"l00559"></a>00559 dout(
<span class=
"stringliteral">" config discovery failed for bConfigurationValue: "</span> << (
<span class=
"keywordtype">unsigned
</span> <span class=
"keywordtype">int
</span>)desc.desc.bConfigurationValue
<< <span class=
"stringliteral">", not added to map."</span>);
582 <a name=
"l00560"></a>00560 <span class=
"keywordflow">return
</span> <span class=
"keyword">false
</span>;
583 <a name=
"l00561"></a>00561 }
584 <a name=
"l00562"></a>00562
585 <a name=
"l00563"></a>00563 <span class=
"comment">// add to the map
</span>
586 <a name=
"l00564"></a>00564 (*this)[desc.desc.bConfigurationValue] = desc;
587 <a name=
"l00565"></a>00565 dout(
<span class=
"stringliteral">" config added to map with bConfigurationValue: "</span> << (
<span class=
"keywordtype">unsigned
</span> <span class=
"keywordtype">int
</span>)desc.desc.bConfigurationValue);
588 <a name=
"l00566"></a>00566 }
589 <a name=
"l00567"></a>00567
590 <a name=
"l00568"></a>00568 <span class=
"keywordflow">return
</span> m_valid =
<span class=
"keyword">true
</span>;
591 <a name=
"l00569"></a>00569 }
592 <a name=
"l00570"></a>00570
593 <a name=
"l00571"></a>00571 <span class=
"comment"></span>
594 <a name=
"l00572"></a>00572 <span class=
"comment">///////////////////////////////////////////////////////////////////////////////
</span>
595 <a name=
"l00573"></a>00573 <span class=
"comment"></span><span class=
"comment">// DeviceDiscovery
</span>
596 <a name=
"l00574"></a>00574
597 <a name=
"l00575"></a>00575 DeviceDiscovery::DeviceDiscovery(
<a class=
"code" href=
"namespaceUsb.html#6d445b3f5ddb92da82207f62e7d9494f" title=
"Typedefs used by the wrapper class, in the hope to make it easier to switch from...">Usb::DeviceIDType
</a> devid)
598 <a name=
"l00576"></a>00576 : m_valid(false)
599 <a name=
"l00577"></a>00577 {
600 <a name=
"l00578"></a>00578 Discover(devid);
601 <a name=
"l00579"></a>00579 }
602 <a name=
"l00580"></a>00580
603 <a name=
"l00581"></a>00581 <span class=
"keywordtype">bool
</span> DeviceDiscovery::Discover(
<a class=
"code" href=
"namespaceUsb.html#6d445b3f5ddb92da82207f62e7d9494f" title=
"Typedefs used by the wrapper class, in the hope to make it easier to switch from...">Usb::DeviceIDType
</a> devid)
604 <a name=
"l00582"></a>00582 {
605 <a name=
"l00583"></a>00583 <span class=
"comment">// start fresh
</span>
606 <a name=
"l00584"></a>00584 configs.clear();
607 <a name=
"l00585"></a>00585 m_valid =
<span class=
"keyword">false
</span>;
608 <a name=
"l00586"></a>00586
609 <a name=
"l00587"></a>00587 <span class=
"comment">// copy the descriptor over to our memory
</span>
610 <a name=
"l00588"></a>00588 <span class=
"keywordflow">if
</span>( !devid ) {
611 <a name=
"l00589"></a>00589 dout(
<span class=
"stringliteral">"DeviceDiscovery::Discover: empty devid"</span>);
612 <a name=
"l00590"></a>00590 <span class=
"keywordflow">return
</span> <span class=
"keyword">false
</span>;
613 <a name=
"l00591"></a>00591 }
614 <a name=
"l00592"></a>00592
615 <a name=
"l00593"></a>00593 desc = devid-
>descriptor;
616 <a name=
"l00594"></a>00594 dout(
<span class=
"stringliteral">"device_desc loaded"</span>
617 <a name=
"l00595"></a>00595 << <span class=
"stringliteral">"\nbLength: "</span> << (
<span class=
"keywordtype">unsigned
</span> <span class=
"keywordtype">int
</span>) desc.bLength
618 <a name=
"l00596"></a>00596 << <span class=
"stringliteral">"\nbDescriptorType: "</span> << (
<span class=
"keywordtype">unsigned
</span> <span class=
"keywordtype">int
</span>) desc.bDescriptorType
619 <a name=
"l00597"></a>00597 << <span class=
"stringliteral">"\nbcdUSB: "</span> << (
<span class=
"keywordtype">unsigned
</span> <span class=
"keywordtype">int
</span>) desc.bcdUSB
620 <a name=
"l00598"></a>00598 << <span class=
"stringliteral">"\nbDeviceClass: "</span> << (
<span class=
"keywordtype">unsigned
</span> <span class=
"keywordtype">int
</span>) desc.bDeviceClass
621 <a name=
"l00599"></a>00599 << <span class=
"stringliteral">"\nbDeviceSubClass: "</span> << (
<span class=
"keywordtype">unsigned
</span> <span class=
"keywordtype">int
</span>) desc.bDeviceSubClass
622 <a name=
"l00600"></a>00600 << <span class=
"stringliteral">"\nbDeviceProtocol: "</span> << (
<span class=
"keywordtype">unsigned
</span> <span class=
"keywordtype">int
</span>) desc.bDeviceProtocol
623 <a name=
"l00601"></a>00601 << <span class=
"stringliteral">"\nbMaxPacketSize0: "</span> << (
<span class=
"keywordtype">unsigned
</span> <span class=
"keywordtype">int
</span>) desc.bMaxPacketSize0
624 <a name=
"l00602"></a>00602 << <span class=
"stringliteral">"\nidVendor: "</span> << (
<span class=
"keywordtype">unsigned
</span> <span class=
"keywordtype">int
</span>) desc.idVendor
625 <a name=
"l00603"></a>00603 << <span class=
"stringliteral">"\nidProduct: "</span> << (
<span class=
"keywordtype">unsigned
</span> <span class=
"keywordtype">int
</span>) desc.idProduct
626 <a name=
"l00604"></a>00604 << <span class=
"stringliteral">"\nbcdDevice: "</span> << (
<span class=
"keywordtype">unsigned
</span> <span class=
"keywordtype">int
</span>) desc.bcdDevice
627 <a name=
"l00605"></a>00605 << <span class=
"stringliteral">"\niManufacturer: "</span> << (
<span class=
"keywordtype">unsigned
</span> <span class=
"keywordtype">int
</span>) desc.iManufacturer
628 <a name=
"l00606"></a>00606 << <span class=
"stringliteral">"\niProduct: "</span> << (
<span class=
"keywordtype">unsigned
</span> <span class=
"keywordtype">int
</span>) desc.iProduct
629 <a name=
"l00607"></a>00607 << <span class=
"stringliteral">"\niSerialNumber: "</span> << (
<span class=
"keywordtype">unsigned
</span> <span class=
"keywordtype">int
</span>) desc.iSerialNumber
630 <a name=
"l00608"></a>00608 << <span class=
"stringliteral">"\nbNumConfigurations: "</span> << (
<span class=
"keywordtype">unsigned
</span> <span class=
"keywordtype">int
</span>) desc.bNumConfigurations
631 <a name=
"l00609"></a>00609 << <span class=
"stringliteral">"\n"</span>
632 <a name=
"l00610"></a>00610 );
633 <a name=
"l00611"></a>00611
634 <a name=
"l00612"></a>00612 m_valid = configs.Discover(devid, desc.bNumConfigurations);
635 <a name=
"l00613"></a>00613 <span class=
"keywordflow">return
</span> m_valid;
636 <a name=
"l00614"></a>00614 }
637 <a name=
"l00615"></a>00615
638 <a name=
"l00616"></a>00616 }
<span class=
"comment">// namespace Usb
</span>
639 <a name=
"l00617"></a>00617
641 <hr size=
"1"><address style=
"text-align: right;"><small>Generated on Sat Aug
29 00:
01:
53 2009 for Barry by
642 <a href=
"http://www.doxygen.org/index.html">
643 <img src=
"doxygen.png" alt=
"doxygen" align=
"middle" border=
"0"></a> 1.5.6 </small></address>