Skip to main content
All CollectionsManaging your ContentReal Time Events (RTEs)
How can I send a command to my serial device based on content playback?
How can I send a command to my serial device based on content playback?
Ian Maison avatar
Written by Ian Maison
Updated over a week ago

Serial commands paired with real-time event triggering eliminate manual input for interrupting content or environment changes to your devices or connected hardware. As an asset plays, simply assign it an RTE template, and your serial input device(s) will do the rest.

Tim, from our marketing team, offers a demo of how this might look:

This article covers the following points:

Requirements before you begin:

  • A supported player (BrightSign or PC Appliance (Windows/Mac)) that is activated against a valid Signagelive licence

Using Real Time Events (RTEs) you can send messages via the serial port on the player based on any of 4 events occurring (please see this overview article for more detail).

Serial commands are typically used to interact with hardware. For instance, a lighting control system or mechanical system may need to operate when your content starts or stops playing.

Configure a Real Time Event template for a serial input command

To configure an RTE for Serial Messaging, you can follow the steps below:

  1. Login to your Signagelive network.

  2. Go to Settings > Real Time Events.

  3. Click on the blue "+" button, and select Custom Event.

  4. Name your event (this will be saved as a template for reuse).

  5. Select whether it is to be Enabled On All Supported Players and Assets.

  6. You now have a choice of when the RTE is to occur, select the appropriate tab from: Asset Download, Asset Start, Asset Complete or Asset Remove.

  7. Within the tab, select Serial.

You will now be presented with the option to set Serial Port connection settings as specified by the external hardware manufacturer. Please refer to their manufacturers manual for the exact value of these settings.

Properties of a Serial Command:

  • Baud Rate (this is the rate at which the information is transferred in the communication channel)

  • Parity (parity is used to add checksums into the data, enabling the target device to determine whether the data was received correctly).

  • Flow Control (manages the flow of data to ensure data can be handled at an efficient pace).

  • EOL (Stands for End of Line, and this can be used to terminate serial strings. Possible values for this are CR, LF and CR+LF).

  • Port.

  • Data Bits.

  • Stop Bits.

  • Protocol.

  • Delay (this is in milliseconds, if the delay is lower than 100 then there is a chance the message may be ignored dependant on the receiving hardware, particularly if you are sending multiple commands (see below).

  • Commands (Enter the commands to send a single command per line and click save).

Values for serial input per device

In order to determine which Serial port the receiving hardware is connected to please see below.

BrightSign

  • If the device being controlled is USB, then it will be Port 2. If not, it will be Port 0 or 1 depending on the device.

Windows

  1. Ensure the Prolific USB to Serial Driver is installed (available here).

  2. Open Device Manager (can be accessed by entering the admin settings. Guide here).

  3. Find the Ports (COM and LPT) section.

  4. Connect the device you plan to control.

  5. The Device Manager should refresh.

  6. Then look for an item named Prolific USB to Serial Port (COM #) (or similar).

  7. Note the number and add that to Signagelive against the ‘Port’ section.

Mac

  1. Load Applications > Utilities > Terminal.

  2. Enter the command ls /dev/cu.*

  3. The returned string that will need to be used for the port will look like /dev/cu.usbserial-A(0740MF

Apply your template to a player

To complete the setup of your RTEs, you will need to configure them against either your network, the intended player(s) or the media asset(s) as desired. The processes for carrying this out are explained below:

Network

This will enable the RTEs across all supported players and assets on your Signagelive network. You enable this by:

  1. Going to Settings > Real Time Events.

  2. Select the RTE you would like to configure.

  3. Select the tick box labeled Enabled On All Supported Players and Assets.

Player

This will enable RTEs across the player(s) that you choose. You can do this by:

  1. Going to Network > Manage.

  2. Selecting the Player you would like to configure.

  3. Navigate to the Real Time Events tab on the far right.

  4. Select the RTEs that you would like to enable.

Please Note: Only players that Support Real Time Events will show the RTE tab.

This will send the RTE for all assets on the player by default.

Media Asset

This will enable RTEs on the specific Media Assets that you select, and will therefore apply whenever the asset is published to a supporting Player.

  1. Go to Content > Playlists.

  2. Select the desired Media Asset(s) from your Library.

  3. Click the blue "+" button.

  4. Select from Template or Custom Events.

  5. Select or configure the desired event.

Please Note

  • It is possible to have multiple RTEs defined, for example: On an asset set a serial RTE to control lighting and on the player set an HTTP RTE to send PoP data to a 3rd party system.

  • If you configure the same RTE on all 3 levels (Network, Player and Asset) then it will be executed 3 times.

  • It is recommended that you create these as templates for the whole network using the numbered steps at the top above. This ensures that the RTEs you create can be reused or applied to different assets. If you create them against specific assets, they cannot be transferred and will need to be created again.

Did this answer your question?