Add event field

Author: gotthardp

README.md

@@ -23,6 +23,8 @@ The server:
  * Invokes internal modules with application logic. It provides examples for:
    * [Semtech/IMST LoRaMote](http://webshop.imst.de/loramote-lora-evaluation-tool.html)
    * [Microchip LoRa(TM) Technology Mote](http://www.microchip.com/Developmenttools/ProductDetails.aspx?PartNO=dm164138)
+ * Automatically parses well-known payload formats. It currently supports:
+   * [Cayenne Low Power Payload](https://github.com/myDevicesIoT/cayenne-docs/blob/master/docs/LORA.md#cayenne-low-power-payload)
  * Invokes external applications. It currently supports connections via:
    * WebSocket protocol [RFC6455](https://tools.ietf.org/rfc/rfc6455.txt)
    * HTTP/1.1 and HTTP/2 protocol (REST API)

doc/Handlers.md

@@ -64,6 +64,7 @@ applications the following fields:
   fcnt       | Integer     | U      | Received frame sequence number.
   port       | Integer     | U      | LoRaWAN port number.
   data       | Hex String  | U      | Raw application payload, encoded as a hexadecimal string.
+  event      | String      | J DL   | Event name (joined, delivered, lost).
   datetime   | ISO 8601    | U J DL | Timestamp using the server clock.
   freq       | Number      | U      | RX central frequency in MHz (unsigned float, Hz precision).
   datr       | String      | U      | LoRa datarate identifier (eg. "SF12BW500").

priv/admin/admin.js

@@ -800,6 +800,7 @@ myApp.config(['NgAdminConfigurationProvider', function (nga) {
                 { value: 'fcnt', label: 'fcnt' },
                 { value: 'port', label: 'port' },
                 { value: 'data', label: 'data' },
+                { value: 'event', label: 'event' },
                 { value: 'datetime', label: 'datetime' },
 
                 { value: 'freq', label: 'freq' },

src/lorawan_application_backend.erl

@@ -149,6 +149,7 @@ handle_delivery({_Network, #profile{app=AppID}, Node}, Result, Receipt) ->
 send_event(Event, Vars0, #handler{app=AppID, parse_event=Parse, fields=Fields}, DeviceOrNode) ->
     Vars =
         vars_add(app, AppID, Fields,
+        vars_add(event, Event, Fields,
         vars_add(datetime, calendar:universal_time(), Fields,
         case DeviceOrNode of
             {#device{deveui=DevEUI, appargs=AppArgs}, DevAddr} ->
@@ -161,7 +162,7 @@ send_event(Event, Vars0, #handler{app=AppID, parse_event=Parse, fields=Fields},
                 vars_add(deveui, get_deveui(DevAddr), Fields,
                 vars_add(appargs, AppArgs, Fields,
                 Vars0)))
-        end)),
+        end))),
     lorawan_backend_factory:event(AppID, DeviceOrNode,
         data_to_fields(AppID, Parse, Vars, Event)).