{"id":13724,"date":"2020-12-12T17:12:15","date_gmt":"2020-12-12T16:12:15","guid":{"rendered":"https:\/\/nerdiy.de\/?p=13724"},"modified":"2020-12-12T18:28:03","modified_gmt":"2020-12-12T17:28:03","slug":"howto-pxlblck-commands-to-configure-the-pxlblck","status":"publish","type":"post","link":"https:\/\/nerdiy.de\/en\/howto-pxlblck-commands-to-configure-the-pxlblck\/","title":{"rendered":"HowTo: pxlBlck \u2013 Commands for configuring the pxlBlck"},"content":{"rendered":"

The pxlBlck plugin and the functions of your pxlBlck can be configured in two different ways. <\/p>\n\n\n\n

One option is to configure most of the functions via the plugin's web menu. You can find a lot of information about this in the article pxlBlck - Install and configure the pxlBlck plugin<\/a><\/em><\/strong><\/p>\n\n\n\n

In addition to this option, you can also set your pxBlck using commands during operation. This has the great advantage that you can also change settings automatically or based on rules. For example, you can automatically adjust the display brightness to the ambient brightness, switch off the display at night or when you are away (to save power) or change settings at the touch of a button.<\/p>\n\n\n\n

\n\n\n\n

General principles<\/h2>\n\n\n\n

In this article, I will mainly describe the various commands. These can be executed as usual for the ESPEasy framework. The various ways in which you can execute commands in the ESPEasy framework and send them to it are described in the article ESPEasy - Execute commands and actions via HTTP, MQTT, UDP and directly<\/a><\/em><\/strong> described.<\/p>\n\n\n\n

The commands described in the following paragraph can be used to configure the pxlBlck plug-in by command and change its appearance\/behavior during operation.<\/p>\n\n\n\n

The structure of the commands is usually similar. After the actual command name, the parameters are passed, each separated by a comma. The form looks something like this:<\/p>\n\n\n\n

commandname,parameter1,parameter2,\u2026,parameterX,<\/em><\/p><\/blockquote>\n\n\n\n

Attention: It is important that the last parameter also ends with a comma. Without this comma, the last parameter is ignored.<\/strong><\/p>\n\n\n\n

The following commands are written in such a way that you can get a quick overview of the command and its attached parameters. The parameters are separated from each other and summarized in square brackets. In addition, the permitted value range of the respective parameter is also given in the square brackets.<\/p>\n\n\n\n

Example:<\/strong><\/p>\n\n\n\n

Command Name,[Parameter1 0-1],[Parameter2 0-15],[ParameterX 0-255],<\/em><\/p><\/blockquote>\n\n\n\n

In this example, Parameter1 has a permitted value range of 0-1, Parameter2 a permitted value range of 0-15 and ParameterX a permitted value range of 0-255.<\/p>\n\n\n\n

It is also important to note that values outside this permitted value range result in this parameter being ignored.<\/strong><\/p>\n\n\n\n

If you want to configure ParameterX in the example above, but leave the rest unchanged, you can send the following command.<\/p>\n\n\n\n

commandname,2,16,133,<\/em><\/p><\/blockquote>\n\n\n\n

Durch diese Angabe werden die ersten beiden eingegebenen Werte ignoriert, weil sie au\u00dferhalb des erlaubten Wertebereichs liegen. Nur der letzte Wert „133“ wird \u00fcbernommen, weil er in dem erlaubten Wertebereich f\u00fcr „ParameterX“ liegt.<\/p>\n\n\n\n

\n\n\n\n

Command list<\/h2>\n\n\n\n

Command: General Settings<\/h3>\n\n\n\n

Um allgemeine Einstellungen vornehmen zu k\u00f6nnen, k\u00f6nnt Ihr den Befehl „pb“ nutzen. Dar\u00fcber l\u00e4sst sich das allgemeine Verhalten und die einfachen Optionen der Anzeige Eures pxlBlcks konfigurieren.<\/p>\n\n\n\n

Command name<\/strong><\/h4>\n\n\n\n

p.b<\/em><\/p><\/blockquote>\n\n\n\n

Command overview<\/strong><\/h4>\n\n\n\n

pb,[display_enabled 0-1],[brightness 0-15],[rc_mark_brightness 0-15],[matrix_rotation 0-3],[selected_dial 0-15],[wc_it_is_enabled 0-1],[wc_o_clock_enabled 0-1] ,[rc_dir_inversed 0-1],[wc_language_id 0-15],[minimal_brightness 0-255],<\/em><\/p>\n\n\n\n

Parameter description<\/strong><\/h4>\n\n\n\n
Parameter name<\/th>Description<\/th>Permitted value range<\/th><\/tr><\/thead>
display_enabled<\/em><\/td>Activates(1) or deactivates(0) the display output. This can be used, for example, to save power when nobody is present. See also pxlBlck - Turn off the display when you're away<\/s><\/strong><\/em><\/td>0-1<\/td><\/tr>
brightness<\/em><\/td>Brightness of the display in 16 steps from 0-15, whereby the display is not completely deactivated at the value 0. In this case, the (absolute) value specified in minimal_brightness is set as the brightness.<\/em><\/td>0-15<\/td><\/tr>
rc_mark_brightness<\/em><\/td>Brightness of the hour markers in ring clock mode in 16 steps from 0-15.<\/em>
matrix_rotation: display orientation of the displayed matrix from 0-3. Increasing this value causes a clockwise rotation of 90\u00b0.<\/em><\/td>		0-15<\/td><\/tr>
matrix_rotation<\/em><\/td>Display orientation of the displayed matrix from 0-3. Increasing this value causes a clockwise rotation of 90\u00b0.<\/em><\/td>0-3<\/td><\/tr>
selected_dial<\/em><\/td>Selected clock face. Here you can select which clock face is shown regularly on the display. This can be a simple animation or a time display.<\/em><\/td><\/td><\/tr>
wc_it_is_enabled<\/em><\/td>Aktiviert(1) oder deaktiviert(0) im Wordclock-Betrieb die Anzeige der Buchstaben „Es ist“.<\/em><\/td>0-1<\/td><\/tr>
wc_o_clock_enabled<\/em><\/td>Aktiviert(1) oder deaktiviert(0) im Wordclock-Betrieb die Anzeige der Buchstaben „Uhr“.<\/em><\/td>0-1<\/td><\/tr>
rc_dir_inversed<\/em><\/td>Inverts(1) or does not invert(0) the direction of movement of the hands in ringclock mode. This setting basically mirrors the ring clock dial on the vertical axis.<\/em><\/td>0-1<\/td><\/tr>
wc_language_id<\/em><\/td>Select the desired language in Wordclock mode. This allows you to display the time on the word clock in different languages.<\/em><\/td><\/td><\/tr>
minimal_brightness<\/em><\/td>The value specified with minimal_brightness is the value that is set as the brightness value when the normal display brightness is set to zero. The difference is that the minimum_brightness specification has a larger setting range. Here you can set the brightness not only in the range 0-15 but in the range 0-255. The big advantage of this is that much darker brightness levels can be set. You can also find more information on this in the article <\/em> pxlBlck - Automatic adjustment of the display brightness via LDR<\/a><\/em><\/strong><\/td>0-255<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

Example<\/h4>\n\n\n\n