>
== Introduction ==
This package contains messages and services providing the interface to interact with the [[http://www.robocup-logistics.org|referee box (refbox)]] of the [[http://www.robocup-logistics.org|RoboCup Logistics League]] which is also used in the [[http://www.robocup-logistics.org/sim-comp|Planning Competition for Logistics Robots In Simulation]].
In addition to this msgs package, you will also need the [[rcll_refbox_peer]] (see its documentation there for a description of the actual topics). But you may, for example, choose to keep the calling code on a different machine than the peer. The messages have a close relation to the respective protobuf message types of the referee box. We suggest also consulting the [[http://www.robocup-logistics.org/refbox|refbox documentation]].
== Message Types ==
BeaconSignal::
Represents a single beacon signal received over the network.([[https://github.com/timn/ros-rcll_ros_msgs/blob/master/msg/BeaconSignal.msg|BeaconSignal.msg]])
ExplorationInfo::
Represents the information received from the refbox during the exploration phase. ([[https://github.com/timn/ros-rcll_ros_msgs/blob/master/msg/ExplorationInfo.msg|ExplorationInfo.msg]])
ExplorationSignal::
Light signal specification (used in !ExplorationInfo). ([[https://github.com/timn/ros-rcll_ros_msgs/blob/master/msg/ExplorationSignal.msg|ExplorationSignal.msg]])
ExplorationZone::
Zone specification (used in !ExplorationInfo). ([[https://github.com/timn/ros-rcll_ros_msgs/blob/master/msg/ExplorationZone.msg|ExplorationZone.msg]])
GameState::
The !GameState message is periodically sent via peer-to-peer to all robots as well as by client-server communication to connected controllers. The game time is restarted in the exploration and production phases, i.e. the time goes from 0 to 180 seconds in the exploration phase and from 0 to 900 seconds in the production phase.<
><
>
In the PRE_GAME and POST_GAME phases as well as in states other than RUNNING the robots must stand still immediately and all the time.<
>([[https://github.com/timn/ros-rcll_ros_msgs/blob/master/msg/GameState.msg|GameState.msg]])
LightSpec::
Light color/state combination specification. ([[https://github.com/timn/ros-rcll_ros_msgs/blob/master/msg/LightSpec.msg|LightSpec.msg]])
Machine::
Machine (in the sense of a on-field MPS station) specification. ([[https://github.com/timn/ros-rcll_ros_msgs/blob/master/msg/Machine.msg|Machine.msg]])
MachineInfo::
Periodic information about a team's machines. ([[https://github.com/timn/ros-rcll_ros_msgs/blob/master/msg/MachineInfo.msg|MachineInfo.msg]])
MachineReportEntry::
Machine report for a single machine as to be sent through a service to the refbox. ([[https://github.com/timn/ros-rcll_ros_msgs/blob/master/msg/MachineReportEntry.msg|MachineReportEntry.msg]])
MachineReportInfo::
Periodic information sent during the exploration phase by the refbox acknowledging reported machines. ([[https://github.com/timn/ros-rcll_ros_msgs/blob/master/msg/MachineReportInfo.msg|MachineReportInfo.msg]])
Order::
Order specification. ([[https://github.com/timn/ros-rcll_ros_msgs/blob/master/msg/Order.msg|Order.msg]])
OrderInfo::
List of currently announced orders sent periodically during the production phase. ([[https://github.com/timn/ros-rcll_ros_msgs/blob/master/msg/OrderInfo.msg|OrderInfo.msg]])
ProductColor::
Constants for the colors of the different elements of an order specification. ([[https://github.com/timn/ros-rcll_ros_msgs/blob/master/msg/ProductColor.msg|ProductColor.msg]])
Ring::
Specification of additional material requirements for a ring color. ([[https://github.com/timn/ros-rcll_ros_msgs/blob/master/msg/Ring.msg|Ring.msg]])
RingInfo::
List of ring specifications. Sent by refbox during production. ([[https://github.com/timn/ros-rcll_ros_msgs/blob/master/msg/RingInfo.msg|RingInfo.msg]])
Team::
Team color specification. ([[https://github.com/timn/ros-rcll_ros_msgs/blob/master/msg/Team.msg|Team.msg]])
Time::
Time specification. ([[https://github.com/timn/ros-rcll_ros_msgs/blob/master/msg/Time.msg|Time.msg]])
== Service Types ==
SendBeaconSignal::
Service specification to send beacon signal to referee box. ([[https://github.com/timn/ros-rcll_ros_msgs/blob/master/srv/SendBeaconSignal.srv|SendBeaconSignal.srv]])
SendMachineReport::
Service to send machine reports during exploration phase. ([[https://github.com/timn/ros-rcll_ros_msgs/blob/master/srv/SendMachineReport.srv|SendMachineReport.srv]])
SendPrepareMachine::
Send instruction to prepare a machine during production. ([[https://github.com/timn/ros-rcll_ros_msgs/blob/master/srv/SendPrepareMachine.srv|SendPrepareMachine.srv]])