The Palcom Proximity Service

GETTING STARTED
To be able to use this service you will need a NFC hardware device. The
functionality of the service can however be tested using mocked-up data.
I used an RFID/NFC card based on SDiD technology. Any of these crd will do
as long as NFC is supported. If NFC is not supported the whole idea of
proximity is lost. Proximity in this context is distances between 0-10 cm. 
The hardware modules I used did unfortunately not include open source drivers,
so I was not able to share these here. Otherwise an example implementation
could have been included.

GETTING REAL PROXIMITY DATA
You need to implement the updateNFCdata() method in the NFCModule class
definition to get real data from a NFC device. There is a suggested
implementation in the NFCModul class definition. This should not be too
difficult to do.

SERVICE DESCRIPTION
I will use the terms "object" and "objectID" to refer to Palcom and non Palcom
nodes that has NFC capabilities. I chose "object" because of the fact that it
may very well be of interest to check for passive objects carrying RFID tags.

The interface of the service has the following functions.

listCloseObjects() - Returns an XML string as follows:

    <objects_in_proximity>
       <object id"objectID" inproximity="true | false" recstatus="true|false"/>
       ...
    </objects_in_proximity>

One object element is listed for each object currently in proximity. objectID
is preferably the same as the deviceID of the Palcom or non Palcom nodes.

----------

isCloseToObject( objecttID ) - Returns a text string, either "True" or "False".

----------

allProximityHistory() - Returns an XML string as follows:

    <object_history>
       <object id"objectID" inproximity="true | false" recstatus="true|false">
          <timestamp>time-and-date-text-string</timestamp>
          ...
       </object>
       ...
    </object_history>

There is one object element for each object that has been in proximity and one
timestamp element for each time one of the objects was in proximity.

----------

objectProximityHistory( objectID ) - Returns an XML string as follows:

    <object_history>
       <object id"objectID" inproximity="true | false" recstatus="true|false">
          <timestamp>time-and-date-text-string</timestamp>
          ...
       </object>
    </object_history>

Same as allProximityHistory() but with only one object element.

----------

recordObjectHistory( objectID, true | false ) - No return value

Tells NFCModule wether to record timestamps on the object specified or not.

----------

recordAllHistory( true | false ) - No return value

Tells NFCModule wether to record timestamps on all objects or not.