484-0003 - GUIDELINE, CONTROLLING LIGHTS ON VISUALTARGET ENCLOSURES

Public Channel / Development Guides

125 views
0 Likes
0 0
The aim of this guideline is to assist developers in making their App capable of controlling the light properties on the VisualTarget line of tablet enclosures.

Share on Social Networks

Share Link

Use permanent link to share in social media

Share with a friend

Please login to send this document by email!

Embed in your website

Select page to start with

1. DEVELOPMENT GUIDELINE 484 - 0003 Rev 2 VISUALTARGET ENCLOSURES CONTROLLING LIGHTS Page 1 of 2 The aim of this guideline is to assist developers in making their App capable of controlling the light properties on the VisualTarget line of tablet enclosures. Understanding the core functionality An audio cable goes from the tablet audio port to the VisualTarget electronics. If the tablet plays a certain frequency through the audio jack, the enclosure recognizes it and switch the lights to the corresponding state requested. The frequency value is encoded in such a way that 100 different colors (99 RGB colors + black/OFF) can be requested of the enclosure. In addition, the selected color can be set to 3 distinct brightness level as well as a blinking state. Th e graphic below highlights how to find the frequency value for a given color/state. Six popular light colors are show, with the full list available here: support.magtarget.com

2. DEVELOPMENT GUIDELINE 484 - 0003 Rev 2 VISUALTARGET ENCLOSURES CONTROLLING LIGHTS Page 2 of 2 Popular color used for meeting scheduling: Red at 100% brightness (room occupied): 4,645 Hz Green at 100% brightness (room available): 4,125 Hz Blinking Yellow (upcoming meeting / check - in): 5,775 Hz In rainbow mode the enclosure progressively cycles through all colors indefinitely. This can be used for testing. It can also be used in scenarios where the enclosure is design ed to attract attention, as in a trade - show display for examples. R equirement s for compatibility with VisualTarget enclosures 1. Frequency plays through the tablet audio port when an audio jack is connected a. Some developers choose to disable audio sent to spea kers to avoid nuisance to the users if the frequency is enabled but nothing is plugged into the audio port 2. Frequency plays continuously a. A five second delay is built into the enclosure electronics to avoid false positive b. T he enclosure will technically keep its last requested color even after the audio frequency stops. But w e ask that the given frequency plays continuously . As random color changes have otherwise been experienced due to noise from the surrounding electrical/network cabling Additional options You may consider implementing the following to improve the user experience: Allow local admin to enter their own frequency for a given state Although this requires more time to develop than a hard - coded frequency set. It greatly improves the customer experience and reduce tech - support tickets. A common request is to have the brightness tweaked as it is either too strong or not strong enough to the customer taste. Allow each enclosure to have a different light setting This can come in handy if an overall office is running at 50% brightness. But a particular enclosure is under direct sunlight, which makes its colors harder to detect, if not set at 100% Testing your App Final testing should be performed on the target device inside a VisualTarget enclosure. But the following tool can be used by developers for preliminary evaluation: Windows/MacOS/Linux: Friture ( f riture.org ) MagTarget can also assist in testing your App free - of - charge I f you send login credentials for your app / services to : info @ magtarget. com

Views

  • 125 Total Views
  • 91 Website Views
  • 34 Embedded Views

Actions

  • 0 Social Shares
  • 0 Likes
  • 0 Dislikes
  • 0 Comments

Share count

  • 0 Facebook
  • 0 Twitter
  • 0 LinkedIn
  • 0 Google+

Embeds 1

  • 1 support.magtarget.com