Brandon Guy

A Collection of Information and Projects from over the years. 

Device Operator Console

Device operator Console is a quick tool built to support Poly devices running UC Software. These devices include the Poly CCX, Trio, and VVX devices running a release of 5.9.x or later.

This tool leverages many of the open APIs in the UC Software to provide a remote operating solution for these devices.

Download the most recent version

You can find a zip of the published software here:

Google Drive Share (Version 1.1)


Abbreviated Feature List

  • Remote Screen Viewing
  • Remote Device Operation
  • Call Control
  • Active Call Statistics
  • Modular Room View (For Trio V+ and Daisy-Chained Trios)

Normal Disclaimer

This Tool is provided free of charge with no implied warranty on behavior. The application does not collect nor send any data to any location other than the device you are connected to.

This application WILL enable the RestAPI of the device and WILL enable the screen capture functionality. Both of these interfaces will still require the administrator password of the device to access.

I’ve built the tool using Visual Studio and published using the ClickOnce Technology. Although the application does have the ability to auto update, this has not currently been implemented. You can read more about ClickOnce here on the Microsoft documentation portal.

Update: Depending on your system, ClickOnce may not be allowed to install by default, a fantastic write up on the ClickOnce behavior with Windows can be found on here: https://www.gonnalearn.com/your-administrator-has-blocked-this-application-because-it-potentially-poses-a-security-risk-to-your-computer/

Known Limitations

  • You must have enabled the Web Server functionality.
    • either http or https may be used
  • You cannot use the default password of ‘456’.
  • VisualPro devices cannot be displayed

Version History

Version 1.1

  • Fixed a CSRF security issue when updating to UCS version 7.x with Visual+ units.

21 thoughts on “Device Operator Console

  • Daniel
    April 24, 2020 at 10:42 am

    Hi Brandon,

    Thanks for sharing this useful tool. Have there been any updates released for this tool since you posted this?

    • Brandon
      June 10, 2020 at 6:17 pm

      I haven’t gotten anything else added into the tool, as life has been a bit crazy.

      I do intend on buttoning up a few things like adding drag support as well as making a quicker way to capture the device screen and exporting it to support customers making their own custom user documentation. I also want to clean up a few workflows for dialing and line selection and add in a way to send digits through a 4×3. if there are some things you’d like to see changed or added, feel free to leave the comments and I’ll work through them as I can.

  • John
    April 27, 2020 at 11:37 am

    Hi, great app, I don’t seem to be able to interact with it in Teams mode at all or in Skype for Business mode get it to let me enter my admin password is that a bug or by design of the solution?

    • Brandon
      June 10, 2020 at 6:14 pm

      Correct, currently the RestAPI controls do not control the android applications, only the native Poly application.

      When running with Skype for Business mode, while this is the Poly Application, the keypad that is used in this interaction is actually an android application keyboard, which we can’t send a command to over the API interface.

      I’m trying to stick to only using externally facing public APIs with this tool so that it can be shared externally, so it is a limitation at this point in time.

  • Aaron G.
    October 15, 2020 at 12:38 am

    It would be most helpful if there was a console and/or debug option for this tool. Right now I’m having a heck of a time getting it to work and have no idea why it isn’t. I’ve tried multiple VVX phones now to no avail. Perhaps a basic user manual or notepad document contained within the ZIP file that has instructions?

    I love the concept of this tool but have yet to successfully use it to comment on it’s functionality. It very well could be operator error but the UI is simple enough I’d like to think that’s not where I’m getting hung up (VoIP joke).

    -Aaron

    • Brandon
      November 21, 2020 at 8:03 pm

      I am hoping to get a few updates into the tool over the holiday. I was going to try to work in some debug logging to help out in these scenarios. The most common problem I’ve seen has been related to firewalls, but it could absolutely be something else going on.

  • chito
    October 22, 2020 at 2:44 am

    This is very helpful especially that we are working from home most of the time. Would just like to know how to navigate to the next page of the display.

    • Brandon
      November 21, 2020 at 8:05 pm

      I have been meaning to add in some overlay controls to simulate swiping for this very reason. Right now there isn’t a way to drag across the screen.

  • Nick
    April 16, 2021 at 11:32 am

    This tool has been incredibly helpful, and I am so glad that I was able to come across it. I do run into some bugs such as the app crashing when disconnecting from a Trio and entering in the IP for another device. We use Trios in the Zoom Room Profile and would love for the ability to virtually interact with the screen. I saw in a previous comment that there isn’t a way to send swipes, but is there a way to send virtual taps? Are there plans to release any updates?

    • Brandon
      June 28, 2021 at 4:29 pm

      Clicks are working, but the API doesn’t extend to the android layer, which means that I cannot click into the Android Numpad, nor can I click into the Android app if you are running Zoom or Teams.

  • Joe
    May 7, 2021 at 1:57 am

    Hi Brandon,
    I really love(d) your tool, as this helped us so much in the past! But since we installed 7.0.0.4269 on our Trio 8800s, we cannot establish a connection any more, the tool always just crashes after some seconds.. 🙁
    Do you have any idea, if we can do anything here to make it run again? Or are there plans to make a new version, that works also with the newer firmware releases?

    BIG THX in advance 🙂

    • Brandon
      June 28, 2021 at 4:28 pm

      I’ve just uploaded version 1.1 which i’m finding to address this issue. Give it a go and let me know if you are still running into issues.

  • Josh
    May 13, 2021 at 9:22 pm

    Very cool – you don’t know how long I was looking for a way to capture the VVX screen for documentation purposes.

    Curious – does this use the uixml node (api/v1/mgmt/uixml) of the rest API & then represent the results as an image on the screen? Or is there a way to directly pull the image via the API?

    • Brandon
      June 28, 2021 at 4:29 pm

      I’m actually using the device feature of Screen Capture. Thanks for the feedback!

  • Stephan Botha
    June 1, 2021 at 7:03 am

    Good day Brandon. Hope you are well.
    Frist of all, thanks for this amazing program, without it I’m lost.
    However I need to ask some advice. Since today I receive the following error when opening the application, and have no idea how to solve it
    Any advice will be welcomed, thanks

    PLATFORM VERSION INFO
    Windows : 10.0.19041.0 (Win32NT)
    Common Language Runtime : 4.0.30319.42000
    System.Deployment.dll : 4.8.4270.0 built by: NET48REL1LAST_C
    clr.dll : 4.8.4300.0 built by: NET48REL1LAST_C
    dfdll.dll : 4.8.4270.0 built by: NET48REL1LAST_C
    dfshim.dll : 10.0.19041.1 (WinBuild.160101.0800)

    SOURCES
    Deployment url : file:///C:/Users/stephan.botha/Zutari/Zutari%20IT%20Operations%20-%20General/0.Zutari%20Operations/Zutari%20Infra%20Build/AV/Polycom%20Teams/DOC-Published-1.0.0.12/Device%20Operator%20Console.application

    IDENTITIES
    Deployment Identity : Device Operator Console.application, Version=1.0.0.12, Culture=neutral, PublicKeyToken=0000000000000000, processorArchitecture=msil

    APPLICATION SUMMARY
    * Installable application.

    ERROR SUMMARY
    Below is a summary of the errors, details of these errors are listed later in the log.
    * Activation of C:\Users\stephan.botha\Zutari\Zutari IT Operations – General\0.Zutari Operations\Zutari Infra Build\AV\Polycom Teams\DOC-Published-1.0.0.12\Device Operator Console.application resulted in exception. Following failure messages were detected:
    + You cannot start application Device Operator Console from this location because it is already installed from a different location.
    + You cannot start application Device Operator Console from location file:///C:/Users/stephan.botha/Zutari/Zutari%20IT%20Operations%20-%20General/0.Zutari%20Operations/Zutari%20Infra%20Build/AV/Polycom%20Teams/DOC-Published-1.0.0.12/Device%20Operator%20Console.application it is already installed from location file:///C:/Users/stephan.botha/Zutari/Zutari%20IT%20Operations%20-%20General/0.Zutari%20Operations/Zutari%20Infra%20Build/Polycom%20Teams/DOC-Published-1.0.0.12/Device%20Operator%20Console.application. You can start it from location file:///C:/Users/stephan.botha/Zutari/Zutari%20IT%20Operations%20-%20General/0.Zutari%20Operations/Zutari%20Infra%20Build/Polycom%20Teams/DOC-Published-1.0.0.12/Device%20Operator%20Console.application or you can uninstall it and reinstall it from location file:///C:/Users/stephan.botha/Zutari/Zutari%20IT%20Operations%20-%20General/0.Zutari%20Operations/Zutari%20Infra%20Build/AV/Polycom%20Teams/DOC-Published-1.0.0.12/Device%20Operator%20Console.application. If you reinstall the application, be aware that you might lose any customizations that you made to the application.

    COMPONENT STORE TRANSACTION FAILURE SUMMARY
    No transaction error was detected.

    WARNINGS
    * The manifest for this application does not have a signature. Signature validation will be ignored.

    OPERATION PROGRESS STATUS
    * [2021/06/01 13:02:08] : Activation of C:\Users\stephan.botha\Zutari\Zutari IT Operations – General\0.Zutari Operations\Zutari Infra Build\AV\Polycom Teams\DOC-Published-1.0.0.12\Device Operator Console.application has started.
    * [2021/06/01 13:02:08] : Processing of deployment manifest has successfully completed.

    ERROR DETAILS
    Following errors were detected during this operation.
    * [2021/06/01 13:02:08] System.Deployment.Application.DeploymentException (DeploymentUriDifferent)
    – You cannot start application Device Operator Console from this location because it is already installed from a different location.
    – Source: System.Deployment
    – Stack trace:
    at System.Deployment.Application.ApplicationActivator.CheckDeploymentProviderValidity(ActivationDescription actDesc, SubscriptionState subState)
    at System.Deployment.Application.ApplicationActivator.PerformDeploymentActivation(Uri activationUri, Boolean isShortcut, String textualSubId, String deploymentProviderUrlFromExtension, BrowserSettings browserSettings, String& errorPageUrl, Uri& deploymentUri)
    at System.Deployment.Application.ApplicationActivator.PerformDeploymentActivationWithRetry(Uri activationUri, Boolean isShortcut, String textualSubId, String deploymentProviderUrlFromExtension, BrowserSettings browserSettings, String& errorPageUrl)
    — End of stack trace from previous location where exception was thrown —
    at System.Runtime.ExceptionServices.ExceptionDispatchInfo.Throw()
    at System.Deployment.Application.ApplicationActivator.PerformDeploymentActivationWithRetry(Uri activationUri, Boolean isShortcut, String textualSubId, String deploymentProviderUrlFromExtension, BrowserSettings browserSettings, String& errorPageUrl)
    at System.Deployment.Application.ApplicationActivator.ActivateDeploymentWorker(Object state)
    — Inner Exception —
    System.Deployment.Application.DeploymentException (DeploymentUriDifferent)
    – You cannot start application Device Operator Console from location file:///C:/Users/stephan.botha/Zutari/Zutari%20IT%20Operations%20-%20General/0.Zutari%20Operations/Zutari%20Infra%20Build/AV/Polycom%20Teams/DOC-Published-1.0.0.12/Device%20Operator%20Console.application it is already installed from location file:///C:/Users/stephan.botha/Zutari/Zutari%20IT%20Operations%20-%20General/0.Zutari%20Operations/Zutari%20Infra%20Build/Polycom%20Teams/DOC-Published-1.0.0.12/Device%20Operator%20Console.application. You can start it from location file:///C:/Users/stephan.botha/Zutari/Zutari%20IT%20Operations%20-%20General/0.Zutari%20Operations/Zutari%20Infra%20Build/Polycom%20Teams/DOC-Published-1.0.0.12/Device%20Operator%20Console.application or you can uninstall it and reinstall it from location file:///C:/Users/stephan.botha/Zutari/Zutari%20IT%20Operations%20-%20General/0.Zutari%20Operations/Zutari%20Infra%20Build/AV/Polycom%20Teams/DOC-Published-1.0.0.12/Device%20Operator%20Console.application. If you reinstall the application, be aware that you might lose any customizations that you made to the application.
    – Source:
    – Stack trace:

    COMPONENT STORE TRANSACTION DETAILS
    No transaction information is available.

    • Brandon
      June 28, 2021 at 4:31 pm

      I think the new version I just published resolves this issue. Give it a go and let me know

  • Nick
    June 21, 2021 at 6:18 pm

    Hi Brandon,

    This is an incredibly helpful tool, and has definitely saved us some headache for our remote sites. Any word regarding updates? If you are looking for beta testers, I’m happy to volunteer.

    • Brandon
      June 28, 2021 at 4:32 pm

      No interfaces available today to take advantages of for the zoom device interaction sadly. Been toying with some thoughts, but just haven’t had much down time to explore them. Something in particular you are looking for?

  • Mark
    June 23, 2021 at 1:52 pm

    I’m having issues downloading DOC. Is the link on this page still the right place to download?

    • Brandon
      June 28, 2021 at 4:33 pm

      Yes, just updated the link to point to the new build. It should take you to a google drive share, which should enable you to download the full ZIP. Just checked and it was working for me in an incognito, but if it’s not working for you, let me know. Thanks

  • Brandon
    June 28, 2021 at 4:35 pm

    Thanks all for the support and understanding. Things have been busy and crazy, so I haven’t had a lot of cycles to put towards this. I did just update to fix an issue whereby the app was crashing in certain deployments with version 7.x or later. If you are still running into issues, feel free to reply and I’ll keep a closer eye here to keep tabs on it.

Leave a Reply

Your email address will not be published. Required fields are marked *.

*
*
You may use these <abbr title="HyperText Markup Language">HTML</abbr> tags and attributes: <a href="" title=""> <abbr title=""> <acronym title=""> <b> <blockquote cite=""> <cite> <code> <del datetime=""> <em> <i> <q cite=""> <s> <strike> <strong>