rn2903: Initial implementation; C; C++ wraps C; examples

This requires a new MRAA with UART sendbreak support.

Signed-off-by: Jon Trulson <jtrulson@ics.com>

examples/java/RN2903_P2P_TX_Example.java

@@ -0,0 +1,111 @@
+/*
+ * Author: Jon Trulson <jtrulson@ics.com>
+ * Copyright (c) 2017 Intel Corporation.
+ *
+ * The MIT License
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining
+ * a copy of this software and associated documentation files (the
+ * "Software"), to deal in the Software without restriction, including
+ * without limitation the rights to use, copy, modify, merge, publish,
+ * distribute, sublicense, and/or sell copies of the Software, and to
+ * permit persons to whom the Software is furnished to do so, subject to
+ * the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be
+ * included in all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+ * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+ * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+ * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+ * LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+ * OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+ * WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+ */
+
+import upm_rn2903.*;
+
+public class RN2903_P2P_TX_Example
+{
+    private static String defaultDev = "/dev/ttyUSB0";
+
+    public static void main(String[] args) throws InterruptedException
+    {
+// ! [Interesting]
+
+        if (args.length > 0)
+            defaultDev = args[0];
+
+        System.out.println("Using device " + defaultDev);
+
+        // Instantiate a RN2903 sensor on defaultDev at 57600 baud.
+        RN2903 sensor = new RN2903(defaultDev,
+                                   javaupm_rn2903.RN2903_DEFAULT_BAUDRATE);
+
+        // To use an internal UART understood by MRAA, use the following
+        // to inititialize rather than the above, which by default uses a
+        // tty path.
+        //
+        // RN2903 sensor = new RN2903(defaultDev,
+        //     upm_rn2903.javaupm_rn2903.RN2903_DEFAULT_BAUDRATE);
+
+        // enable debugging
+        // sensor.setDebug(true);
+
+        // get version
+        if (sensor.command("sys get ver")
+            != RN2903_RESPONSE_T.RN2903_RESPONSE_OK)
+        {
+            System.out.println("Failed to retrieve device version string");
+            System.exit(1);
+        }
+        System.out.println("Firmware version: " + sensor.getResponse());
+
+        System.out.println("Hardware EUI: " + sensor.getHardwareEUI());
+
+        // For this example, we will just try transmitting a packet over
+        // LoRa.  We reset the device to defaults, and we do not make any
+        // adjustments to the radio configuration.  You will probably want
+        // to do so for a real life application.
+
+        // The first thing to do is to suspend the LoRaWAN stack on the device.
+        sensor.macPause();
+
+        // the default radio watchdog timer is set for 15 seconds, so we
+        // will send a packet every 10 seconds.  In reality, local
+        // restrictions limit the amount of time on the air, so in a real
+        // implementation, you would not want to send packets that
+        // frequently.
+
+        Integer count = 0;
+        while (true)
+        {
+            String output = "Ping " + count.toString();
+            count++;
+
+            // All payloads must be hex encoded
+            String payload = sensor.toHex(output);
+
+            System.out.println("Transmitting a packet, data: '"
+                + output
+                + "' -> hex: '"
+                + payload
+                + "'");
+
+            RN2903_RESPONSE_T rv = sensor.radioTx(payload);
+
+            if (rv == RN2903_RESPONSE_T.RN2903_RESPONSE_OK)
+                System.out.println("Transmit successful.");
+            else
+                System.out.println("Transmit failed with code "
+                                   + rv.toString());
+
+            System.out.println();
+
+            Thread.sleep(10000);
+        }
+
+// ! [Interesting]
+    }
+}