Event Display



The Event Display will allow you to create and view events that are registered by __prod_name while recording or acquiring. The event display can be launched from the View menu of __prod_name:



Manual Event Entry Section

The manual event entry section allows you to enter any string you want and have it timestamped and saved to an event record.

1. Event String Entry The event string can be used as a label for a specific event.  You can enter any text you wish (up to 128 characters) into this box. There are different modes available for event string entry that are explained below.  Pressing the Enter key will  immediately generate an event record and store the text entered here into the record.  
2. Post Event
Clicking the post event button will immediately generate an event with the text in the event string box at the current timestamp. You can either click this button or just press Enter after typing the event string to generate the event.
3. Event Options
Launches the Event Options Dialog where you can modify event display and generation settings.
4. Timestamp The __prod_name timestamp indicating when the event occurred.
5. TTL Value
If the event was created due to a TTL bit changing, then this represents the current value on a TTL port at the time the event was generated.  Events generated by pressing the post event button will have this value set to 0. Events generated using the -PostEvent command will show the user specified value used in the command.
6. Event ID
An ID representing the source of this event. See -PostEvent for more information.
7. Event String
The string stored in the event record. This can be either a user defined string or an automatically generated string depending on where the event originated. Event strings can be associated with a specific TTL bit going from 0 (low) to 1 (high) by using named events.
8. Clear Event History Display
Clears out all the events in the event history.  This does not remove events from a recorded event file, only from the display.


Event Options Dialog

This dialog must be closed before you can continue using __prod_name.


1. Single Key Entry Enable When this option is unchecked, then either the Enter key must be pressed or the post event button clicked to generate an event.  Single key entry allows you to immediately generate an event whenever a letter is entered into the event string box.  After any key is pressed,an event record will be generated with the event string and the last letter in the event string will be highlighted.  Pressing another key will change the last letter in the event string to the key you just pressed and generate a new record; highlighting the last letter again. This can be useful for generating numbered events.

Example:  You wish to generate events labeled "event1",  "event2", and "event3". Begin with the single key check box unchecked, so you are in normal entry mode.  Type the word "event" (without the quotes)into the event string box.  Open up the Event Options dialog and click the single key entry enable box to check it.  Close the Event Options dialog and then click in the event string entry right after the "t" in "event."  Press the "1" key.  You will see an event with the label "event1" appear in the Event History.  Now press "2."  Immediately "event2" appears in the Event History.  Finally press "3."  "event3" should now be in the Event History list.  Unchecking the single key entry enable will then return you to normal event entry mode. 
2. Immediate Timestamp Entry Mode When this option is unchecked, the timestamp for the event will be taken at the time the event is posted (either by pressing Enter in the event string entry box, or clicking the post event button.)  Checking the Immediate Timestamp entry mode box will take the timestamp when you first begin typing into the event string box, not when you post the event.
3. TTL Value Format Changes the numeric format used to display TTL values in the event history.  Changing the format will change all of the TTL values currently shown in the event history.
  1. Binary:  Shows individual TTL bit on (1 ) or off (0). Bit number 0 is the rightmost bit in the string and the left most bit is bit 15. Ports that are less than 16 bits will have their value 0 extended to 16 digits.
  2. Decimal:  Shows a base 10 representation of all TTL bits.
  3. Hexadecimal:   Shows a base 16 representation of all TTL bits. Each digit represents a group of four bits with the right most digit representing bits 0 - 3. Ports that are less than 16 bits will have their value 0 extended to 4 hex digits.
Example : On an eight bit port, bits 3 and 1 are on and all other bits are off. The representation of this TTL value in each or the value formats is as follows:
  • Binary: 0000000000001010
  • Decimal: 10
  • Hexadecimal: 000A
4. Named TTL Event List
List of named TTL events that are currently active. See the -SetNamedTTLEvent command for more information. Clicking on an item in this list will populate the edit controls with the values for the selected item.
5. TTL Bit
The TTL bit number associated with the named event. When this TTL bit goes high (1) on the selected digital IO device port, the text in the event string will be substituted for the default TTL event string.
6. Digital IO Device Port
The port of the selected digital IO device where the desired bit is located. See digital IO ports for more information.
7. Digital IO Device
The name of the digital IO device that will be monitored for the bit change.
8. Event String
The custom event string to use when the specified TTL bit goes high (1).

NOTE : Replacing the default event string means that some information about the source of the TTL value will be lost. Specifically, the name of the Digital IO device and the port number that generated the TTL
9. Set Named TTL Event
Associates an event string with a the TTL bit on the port of the digital IO device shown in boxes 5, 6 and 7. If a named TTL event exists that matches the bit/port/device combination, the event string of that named event will be replaced with the new event string. See the -SetNamedTTLEvent command for more information.
10. Removed Selected Named TTL Event
Removes the selected named TTL event from the system. The next time that bit goes high (1), it will use the default TTL event string. See the -RemoveNamedTTLEvent command for more information.
11. Close
Closes this dialog.