An implementation of the WPILib WebSocket protocol for Python
Project description
wpilib-ws-py
This library is an implementation of the WPILib simulation WebSocket, used for controlling non-frc hardware or simulation software using WPILib. The specification of this protocol is found here.
My own dive into the source code for the websocket, which has some undocumented information: https://github.com/AM2i9/wpilib-ws-py/payloads.md
from wpilib_ws import WPILibWsServer
server = WPILibWsServer()
# The on_message decorator will let you create handlers for message events.
# Optionally a device type can be entered to only handle messages for that
# specific device type. A list of device types and other hardware messages can
# be found here:
# https://github.com/wpilibsuite/allwpilib/blob/main/simulation/halsim_ws_core/doc/hardware_ws_api.md#hardware-messages
@server.on_message("PWM")
async def pwm_handler(message):
payload = message.data
print(f"Recieved PWM event: {payload}")
# ...
@server.on_message("CANMotor")
async def can_motor_handler(message):
payload = message.data
print(f"Recieved CANMotor event: {payload}")
# ...
# Optionally, a device name can be entered to `on_message()`:
@server.on_message("SimDevice", "SPARK MAX")
async def spark_max_handler(message):
# SimDevices are arbitrary devices sent over the websocket, which can be
# used by vendor libraries to be able to use their controllers in robot
# simulation. For example, SPARK MAX and other REV controllers will not
# show as CAN devices, but as SimDevices.
payload = message.data
print(f"Recieved update for SPARK MAX controller: {payload}")
@server.on_message("CANMotor", "Victor SPX")
async def victor_handler(message):
payload = message.data
print(f"Recieved update for Victor SPX controller: {payload}")
# The while_connected decorator is a loop that runs alongside the server, and
# can be used for periodic tasks, such as sending battery voltage, like below.
@server.while_connected()
async def while_connected():
await server.send_payload(
{"type": "RoboRIO", "device": "", "data": {">vin_voltage": 12.0}}
)
server.run()
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
wpilib-ws-py-0.3.0.tar.gz
(5.8 kB
view hashes)
Built Distribution
Close
Hashes for wpilib_ws_py-0.3.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | e36fe820b7b5a0de6be48d5edf0ea3865f0d50b1bcdd52002c99f10a75793fce |
|
MD5 | 5f2076a899fc64bf423d596ceea35bab |
|
BLAKE2b-256 | 0eab72180a9e816970388b793ccc7a0575f979f5b1cb72b2afa964ab9291b5b6 |