Running robot code¶
Now that you’ve created your first Python robot program, you probably want to know how to run the code. The process to run a python script is slightly different for each operating system.
This section assumes that you’ve already installed pyfrc. If you haven’t, now’s a great time to do so!
How to execute the script¶
On Windows, you will typically execute your robot code by opening up the command prompt (cmd), changing directories to where your robot code is, and then running this:
py -3 robot.py
On Linux/macOS, you will typically execute your robot code by opening up the Terminal program, changing directories to where your robot code is, and then running this:
If you’re using pydev with Eclipse, there are a couple of ways to run the code.
- Right click on the file in project explorer, and select
PyDev -> Run As -> Python Run
- Right click on the text editor and select
Run As -> Python Run
After running the python script the first time, you’ll want to pass it arguments (see below). To edit the arguments, click on the little arrow next to the green play button, and select “Run Configurations”. Under “Python Run”, you can select your configuration, and then select the “arguments” tab.
When you run your code without additional arguments, you’ll see an error message
saying something like
robot.py: error: the following arguments are required:
command. RobotPy tools install various commands that you can run from your
robot code. To discover the various features that are installed, you can use the
Windows: py -3 robot.py --help Linux/macOS: python3 robot.py --help
RobotPy supports an extension mechanism that allows advanced users the
ability to create their own custom
robot.py commandline options.
For more information, see Adding options to robot.py
There are two ways you can run the code: on the robot, and on the simulator:
If you’re just starting out with RobotPy, you’ll probably find it faster (and more instructive) to start playing with your code in the simulator before you actually deploy it to a robot.