Station Color Properties [stcol]

This request sets various Station Indicator Color properties.

URL:

/set.cgi?dst=stcol&<optional-parameters>

Optional Parameters:

  • station=<-1,0..1000> (optional)
    • This parameter (if present) chooses which station to operate on.
    • If this parameter is not preset or -1 is specified, then this function will operate on the “global” station settings.

  • button=<-1,0..1000> (optional)
    • This parameter (if present) chooses which button to operate on.
    • If this parameter is not preset or -1 is specified, then this function will operate on all buttons of the specified station.

  • <colorName>=<rgbColor> (optional)
    • The colorName parameter may be any of user1, user2, user3, user4, on, off, mixed, locked.
    • The rgbColor parameter may be a 6-digit or 8-digit hexadecimal color. For example, Red would be expressed as FF0000, and a Dark Blue would be 000033.
    • One or more color parameters may be specified in the same URL.

Response:

A single byte is returned. The following table explains the possible return values.

Result Description
0x00 The operation was successful.
0xFF An internal shared memory error occurred.

Examples:

Function URL
Set the “On” color of Button 2 of Station 3 to Green /set.cgi?dst=stcol&station=3&button=2&on=00FF00
Set the “Off” color of all buttons on Station 4 to Dark Yellow /set.cgi?dst=stcol&station=4&on=222200
Set the “User 1” and “User 2” colors of all buttons /set.cgi?dst=stcol&user1=FF8800&user2=00FF44