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>
This commit is contained in:
Jon Trulson
2017-04-28 18:33:34 -06:00
parent c78da687d4
commit 21a1860ec2
26 changed files with 4918 additions and 0 deletions

View File

@ -189,6 +189,7 @@ add_example(BMM150_Example bmm150)
add_example(LSM303AGR_Example lsm303agr)
add_example(LSM303D_Example lsm303d)
add_example(VEML6070Sample veml6070)
add_example(RN2903_Example rn2903)
add_example_with_path(Jhd1313m1_lcdSample jhd1313m1 jhd1313m1)
add_example_with_path(Jhd1313m1Sample jhd1313m1 jhd1313m1)
@ -215,3 +216,5 @@ add_example_with_path(NMEAGPS_I2C_Example nmea_gps nmea_gps)
add_example_with_path(MCP2515_TXRX_Example mcp2515 mcp2515)
add_example_with_path(LE910_Example uartat uartat)
add_example_with_path(SpeakerPWMSample speaker speaker)
add_example_with_path(RN2903_P2P_RX_Example rn2903 rn2903)
add_example_with_path(RN2903_P2P_TX_Example rn2903 rn2903)

View File

@ -0,0 +1,138 @@
/*
* 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_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());
// we can support two types of join, OTAA and ABP. Each requires
// that certain parameters be set first. We will only attempt ABP
// joining with this example since it's the only one that can
// succeed without actual configuration. In both cases, if you
// are actually attempting to join a real LoRaWAN network, you
// must change the parameters below to match the network you are
// attempting to join.
// For OTAA, you need to supply valid Device EUI, Application EUI,
// and Application key:
//
// sensor.setDeviceEUI("0011223344556677");
// sensor.setApplicationEUI("0011223344556677");
// sensor.setApplicationKey("01234567012345670123456701234567");
//
// RN2903_JOIN_STATUS_T rv = sensor.join(RN2903_JOIN_TYPE_OTAA);
// A successful join will return RN2903_JOIN_STATUS_ACCEPTED (0).
// cout << "JOIN: got rv " << int(rv) << endl;
// Try an ABP join. Note, these parameters are made up. For a
// real network, you will want to use the correct values
// obviously. For an ABP join, you need to supply the Device
// Address, Network Session Key, and the Application Session Key.
sensor.setDeviceAddr("00112233");
sensor.setNetworkSessionKey("00112233001122330011223300112233");
sensor.setApplicationSessionKey("00112233001122330011223300112233");
RN2903_JOIN_STATUS_T rv =
sensor.join(RN2903_JOIN_TYPE_T.RN2903_JOIN_TYPE_ABP);
if (rv == RN2903_JOIN_STATUS_T.RN2903_JOIN_STATUS_ACCEPTED)
{
System.out.println("Join successful.");
// All transmit payloads must be hex encoded strings, so
// pretend we have a temperature sensor that gave us a value
// of 25.6 C, and we want to transmit it.
String faketemp = "25.6";
System.out.println("Transmitting a packet...");
RN2903_MAC_TX_STATUS_T trv =
sensor.macTx(RN2903_MAC_MSG_TYPE_T.RN2903_MAC_MSG_TYPE_UNCONFIRMED,
1, // port number
sensor.toHex(faketemp));
if (trv == RN2903_MAC_TX_STATUS_T.RN2903_MAC_TX_STATUS_TX_OK)
System.out.println("Transmit successful.");
else
{
// check to see if we got a downlink packet
if (trv == RN2903_MAC_TX_STATUS_T.RN2903_MAC_TX_STATUS_RX_RECEIVED)
{
System.out.println("Transmit successful, downlink packet received: "
+ sensor.getResponse());
}
else
{
System.out.println("Transmit failed with code " + trv);
}
}
}
else
{
System.out.println("Join failed with code " + rv);
}
System.out.println("Exiting...");
// ! [Interesting]
}
}

View File

@ -0,0 +1,106 @@
/*
* 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_RX_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 to receive a packet
// transmitted by the p2p-tx rn2903 example. 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();
// We will use continuous mode (window_size 0), though the default
// radio watch dog timer will expire every 15 seconds. We will
// just loop here.
while (true)
{
System.out.println("Waiting for packet...");
RN2903_RESPONSE_T rv = sensor.radioRx(0);
if (rv != RN2903_RESPONSE_T.RN2903_RESPONSE_OK)
{
System.out.println("radioRx() failed with code "
+ rv.toString());
}
else
{
String resp = sensor.getResponse();
String payload = sensor.getRadioRxPayload();
if (payload.length() == 0)
System.out.println("Got response: '" + resp + "'");
else
System.out.println("Got payload: '"
+ sensor.fromHex(payload)
+ "'");
}
System.out.println();
}
// ! [Interesting]
}
}

View File

@ -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]
}
}