RDM_TEST_SERVER.PY(1)

✨ rdm_test_server.py β€” the manual page, bestie edition ✨

aka RDM_TEST_SERVER.PY(1) β€” a User Commands moment, section 1, we love to see it πŸ’…


🌸 NAME 🌸

rdm_test_server.py β€” a whole web server whose entire job is testing RDM responders for adherence to the standards. Like a vibe check but for hardware, fr fr πŸ¦‹


πŸŽ€ SYNOPSIS πŸŽ€

rdm_test_server.py [options]

✨ DESCRIPTION ✨

okay so here's the tea πŸ“: this starts up the TestServer (which is literally just a simple Web Server) and it runs a whole series of tests on a RDM responder, then shows you the results in a Web UI. Iconic behaviour honestly πŸ‘‘

but β€” and this is the important part β€” it requires the OLA server to already be running, and the RDM device needs to have been detected. You can confirm all that by running:

ola_rdm_discover -u UNIVERSE

now the warning part, and bestie I need you to actually listen 😭

This will send SET commands to the broadcast UIDs, which means the start address, device label etc. will be changed for all devices connected to the responder. Think twice about running this on your production lighting rig. Like. Twice. Minimum. πŸ™ˆ

πŸ’– OPTIONS πŸ’–

  • -h, --help β€” show this help message and exit. classic, reliable, never lets you down 🫢
  • -p DIR, --pid-location=DIR β€” the directory to load the PID definitions from. that's where the PID lore lives πŸ“
  • -d WWW_DIR, --www-dir=WWW_DIR β€” the root directory to serve static files from. and heads up: this one must be absolute. no relative paths, no shortcuts, absolute only, periodt πŸ’…
  • -l LOG_DIRECTORY, --log-directory=LOG_DIRECTORY β€” the directory to store log files in. receipts. keep them πŸ“
  • --world-writeable β€” make the log directory world writeable. that's it, that's the whole flag 🌈

and that's the whole page, you ate that πŸ’–

this was rdm_test_server.py, dated October 2015 β€” go forth and test responsibly, my love βœ¨πŸŽ€