alexey.zholtikov/upm
1
0
Fork 0
mirror of https://github.com/eclipse/upm.git synced 2025-07-01 09:21:12 +03:00
Code Issues Actions Packages Projects Releases Wiki Activity

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

Browse Source 
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
Download Patch File Download Diff File Expand all files Collapse all files

122
examples/c++/rn2903-p2p-rx.cxx Normal file
View File

@ -0,0 +1,122 @@
/*
* Author: Jon Trulson <jtrulson@ics.com>
* Copyright (c) 2017 Intel Corporation.
*
* 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.
*/
#include <unistd.h>
#include <iostream>
#include <sstream>
#include <string>
#include <signal.h>
#include "rn2903.hpp"
#include "upm_utilities.h"
using namespace std;
bool shouldRun = true;
void sig_handler(int signo)
{
if (signo == SIGINT)
shouldRun = false;
}
int main(int argc, char **argv)
{
signal(SIGINT, sig_handler);
//! [Interesting]
string defaultDev = "/dev/ttyUSB0";
if (argc > 1)
defaultDev = argv[1];
cout << "Using device: " << defaultDev << endl;
// Instantiate a RN2903 sensor on defaultDev at 57600 baud.
upm::RN2903 sensor = upm::RN2903(defaultDev,
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.
//
// upm::RN2903 sensor = upm::RN2903(0, RN2903_DEFAULT_BAUDRATE);
// enable debugging
// sensor.setDebug(true);
// get version
if (sensor.command("sys get ver"))
{
cout << "Failed to retrieve device version string" << endl;
return 1;
}
cout << "Firmware version: " << sensor.getResponse() << endl;
cout << "Hardware EUI: " << sensor.getHardwareEUI() << endl;
// 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 (shouldRun)
{
cout << "Waiting for packet..." << endl;
RN2903_RESPONSE_T rv;
rv = sensor.radioRx(0);
if (rv)
{
cout << "radioRx() failed with code " << int(rv) << endl;
}
else
{
string resp = sensor.getResponse();
string payload = sensor.getRadioRxPayload();
if (!payload.size())
cout << "Got response: '" << resp << "'" << endl;
else
cout <<"Got payload: '"
<< sensor.fromHex(payload)
<< "'"
<< endl;
}
cout << endl;
}
cout << "Exiting" << endl;
//! [Interesting]
return 0;
}

126
examples/c++/rn2903-p2p-tx.cxx Normal file
View File

@ -0,0 +1,126 @@
/*
* Author: Jon Trulson <jtrulson@ics.com>
* Copyright (c) 2017 Intel Corporation.
*
* 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.
*/
#include <unistd.h>
#include <iostream>
#include <sstream>
#include <string>
#include <signal.h>
#include "rn2903.hpp"
#include "upm_utilities.h"
using namespace std;
bool shouldRun = true;
void sig_handler(int signo)
{
if (signo == SIGINT)
shouldRun = false;
}
int main(int argc, char **argv)
{
signal(SIGINT, sig_handler);
//! [Interesting]
string defaultDev = "/dev/ttyUSB0";
if (argc > 1)
defaultDev = argv[1];
cout << "Using device: " << defaultDev << endl;
// Instantiate a RN2903 sensor on defaultDev at 57600 baud.
upm::RN2903 sensor = upm::RN2903(defaultDev,
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.
//
// upm::RN2903 sensor = upm::RN2903(0, RN2903_DEFAULT_BAUDRATE);
// enable debugging
// sensor.setDebug(true);
// get version
if (sensor.command("sys get ver"))
{
cout << "Failed to retrieve device version string" << endl;
return 1;
}
cout << "Firmware version: " << sensor.getResponse() << endl;
cout << "Hardware EUI: " << sensor.getHardwareEUI() << endl;
// 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.
int count = 0;
while (shouldRun)
{
ostringstream output;
output << "Ping " << count++;
// All payloads must be hex encoded
string payload = sensor.toHex(output.str());
cout << "Transmitting a packet, data: '"
<< output.str()
<< "' -> hex: '"
<< payload
<< "'"
<< endl;
RN2903_RESPONSE_T rv;
rv = sensor.radioTx(payload);
if (rv == RN2903_RESPONSE_OK)
cout << "Transmit successful." << endl;
else
cout << "Transmit failed with code " << int(rv) << endl;
cout << endl;
upm_delay(10);
}
cout << "Exiting" << endl;
//! [Interesting]
return 0;
}

137
examples/c++/rn2903.cxx Normal file
View File

@ -0,0 +1,137 @@
/*
* Author: Jon Trulson <jtrulson@ics.com>
* Copyright (c) 2017 Intel Corporation.
*
* 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.
*/
#include <unistd.h>
#include <iostream>
#include <string>
#include "rn2903.hpp"
#include "upm_utilities.h"
using namespace std;
int main(int argc, char **argv)
{
//! [Interesting]
string defaultDev = "/dev/ttyUSB0";
if (argc > 1)
defaultDev = argv[1];
cout << "Using device: " << defaultDev << endl;
// Instantiate a RN2903 sensor on defaultDev at 57600 baud.
upm::RN2903 sensor = upm::RN2903(defaultDev,
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.
//
// upm::RN2903 sensor = upm::RN2903(0, RN2903_DEFAULT_BAUDRATE);
// enable debugging
// sensor.setDebug(true);
// get version
if (sensor.command("sys get ver"))
{
cout << "Failed to retrieve device version string" << endl;
return 1;
}
cout << "Firmware version: " << sensor.getResponse() << endl;
cout << "Hardware EUI: " << sensor.getHardwareEUI() << endl;
// 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_ABP);
if (rv == RN2903_JOIN_STATUS_ACCEPTED)
{
cout << "Join successful." << endl;
// 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";
cout << "Transmitting a packet..." << endl;
RN2903_MAC_TX_STATUS_T trv;
trv = sensor.macTx(RN2903_MAC_MSG_TYPE_UNCONFIRMED,
1, // port number
sensor.toHex(faketemp));
if (trv == RN2903_MAC_TX_STATUS_TX_OK)
cout << "Transmit successful." << endl;
else
{
// check to see if we got a downlink packet
if (trv == RN2903_MAC_TX_STATUS_RX_RECEIVED)
{
cout << "Transmit successful, downlink packet received: "
<< sensor.getResponse();
}
else
{
cout << "Transmit failed with code " << int(trv) << endl;
}
}
}
else
{
cout << "Join failed with code " << int(rv) << endl;
}
cout << "Exiting" << endl;
//! [Interesting]
return 0;
}

137
examples/c/rn2903-p2p-rx.c Normal file
View File

@ -0,0 +1,137 @@
/*
* Author: Jon Trulson <jtrulson@ics.com>
* Copyright (c) 2017 Intel Corporation.
*
* 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.
*/
#include <unistd.h>
#include <stdio.h>
#include <string.h>
#include <signal.h>
#include "rn2903.h"
#include "upm_utilities.h"
#include "upm_platform.h"
int shouldRun = true;
void sig_handler(int signo)
{
if (signo == SIGINT)
shouldRun = false;
}
#if defined(UPM_PLATFORM_ZEPHYR) && !defined(CONFIG_STDOUT_CONSOLE)
# define printf printk
#endif
int main(int argc, char **argv)
{
//! [Interesting]
char *defaultDev = "/dev/ttyUSB0";
if (argc > 1)
defaultDev = argv[1];
printf("Using device: %s\n", defaultDev);
// Instantiate a RN2903 sensor on defaultDev at 57600 baud.
#if defined(UPM_PLATFORM_ZEPHYR)
rn2903_context sensor = rn2903_init(0, RN2903_DEFAULT_BAUDRATE);
#else
rn2903_context sensor = rn2903_init_tty(defaultDev,
RN2903_DEFAULT_BAUDRATE);
#endif
// 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_context sensor = rn2903_init(0, RN2903_DEFAULT_BAUDRATE);
if (!sensor)
{
printf("rn2903_init_tty() failed.\n");
return 1;
}
// enable debugging
// rn2903_set_debug(sensor, true);
// get version
if (rn2903_command(sensor, "sys get ver"))
{
printf("Failed to retrieve device version string\n");
rn2903_close(sensor);
return 1;
}
printf("Firmware version: %s\n", rn2903_get_response(sensor));
printf("Hardware EUI: %s\n", rn2903_get_hardware_eui(sensor));
// 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.
if (rn2903_mac_pause(sensor))
{
printf("Failed to pause the LoRaWAN stack\n");
rn2903_close(sensor);
return 1;
}
// 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 (shouldRun)
{
printf("Waiting for packet...\n");
RN2903_RESPONSE_T rv;
rv = rn2903_radio_rx(sensor, 0);
if (rv)
{
printf("rn2903_radio_rx() failed with code (%d)\n", rv);
}
else
{
const char *resp = rn2903_get_response(sensor);
const char *payload = rn2903_get_radio_rx_payload(sensor);
if (!payload)
printf("Got response: '%s'\n", resp);
else
printf("Got payload: '%s'\n",
rn2903_from_hex(sensor, payload));
}
printf("\n");
}
printf("Exiting\n");
rn2903_close(sensor);
//! [Interesting]
return 0;
}

139
examples/c/rn2903-p2p-tx.c Normal file
View File

@ -0,0 +1,139 @@
/*
* Author: Jon Trulson <jtrulson@ics.com>
* Copyright (c) 2017 Intel Corporation.
*
* 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.
*/
#include <unistd.h>
#include <stdio.h>
#include <string.h>
#include <signal.h>
#include "rn2903.h"
#include "upm_utilities.h"
#include "upm_platform.h"
bool shouldRun = true;
void sig_handler(int signo)
{
if (signo == SIGINT)
shouldRun = false;
}
#if defined(UPM_PLATFORM_ZEPHYR) && !defined(CONFIG_STDOUT_CONSOLE)
# define printf printk
#endif
int main(int argc, char **argv)
{
//! [Interesting]
char *defaultDev = "/dev/ttyUSB0";
if (argc > 1)
defaultDev = argv[1];
printf("Using device: %s\n", defaultDev);
// Instantiate a RN2903 sensor on defaultDev at 57600 baud.
#if defined(UPM_PLATFORM_ZEPHYR)
rn2903_context sensor = rn2903_init(0, RN2903_DEFAULT_BAUDRATE);
#else
rn2903_context sensor = rn2903_init_tty(defaultDev,
RN2903_DEFAULT_BAUDRATE);
#endif
// 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_context sensor = rn2903_init(0, RN2903_DEFAULT_BAUDRATE);
if (!sensor)
{
printf("rn2903_init_tty() failed.\n");
return 1;
}
// enable debugging
// rn2903_set_debug(sensor, true);
// get version
if (rn2903_command(sensor, "sys get ver"))
{
printf("Failed to retrieve device version string\n");
rn2903_close(sensor);
return 1;
}
printf("Firmware version: %s\n", rn2903_get_response(sensor));
printf("Hardware EUI: %s\n", rn2903_get_hardware_eui(sensor));
// 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.
if (rn2903_mac_pause(sensor))
{
printf("Failed to pause the LoRaWAN stack\n");
rn2903_close(sensor);
return 1;
}
// 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.
int count = 0;
while (shouldRun)
{
char pingbuf[32] = {};
snprintf(pingbuf, 32, "Ping %d", count++);
// All payloads must be hex encoded
const char *payload = rn2903_to_hex(sensor, pingbuf, strlen(pingbuf));
printf("Transmitting a packet, data: '%s' -> hex: '%s'\n",
pingbuf, payload);
RN2903_RESPONSE_T rv;
rv = rn2903_radio_tx(sensor, payload);
if (rv == RN2903_RESPONSE_OK)
printf("Transmit successful.\n");
else
printf("Transmit failed with code %d.\n", rv);
printf("\n");
upm_delay(10);
}
printf("Exiting\n");
rn2903_close(sensor);
//! [Interesting]
return 0;
}

153
examples/c/rn2903.c Normal file
View File

@ -0,0 +1,153 @@
/*
* Author: Jon Trulson <jtrulson@ics.com>
* Copyright (c) 2017 Intel Corporation.
*
* 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.
*/
#include <unistd.h>
#include <stdio.h>
#include <string.h>
#include "rn2903.h"
#include "upm_utilities.h"
#include "upm_platform.h"
#if defined(UPM_PLATFORM_ZEPHYR) && !defined(CONFIG_STDOUT_CONSOLE)
# define printf printk
#endif
int main(int argc, char **argv)
{
//! [Interesting]
char *defaultDev = "/dev/ttyUSB0";
if (argc > 1)
defaultDev = argv[1];
printf("Using device: %s\n", defaultDev);
// Instantiate a RN2903 sensor on defaultDev at 57600 baud.
#if defined(UPM_PLATFORM_ZEPHYR)
rn2903_context sensor = rn2903_init(0, RN2903_DEFAULT_BAUDRATE);
#else
rn2903_context sensor = rn2903_init_tty(defaultDev,
RN2903_DEFAULT_BAUDRATE);
#endif
// 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_context sensor = rn2903_init(0, RN2903_DEFAULT_BAUDRATE);
if (!sensor)
{
printf("rn2903_init_tty() failed.\n");
return 1;
}
// enable debugging
// rn2903_set_debug(sensor, true);
// get version
if (rn2903_command(sensor, "sys get ver"))
{
printf("Failed to retrieve device version string\n");
rn2903_close(sensor);
return 1;
}
printf("Firmware version: %s\n", rn2903_get_response(sensor));
printf("Hardware EUI: %s\n", rn2903_get_hardware_eui(sensor));
// 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:
//
// rn2903_set_device_eui(sensor, "0011223344556677");
// rn2903_set_application_eui(sensor, "0011223344556677");
// rn2903_set_application_key(sensor, "01234567012345670123456701234567");
//
// RN2903_JOIN_STATUS_T rv = rn2903_join(sensor, RN2903_JOIN_TYPE_OTAA);
// A successful join will return RN2903_JOIN_STATUS_ACCEPTED (0).
// printf("JOIN: got rv %d\n", rv);
// 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.
rn2903_set_device_addr(sensor, "00112233");
rn2903_set_network_session_key(sensor, "00112233001122330011223300112233");
rn2903_set_application_session_key(sensor,
"00112233001122330011223300112233");
RN2903_JOIN_STATUS_T rv = rn2903_join(sensor, RN2903_JOIN_TYPE_ABP);
if (rv == RN2903_JOIN_STATUS_ACCEPTED)
{
printf("Join successful.\n");
// 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.
const char *faketemp = "25.6";
printf("Transmitting a packet....\n");
RN2903_MAC_TX_STATUS_T trv;
trv = rn2903_mac_tx(sensor, RN2903_MAC_MSG_TYPE_UNCONFIRMED,
1, // port number
rn2903_to_hex(sensor, faketemp, strlen(faketemp)));
if (trv == RN2903_MAC_TX_STATUS_TX_OK)
printf("Transmit successful.\n");
else
{
// check to see if we got a downlink packet
if (trv == RN2903_MAC_TX_STATUS_RX_RECEIVED)
{
printf("Transmit successful, downlink packet received: %s\n",
rn2903_get_response(sensor));
}
else
{
printf("Transmit failed with code %d.\n", trv);
}
}
}
else
{
printf("Join failed with code %d.\n", rv);
}
printf("Exiting\n");
rn2903_close(sensor);
//! [Interesting]
return 0;
}

3
examples/java/CMakeLists.txt
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)

138
examples/java/RN2903_Example.java Normal file
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]
}
}

106
examples/java/RN2903_P2P_RX_Example.java Normal file
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]
}
}

111
examples/java/RN2903_P2P_TX_Example.java Normal file
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]
}
}

103
examples/javascript/rn2903-p2p-rx.js Normal file
View File

@ -0,0 +1,103 @@
/*
* Author: Jon Trulson <jtrulson@ics.com>
* Copyright (c) 2017 Intel Corporation.
*
* 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.
*/
var sensorObj = require('jsupm_rn2903');
var defaultDev = "/dev/ttyUSB0";
// if an argument was specified, use it as the device instead
if (process.argv.length > 2)
{
defaultDev = process.argv[2];
}
console.log("Using device:", defaultDev);
// Instantiate a RN2903 sensor on defaultDev at 57600 baud.
var sensor = new sensorObj.RN2903(defaultDev,
sensorObj.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.
//
// var sensor = new sensorObj.RN2903(0,
// sensorObj.RN2903_DEFAULT_BAUDRATE);
// enable debugging
// sensor.setDebug(true);
// get version
if (sensor.command("sys get ver"))
{
console.log("Failed to retrieve device version string");
process.exit(1);
}
console.log("Firmware version: " + sensor.getResponse());
console.log("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)
{
console.log("Waiting for packet...");
var rv = sensor.radioRx(0);
if (rv)
{
console.log("radioRx() failed with code " + rv);
}
else
{
var resp = sensor.getResponse();
var payload = sensor.getRadioRxPayload();
if (!payload.length)
console.log("Got response: '" + resp + "'");
else
console.log("Got payload: '"
+ sensor.fromHex(payload)
+ "'");
}
console.log();
}
process.on('SIGINT', function() {
sensor = null;
sensorObj.cleanUp();
sensorObj = null;
console.log("Exiting...");
process.exit(0);
});

108
examples/javascript/rn2903-p2p-tx.js Normal file
View File

@ -0,0 +1,108 @@
/*
* Author: Jon Trulson <jtrulson@ics.com>
* Copyright (c) 2017 Intel Corporation.
*
* 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.
*/
var sensorObj = require('jsupm_rn2903');
var defaultDev = "/dev/ttyUSB0";
// if an argument was specified, use it as the device instead
if (process.argv.length > 2)
{
defaultDev = process.argv[2];
}
console.log("Using device:", defaultDev);
// Instantiate a RN2903 sensor on defaultDev at 57600 baud.
var sensor = new sensorObj.RN2903(defaultDev,
sensorObj.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.
//
// var sensor = new sensorObj.RN2903(0,
// sensorObj.RN2903_DEFAULT_BAUDRATE);
// enable debugging
// sensor.setDebug(true);
// get version
if (sensor.command("sys get ver"))
{
console.log("Failed to retrieve device version string");
process.exit(1);
}
console.log("Firmware version: " + sensor.getResponse());
console.log("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.
var count = 0;
function transmit()
{
var output = "Ping " + count;
count++;
// All payloads must be hex encoded
var payload = sensor.toHex(output);
console.log("Transmitting a packet, data: '"
+ output
+ "' -> hex: '"
+ payload
+ "'");
var rv = sensor.radioTx(payload);
if (rv == sensorObj.RN2903_RESPONSE_OK)
console.log("Transmit successful.");
else
console.log("Transmit failed with code " + rv);
console.log();
}
setInterval(transmit, 10000);
process.on('SIGINT', function() {
sensor = null;
sensorObj.cleanUp();
sensorObj = null;
console.log("Exiting...");
process.exit(0);
});

131
examples/javascript/rn2903.js Normal file
View File

@ -0,0 +1,131 @@
/*
* Author: Jon Trulson <jtrulson@ics.com>
* Copyright (c) 2017 Intel Corporation.
*
* 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.
*/
var sensorObj = require('jsupm_rn2903');
var defaultDev = "/dev/ttyUSB0";
// if an argument was specified, use it as the device instead
if (process.argv.length > 2)
{
defaultDev = process.argv[2];
}
console.log("Using device:", defaultDev);
// Instantiate a RN2903 sensor on defaultDev at 57600 baud.
var sensor = new sensorObj.RN2903(defaultDev,
sensorObj.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.
//
// var sensor = new sensorObj.RN2903(0,
// sensorObj.RN2903_DEFAULT_BAUDRATE);
// enable debugging
// sensor.setDebug(true);
// get version
if (sensor.command("sys get ver"))
{
console.log("Failed to retrieve device version string");
process.exit(1);
}
console.log("Firmware version: " + sensor.getResponse());
console.log("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");
var rv = sensor.join(sensorObj.RN2903_JOIN_TYPE_ABP);
if (rv == sensorObj.RN2903_JOIN_STATUS_ACCEPTED)
{
console.log("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.
var faketemp = "25.6";
console.log("Transmitting a packet...");
var trv = sensor.macTx(sensorObj.RN2903_MAC_MSG_TYPE_UNCONFIRMED,
1, // port number
sensor.toHex(faketemp));
if (trv == sensorObj.RN2903_MAC_TX_STATUS_TX_OK)
console.log("Transmit successful.");
else
{
// check to see if we got a downlink packet
if (trv == sensorObj.RN2903_MAC_TX_STATUS_RX_RECEIVED)
{
console.log("Transmit successful, downlink packet received: "
+ sensor.getResponse());
}
else
{
console.log("Transmit failed with code " + trv);
}
}
}
else
{
console.log("Join failed with code " + rv);
}
console.log("Exiting");
sensor = null;
sensorObj.cleanUp();
sensorObj = null;
process.exit(0);

108
examples/python/rn2903-p2p-rx.py Executable file
View File

@ -0,0 +1,108 @@
#!/usr/bin/python
# 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.
from __future__ import print_function
import time, sys, signal, atexit
from upm import pyupm_rn2903 as sensorObj
def main():
## Exit handlers ##
# This function stops python from printing a stacktrace when you
# hit control-C
def SIGINTHandler(signum, frame):
raise SystemExit
# This function lets you run code on exit
def exitHandler():
print("Exiting")
sys.exit(0)
# Register exit handlers
atexit.register(exitHandler)
signal.signal(signal.SIGINT, SIGINTHandler)
defaultDev = "/dev/ttyUSB0"
if (len(sys.argv) > 1):
defaultDev = sys.argv[1]
print("Using device", defaultDev)
# Instantiate a RN2903 sensor on defaultDev at 57600 baud.
sensor = sensorObj.RN2903(defaultDev,
sensorObj.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.
#
# sensor = sensorObj.RN2903(0,
# sensorObj.RN2903_DEFAULT_BAUDRATE)
# enable debugging
# sensor.setDebug(True)
# get version
if (sensor.command("sys get ver")):
print("Failed to retrieve device version string")
sys.exit(1)
print("Firmware version: " + sensor.getResponse())
print("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):
print("Waiting for packet...")
rv = sensor.radioRx(0);
if (rv):
print("radioRx() failed with code " + str(rv))
else:
resp = sensor.getResponse();
payload = sensor.getRadioRxPayload();
if (not len(payload)):
print("Got response: '", end='')
print(resp, end="")
print("'")
else:
print("Got payload: '", end='')
print(sensor.fromHex(payload), end='')
print("'")
print()
if __name__ == '__main__':
main()

114
examples/python/rn2903-p2p-tx.py Executable file
View File

@ -0,0 +1,114 @@
#!/usr/bin/python
# 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.
from __future__ import print_function
import time, sys, signal, atexit
from upm import pyupm_rn2903 as sensorObj
def main():
## Exit handlers ##
# This function stops python from printing a stacktrace when you
# hit control-C
def SIGINTHandler(signum, frame):
raise SystemExit
# This function lets you run code on exit
def exitHandler():
print("Exiting")
sys.exit(0)
# Register exit handlers
atexit.register(exitHandler)
signal.signal(signal.SIGINT, SIGINTHandler)
defaultDev = "/dev/ttyUSB0"
if (len(sys.argv) > 1):
defaultDev = sys.argv[1]
print("Using device", defaultDev)
# Instantiate a RN2903 sensor on defaultDev at 57600 baud.
sensor = sensorObj.RN2903(defaultDev,
sensorObj.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.
#
# sensor = sensorObj.RN2903(0,
# sensorObj.RN2903_DEFAULT_BAUDRATE)
# enable debugging
# sensor.setDebug(True)
# get version
if (sensor.command("sys get ver")):
print("Failed to retrieve device version string")
sys.exit(1)
print("Firmware version: " + sensor.getResponse())
print("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.
count = 0;
while (True):
output = "Ping " + str(count)
count += 1
# All payloads must be hex encoded
payload = sensor.toHex(output);
print("Transmitting a packet, data: '", end='')
print(output, end='')
print("' -> hex: '", end='')
print(payload, end='')
print("'")
rv = sensor.radioTx(payload);
if (rv == sensorObj.RN2903_RESPONSE_OK):
print("Transmit successful.")
else:
print("Transmit failed with code " + str(rv))
print()
time.sleep(10)
if __name__ == '__main__':
main()

129
examples/python/rn2903.py Executable file
View File

@ -0,0 +1,129 @@
#!/usr/bin/python
# 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.
from __future__ import print_function
import time, sys, signal, atexit
from upm import pyupm_rn2903 as sensorObj
def main():
## Exit handlers ##
# This function stops python from printing a stacktrace when you
# hit control-C
def SIGINTHandler(signum, frame):
raise SystemExit
# This function lets you run code on exit
def exitHandler():
print("Exiting")
sys.exit(0)
# Register exit handlers
atexit.register(exitHandler)
signal.signal(signal.SIGINT, SIGINTHandler)
defaultDev = "/dev/ttyUSB0"
if (len(sys.argv) > 1):
defaultDev = sys.argv[1]
print("Using device", defaultDev)
# Instantiate a RN2903 sensor on defaultDev at 57600 baud.
sensor = sensorObj.RN2903(defaultDev,
sensorObj.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.
#
# sensor = sensorObj.RN2903(0,
# sensorObj.RN2903_DEFAULT_BAUDRATE)
# enable debugging
# sensor.setDebug(True)
# get version
if (sensor.command("sys get ver")):
print("Failed to retrieve device version string")
sys.exit(1)
print("Firmware version: " + sensor.getResponse())
print("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")
#
# rv = sensor.join(RN2903_JOIN_TYPE_OTAA)
# A successful join will return RN2903_JOIN_STATUS_ACCEPTED (0).
# 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")
rv = sensor.join(sensorObj.RN2903_JOIN_TYPE_ABP)
if (rv == sensorObj.RN2903_JOIN_STATUS_ACCEPTED):
print("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.
faketemp = "25.6"
print("Transmitting a packet...")
trv = sensor.macTx(sensorObj.RN2903_MAC_MSG_TYPE_UNCONFIRMED,
1, # port number
sensor.toHex(faketemp))
if (trv == sensorObj.RN2903_MAC_TX_STATUS_TX_OK):
print("Transmit successful.")
else:
# check to see if we got a downlink packet
if (trv == sensor.Obj.RN2903_MAC_TX_STATUS_RX_RECEIVED):
print("Transmit successful, downlink packet received:", end=' ')
print(sensor.getResponse())
else:
print("Transmit failed with code " + str(trv))
else:
print("Join failed with code " + str(rv))
if __name__ == '__main__':
main()