This wiki was in read-only mode for many years, but can now be edited again. A lot of information will need to be updated.
BZRobots/Protocol: Difference between revisions
		
		
		
		Jump to navigation
		Jump to search
		
No edit summary  | 
				|||
| Line 1: | Line 1: | ||
== BZRobots Enhanced Protocol ==  | == BZRobots Enhanced Protocol ==  | ||
This is a draft of the protocol that's being planned for the new bzrobots as a part of GSoC.  | This is a draft of the protocol that's being planned for the new bzrobots as a part of GSoC. The protocol is inspired by the API it will convey the messages of, which in turn is inspired by [http://robocode.sourceforge.net RoboCode]. ;-)  | ||
{| cellspacing="0" border="1"  | {| cellspacing="0" border="1"  | ||
|+ Backend messages  | |+ Backend -> frontend messages  | ||
!Message syntax  | !Message syntax  | ||
!Description  | !Description  | ||
|-  | |-  | ||
|SOME_COMMAND_HERE <float>  | |SOME_COMMAND_HERE <float>  | ||
|THIS RUNS SOME COMMAND WITH FLOAT ARGUMENT  | |THIS RUNS SOME COMMAND WITH FLOAT ARGUMENT  | ||
|}  | |}  | ||
{| cellspacing="0" border="1"  | {| cellspacing="0" border="1"  | ||
|+ Frontend messages  | |+ Frontend -> backend messages  | ||
!Message syntax  | !Message syntax  | ||
!Description  | !Description  | ||
|-  | |-  | ||
|  | |setAhead <distance>  | ||
|  | |Sets planned movement (for next 'execute') that moves 'distance' units.  | ||
|  | |-  | ||
|setBack <distance>  | |||
|Sets planned movement backwards, same as setAhead -distance  | |||
|-  | |||
|setTurnLeft <degrees>  | |||
|Sets planned turn (for next 'execute') that turns 'degrees' degrees to the left.  | |||
|-  | |||
|setTurnRight <degrees>  | |||
|Sets planned turn (for next 'execute') that turns 'degrees' degrees to the right, same as setTurnLeft -degrees.  | |||
|-  | |||
|setFire  | |||
|Sets a planned shot (for next 'execute')  | |||
|-  | |||
|getDistanceRemaining  | |||
|Gives a 'distanceRemaining'-reply with how much is left of the currently planned movement.  | |||
|-  | |||
|getTurnRemaining  | |||
|Gives a 'turnRemaining'-reply with how much is left of the currently planned turn.  | |||
|-  | |||
|execute  | |||
|Runs a tick of the 'planned actions', and replies with a 'tick over' when the tick has passed.  | |||
|}  | |}  | ||
Revision as of 19:38, 18 June 2007
BZRobots Enhanced Protocol
This is a draft of the protocol that's being planned for the new bzrobots as a part of GSoC. The protocol is inspired by the API it will convey the messages of, which in turn is inspired by RoboCode. ;-)
| Message syntax | Description | 
|---|---|
| SOME_COMMAND_HERE <float> | THIS RUNS SOME COMMAND WITH FLOAT ARGUMENT | 
| Message syntax | Description | 
|---|---|
| setAhead <distance> | Sets planned movement (for next 'execute') that moves 'distance' units. | 
| setBack <distance> | Sets planned movement backwards, same as setAhead -distance | 
| setTurnLeft <degrees> | Sets planned turn (for next 'execute') that turns 'degrees' degrees to the left. | 
| setTurnRight <degrees> | Sets planned turn (for next 'execute') that turns 'degrees' degrees to the right, same as setTurnLeft -degrees. | 
| setFire | Sets a planned shot (for next 'execute') | 
| getDistanceRemaining | Gives a 'distanceRemaining'-reply with how much is left of the currently planned movement. | 
| getTurnRemaining | Gives a 'turnRemaining'-reply with how much is left of the currently planned turn. | 
| execute | Runs a tick of the 'planned actions', and replies with a 'tick over' when the tick has passed. |