Home Assistant Plantronics Windows Service

Welcome! This Python based Windows Service communicates the status of your Plantronics headset to Home Assistant.

Requirements

• Python 3.* installed and added to PATH
• Plantronics Hub
• Ensure you can browse to the CallManager state URL http://127.0.0.1:32017/Spokes/CallServices/CallManagerState/ and confirm that the HasActiveCall status will change when you are in a call.

How to install

• Open a PowerShell window as administrator and run:

pip install -r .\requirements.txt

Make sure that the packages show up under C:\Program Files (x86)\Python*\Lib\site-packages as the Windows Service needs to access it.

• Run the script from the PowerShell console with administrator privileges.

• Clone or download the source code from this repository. Copy secrets.example.json to secrets.json and provide the required info.

• Make sure the SYSTEM account has access to this folder as the service will run under SYSTEM.

• Browse to the location and run the code below in PowerShell with administrator privileges:

python .\main.py --startup delayed --wait 2 install
python .\main.py start

Troubleshooting

• Check if the service is started. In PowerShell, run:

Get-Service -Name "HomeAssistantPlantronicsSync"
Get-Service -Name "HomeAssistantPlantronicsSync" | Start-Service

• You can run the following code to debug the service:

python .\main.py debug

• In case you receive the error Error starting service: The service did not respond to the start or control request in a timely fashion during the start of the service, make sure to have the pywintypes36.dll file available from the C:\Program Files (x86)\Python*\Lib\site-packages\win32 folder. In case the file is missing, copy it from the C:\Program Files (x86)\Python*\Lib\site-packages\pywin32_system32 folder.
• Open up an issue within this repository in case your issue is not listed here or listed as a closed issue.