Important changes to repositories hosted on mbed.com
Mbed hosted mercurial repositories are deprecated and are due to be permanently deleted in July 2026.
To keep a copy of this software download the repository Zip archive or clone locally using Mercurial.
It is also possible to export all your personal repositories from the account settings page.
Dependents: lora-temperature LoRaWAN-lmic-app_HS LoRaWAN-lmic-app_huynh
LoRa WAN in C for sx1276 shield
Currently version 1.5
LoRaWAN network configuration for end-device
The following three pieces of information uniquely identifies end-device to network to allow over-the-air activation. These are stored in the end-device prior to join procedure.
AppEUI
Uniquely identifies application provider of end-device.
Least-significant byte first, 8 bytes, use reverse memcpy() to keep same order as shown on lora server.
example C code
static const u1_t APPEUI[8] = { 0x01, 0x00, 0x01, 0x00, 0x00, 0x0C, 0x25, 0x00 };
This is copied into LMIC by os_getArtEui() callback function in application.
DevEUI
End-device ID, unique to each end-node.
Least-significant byte first, 8 bytes, use reverse memcpy() to keep same order as shown on lora server.
example C code
static const u1_t DEVEUI[8] = { 0x00, 0x00, 0x00, 0x00, 0x01, 0x0C, 0x25, 0x00 };
This is copied into LMIC by os_getDevEui() callback function in application.
AppKey (aka DevKey)
128-bit (16byte) AES key.
example C code
static const u1_t DEVKEY[16] = { 0xe4, 0x72, 0x71, 0xc5, 0xf5, 0x30, 0xa9, 0x9f, 0xcf, 0xc4, 0x0e, 0xab, 0xea, 0xd7, 0x19, 0x42 };
This is copied into LMIC by os_getDevKey() callback function in application.
Using over-the air activation, the end-device (LMIC) performs a join procedure every time it starts for first time, or has lost session context information. When join procedure has successfully completed, the end-device will have a network session key (NwkSKey) and an application session key (AppSKey), which are used for encryption and message integrity check.
US915 configuration with http://us01-iot.semtech.com/
- log in to server
- click on Applications
- find your application and click it
- go to configure motes
- to create a mote, you may enter a new DevEUI
- you may copy-paste the 16byte application key from an already existing mote, if you desire.
CHNL_HYBRID | 125KHz | 500KHz |
|---|---|---|
| defined value | channels | channel |
| 0 | 0 to 7 | 64 |
| 1 | 8 to 15 | 65 |
| 2 | 16 to 23 | 66 |
| 3 | 24 to 31 | 67 |
| 4 | 32 to 39 | 68 |
| 5 | 40 to 47 | 69 |
| 6 | 48 to 55 | 70 |
| 7 | 56 to 63 | 71 |
| undef | 0 to 63 | 64 to 71 |
Diff: hal/hal.cpp
- Revision:
- 0:62d1edcc13d1
--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/hal/hal.cpp Thu Jan 22 12:50:49 2015 +0000
@@ -0,0 +1,270 @@
+/*******************************************************************************
+ * Copyright (c) 2014 IBM Corporation.
+ * All rights reserved. This program and the accompanying materials
+ * are made available under the terms of the Eclipse Public License v1.0
+ * which accompanies this distribution, and is available at
+ * http://www.eclipse.org/legal/epl-v10.html
+ *
+ * Contributors:
+ * IBM Zurich Research Lab - initial API, implementation and documentation
+ * Semtech Apps Team - Modified to support the MBED sx1276 driver
+ * library.
+ * Possibility to use original or Semtech's MBED
+ * radio driver. The selection is done by setting
+ * USE_SMTC_RADIO_DRIVER preprocessing directive
+ * in lmic.h
+ *******************************************************************************/
+#include "mbed.h"
+#include "lmic.h"
+#include "mbed_debug.h"
+
+#if USE_SMTC_RADIO_DRIVER
+
+#else
+
+extern void radio_irq_handler( u1_t dio );
+
+static DigitalOut nss( D10 );
+static SPI spi( D11, D12, D13 ); // ( mosi, miso, sclk )
+
+static DigitalInOut rst( A0 );
+static DigitalOut rxtx( A4 );
+
+static InterruptIn dio0( D2 );
+static InterruptIn dio1( D3 );
+static InterruptIn dio2( D4 );
+
+static void dio0Irq( void )
+{
+ radio_irq_handler( 0 );
+}
+
+static void dio1Irq( void )
+{
+ radio_irq_handler( 1 );
+}
+static void dio2Irq( void )
+{
+ radio_irq_handler( 2 );
+}
+
+#endif
+
+static u1_t irqlevel = 0;
+static u4_t ticks = 0;
+
+static Timer timer;
+static Ticker ticker;
+
+static void reset_timer( void )
+{
+ ticks += timer.read_us( ) >> 6;
+ timer.reset( );
+}
+
+void hal_init( void )
+{
+ __disable_irq( );
+ irqlevel = 0;
+
+#if USE_SMTC_RADIO_DRIVER
+
+#else
+ // configure input lines
+ dio0.mode( PullDown );
+ dio0.rise( dio0Irq );
+ dio0.enable_irq( );
+ dio1.mode( PullDown );
+ dio1.rise( dio1Irq );
+ dio1.enable_irq( );
+ dio2.mode( PullDown );
+ dio2.rise( dio2Irq );
+ dio2.enable_irq( );
+ // configure reset line
+ rst.input( );
+ // configure spi
+ spi.frequency( 8000000 );
+ spi.format( 8, 0 );
+ nss = 1;
+#endif
+ // configure timer
+ timer.start( );
+ ticker.attach_us( reset_timer, 10000000 ); // reset timer every 10sec
+ __enable_irq( );
+}
+
+#if USE_SMTC_RADIO_DRIVER
+
+#else
+
+void hal_pin_rxtx( u1_t val )
+{
+ rxtx = !val;
+}
+
+void hal_pin_nss( u1_t val )
+{
+ nss = val;
+}
+
+void hal_pin_rst( u1_t val )
+{
+ if( val == 0 || val == 1 )
+ { // drive pin
+ rst.output( );
+ rst = val;
+ }
+ else
+ { // keep pin floating
+ rst.input( );
+ }
+}
+
+u1_t hal_spi( u1_t out )
+{
+ return spi.write( out );
+}
+
+#endif
+
+void hal_disableIRQs( void )
+{
+ __disable_irq( );
+ irqlevel++;
+}
+
+void hal_enableIRQs( void )
+{
+ if( --irqlevel == 0 )
+ {
+ __enable_irq( );
+ }
+}
+
+void hal_sleep( void )
+{
+ // NOP
+}
+
+u4_t hal_ticks( void )
+{
+ hal_disableIRQs( );
+ int t = ticks + ( timer.read_us( ) >> 6 );
+ hal_enableIRQs( );
+ return t;
+}
+
+static u2_t deltaticks( u4_t time )
+{
+ u4_t t = hal_ticks( );
+ s4_t d = time - t;
+ if( d <= 0 )
+ {
+ return 0; // in the past
+ }
+ if( ( d >> 16 ) != 0 )
+ {
+ return 0xFFFF; // far ahead
+ }
+ return ( u2_t )d;
+}
+
+void hal_waitUntil( u4_t time )
+{
+ while( deltaticks( time ) != 0 ); // busy wait until timestamp is reached
+}
+
+u1_t hal_checkTimer( u4_t time )
+{
+ return ( deltaticks( time ) < 2 );
+}
+
+void hal_failed( void )
+{
+ while( 1 );
+}
+
+//////////////////////////////////////////////////////////////////////
+// DEBUG CODE BELOW (use CFG_DEBUG)
+//////////////////////////////////////////////////////////////////////
+#ifdef CFG_DEBUG
+
+void debug_init( void )
+{
+ // print banner
+ debug( "\r\n============== DEBUG STARTED ==============\r\n" );
+}
+
+void debug_char( u1_t c )
+{
+ debug( "%c", c );
+}
+
+void debug_hex( u1_t b )
+{
+ debug( "%02X", b );
+}
+
+void debug_buf( const u1_t* buf, u2_t len )
+{
+ while( len-- )
+ {
+ debug_hex( *buf++ );
+ debug_char( ' ' );
+ }
+ debug_char( '\r' );
+ debug_char( '\n' );
+}
+
+void debug_uint( u4_t v )
+{
+ for( s1_t n = 24; n >= 0; n -= 8 )
+ {
+ debug_hex( v >> n );
+ }
+}
+
+void debug_str( const u1_t* str )
+{
+ while( *str )
+ {
+ debug_char( *str++ );
+ }
+}
+
+void debug_val( const u1_t* label, u4_t val )
+{
+ debug_str( label );
+ debug_uint( val );
+ debug_char( '\r' );
+ debug_char( '\n' );
+}
+
+void debug_led( u1_t val )
+{
+ debug_val( "LED = ", val );
+}
+
+void debug_event( int ev )
+{
+ static const u1_t* evnames[] =
+ {
+ [EV_SCAN_TIMEOUT] = "SCAN_TIMEOUT",
+ [EV_BEACON_FOUND] = "BEACON_FOUND",
+ [EV_BEACON_MISSED] = "BEACON_MISSED",
+ [EV_BEACON_TRACKED] = "BEACON_TRACKED",
+ [EV_JOINING] = "JOINING",
+ [EV_JOINED] = "JOINED",
+ [EV_RFU1] = "RFU1",
+ [EV_JOIN_FAILED] = "JOIN_FAILED",
+ [EV_REJOIN_FAILED] = "REJOIN_FAILED",
+ [EV_TXCOMPLETE] = "TXCOMPLETE",
+ [EV_LOST_TSYNC] = "LOST_TSYNC",
+ [EV_RESET] = "RESET",
+ [EV_RXCOMPLETE] = "RXCOMPLETE",
+ [EV_LINK_DEAD] = "LINK_DEAD",
+ [EV_LINK_ALIVE] = "LINK_ALIVE",
+ };
+ debug( "%s\r\n", evnames[ev] );
+}
+#endif // CFG_DEBUG