/philips-signage-display-sicp

API client for controlling Philips displays that implement Philips SICP protocol. Built using cross-platform .NET Core, in C#.

Primary LanguageC#MIT LicenseMIT

philips-signage-display-sicp

API client for controlling Philips displays that implement Philips SICP protocol. Built using cross-platform .NET Core.

This project was created to manage a Philips 10BDL3051T display through the Philips SICP protocol. The protocol defines about 50 different commands but only the commands supported by the 10BDL3051T has been implemented (in Philips10BDL3051TClient). See instructions below if you require support for a different display. Note that many commands implemented for 10BDL3051T works for other models as well.

Documentation of the SICP protocol can be found online: Documentation of the SICP protocol, v1.99, 25 May 2017

SICP stands for Serial (Ethernet) Interface Communication Protocol.

Install

A package has been published to Nuget: https://www.nuget.org/packages/PhilipsSignageDisplaySicp

dotnet add package PhilipsSignageDisplaySicp --version 1.0.1

Usage

var displayIpAddress = IPAddress.Parse("192.168.1.100");

using (var socket = new SicpSocket(displayIpAddress, keepAlive: true)) 
{
    // SICP client for Philips 10BDL3051T (10" Android tablet). 
    // can be used for other Philiips displays as well (except led strip)
    var client = new Philips10BDL3051TClient(socket);

    // print hardware and software information
    Console.WriteLine(client.GetPlatformAndModelInfo());

    // turn off the screen
    client.EnableScreen(false);

    // set volume to 50%
    client.SetVolume(0.50);

    // set led strip color to blue
    client.EnableLedStrip(Color.Blue);
}

See more examples in the sample console project.

Features implemented for Philips 10BDL3051T

Philips 10BDL3051T

The Philips 10BDL3051T is a 10 inch tablet running Android 4.4, with hardware and software suitable for signage solutions. It is perfect fit for room booking displays or control panels.

The USA market has an almost identical product called 10BDL4151T.

To my knowledge this is the complete feature set implemented by 10BDL3051T.

  • Controlling LED light
    • EnableLedStrip(Color color)
    • DisableLedStrip
    • GetLedStrip
  • Toggling screen on and off
    • IsScreenOn
    • EnableScreen(bool enabled = true)
  • Controlling the speaker volume
    • GetVolume
    • SetVolume(double speakerVolumePercentage)
  • Controlling which input/app is active. E.g. browser, media player, PDF player or custom app.
    • GetInputSource
    • SetInputSource(InputSource inputSource)
  • Schedule of when apps/inputs are activated. (Note: updating of schedule was very buggy in my device)
    • GetSchedule(SchedulePage schedule)
    • SetSchedule(SchedulePage schedulePage, Schedule schedule)
  • Disabling touch support
    • IsTouchEnabled
    • SetTouchEnabled(bool enabled = true)
  • Setting what is display during boot of the display
    • GetPowerOnLogo
    • SetPowerOnLogo(PowerOnLogo powerOnLogo)
  • Deactivating USB and MicroSD ports to protect from malware and intrusions
    • IsExternalPortsEnabled
    • EnableExternalPorts(bool enabled = true)
  • Control which group the display is part of
    • GetGroupId
    • SetGroupId(byte groupId)
  • Misc. hardware and model information
    • GetOperatingHours
    • GetSerialCode
    • GetModelInfo
    • GetPlatformInfo
  • Reset the display to factory settings
    • PerformFactoryReset

Implementing a custom display client

If you have a different display than the Philips 10BDL3051T, then you may need to create a custom SICP client. This can be done in the following manner.

  1. Create a new class and inherit from PhilipsSicpClient:

    public class CustomPhilipsClient : PhilipsSicpClient {
    public CustomPhilipsClient(SicpSocket socket, byte monitorId = 1, byte groupId = 0) 
        : base(socket, monitorId, groupId) { }
}

  2. Implement the command methods you need. Read the documentation to know how to format your command parameters. In this example we will implement the "4.1 Power state" command.

    public virtual bool GetPowerState()
{
    var message = Get(SicpCommands.PowerStateGet);
    // power is on when first parameter equals to 0x02
    return message.CommandParameters[0] == 0x02;
}

public virtual void SetPowerState(bool powerState)
{
    Set(SicpCommands.PowerStateSet, powerState.ToByte(trueValue: 0x02, falseValue: 0x01));
}

  3. Instantiate your new client by passing in a SicpSocket instance.

    var socket = new SicpSocket(IPAddress.Parse("192.168.1.100"));
var client = new CustomPhilipsClient(socket);

var powerState = client.GetPowerState();
client.SetPowerState(!powerState);

Philips displays with support of SICP protocol

The following table lists some of the Philips displays that implement the SICP protocol. Every device may support different subsets of the available commands.

Model Platform
Philips 10BDL3051T Android
Philips 32BDL4050D Dragon 1.0
Philips 43BDL4050D Dragon 1.0
Philips 43BDL4051T Dragon 1.0
Philips 49BDL4050D Dragon 1.0
Philips 55BDL4050D Dragon 1.0
Philips 55BDL4051T Dragon 1.0
Philips 65BDL3051T Dragon 1.0
Philips 65BDL4050D Dragon 1.0
Philips 42BDL5055P Dragon 1.5
Philips 42BDL5057P Dragon 1.5
Philips 49BDL5055P Dragon 1.5
Philips 49BDL5057P Dragon 1.5
Philips 55BDL5055P Dragon 1.5
Philips 55BDL5057P Dragon 1.5
Philips BDL4676XL eagle
Philips BDL4677XL eagle
Philips BDL4682XL eagle
Philips BDL5585XL eagle
Philips BDL5587XL eagle
Philips BDL6551V eagle
Philips BDL6520EL eagle 1.2
Philips BDL6524ET/02 eagle 1.2
Philips BDL3250EL eagle 1.3
Philips BDL4250EL eagle 1.3
Philips BDL4252EL eagle 1.3
Philips BDL4254ET eagle 1.3
Philips BDL4256ET eagle 1.3
Philips BDL4271VL eagle 1.3
Philips BDL4650EL eagle 1.3
Philips BDL4652EL eagle 1.3
Philips BDL4671VL eagle 1.3
Philips BDL4677XH eagle 1.3
Philips BDL4678XL eagle 1.3
Philips BDL4776XL eagle 1.3
Philips BDL4777XH eagle 1.3
Philips BDL4777XL eagle 1.3
Philips BDL5551EL eagle 1.3
Philips BDL5554ET eagle 1.3
Philips BDL5556ET eagle 1.3
Philips BDL5571VL eagle 1.3
Philips BDL5586XH eagle 1.3
Philips BDL5586XL eagle 1.3
Philips BDL8470EU Himalaya
Philips BDL8470QT Himalaya
Philips BDL8470QU Himalaya
Philips BDL9870EU Himalaya
Philips 75BDL3000U Himalaya 1.2
Philips 75BDL3010T Himalaya 1.2
Philips 75BDL3003H Himalaya 1.2
Philips BDL3220QL MTK5580
Philips BDL4220QL MTK5580
Philips BDL4235DL MTK5580
Philips BDL4620QL MTK5580
Philips BDL5520QL MTK5580
Philips BDL3230QL MTK5580P2
Philips BDL4330QL MTK5580P2
Philips BDL4335QL MTK5580P2
Philips BDL4830QL MTK5580P2
Philips BDL4835QL MTK5580P2
Philips BDL5530QL MTK5580P2
Philips BDL5535QL MTK5580P2
Philips 55BDL1005X Phoenix 1.0
Philips 55BDL1007X Phoenix 1.0
Philips 65BDL3000Q Phoenix 1.0
Philips 65BDL3010T Phoenix 1.0
Philips BDL3260EL Phoenix 1.0
Philips BDL4260EL Phoenix 1.0
Philips BDL4280VL Phoenix 1.0
Philips BDL4660EL Phoenix 1.0
Philips BDL4680VL Phoenix 1.0
Philips BDL4765EL Phoenix 1.0
Philips BDL4780VH Phoenix 1.0
Philips BDL4988XC Phoenix 1.0
Philips BDL4988XL Phoenix 1.0
Philips BDL5560EL Phoenix 1.0
Philips BDL5580VL Phoenix 1.0
Philips BDL5588XC Phoenix 1.0
Philips BDL5588XH Phoenix 1.0
Philips BDL5588XL Phoenix 1.0
Philips BDL6520QL Phoenix 1.0
Philips BDL6526QT Phoenix 1.0
Philips BDL4270EL Phoenix 2.0
Philips BDL4290VL Phoenix 2.0
Philips BDL4970EL Phoenix 2.0
Philips BDL4990VL Phoenix 2.0
Philips BDL5570EL Phoenix 2.0
Philips BDL5590VL Phoenix 2.0
Philips 55BDL9018L LED
Philips 55BDL9025L LED