OZWCP(1)

📦 version 1.6~git20200306.4b8a39d, in debian bookworm, ubuntu jammy, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

💖 NAME 💖

ozwcp — the OpenZWave Control Panel, bestie. That's it, that's the name, and honestly? Iconic.

✨ SYNOPSIS ✨

ozwcp [-d] [-p port]

🎀 DESCRIPTION 🎀

Okay so, OpenZWave Control Panel (that's ozwcp to its friends) is your little web-based bestie for querying, managing, and monitoring Z-Wave nodes and networks. Full remote-control main character energy for your smart home. 🏠✨

Some cute little things you can do with it:

  • add and remove nodes
  • test commands
  • view and change node configuration parameters

Once it's running, open a web browser and connect to the host:port that ozwcp is listening on. By default that's http://localhost:8090/ 🦋

Then type in the device path — for example /dev/ttyACM0 — and smash that "Initialize" button. 💅

Heads up bestie: a LOT of Z-Wave USB sticks act as serial devices. If yours does, do not check the USB box. The way that little checkbox will ruin your whole afternoon, no cap. 😭

Big important vibe check: ozwcp has to be able to exclusively read and write to the controller. Exclusively. It's giving only-child. 🫶

Usually that means:

  • running it as a user who's a member of the device group — like dialout for serial ports
  • or just changing the permissions of the device file

Running as root should also work, but it is not recommended, so like… don't. 🙈

And please, before you initialize, stop any other programs that might be using the device. They will fight over it and it will be messy. 💀

🔥 OPTIONS 🔥

  • -d — turns on debugging. Let it yap, you'll need the receipts. 🔍
  • -p port — listen on the port you specify instead of the default 8090. Customize your kingdom, queen. 👑

🌸 FILES 🌸

  • /etc/openzwave — the OpenZWave configuration files live here. 🏡
  • /usr/share/openzwave-controlpanel — static files for the web server. The aesthetic bits. ✨
  • ozwcache_*.xml — a cache of your current network configuration. Lowkey note: this used to be called zwcfg_*.xml, so if you were around back then, that's the glow-up. 🦋
  • OZW_Log.txt — the OpenZWave log file. Genuinely useful when you're debugging, fr fr. 🍓

👑 AUTHORS 👑

ozwcp was written by Greg Satz <satz@iranger.com>, and it's been maintained by Justin Hammond <justin@dynam.ac> plus a whole squad of other contributors. Team effort, we love to see it. 💜

This manual page was written by Dara Adib <daradib@ocf.berkeley.edu> for the Debian project — but it may be used by others, so share the love. 🫶

🌈 SEE ALSO 🌈

  • /usr/share/doc/openzwave-controlpanel/README — go read it, bestie, it's giving lore. 📖

That's the whole page, babe. Sending you off with love from the General Commands Manual, dated 2016-12-24, signed OZWCP(1). Now go initialize that controller and slay. 💖✨💅

📦 where this page comes from