{"type":"doc","content":[{"type":"paragraph","content":[{"text":"This page outlines how to use serial I/O to issue commands to a TV display through a BrightSign player. Once a player and TV have been connected by RS-232 through DB9, USB, or 3.5mm serial cables, presentations can deliver commands as scheduled through ","type":"text"},{"text":"BrightAuthor","type":"text","marks":[{"type":"link","attrs":{"href":"https://docs.brightsign.biz/display/DOC/Commands"}}]},{"text":". Proper use of this document requires knowledge of BrightSign player ","type":"text"},{"text":"serial port configuration","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/DOC/pages/6558652"}}]},{"text":".","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Connecting Devices","type":"text"}]},{"type":"paragraph","content":[{"text":"RS-232 communication is conducted between two interface types: Data Terminal Equipment (DTE) and Data Circuit-terminating Equipment (DCE). In order to connect a BrightSign player and TV for serial I/O, the interface types on the two devices must be determined. Most BrightSign players function as a DCE devices, while TVs may vary. Consult documentation for both the ","type":"text"},{"text":"player","type":"text","marks":[{"type":"link","attrs":{"href":"https://docs.brightsign.biz/display/DOC/Hardware"}}]},{"text":" and TV to determine if they are DTE or DCE.","type":"text"}]},{"type":"paragraph","content":[{"text":"Straight-through cabling only supports DTE to DCE connections. If both devices are DTE or DCE, a connection can be established through a null-modem cable or transformer, which flips RX/TX signals. ","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Issuing Commands","type":"text"}]},{"type":"panel","attrs":{"panelType":"warning"},"content":[{"type":"heading","attrs":{"level":3},"content":[{"text":"Note","type":"text"}]},{"type":"paragraph","content":[{"text":"The DE-9 (more commonly referred to as DB-9) serial port is fully RS-232 compatible, but the 3.5mm serial port can only interoperate with some RS-232 compatible devices. It can receive from any RS-232 device, but transmission may not work depending on the electrical characteristics of the devices.","type":"text"}]}]},{"type":"paragraph","content":[{"text":"After the connection between devices is established, commands can be sent from the player to the TV. ","type":"text"},{"text":"Commands can typically be found in the TV manufacturer documentation. BrightAuthor can only send decimal or ASCII values; however, many TVs operate in other numeric systems like hexadecimal. Be sure to properly convert the command value to decimal or ASCII before entering the serial bytes. BrightSign players can support sending commands in hexadecimal and binary through the use of third party scripts and plugins. For more information on how to do this, contact our ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]},{"text":"support","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}},{"type":"link","attrs":{"href":"https://brightsign.zendesk.com/hc/en-us/"}}]},{"text":".","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]},{"type":"paragraph","content":[{"text":"The following is an example of how to send a command in decimal:","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":90.0},"content":[{"type":"media","attrs":{"width":1280,"id":"7282f80b-eead-4607-8fa5-54af5c3e2282","collection":"contentId-6558667","type":"file","height":682}}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Create an Interactive presentation in BrightAuthor.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Open the media state or event where you want to send the command.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Click the ","type":"text"},{"text":"Advanced","type":"text","marks":[{"type":"strong"}]},{"text":" tab.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Click ","type":"text"},{"text":"Add Command","type":"text","marks":[{"type":"strong"}]},{"text":" and set the command to ","type":"text"},{"text":"Send – Serial Bytes","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Set the ","type":"text"},{"text":"Port","type":"text","marks":[{"type":"strong"}]},{"text":" to 0 (standard case for most serial devices).","type":"text"}]},{"type":"paragraph","content":[{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.migration","extensionKey":"__confluenceADFMigrationUnsupportedContentInternalExtension__","text":"","parameters":{"cxhtml":"Note

A USB-serial device (such as a GPS receiver) will enumerate on port 2. Additional USB-serial devices will enumerate on ports 3, 4, 5, etc. The enumeration order will remain consistent between reboots as long as the USB-serial devices are connected to the same player/hub ports. The enumeration order can be retrieved using the "usblist" command at the brightsign> shell prompt; otherwise, it will need to be determined by testing the setup.

","block-inline":true,"nestedContent":{"type":"doc","content":[{"type":"panel","attrs":{"panelType":"warning"},"content":[{"type":"heading","attrs":{"level":3},"content":[{"text":"Note","type":"text"}]},{"type":"paragraph","content":[{"text":"A USB-serial device (such as a GPS receiver) will enumerate on port 2. Additional USB-serial devices will enumerate on ports 3, 4, 5, etc. The enumeration order will remain consistent between reboots as long as the USB-serial devices are connected to the same player/hub ports. The enumeration order can be retrieved using the \"usblist\" command at the ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#333333"}}]},{"text":"brightsign>","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#333333"}}]},{"text":"shell prompt","type":"text","marks":[{"type":"link","attrs":{"href":"https://docs.brightsign.biz/display/DOC/BrightScript+Debug+Console"}}]},{"text":"; otherwise, it will need to be determined by testing the setup.","type":"text","marks":[{"type":"textColor","attrs":{"color":"#333333"}}]}]}]}],"version":1},"reason":"A note macro in a list item can't be created or edited in the new editor."}}}]},{"type":"paragraph"}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Enter the command in the ","type":"text"},{"text":"Bytes","type":"text","marks":[{"type":"strong"}]},{"text":" field. Use a comma to separate each byte.","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"The following is an example of how to send a command in ASCII:","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":55.0},"content":[{"type":"media","attrs":{"width":1306,"id":"234ed25f-feb6-4ef9-9dc3-54407769cf84","collection":"contentId-6558667","type":"file","height":717}}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Create an Interactive presentation in BrightAuthor.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Open the media state or event where you want to send the command.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Click on the ","type":"text"},{"text":"Advanced","type":"text","marks":[{"type":"strong"}]},{"text":" tab.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Click ","type":"text"},{"text":"Add Command","type":"text","marks":[{"type":"strong"}]},{"text":" and set the command to ","type":"text"},{"text":"Send – Serial String (EOL)","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Set the ","type":"text"},{"text":"Port","type":"text","marks":[{"type":"strong"}]},{"text":" to 0 (standard case for most serial devices).","type":"text"}]},{"type":"paragraph","content":[{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.migration","extensionKey":"__confluenceADFMigrationUnsupportedContentInternalExtension__","text":"","parameters":{"cxhtml":"Note

Browser not supported