Basestation Protocol

MSL RefBox now uses a JSON based protocol for communication with the base stations through a TCP connection. This TCP connection is established by connecting to RefBox port 28097.

Relevant information regarding the new protocol can be found in the following links:

• REFBOX V2.0 BETA Version – JSON formatted Commands and Connection Procedure
• MSL RefBox list of Commands send to Base Stations.
• MSL RefBox table list of Commands send to Base Stations.

The following information refers to the previous character-based protocol. This was used until version 1.5.0 of the MSL RefBox (you can still find it at this URL).

This version and protocol is now deprecated.

Command List

Command	Character	Description
STOP	S
START	s
WELCOME	W	Sent to signal an established connection.
WORLD_STATE	w	This seems not to be used anymore @mbc
RESET	Z
TESTMODE_ON	U	Reserved for RefBox debugging
TESTMODE_OFF	u	Reserved for RefBox debugging
YELLOW_CARD_MAGENTA	y
YELLOW_CARD_CYAN	Y
RED_CARD_MAGENTA	r
RED_CARD_CYAN	R
DOUBLE_YELLOW_IN_MAGENTA	b
DOUBLE_YELLOW_IN_CYAN	B
FIRST_HALF	1
SECOND_HALF	2
FIRST_HALF_OVERTIME	3
SECOND_HALF_OVERTIME	4
HALF_TIME	h
END_GAME	e
GAMEOVER	z
PARKING	L
GOAL_MAGENTA	a
GOAL_CYAN	A
SUBGOAL_MAGENTA	d
SUBGOAL_CYAN	D
KICKOFF_MAGENTA	k
KICKOFF_CYAN	K
FREEKICK_MAGENTA	f
FREEKICK_CYAN	F
GOALKICK_MAGENTA	g
GOALKICK_CYAN	G
THROWIN_MAGENTA	t
THROWIN_CYAN	T
CORNER_MAGENTA	c
CORNER_CYAN	C
PENALTY_MAGENTA	p
PENALTY_CYAN	P
DROPPED_BALL	N
REPAIR_OUT_MAGENTA	o
REPAIR_OUT_CYAN	O
REPAIR_IN_MAGENTA	i	This seems not to be used anymore @mbc
REPAIR_IN_CYAN	I	This seems not to be used anymore @mbc