5 <link rel="stylesheet" href="styles.css"> |
5 <link rel="stylesheet" href="styles.css"> |
6 </head> |
6 </head> |
7 <body> |
7 <body> |
8 <a NAME="top" ID="top"></a> |
8 <a NAME="top" ID="top"></a> |
9 <h1>eric7.MicroPython.MicroPythonWebreplSocket</h1> |
9 <h1>eric7.MicroPython.MicroPythonWebreplSocket</h1> |
10 |
|
11 <p> |
10 <p> |
12 Module implementing a websocket class to be connect to the MicroPython webrepl |
11 Module implementing a websocket class to be connect to the MicroPython webrepl |
13 interface. |
12 interface. |
14 </p> |
13 </p> |
|
14 |
15 <h3>Global Attributes</h3> |
15 <h3>Global Attributes</h3> |
16 |
16 <table> |
17 <table> |
17 <tr><td>None</td></tr> |
18 <tr><td>None</td></tr> |
18 </table> |
19 </table> |
19 |
20 <h3>Classes</h3> |
20 <h3>Classes</h3> |
21 |
21 <table> |
22 <table> |
|
23 |
|
24 <tr> |
22 <tr> |
25 <td><a href="#MicroPythonWebreplSocket">MicroPythonWebreplSocket</a></td> |
23 <td><a href="#MicroPythonWebreplSocket">MicroPythonWebreplSocket</a></td> |
26 <td>Class implementing a websocket client to be connected to the MicroPython webrepl interface.</td> |
24 <td>Class implementing a websocket client to be connected to the MicroPython webrepl interface.</td> |
27 </tr> |
25 </tr> |
28 </table> |
26 </table> |
|
27 |
29 <h3>Functions</h3> |
28 <h3>Functions</h3> |
30 |
29 <table> |
31 <table> |
30 <tr><td>None</td></tr> |
32 <tr><td>None</td></tr> |
31 </table> |
33 </table> |
32 |
34 <hr /> |
33 <hr /> |
35 <hr /> |
34 <hr /> |
36 <a NAME="MicroPythonWebreplSocket" ID="MicroPythonWebreplSocket"></a> |
35 <a NAME="MicroPythonWebreplSocket" ID="MicroPythonWebreplSocket"></a> |
37 <h2>MicroPythonWebreplSocket</h2> |
36 <h2>MicroPythonWebreplSocket</h2> |
38 |
|
39 <p> |
37 <p> |
40 Class implementing a websocket client to be connected to the MicroPython webrepl |
38 Class implementing a websocket client to be connected to the MicroPython webrepl |
41 interface. |
39 interface. |
42 </p> |
40 </p> |
|
41 |
43 <h3>Signals</h3> |
42 <h3>Signals</h3> |
44 <dl> |
43 <dl> |
45 |
44 |
46 <dt>readyRead()</dt> |
45 <dt>readyRead()</dt> |
47 <dd> |
46 <dd> |
49 </dd> |
48 </dd> |
50 </dl> |
49 </dl> |
51 <h3>Derived from</h3> |
50 <h3>Derived from</h3> |
52 QWebSocket |
51 QWebSocket |
53 <h3>Class Attributes</h3> |
52 <h3>Class Attributes</h3> |
54 |
53 <table> |
55 <table> |
54 <tr><td>None</td></tr> |
56 <tr><td>None</td></tr> |
55 </table> |
57 </table> |
56 |
58 <h3>Class Methods</h3> |
57 <h3>Class Methods</h3> |
59 |
58 <table> |
60 <table> |
59 <tr><td>None</td></tr> |
61 <tr><td>None</td></tr> |
60 </table> |
62 </table> |
61 |
63 <h3>Methods</h3> |
62 <h3>Methods</h3> |
64 |
63 <table> |
65 <table> |
|
66 |
|
67 <tr> |
64 <tr> |
68 <td><a href="#MicroPythonWebreplSocket.__init__">MicroPythonWebreplSocket</a></td> |
65 <td><a href="#MicroPythonWebreplSocket.__init__">MicroPythonWebreplSocket</a></td> |
69 <td>Constructor</td> |
66 <td>Constructor</td> |
70 </tr> |
67 </tr> |
71 <tr> |
68 <tr> |
115 <tr> |
112 <tr> |
116 <td><a href="#MicroPythonWebreplSocket.writeTextMessage">writeTextMessage</a></td> |
113 <td><a href="#MicroPythonWebreplSocket.writeTextMessage">writeTextMessage</a></td> |
117 <td>Public method write some text data to the webrepl server of the connected device.</td> |
114 <td>Public method write some text data to the webrepl server of the connected device.</td> |
118 </tr> |
115 </tr> |
119 </table> |
116 </table> |
|
117 |
120 <h3>Static Methods</h3> |
118 <h3>Static Methods</h3> |
121 |
119 <table> |
122 <table> |
120 <tr><td>None</td></tr> |
123 <tr><td>None</td></tr> |
121 </table> |
124 </table> |
122 |
125 |
123 |
126 <a NAME="MicroPythonWebreplSocket.__init__" ID="MicroPythonWebreplSocket.__init__"></a> |
124 <a NAME="MicroPythonWebreplSocket.__init__" ID="MicroPythonWebreplSocket.__init__"></a> |
127 <h4>MicroPythonWebreplSocket (Constructor)</h4> |
125 <h4>MicroPythonWebreplSocket (Constructor)</h4> |
128 <b>MicroPythonWebreplSocket</b>(<i>timeout=10000, parent=None</i>) |
126 <b>MicroPythonWebreplSocket</b>(<i>timeout=10000, parent=None</i>) |
129 |
|
130 <p> |
127 <p> |
131 Constructor |
128 Constructor |
132 </p> |
129 </p> |
|
130 |
133 <dl> |
131 <dl> |
134 |
132 |
135 <dt><i>timeout</i> (int)</dt> |
133 <dt><i>timeout</i> (int)</dt> |
136 <dd> |
134 <dd> |
137 timout in milliseconds to be set |
135 timout in milliseconds to be set |
142 </dd> |
140 </dd> |
143 </dl> |
141 </dl> |
144 <a NAME="MicroPythonWebreplSocket.__textDataReceived" ID="MicroPythonWebreplSocket.__textDataReceived"></a> |
142 <a NAME="MicroPythonWebreplSocket.__textDataReceived" ID="MicroPythonWebreplSocket.__textDataReceived"></a> |
145 <h4>MicroPythonWebreplSocket.__textDataReceived</h4> |
143 <h4>MicroPythonWebreplSocket.__textDataReceived</h4> |
146 <b>__textDataReceived</b>(<i>strMessage</i>) |
144 <b>__textDataReceived</b>(<i>strMessage</i>) |
147 |
|
148 <p> |
145 <p> |
149 Private slot handling a received text message. |
146 Private slot handling a received text message. |
150 </p> |
147 </p> |
|
148 |
151 <dl> |
149 <dl> |
152 |
150 |
153 <dt><i>strMessage</i> (str)</dt> |
151 <dt><i>strMessage</i> (str)</dt> |
154 <dd> |
152 <dd> |
155 received text message |
153 received text message |
156 </dd> |
154 </dd> |
157 </dl> |
155 </dl> |
158 <a NAME="MicroPythonWebreplSocket.connectToDevice" ID="MicroPythonWebreplSocket.connectToDevice"></a> |
156 <a NAME="MicroPythonWebreplSocket.connectToDevice" ID="MicroPythonWebreplSocket.connectToDevice"></a> |
159 <h4>MicroPythonWebreplSocket.connectToDevice</h4> |
157 <h4>MicroPythonWebreplSocket.connectToDevice</h4> |
160 <b>connectToDevice</b>(<i>host, port</i>) |
158 <b>connectToDevice</b>(<i>host, port</i>) |
161 |
|
162 <p> |
159 <p> |
163 Public method to connect to the given host and port. |
160 Public method to connect to the given host and port. |
164 </p> |
161 </p> |
|
162 |
165 <dl> |
163 <dl> |
166 |
164 |
167 <dt><i>host</i> (str)</dt> |
165 <dt><i>host</i> (str)</dt> |
168 <dd> |
166 <dd> |
169 host name or IP address |
167 host name or IP address |
186 </dd> |
184 </dd> |
187 </dl> |
185 </dl> |
188 <a NAME="MicroPythonWebreplSocket.disconnect" ID="MicroPythonWebreplSocket.disconnect"></a> |
186 <a NAME="MicroPythonWebreplSocket.disconnect" ID="MicroPythonWebreplSocket.disconnect"></a> |
189 <h4>MicroPythonWebreplSocket.disconnect</h4> |
187 <h4>MicroPythonWebreplSocket.disconnect</h4> |
190 <b>disconnect</b>(<i></i>) |
188 <b>disconnect</b>(<i></i>) |
191 |
|
192 <p> |
189 <p> |
193 Public method to disconnect the websocket. |
190 Public method to disconnect the websocket. |
194 </p> |
191 </p> |
|
192 |
195 <a NAME="MicroPythonWebreplSocket.hasTimedOut" ID="MicroPythonWebreplSocket.hasTimedOut"></a> |
193 <a NAME="MicroPythonWebreplSocket.hasTimedOut" ID="MicroPythonWebreplSocket.hasTimedOut"></a> |
196 <h4>MicroPythonWebreplSocket.hasTimedOut</h4> |
194 <h4>MicroPythonWebreplSocket.hasTimedOut</h4> |
197 <b>hasTimedOut</b>(<i></i>) |
195 <b>hasTimedOut</b>(<i></i>) |
198 |
|
199 <p> |
196 <p> |
200 Public method to check, if the last 'readUntil()' has timed out. |
197 Public method to check, if the last 'readUntil()' has timed out. |
201 </p> |
198 </p> |
|
199 |
202 <dl> |
200 <dl> |
203 <dt>Return:</dt> |
201 <dt>Return:</dt> |
204 <dd> |
202 <dd> |
205 flag indicating a timeout |
203 flag indicating a timeout |
206 </dd> |
204 </dd> |
212 </dd> |
210 </dd> |
213 </dl> |
211 </dl> |
214 <a NAME="MicroPythonWebreplSocket.isConnected" ID="MicroPythonWebreplSocket.isConnected"></a> |
212 <a NAME="MicroPythonWebreplSocket.isConnected" ID="MicroPythonWebreplSocket.isConnected"></a> |
215 <h4>MicroPythonWebreplSocket.isConnected</h4> |
213 <h4>MicroPythonWebreplSocket.isConnected</h4> |
216 <b>isConnected</b>(<i></i>) |
214 <b>isConnected</b>(<i></i>) |
217 |
|
218 <p> |
215 <p> |
219 Public method to check the connected state of the websocket. |
216 Public method to check the connected state of the websocket. |
220 </p> |
217 </p> |
|
218 |
221 <dl> |
219 <dl> |
222 <dt>Return:</dt> |
220 <dt>Return:</dt> |
223 <dd> |
221 <dd> |
224 flag indicating the connected state |
222 flag indicating the connected state |
225 </dd> |
223 </dd> |
231 </dd> |
229 </dd> |
232 </dl> |
230 </dl> |
233 <a NAME="MicroPythonWebreplSocket.login" ID="MicroPythonWebreplSocket.login"></a> |
231 <a NAME="MicroPythonWebreplSocket.login" ID="MicroPythonWebreplSocket.login"></a> |
234 <h4>MicroPythonWebreplSocket.login</h4> |
232 <h4>MicroPythonWebreplSocket.login</h4> |
235 <b>login</b>(<i>password</i>) |
233 <b>login</b>(<i>password</i>) |
236 |
|
237 <p> |
234 <p> |
238 Public method to login to the webrepl console of the device. |
235 Public method to login to the webrepl console of the device. |
239 </p> |
236 </p> |
|
237 |
240 <dl> |
238 <dl> |
241 |
239 |
242 <dt><i>password</i> (str)</dt> |
240 <dt><i>password</i> (str)</dt> |
243 <dd> |
241 <dd> |
244 password |
242 password |
257 </dd> |
255 </dd> |
258 </dl> |
256 </dl> |
259 <a NAME="MicroPythonWebreplSocket.readAll" ID="MicroPythonWebreplSocket.readAll"></a> |
257 <a NAME="MicroPythonWebreplSocket.readAll" ID="MicroPythonWebreplSocket.readAll"></a> |
260 <h4>MicroPythonWebreplSocket.readAll</h4> |
258 <h4>MicroPythonWebreplSocket.readAll</h4> |
261 <b>readAll</b>(<i>timeout=0</i>) |
259 <b>readAll</b>(<i>timeout=0</i>) |
262 |
|
263 <p> |
260 <p> |
264 Public method to read all available data. |
261 Public method to read all available data. |
265 </p> |
262 </p> |
|
263 |
266 <dl> |
264 <dl> |
267 |
265 |
268 <dt><i>timeout</i> (int (optional))</dt> |
266 <dt><i>timeout</i> (int (optional))</dt> |
269 <dd> |
267 <dd> |
270 timeout in milliseconds (0 for no timeout) |
268 timeout in milliseconds (0 for no timeout) |
284 </dd> |
282 </dd> |
285 </dl> |
283 </dl> |
286 <a NAME="MicroPythonWebreplSocket.readUntil" ID="MicroPythonWebreplSocket.readUntil"></a> |
284 <a NAME="MicroPythonWebreplSocket.readUntil" ID="MicroPythonWebreplSocket.readUntil"></a> |
287 <h4>MicroPythonWebreplSocket.readUntil</h4> |
285 <h4>MicroPythonWebreplSocket.readUntil</h4> |
288 <b>readUntil</b>(<i>expected=b"\n", size=None, timeout=0</i>) |
286 <b>readUntil</b>(<i>expected=b"\n", size=None, timeout=0</i>) |
289 |
|
290 <p> |
287 <p> |
291 Public method to read data until an expected sequence is found |
288 Public method to read data until an expected sequence is found |
292 (default: \n) or a specific size is exceeded. |
289 (default: \n) or a specific size is exceeded. |
293 </p> |
290 </p> |
|
291 |
294 <dl> |
292 <dl> |
295 |
293 |
296 <dt><i>expected</i> (bytes)</dt> |
294 <dt><i>expected</i> (bytes)</dt> |
297 <dd> |
295 <dd> |
298 expected bytes sequence |
296 expected bytes sequence |
320 </dd> |
318 </dd> |
321 </dl> |
319 </dl> |
322 <a NAME="MicroPythonWebreplSocket.setTimeout" ID="MicroPythonWebreplSocket.setTimeout"></a> |
320 <a NAME="MicroPythonWebreplSocket.setTimeout" ID="MicroPythonWebreplSocket.setTimeout"></a> |
323 <h4>MicroPythonWebreplSocket.setTimeout</h4> |
321 <h4>MicroPythonWebreplSocket.setTimeout</h4> |
324 <b>setTimeout</b>(<i>timeout</i>) |
322 <b>setTimeout</b>(<i>timeout</i>) |
325 |
|
326 <p> |
323 <p> |
327 Public method to set the socket timeout value. |
324 Public method to set the socket timeout value. |
328 </p> |
325 </p> |
|
326 |
329 <dl> |
327 <dl> |
330 |
328 |
331 <dt><i>timeout</i> (int)</dt> |
329 <dt><i>timeout</i> (int)</dt> |
332 <dd> |
330 <dd> |
333 timout in milliseconds to be set |
331 timout in milliseconds to be set |
338 <b>timeout</b>(<i></i>) |
336 <b>timeout</b>(<i></i>) |
339 |
337 |
340 <a NAME="MicroPythonWebreplSocket.waitForConnected" ID="MicroPythonWebreplSocket.waitForConnected"></a> |
338 <a NAME="MicroPythonWebreplSocket.waitForConnected" ID="MicroPythonWebreplSocket.waitForConnected"></a> |
341 <h4>MicroPythonWebreplSocket.waitForConnected</h4> |
339 <h4>MicroPythonWebreplSocket.waitForConnected</h4> |
342 <b>waitForConnected</b>(<i></i>) |
340 <b>waitForConnected</b>(<i></i>) |
343 |
|
344 <p> |
341 <p> |
345 Public method to wait for the websocket being connected. |
342 Public method to wait for the websocket being connected. |
346 </p> |
343 </p> |
|
344 |
347 <dl> |
345 <dl> |
348 <dt>Return:</dt> |
346 <dt>Return:</dt> |
349 <dd> |
347 <dd> |
350 flag indicating the connect result |
348 flag indicating the connect result |
351 </dd> |
349 </dd> |
357 </dd> |
355 </dd> |
358 </dl> |
356 </dl> |
359 <a NAME="MicroPythonWebreplSocket.writeTextMessage" ID="MicroPythonWebreplSocket.writeTextMessage"></a> |
357 <a NAME="MicroPythonWebreplSocket.writeTextMessage" ID="MicroPythonWebreplSocket.writeTextMessage"></a> |
360 <h4>MicroPythonWebreplSocket.writeTextMessage</h4> |
358 <h4>MicroPythonWebreplSocket.writeTextMessage</h4> |
361 <b>writeTextMessage</b>(<i>data</i>) |
359 <b>writeTextMessage</b>(<i>data</i>) |
362 |
|
363 <p> |
360 <p> |
364 Public method write some text data to the webrepl server of the connected |
361 Public method write some text data to the webrepl server of the connected |
365 device. |
362 device. |
366 </p> |
363 </p> |
|
364 |
367 <dl> |
365 <dl> |
368 |
366 |
369 <dt><i>data</i> (bytes)</dt> |
367 <dt><i>data</i> (bytes)</dt> |
370 <dd> |
368 <dd> |
371 text data to be sent |
369 text data to be sent |