altoslib: Pass InterruptedException up the stack instead of hiding it
[fw/altos] / altoslib / AltosLink.java
1 /*
2  * Copyright © 2011 Keith Packard <keithp@keithp.com>
3  *
4  * This program is free software; you can redistribute it and/or modify
5  * it under the terms of the GNU General Public License as published by
6  * the Free Software Foundation; version 2 of the License.
7  *
8  * This program is distributed in the hope that it will be useful, but
9  * WITHOUT ANY WARRANTY; without even the implied warranty of
10  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
11  * General Public License for more details.
12  *
13  * You should have received a copy of the GNU General Public License along
14  * with this program; if not, write to the Free Software Foundation, Inc.,
15  * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.
16  */
17
18 package org.altusmetrum.altoslib_2;
19
20 import java.io.*;
21 import java.util.concurrent.*;
22 import java.util.*;
23
24 public abstract class AltosLink implements Runnable {
25
26         public final static int ERROR = -1;
27         public final static int TIMEOUT = -2;
28
29         public abstract int getchar() throws InterruptedException;
30         public abstract void print(String data) throws InterruptedException;
31         public abstract void putchar(byte c);
32         public abstract void close() throws InterruptedException;
33
34         public static boolean debug = false;
35         public static void set_debug(boolean in_debug) { debug = in_debug; }
36
37         public boolean has_error;
38
39         LinkedList<String> pending_output = new LinkedList<String>();
40
41         public LinkedList<LinkedBlockingQueue<AltosLine>> monitors = new LinkedList<LinkedBlockingQueue<AltosLine>> ();;
42         public LinkedBlockingQueue<AltosLine> reply_queue = new LinkedBlockingQueue<AltosLine>();
43         public LinkedBlockingQueue<byte[]> binary_queue = new LinkedBlockingQueue<byte[]>();
44
45         public synchronized void add_monitor(LinkedBlockingQueue<AltosLine> q) {
46                 set_monitor(true);
47                 monitors.add(q);
48         }
49
50         public synchronized void remove_monitor(LinkedBlockingQueue<AltosLine> q) {
51                 monitors.remove(q);
52                 if (monitors.isEmpty())
53                         set_monitor(false);
54         }
55
56         public void printf(String format, Object ... arguments) {
57                 String  line = String.format(format, arguments);
58                 if (debug)
59                         pending_output.add(line);
60                 try {
61                         print(line);
62                 } catch (InterruptedException ie) {
63
64                 }
65         }
66
67         public String get_reply_no_dialog(int timeout) throws InterruptedException, TimeoutException {
68                 flush_output();
69                 AltosLine line = reply_queue.poll(timeout, TimeUnit.MILLISECONDS);
70                 if (line != null)
71                         return line.line;
72                 return null;
73         }
74
75         public String get_reply() throws InterruptedException {
76                 return get_reply(5000);
77         }
78
79                 
80         public abstract boolean can_cancel_reply();
81         public abstract boolean show_reply_timeout();
82         public abstract void hide_reply_timeout();
83
84         public boolean  reply_abort;
85         public int      in_reply;
86
87         boolean         reply_timeout_shown = false;
88
89         private boolean check_reply_timeout() {
90                 if (!reply_timeout_shown)
91                         reply_timeout_shown = show_reply_timeout();
92                 return reply_abort;
93         }
94
95         private void cleanup_reply_timeout() {
96                 if (reply_timeout_shown) {
97                         reply_timeout_shown = false;
98                         hide_reply_timeout();
99                 }
100         }
101
102         private int     len_read = 0;
103
104         public void run () {
105                 int c;
106                 byte[] line_bytes = null;
107                 int line_count = 0;
108
109                 try {
110                         for (;;) {
111                                 c = getchar();
112                                 if (Thread.interrupted()) {
113                                         break;
114                                 }
115                                 if (c == ERROR) {
116                                         if (debug)
117                                                 System.out.printf("ERROR\n");
118                                         has_error = true;
119                                         add_telem (new AltosLine());
120                                         add_reply (new AltosLine());
121                                         break;
122                                 }
123                                 if (c == TIMEOUT) {
124                                         if (debug)
125                                                 System.out.printf("TIMEOUT\n");
126                                         continue;
127                                 }
128                                 if (c == '\r' && len_read == 0)
129                                         continue;
130                                 synchronized(this) {
131                                         if (c == '\n' && len_read == 0) {
132                                                 if (line_count != 0) {
133                                                         add_bytes(line_bytes, line_count);
134                                                         line_count = 0;
135                                                 }
136                                         } else {
137                                                 if (line_bytes == null) {
138                                                         line_bytes = new byte[256];
139                                                 } else if (line_count == line_bytes.length) {
140                                                         byte[] new_line_bytes = new byte[line_count * 2];
141                                                         System.arraycopy(line_bytes, 0, new_line_bytes, 0, line_count);
142                                                         line_bytes = new_line_bytes;
143                                                 }
144                                                 line_bytes[line_count] = (byte) c;
145                                                 line_count++;
146                                                 if (len_read !=0 && line_count == len_read) {
147                                                         add_binary(line_bytes, line_count);
148                                                         line_count = 0;
149                                                         len_read = 0;
150                                                 }
151                                         }
152                                 }
153                         }
154                 } catch (InterruptedException e) {
155                 }
156         }
157
158
159         public String get_reply(int timeout) throws InterruptedException {
160                 boolean can_cancel = can_cancel_reply();
161                 String  reply = null;
162
163                 if (!can_cancel && remote)
164                         System.out.printf("Uh-oh, reading remote serial device from swing thread\n");
165
166                 if (remote && can_cancel)
167                         timeout = 500;
168                 try {
169                         ++in_reply;
170
171                         flush_output();
172
173                         reply_abort = false;
174                         reply_timeout_shown = false;
175                         for (;;) {
176                                 AltosLine line = reply_queue.poll(timeout, TimeUnit.MILLISECONDS);
177                                 if (line != null) {
178                                         cleanup_reply_timeout();
179                                         reply = line.line;
180                                         break;
181                                 }
182                                 if (!remote || !can_cancel || check_reply_timeout()) {
183                                         reply = null;
184                                         break;
185                                 }
186                         }
187                 } finally {
188                         --in_reply;
189                 }
190                 return reply;
191         }
192
193         public byte[] get_binary_reply(int timeout, int len) throws InterruptedException {
194                 boolean can_cancel = can_cancel_reply();
195                 byte[] bytes = null;
196
197                 synchronized(this) {
198                         len_read = len;
199                 }
200                 try {
201                         ++in_reply;
202
203                         flush_output();
204
205                         reply_abort = false;
206                         reply_timeout_shown = false;
207                         for (;;) {
208                                 bytes = binary_queue.poll(timeout, TimeUnit.MILLISECONDS);
209                                 if (bytes != null) {
210                                         cleanup_reply_timeout();
211                                         break;
212                                 }
213                                 if (!remote || !can_cancel || check_reply_timeout()) {
214                                         bytes = null;
215                                         break;
216                                 }
217                         }
218                         
219                 } finally {
220                         --in_reply;
221                 }
222                 return bytes;
223         }
224
225         public void add_telem(AltosLine line) throws InterruptedException {
226                 for (int e = 0; e < monitors.size(); e++) {
227                         LinkedBlockingQueue<AltosLine> q = monitors.get(e);
228                         q.put(line);
229                 }
230         }
231
232         public void add_reply(AltosLine line) throws InterruptedException {
233                 reply_queue.put (line);
234         }
235
236         public void abort_reply() {
237                 try {
238                         add_telem (new AltosLine());
239                         add_reply (new AltosLine());
240                 } catch (InterruptedException ie) {
241                 }
242         }
243
244         public void add_string(String line) throws InterruptedException {
245                 if (line.startsWith("TELEM") || line.startsWith("VERSION") || line.startsWith("CRC")) {
246                         add_telem(new AltosLine(line));
247                 } else {
248                         add_reply(new AltosLine(line));
249                 }
250         }
251
252         public void add_bytes(byte[] bytes, int len) throws InterruptedException {
253                 String  line;
254                 try {
255                         line = new String(bytes, 0, len, "UTF-8");
256                 } catch (UnsupportedEncodingException ue) {
257                         line = "";
258                         for (int i = 0; i < len; i++)
259                                 line = line + bytes[i];
260                 }
261                 if (debug)
262                         System.out.printf("\t\t\t\t\t%s\n", line);
263                 add_string(line);
264         }
265
266         public void add_binary(byte[] bytes, int len) throws InterruptedException {
267                 byte[] dup = new byte[len];
268
269                 if (debug)
270                         System.out.printf ("\t\t\t\t\t%d:", len);
271                 for(int i = 0; i < len; i++) {
272                         dup[i] = bytes[i];
273                         if (debug)
274                                 System.out.printf(" %02x", dup[i]);
275                 }
276                 if (debug)
277                         System.out.printf("\n");
278
279                 binary_queue.put(dup);
280         }
281
282         public void flush_output() {
283                 for (String s : pending_output)
284                         System.out.print(s);
285                 pending_output.clear();
286         }
287
288         public void flush_input(int timeout) throws InterruptedException {
289                 flush_output();
290                 boolean got_some;
291
292                 do {
293                         Thread.sleep(timeout);
294                         got_some = !reply_queue.isEmpty();
295                         reply_queue.clear();
296                 } while (got_some);
297         }
298
299
300         public void flush_input() throws InterruptedException {
301                 if (remote)
302                         flush_input(500);
303                 else
304                         flush_input(100);
305         }
306
307
308         /*
309          * Various command-level operations on
310          * the link
311          */
312         public boolean monitor_mode = false;
313         public int telemetry = AltosLib.ao_telemetry_standard;
314         public double frequency;
315         public String callsign;
316         AltosConfigData config_data;
317
318         private Object config_data_lock = new Object();
319
320         private int telemetry_len() {
321                 return AltosLib.telemetry_len(telemetry);
322         }
323
324         private void set_radio_freq(int frequency) {
325                 if (monitor_mode)
326                         printf("m 0\nc F %d\nm %x\n",
327                                frequency, telemetry_len());
328                 else
329                         printf("c F %d\n", frequency);
330                 flush_output();
331         }
332
333         public void set_radio_frequency(double frequency,
334                                         boolean has_frequency,
335                                         boolean has_setting,
336                                         int cal) {
337                 if (debug)
338                         System.out.printf("set_radio_frequency %7.3f (freq %b) (set %b) %d\n", frequency, has_frequency, has_setting, cal);
339                 if (frequency == 0)
340                         return;
341                 if (has_frequency)
342                         set_radio_freq((int) Math.floor (frequency * 1000));
343                 else if (has_setting)
344                         set_radio_setting(AltosConvert.radio_frequency_to_setting(frequency, cal));
345                 else
346                         set_channel(AltosConvert.radio_frequency_to_channel(frequency));
347         }
348
349         public void set_radio_frequency(double in_frequency) throws InterruptedException, TimeoutException {
350                 frequency = in_frequency;
351                 config_data();
352                 set_radio_frequency(frequency,
353                                     config_data.radio_frequency > 0,
354                                     config_data.radio_setting > 0,
355                                     config_data.radio_calibration);
356         }
357
358         public void set_telemetry(int in_telemetry) {
359                 telemetry = in_telemetry;
360                 if (monitor_mode)
361                         printf("m 0\nm %x\n", telemetry_len());
362                 flush_output();
363         }
364
365         public void set_monitor(boolean monitor) {
366                 monitor_mode = monitor;
367                 if (monitor)
368                         printf("m %x\n", telemetry_len());
369                 else
370                         printf("m 0\n");
371                 flush_output();
372         }
373
374         private void set_channel(int channel) {
375                 if (monitor_mode)
376                         printf("m 0\nc r %d\nm %x\n",
377                                channel, telemetry_len());
378                 else
379                         printf("c r %d\n", channel);
380                 flush_output();
381         }
382
383         private void set_radio_setting(int setting) {
384                 if (monitor_mode)
385                         printf("m 0\nc R %d\nm %x\n",
386                                setting, telemetry_len());
387                 else
388                         printf("c R %d\n", setting);
389                 flush_output();
390         }
391
392         public AltosConfigData config_data() throws InterruptedException, TimeoutException {
393                 synchronized(config_data_lock) {
394                         if (config_data == null)
395                                 config_data = new AltosConfigData(this);
396                         return config_data;
397                 }
398         }
399
400         public void set_callsign(String callsign) {
401                 this.callsign = callsign;
402                 printf ("c c %s\n", callsign);
403                 flush_output();
404         }
405
406         public boolean is_loader() throws InterruptedException {
407                 boolean ret = false;
408                 printf("v\n");
409                 for (;;) {
410                         String line = get_reply();
411
412                         if (line == null)
413                                 return false;
414                         if (line.startsWith("software-version"))
415                                 break;
416                         if (line.startsWith("altos-loader"))
417                                 ret = true;
418                 }
419                 return ret;
420         }
421
422         public void to_loader() throws InterruptedException {
423                 printf("X\n");
424                 flush_output();
425                 close();
426                 Thread.sleep(1000);
427         }
428
429         public boolean remote;
430         public int serial;
431         public String name;
432
433         public void start_remote() throws TimeoutException, InterruptedException {
434                 if (frequency == 0.0)
435                         frequency = AltosPreferences.frequency(serial);
436                 if (debug)
437                         System.out.printf("start remote %7.3f\n", frequency);
438                 set_radio_frequency(frequency);
439                 set_callsign(AltosPreferences.callsign());
440                 printf("p\nE 0\n");
441                 flush_input();
442                 remote = true;
443         }
444
445         public void stop_remote() throws InterruptedException {
446                 if (debug)
447                         System.out.printf("stop remote\n");
448                 try {
449                         flush_input();
450                 } finally {
451                         printf ("~\n");
452                         flush_output();
453                 }
454                 remote = false;
455         }
456
457         public int rssi() throws TimeoutException, InterruptedException {
458                 if (remote)
459                         return 0;
460                 printf("s\n");
461                 String line = get_reply_no_dialog(5000);
462                 if (line == null)
463                         throw new TimeoutException();
464                 String[] items = line.split("\\s+");
465                 if (items.length < 2)
466                         return 0;
467                 if (!items[0].equals("RSSI:"))
468                         return 0;
469                 int rssi = Integer.parseInt(items[1]);
470                 return rssi;
471         }
472
473         public String[] adc() throws TimeoutException, InterruptedException {
474                 printf("a\n");
475                 for (;;) {
476                         String line = get_reply_no_dialog(5000);
477                         if (line == null) {
478                                 throw new TimeoutException();
479                         }
480                         if (!line.startsWith("tick:"))
481                                 continue;
482                         String[] items = line.split("\\s+");
483                         return items;
484                 }
485         }
486
487         public boolean has_monitor_battery() {
488                 return config_data.has_monitor_battery();
489         }
490
491         public double monitor_battery() throws InterruptedException {
492                 int monitor_batt = AltosLib.MISSING;
493
494                 if (config_data.has_monitor_battery()) {
495                         try {
496                         String[] items = adc();
497                         for (int i = 0; i < items.length;) {
498                                 if (items[i].equals("batt")) {
499                                         monitor_batt = Integer.parseInt(items[i+1]);
500                                         i += 2;
501                                         continue;
502                                 }
503                                 i++;
504                         }
505                         } catch (TimeoutException te) {
506                         }
507                 }
508                 if (monitor_batt == AltosLib.MISSING)
509                         return AltosLib.MISSING;
510                 return AltosConvert.cc_battery_to_voltage(monitor_batt);
511         }
512
513         public AltosLink() {
514                 callsign = "";
515                 has_error = false;
516         }
517 }