Aasimon.org Wiki

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
======Artefact======
[[LUA Scripts]]

====Reply problems====
The outline of the problem is, "when is it possible to return status information to the client, and when is it actually needed?".
  * If the transaction contains a single data entry, the server should respond with the status of the insertion of that entry.
  * If the transaction contains several data entries, the server should respond with the status of the insertions of these entries.
    * We need a way to map a status message to an entry.
    * We need a status message system that can contain several status messages.
  * If the transaction contains both data entry (or entries) and query (or queries), the server should respond with the status of the insertions as well as the answer to and status of query (queries).
Should (can) the status message be treated as just another query?\\
\\
===Proposition===
Data and Query cannot be located in the same transaction.
Query works as it does now (it reply's with the result of the query in the requested reply-language).\\
Data returns a (using the same result structure as the queries) series of status messages, each mapping to a Data section by number starting from 0.\\
Therefore the order in which the Data segments are handled matter!\\
The reply language of the Data transaction will be the XML language. This might be user defined at some later point.
The Queries can be extended to also include a status message list in the reply.

====The data transportation path====
When an apparatus is connected the following must be crafted:
  * Feed parser so file and conf.
  * Artefact classifier.
    * Makes superficial parsing of the data to identify whether the data is valid.
    * Figure out what classes are contained in the data, and report this.

  (data) => network -> [lua] Parser -> [lua] Classifier (data, classes) -> [c] Store (db/disk)

  * Artefact interpreter.
    * Parses and interprets the data, translating it into an internal tree structure.

  (data, class) => [lua] Parser -> [lua] Interpretation -> [lua/c] Tree structure -> [c] Pretty printer -> network

===Template code===
<code lua>
--
-- Read the data from <filename> and determ which classes it contains.
--
-- The following functions are available in the classify function:
--    - addClass(classname)
--          Mark data content as classname.
--    - invalidData(errormsg)
--          Report that the data is invalid.
function classify(filename) 
  -- Load data from file
  data = loadDataFromFile(filename);

  -- ID has to equal NIDEK/
end

--
-- Interpret data in <filename> creating a tree structure of groups. Each group
-- contains values determed by the interpreter.
--
-- The following functions are available in the interpret function:
--    - addGroup(parent, groupname) // Parent can be 0 if root
--          Creates a new group with a groupname refering to a parent group.
--          A value of 0 is allowed the group does not have any parents (ie. it is root).
--          The function returns a group descriptor refering to the group.
--    - addValue(groupdescriptor, valuename, value)
--          Adds a value with key valuename to a group refered to by groupdescriptor.
-- interpret() must return the root of the created tree structure.
function interpret(filename)
  
end

function loadDataFromFile(filename)
  local file = assert(io.open(filename))
  local data = f:read("*all")
  f.close()

  return data;
end
</code>

====Patient registration====
The system stores data. These data is connected to a patient ID, a timestamp, a location and an apparatus.\\
Getting the patient ID is a non-trivial task at best.\\
See the [[pentominos:registration]] section for a description of the framework surrounding the registration system.

====RFID tag project====
[[pentominos:rfid project]]

====Network communication (protocol)====
All network communication are done via XML documents.\\
<del>Every XML document is terminated by the zero character ('\0' in c/c++)\\
Sending the zero character to a process will reset it, and thereby cleaning up all mess made by illegal documents.</del>\\
A connection can only be created in client-mode, and will exists as long as the client intends it to.\\
A server listen will run in a read loop until the client terminates the connection.\\
The server must reply to all request with an answer, no matter if the preceding processing went well or not.


====The client====
The client reads its config file, and forks for each config section it encounters.\\
Every fork handles a single apparatus according to the attached config section.\\
The main thread runs infinitely and makes sure to terminate all client forks upon termination.\\
Every client is connected physically to a port on the host computer, and a LUA program runs to determine whether data is ready to be read or not.\\
The LUA programs hereafter sends this data to the server indirectly through a number of exposed c methods.\\
Each LUA program must run in an infinite loop, terminating only when the function stop() returns true, and it must not hang waiting on read, but rather have a time-out, and loop again.

[[pentominos:feed]]


====Data types====
Problem: An apparatus produces more than one type of data, but stores all measured values in the same data block.
How to make a query that will hit this multi-data block?\\
Solutions:
  * Make the validator insert one entry in the db for each data type, referring to the same data block (file).
    * The data are only stored once in the file system.
    * We don't need to make drastic changes to the server code (or client for that matter).

====Links====
  * http://xerces.apache.org/xerces-c/

====TODO====
  * {{:check.png}} Make SQL comm functions for the LUA programs (e.g. for the cpr server).
  * {{:check.png}} Rewrite server to utilize read loop.
  * {{:check.png}} Replace xerces-c with eXpat.
  * {{:uncheck.png}} Make SQL comm functions for the LUA programs return all results and not just the first one.
  * {{:uncheck.png}} Make all use of time (struct time_t and postgresql timestamps) [[http://en.wikipedia.org/wiki/Year_2038_problem|Y2K38]] safe.