Skip to content

Latest commit

 

History

History
49 lines (35 loc) · 2.17 KB

readme.md

File metadata and controls

49 lines (35 loc) · 2.17 KB
Raw

Home Assistant Plantronics Windows Service

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

Image of Plantronics state in 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 postinstall.py 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.