Tik-76.115 Individual Project: Guinea Pig
$Id: abc_interface.html,v 1.3 1996/04/22 07:29:31 kepa Exp $

Testee UI - A/B/C Test Communication protocol

This document describes the communication protocols used between Test Logic process and GUI process to implement A/B/C Test Testee UI.

Protocol messages sent to GUI process

Here is the list of protocol messages sent to GUI process. The type of the parameter is in parenthesis. The command and parameters are separated by whitespace and each command line ends with a newline character ('\n').

ARM bmin(int) bmax(int) bstart(int) btick(int) cmin(int) cmax(int) cstart(int) ctick(int)
ENABLE
CLOSE

ARM command tells GUI to reset the GUI and all variables. It also configures the scales used to give grades to the samples played. min is the min grade that can be given, max is the maximum grade that can be given, start is the grade that the slider starts from, tick tells what is the spacing between ticks under the slider (use 0 for no ticks). All these values can be configured to both sliders individually.

ENABLE command tells GUI to enable the testee to give his/her answer.

CLOSE command tells GUI process to exit, closing communication socket and GUI window during the process.

Protocol messages sent by GUI process

Here is the list of protocol messages sent by GUI process. The type of the parameter is in parenthesis. The command and parameters are separated by whitespace and each command line ends with a newline character ('\n').

EVENT timestamp(float) BUTTON A
EVENT timestamp(float) BUTTON B
EVENT timestamp(float) BUTTON C
EVENT timestamp(float) BUTTON STOP
ANSWER timestamp(float) bval(int) cval(int)

The GUI process will start sending messages after receiving the ENABLE message from test logic. It will then send any number of the EVENT messages followed by a single ANSWER message. The button events are requests from the test subject to the test logic to start or end playing samples. The timestamp parameter is a float telling the system time in seconds as returned by Python time.time() method.

ANSWER bval cval message means testee pressed the OK button. The bval and cval parameters give the values of the B and C sliders when user pressed the OK button.

· Communication protocols · Testee UI Architecture · Testee UI Index · Document index · Guinea Pig ·