ismagom / lwm2m-galileo Goto Github PK

This is a fork of liblwm2m by David Navarro (https://github.com/01org/liblwm2m). 

Galileom2m
----------

galileom2m uses the LWM2M protocol to provide OTA and device management for the Intel Galileo Board.

Summary of changes:
 * Fixed some warnings in the original code. 
 * Defined an object API for easy setup of objects and its resources. 
 * Added applications object, aimed at providing OTA software reconfiguration. 
 * Added a timer that runs functions to update the status of objects. 
 * Uses GPIO interface to obtain values of solar panel and VBAT voltage from the Solar Panel shield v2.0. 
 VBAT pin and Solar panel should be connected to A0 and A1 pins respectively.
 
OTA
====

To perform an OTA, need to WRITE to the applications object instance
1) WRITE application name
2) WRITE application URL
3) EXEC application Download
4) WRITE application args
5) EXEC application Run

Application status is obtained by reading application Status or Error code resources. 

It requires tftp and start-stop-daemon commands. 


Follow the instructions below for compiling and usage. 


liblwm2m
=========

liblwm2m is an implementation of the LWM2M protocol from the Open Mobile Alliance.

Source Layout
-------------

-+- core                (the LWM2M engine)
 |
 +- externals
 |    |
 |    +- er-coap-13     (Erbium's CoAP engine from http://people.inf.ethz.ch/mkovatsc/erbium.php,
 |                       modified to run on linux)
 |
 +- tests               (example and test application)
      |
      +- client         (a command-line LWM2M client with two test objects)
      |
      +- server         (a command-line LWM2M server)
      |
      +- TLV            (application decoding two hard-coded TLV buffers)
      |
      +- utils          (utility functions for command-line interface)


Compiling
---------

Despite its name, liblwm2m is not a library but files to be built with an application. liblwm2m
uses CMake. Look at tests/server/CMakeLists.txt for an example of how to include it. 
Two compilation switches are used: LWM2M_CLIENT_MODE and LWM2M_SERVER_MODE.

Define LWM2M_CLIENT_MODE to enable LWM2M Client interfaces. Define LWM2M_SERVER_MODE to enable
LWM2M Server interfaces. Both can be defined at the same time.


Testing
-------

To compile the test server
 - - - - - - - - - - - - -

In the any directory, run the following commands:
    cmake [liblwm2m directory]/tests/server
    make
    ./lwm2mserver

The lwm2mserver listens on UDP port 5684. It features a basic command line interface. Type 'help' for
a list of supported commands.


To compile the test client
 - - - - - - - - - - - - -
  
In the any directory, run the following commands:
    cmake [liblwm2m directory]/tests/client
    make
    ./lwm2mclient


The lwm2mclient opens udp port 5683. You can connect to it by installing the firefox plugin Copper
(http://people.inf.ethz.ch/mkovatsc/copper.php) and opening a new Firefox tab to: coap://[::1]:5683
At launch, lwm2mclient tries to register to a LWM2M Server at [::1]:5684. It features a basic command
line interface. Type 'help' for a list of supported commands.