Stamp Plot Manual

Stamp Plot Control Codes

The plot may be configured from the Stamp using the following control codes:

       !TITL message	Sets to title of the form to the message

!USRS message Sets the User Status box to display the message !BELL Sounds the bell on the PC !AMAX value Sets the plot maximum analog value !AMIN value Sets the plot minimum analog value !SPAN minValue, MaxValue Sets the plots analog maximim and minimum as above but also adds the range to the Range Drop-Down box. !AMUL value Sets the value to multiply incoming data by

!TMAX value Sets the plot maximum time (seconds) !TMIN value Sets the plot minimum time (seconds) !PNTS value Sets the number of data points to collect !PLOT ON/OFF Enables/disables the plotting of data !RSET Resets the plot and all data !CLRM Clears the message list !CLMM Clears the min/max recorded values !CMMR ON/OFF Enables/Disables clearing of Min/Max recorded values

                       on reset

!MAXS Sets the plot to STOP when datapoints are full !MAXR Sets the plot to RESET when datapoints are full !SHFT ON/OFF Enables/disables the plot from shifting when recording data (may cause a loss of data accuracy if enabled) !TSMP ON/OFF Enables time stamping of list messages, messages and data saved to files !SAVD ON/OFF Enables saving of analog and digital data to files (stampdat.txt)

       !SAVM ON/OFF	Enables saving of messages to a file (stampmsg.txt)

!DELD Deletes the saved data file (stampdat.txt) !DELM Deletes the saved message file (stampmsg.txt)

See also: Data and Message Saving

Example: printf("!SPAN 0, 500\n !RSET\n !PLOT ON\n");

Recommendations:

Upon microcontroller reset for configuring:

   * Pause for 500 mSec to allow PC buffer to clear.
   * Reset (!RSET) prior to any time/value changes to clear data.
   * Reset (!RSET) at end of configuration to reset plot to time 0
   * The application requires a minimum processing time.
     A short pause (10mSec on fairly fast computers) may be required in short programs. 

Data and Message Saving

Data and messages may be recorded to a file.

Messages will be saved to a file named "stampmsg.txt" in the application directory. They will be time stamped if enabled.

Data will be saved to a file names "stampdat.txt" in the application directory The data will be time stamped if enabled.

The data file has the following format:

[System time, plot time in seconds,] analog data point value, analog value, digital datapoint value, digital data.

NOTE: Writing to the file is based on ANALOG DATA ARRIVING ONLY. If you are dealing with only digital data, transmit a 0 analog value along with your digital data.

i.e.: DEBUG DEC 0,CR, IBIN8 INS, CR

When deleting the data or analog files (from the application or from the microcontroller), if file save is enabled the files will be re-created and new data will be saved. Examples

Simplest possible example for analog value and digital one.

See the code or download it.