Skip to content

zeninputfail/xvgu-controller

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

13 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

XVGU Signal Tower Controller

This project provides a Python-based tool (CLI + GUI) for controlling Schneider Electric Pro-face XVGU3SHAG and XVGU3SWG USB signal towers from a Raspberry Pi.

Tested on: Raspberry Pi 5 with Raspberry Pi OS 64-bit
Compatible devices: XVGU3SHAG, XVGU3SWG
⚠️ This project is an independent implementation and not affiliated with Schneider Electric.

Watch the XVGU Tower in Pink (demo video)


Files

  • xvgu.py --- USB control script (command-line interface)
  • xvgu_gui.py --- Tkinter GUI for light and buzzer control
  • 99-xvgu.rules --- udev rule to allow USB access without sudo

About

This project controls Schneider Electric Pro-face XVGU USB signal towers using Python on Raspberry Pi.

For a detailed walkthrough, development background, and examples (including CO₂ monitoring integration), check out the full article on Qiita: USBパトライト (EZタワーライト/Schneider XVGU) をPythonから制御してみた.


Installation and Usage (Raspberry Pi 5)

1. Connect the device

Plug the XVGU signal tower into a USB port on your Raspberry Pi.

2. Install dependencies

sudo apt update
sudo apt install -y python3-tk libusb-1.0-0 python3-pip
pip3 install pyusb

3. Set up USB permissions

sudo cp 99-xvgu.rules /etc/udev/rules.d/
sudo udevadm control --reload-rules
sudo udevadm trigger

Then unplug and reconnect the XVGU device.

4. Run a test (CLI)

# Turn on red on layer ONE
python3 xvgu.py ledset --layer ONE --name red --pattern ON

# Start buzzer (default: tone=high, volume=mid)
python3 xvgu.py buzzer

# Start buzzer with custom tone and volume
python3 xvgu.py buzzer --tone high --volume big --seconds 2

# Stop buzzer
python3 xvgu.py buzzer --off

5. Launch the GUI

python3 xvgu_gui.py

This opens a graphical interface to control lights and buzzer. GUI


Device Info

The tool communicates with the XVGU device using:

  • VID: 0x16DE
  • PID: 0x000C

License

MIT License


Disclaimer

This project is an independent implementation.
It is not affiliated with or endorsed by Schneider Electric or Pro-face.

Schneider Electric and Pro-face are trademarks of their respective owners.

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages