Changes between Version 9 and Version 10 of WARPnet1/BuildClientScripts

Timestamp:

Jun 18, 2010, 3:27:38 PM (14 years ago)

Author:

sgupta

Comment:

--

WARPnet1/BuildClientScripts

@@ -5 +5 @@
 == Building the Client Script ==
 
+=== Synchronizing Structs ===
+
 There are two files that the user control over as the build their custom scripts to control the boards. The first is `warpnet_client_experiment_structs.py`. This file defines the data structures that are sent back and forth between the FPGA design and the client script. The FPGA design and this file must be in sync for data to be accurately transferred between the two. Let us look at an example to understand how this file is built. The following is the ControlStruct that is used to set basic node parameters. First we see the C struct that is stored in the FPGA.
+
 {{{
 #!c
@@ -70 +73 @@
 }}}
 
-The `prepToSend` function creates the raw data that is seen by `warpnet.c`in the FPGA. It creates a byte packed data of 6 bytes (6B), 1 short (H) and 3 ints (3I). This is exactly what the node is expecting. A appropriate response from the node is a `warpnetACK` which `updateFromNode` parses in the python file.
+The `prepToSend` function creates the raw data that is seen by `warpnet.c` in the FPGA. It creates a byte packed data of 6 bytes (6B), 1 short (H) and 3 ints (3I). This is exactly what the node is expecting. A appropriate response from the node is a `warpnetACK` which `updateFromNode` parses in the python file.
+
+For a struct that is requesting data the raw data sent would be a `warpnetRequest` struct and expect a response of the appropriate type.
+
+=== Logging Data ===
+
+As statistics are received by the client, there is good chance that the data would want to be written to a file. There is a built in method to do this. In the top-level script create a `DataLogger` object like the following.
+{{{
+ dataLog = DataLogger('filename.txt', fileRefreshTime)
+}}}
+
+When instantiating a struct pass the `dataLog` object to the it as follows:
+{{{
+ statStruct = StatisticsStruct(dataLog)
+}}}
+
+In the StatisticsStruct any received data in `updateFromNode` can be written to the this log file using
+{{{
+ self.logData('Data0=%d, Data1=%d" %(dataTuple[0], dataTuple[1]))
+}}}
 
 == Running the Client Script ==