Tik-76.115 Individual Project: Guinea Pig
$Id: ab_interface.html,v 1.4 1996/04/21 18:55:45 kepa Exp $

Testee UI - A/B Test Communication protocol

This document describes the communication protocols used between Test Logic process and GUI process to implement A/B 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
PLAYING sample(string)
STOPPED sample(string)
ENABLE warnTO(float) answerTO(float)
CLOSE

ARM command tells GUI to colour all buttons grey.

PLAYING command is used to change the colour of the bar on top of a sample blue. The sample parameter is either A or B.

STOPPED command is used to change the colour of the bar on top of the sample buttons grey. The sample parameter is either A or B.

ENABLE command tells GUI to enable the testee to give his/her answer. GUI enables the user to give answers and colours bars on top of the sample buttons green. If warnTO is greater than zero, it it used to enable a timeout, after which the colour of both bars on top of the sample buttons turn yellow. If answerTO is greater than zero, it it used to enable a timeout, after which testee is no longer able to give his/her answer. This is indicated to Test Logic by sending a timeout message (see below). Also the colour of both bars on top of the sample buttons turn red.

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').

ANSWER timestamp(float) A
ANSWER timestamp(float) B
ANSWER timestamp(float) TIMEOUT

The GUI process will send only one of these messages above each time it has been enabled with ENABLE message. The timestamp parameter is a float telling the system time in seconds as returned by Python time.time() method.

ANSWER A message means testee pressed the A button.

ANSWER B message means testee pressed the B button.

ANSWER TIMEOUT message means the answering time ran out before testee gave any answer.

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