Rainforest Automation, Inc.
EAGLE™
Uploader API Manual
5
macId
– this is a 12-digit hexadecimal number. It is the MAC Address of the
EAGLE
™.
version
– this is for future use and is currently undefined.
timestamp -- this is an integer with a standard Unix timestamp, i.e., number of seconds
since Jan.1, 1970.
The body of the Root Element consists of XML Fragments. An XML Fragment is a stripped
down XML Element. The
EAGLE
™ uses XML Fragments to simplify the parsing of the data
stream, while providing a data structure that is flexible and human readable.
The XML Fragments have the following structure:
<tag>
<element>value</element>
…
</tag>
Where:
-
Every line ends with the newline character (0x0A).
-
<tag>
is the start tag for the XML Fragment; each type will have a unique tag name;
-
<element>
is the start tag for an element; there will be one or more child elements in the
fragment; each element will have a unique element name.
-
… indicates the variable number of specific elements
Element values can be of various types:
-
{string}
indicates an element consisting of Extended ASCII text
-
{enumeration}
indicates an element that can have a specific list of values.
-
0xFFFFF
indicates an element consisting of a base16 (hex) number
-
00
indicates an element consisting of an integer
-
000.000
indicates an element consisting of a signed decimal number
[<element>]
– square brackets indicate optional elements.
value1|value2|value3
– vertical bars separate valid values in an enumeration list.
Note that element names are case insensitive; the case is used strictly for legibility. XML
parsers should be designed to ignore case when receiving requests from the
EAGLE
™.
Example
Here is an example of a POST request:
POST /rfaeagle.php HTTP/1.0
Host: 192.168.11.3:8888
Accept: */*
From: [email protected]
User-Agent: Raven Uploader/v1
Content-Length: 483
Content-Type: application/x-www-form-urlencoded
<?xml version="1.0"?>
<rainforest macId="0xf0ad4e00ce69" timestamp="1355292588s">
