/*
xdsp_15_tm1637.ino - Support for TM1637- and TM1638-based seven-segment displays for Tasmota
Copyright (C) 2021 Ajith Vasudevan
This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program. If not, see .
*/
#ifdef USE_DISPLAY
#ifdef USE_DISPLAY_TM1637
/*********************************************************************************************\
This driver enables the display of numbers (both integers and floats) and basic text
on the inexpensive TM1637-, TM1638- and MAX7219-based seven-segment modules.
Raw segments can also be displayed.
In addition, it is also possible to set brightness (8 levels), clear the display, scroll text,
display a rudimentary bar graph, and a Clock (12 hr and 24 hr).
To use, compile Tasmota with USE_DISPLAY and USE_DISPLAY_TM1637, or build the tasmota-display env.
For TM1637:
Connect the TM1637 display module's pins to any free GPIOs of the ESP8266 module
and assign the pins as follows from Tasmota's GUI:
DIO hardware pin --> "TM1637 DIO"
CLK hardware pin --> "TM1637 CLK"
For TM1638:
Connect the TM1638 display module's pins to any free GPIOs of the ESP8266 module
and assign the pins as follows from Tasmota's GUI:
DIO hardware pin --> "TM1638 DIO"
CLK hardware pin --> "TM1638 CLK"
STB hardware pin --> "TM1638 STB"
For MAX7219:
Connect the MAX7219 display module's pins to any free GPIOs of the ESP8266 module
and assign the pins as follows from Tasmota's GUI:
DIN hardware pin --> "MAX7219 DIN"
CS hardware pin --> "MAX7219 CS"
CLK hardware pin --> "MAX7219 CLK"
Once the GPIO configuration is saved and the ESP8266/ESP32 module restarts,
set the Display Model to 15 and Display Mode to 0
using the command "Backlog DisplayModel 15 ; DisplayMode 0"
If your display is a TM1637 with 6 digits, set Display Width to the number of digits your
display has, using the command "DisplayWidth 6".
After the ESP8266/ESP32 module restarts again, turn ON the display with the command "Power 1"
Now, the following "Display" commands can be used:
DisplayClear
Clears the display, command: "DisplayClear"
DisplayNumber num [,position {0-(Settings->display_width-1))} [,leading_zeros {0|1} [,length {1 to Settings->display_width}]]]
Clears and then displays number without decimal. command e.g., "DisplayNumber 1234"
Control 'leading zeros', 'length' and 'position' with "DisplayNumber 1234, , , "
'leading zeros' can be 1 or 0 (default), 'length' can be 1 to Settings->display_width, 'position' can be 0 (left-most) to Settings->display_width (right-most).
See function description below for more details.
DisplayNumberNC num [,position {0-(Settings->display_width-1))} [,leading_zeros {0|1} [,length {1 to Settings->display_width}]]]
Display integer number as above, but without clearing first. e.g., "DisplayNumberNC 1234". Usage is same as above.
DisplayFloat num [,position {0-(Settings->display_width-1)} [,precision {0-Settings->display_width} [,length {1 to Settings->display_width}]]]
Clears and then displays float (with decimal point) command e.g., "DisplayFloat 12.34"
See function description below for more details.
DisplayFloatNC num [,position {0-(Settings->display_width-1)} [,precision {0-Settings->display_width} [,length {1 to Settings->display_width}]]]
Displays float (with decimal point) as above, but without clearing first. command e.g., "DisplayFloatNC 12.34"
See function description below for more details.
DisplayRaw position {0-(Settings->display_width-1)},length {1 to Settings->display_width}, num1 [, num2[, num3[, num4[, ...upto Settings->display_width numbers]]]]]
Takes upto Settings->display_width comma-separated integers (0-255) and displays raw segments. Each number represents a
7-segment digit. Each 8-bit number represents individual segments of a digit.
For example, the command "DisplayRaw 0, 4, 255, 255, 255, 255" would display "[8.8.8.8.]"
DisplayText text [, position {0-(Settings->display_width-1)} [,length {1 to Settings->display_width}]]
Clears and then displays basic text. command e.g., "DisplayText ajith vasudevan"
Control 'length' and 'position' with "DisplayText , , "
'length' can be 1 to Settings->display_width, 'position' can be 0 (left-most) to Settings->display_width-1 (right-most)
A caret(^) symbol in the text input is dispayed as the degrees(°) symbol. This is useful for displaying Temperature!
For example, the command "DisplayText 22.5^" will display "22.5°".
DisplayTextNC text [, position {0-Settings->display_width-1} [,length {1 to Settings->display_width}]]
Clears first, then displays text. Usage is same as above.
DisplayScrollText text [, num_loops]
Displays scrolling text indefinitely, until another Display- command (other than DisplayScrollText
or DisplayScrollDelay is issued). Optionally, stop scrolling after num_loops iterations.
DisplayScrollDelay delay {0-15} // default = 4
Sets the speed of text scroll. Smaller delay = faster scrolling.
DisplayLevel num {0-100}
Display a horizontal bar graph (0-100) command e.g., "DisplayLevel 50" will display [|||| ]
DisplayClock 1|2|0
Displays a clock.
Commands "DisplayClock 1" // 12 hr format
"DisplayClock 2" // 24 hr format
"DisplayClock 0" // turn off clock
In addition, setting DisplayMode to 1 shows the time, setting it to 2 shows the date
and setting it to 3 alternates between time and date.
\*********************************************************************************************/
#define XDSP_15 15
#define CMD_MAX_LEN 55
#define LEVEL_MIN 0
#define LEVEL_MAX 100
#define SCROLL_MAX_LEN 50
#define POSITION_MIN 0
#define POSITION_MAX 8
#define LED_MIN 0
#define LED_MAX 255
#define MAX7219_ADDR 0
#include "SevenSegmentTM1637.h"
#include
#include
SevenSegmentTM1637 *tm1637display;
TM1638plus *tm1638display;
LedControl *max7219display;
enum display_types
{
TM1637,
TM1638,
MAX7219
};
struct
{
char scroll_text[CMD_MAX_LEN];
char msg[60];
char model_name[8];
uint8_t scroll_delay = 4;
uint8_t scroll_index = 0;
uint8_t iteration = 0;
uint8_t scroll_counter = 0;
uint8_t scroll_counter_max = 3;
uint8_t display_type = TM1637;
uint8_t digit_order[6] = { 0, 1, 2, 3, 4, 5 };
bool init_done = false;
bool scroll = false;
bool show_clock = false;
bool clock_24 = false;
} TM1637Data;
/*********************************************************************************************\
* Init function
\*********************************************************************************************/
void TM1637Init(void)
{
if (PinUsed(GPIO_TM1638CLK) && PinUsed(GPIO_TM1638DIO) && PinUsed(GPIO_TM1638STB))
{
TM1637Data.display_type = TM1638;
Settings->display_width = 8;
}
else if (PinUsed(GPIO_TM1637CLK) && PinUsed(GPIO_TM1637DIO))
{
TM1637Data.display_type = TM1637;
if ((!Settings->display_width || Settings->display_width > 6))
{
Settings->display_width = 4;
Settings->display_options.type = 0;
}
TM1637SetDigitOrder();
}
else if (PinUsed(GPIO_MAX7219DIN) && PinUsed(GPIO_MAX7219CLK) && PinUsed(GPIO_MAX7219CS))
{
TM1637Data.display_type = MAX7219;
Settings->display_width = 8;
}
else
{
return;
}
Settings->display_model = XDSP_15;
Settings->display_cols[0] = Settings->display_width;
Settings->display_height = 1;
Settings->display_rows = Settings->display_height;
uint8_t dimmer16 = GetDisplayDimmer16();
if(!dimmer16 || dimmer16 < 2 || dimmer16 > 15) SetDisplayDimmer(50);
if (TM1637 == TM1637Data.display_type)
{
strcpy_P(TM1637Data.model_name, PSTR("TM1637"));
tm1637display = new SevenSegmentTM1637(Pin(GPIO_TM1637CLK), Pin(GPIO_TM1637DIO));
tm1637display->begin(Settings->display_width, 1);
}
else if (TM1638 == TM1637Data.display_type)
{
strcpy_P(TM1637Data.model_name, PSTR("TM1638"));
tm1638display = new TM1638plus(Pin(GPIO_TM1638STB), Pin(GPIO_TM1638CLK), Pin(GPIO_TM1638DIO), true);
tm1638display->displayBegin();
}
else if (MAX7219 == TM1637Data.display_type)
{
strcpy_P(TM1637Data.model_name, PSTR("MAX7219"));
max7219display = new LedControl(Pin(GPIO_MAX7219DIN), Pin(GPIO_MAX7219CLK), Pin(GPIO_MAX7219CS), 1);
max7219display->shutdown(MAX7219_ADDR, false);
}
TM1637ClearDisplay();
TM1637Dim();
TM1637Data.init_done = true;
AddLog(LOG_LEVEL_INFO, PSTR("DSP: %s with %d digits (type %d)"), TM1637Data.model_name, Settings->display_width, Settings->display_options.type);
}
// Function to display specified ascii char at specified position for MAX7219
void displayMAX7219ASCII(uint8_t pos, char c)
{
pos = 7 - pos;
max7219display->setChar(MAX7219_ADDR, pos, c, false);
}
// Function to display specified ascii char with dot at specified position for MAX7219
void displayMAX7219ASCIIwDot(uint8_t pos, char c)
{
pos = 7 - pos;
max7219display->setChar(MAX7219_ADDR, pos, c, true);
}
// Function to display raw segments at specified position for MAX7219
void displayMAX72197Seg(uint8_t pos, uint8_t seg)
{
bool dec_bit = seg & 128;
seg = seg << 1;
seg = seg | dec_bit;
uint8_t NO_OF_BITS = 8;
uint8_t reverse_num = 0;
for (uint8_t i = 0; i < NO_OF_BITS; i++)
{
if ((seg & (1 << i)))
reverse_num |= 1 << ((NO_OF_BITS - 1) - i);
}
seg = reverse_num;
pos = 7 - pos;
max7219display->setRow(MAX7219_ADDR, pos, seg);
}
// Function to fix order of hardware digits for different TM1637 variants
void TM1637SetDigitOrder(void) {
if (0 == Settings->display_options.type) {
for (uint32_t i = 0; i < 6; i++) {
TM1637Data.digit_order[i] = i;
}
}
else if (1 == Settings->display_options.type) {
TM1637Data.digit_order[0] = 2;
TM1637Data.digit_order[1] = 1;
TM1637Data.digit_order[2] = 0;
TM1637Data.digit_order[3] = 5;
TM1637Data.digit_order[4] = 4;
TM1637Data.digit_order[5] = 3;
}
}
/*********************************************************************************************\
* Displays number without decimal, with/without leading zeros, specifying start-position
* and length, optionally skipping clearing display before displaying the number.
* commands: DisplayNumber num [,position {0-(Settings->display_width-1)} [,leading_zeros {0|1} [,length {1 to Settings->display_width}]]]
* DisplayNumberNC num [,position {0-(Settings->display_width-1)} [,leading_zeros {0|1} [,length {1 to Settings->display_width}]]] // "NC" --> "No Clear"
\*********************************************************************************************/
bool CmndTM1637Number(bool clear)
{
char sNum[CMD_MAX_LEN];
char sLeadingzeros[CMD_MAX_LEN];
char sPosition[CMD_MAX_LEN];
char sLength[CMD_MAX_LEN];
uint8_t length = 0;
bool leadingzeros = false;
uint8_t position = 0;
uint32_t num = 0;
switch (ArgC())
{
case 4:
subStr(sLength, XdrvMailbox.data, ",", 4);
length = atoi(sLength);
case 3:
subStr(sLeadingzeros, XdrvMailbox.data, ",", 3);
leadingzeros = atoi(sLeadingzeros);
case 2:
subStr(sPosition, XdrvMailbox.data, ",", 2);
position = atoi(sPosition);
case 1:
subStr(sNum, XdrvMailbox.data, ",", 1);
num = atof(sNum);
}
if ((position < 0) || (position > (Settings->display_width - 1)))
position = 0;
AddLog(LOG_LEVEL_DEBUG, PSTR("TM7: num %d, pos %d, lead %d, len %d"), num, position, leadingzeros, length);
if (clear)
TM1637ClearDisplay();
char txt[30];
snprintf_P(txt, sizeof(txt), PSTR("%d"), num);
if (!length)
length = strlen(txt);
if ((length < 0) || (length > Settings->display_width))
length = Settings->display_width;
char pad = (leadingzeros ? '0' : ' ');
uint32_t i = position;
uint8_t rawBytes[1];
for (; i < position + (length - strlen(txt)); i++)
{
if (i > Settings->display_width)
break;
if (TM1637 == TM1637Data.display_type)
{
rawBytes[0] = tm1637display->encode(pad);
tm1637display->printRaw(rawBytes, 1, TM1637Data.digit_order[i]);
}
else if (TM1638 == TM1637Data.display_type)
tm1638display->displayASCII(i, pad);
else if (MAX7219 == TM1637Data.display_type)
{
if (i > 7)
break;
displayMAX7219ASCII(i, pad);
}
}
for (uint32_t j = 0; i < position + length; i++, j++)
{
if (i > Settings->display_width)
break;
if (txt[j] == 0)
break;
if (TM1637 == TM1637Data.display_type)
{
rawBytes[0] = tm1637display->encode(txt[j]);
tm1637display->printRaw(rawBytes, 1, TM1637Data.digit_order[i]);
}
else if (TM1638 == TM1637Data.display_type)
tm1638display->displayASCII(i, txt[j]);
else if (MAX7219 == TM1637Data.display_type)
{
if (i > 7)
break;
if (txt[j] == 0)
break;
displayMAX7219ASCII(i, txt[j]);
}
}
return true;
}
/*********************************************************************************************\
* Displays number with decimal, specifying position, precision and length,
* optionally skipping clearing display before displaying the number.
* commands: DisplayFloat num [,position {0-(Settings->display_width-1)} [,precision {0-Settings->display_width} [,length {1 to Settings->display_width}]]]
* DisplayFloatNC num [,position {0-(Settings->display_width-1)} [,precision {0-Settings->display_width} [,length {1 to Settings->display_width}]]] // "NC" --> "No Clear"
\*********************************************************************************************/
bool CmndTM1637Float(bool clear)
{
char sNum[CMD_MAX_LEN];
char sPrecision[CMD_MAX_LEN];
char sPosition[CMD_MAX_LEN];
char sLength[CMD_MAX_LEN];
uint8_t length = 0;
uint8_t precision = Settings->display_width;
uint8_t position = 0;
float fnum = 0.0f;
switch (ArgC())
{
case 4:
subStr(sLength, XdrvMailbox.data, ",", 4);
length = atoi(sLength);
case 3:
subStr(sPrecision, XdrvMailbox.data, ",", 3);
precision = atoi(sPrecision);
case 2:
subStr(sPosition, XdrvMailbox.data, ",", 2);
position = atoi(sPosition);
case 1:
subStr(sNum, XdrvMailbox.data, ",", 1);
fnum = atof(sNum);
}
if ((position < 0) || (position > (Settings->display_width - 1)))
position = 0;
if ((precision < 0) || (precision > Settings->display_width))
precision = Settings->display_width;
if (clear)
TM1637ClearDisplay();
char txt[30];
ext_snprintf_P(txt, sizeof(txt), PSTR("%*_f"), precision, &fnum);
if (!length)
length = strlen(txt);
if ((length <= 0) || (length > Settings->display_width))
length = Settings->display_width;
AddLog(LOG_LEVEL_DEBUG, PSTR("TM7: num %4_f, prec %d, len %d"), &fnum, precision, length);
if (TM1637 == TM1637Data.display_type)
{
uint8_t rawBytes[1];
for (uint32_t i = 0, j = 0; i < length; i++, j++)
{
if (txt[i] == 0)
break;
rawBytes[0] = tm1637display->encode(txt[i]);
if (txt[i + 1] == '.')
{
rawBytes[0] = rawBytes[0] | 128;
i++;
length++;
}
if ((j + position) > Settings->display_width)
break;
tm1637display->printRaw(rawBytes, 1, TM1637Data.digit_order[j + position]);
}
}
else if (TM1638 == TM1637Data.display_type)
{
for (uint32_t i = 0, j = 0; i < length; i++, j++)
{
if ((j + position) > 7)
break;
if (txt[i] == 0)
break;
if (txt[i + 1] == '.')
{
tm1638display->displayASCIIwDot(j + position, txt[i]);
i++;
length++;
}
else
tm1638display->displayASCII(j + position, txt[i]);
}
}
else if (MAX7219 == TM1637Data.display_type)
{
for (uint32_t i = 0, j = 0; i < length; i++, j++)
{
if ((j + position) > 7)
break;
if (txt[i] == 0)
break;
if (txt[i + 1] == '.')
{
displayMAX7219ASCIIwDot(j + position, txt[i]);
i++;
length++;
}
else
displayMAX7219ASCII(j + position, txt[i]);
}
}
return true;
}
// /*********************************************************************************************\
// * Clears the display
// * Command: DisplayClear
// \*********************************************************************************************/
bool CmndTM1637Clear(void)
{
TM1637ClearDisplay();
sprintf(TM1637Data.msg, PSTR("Cleared"));
XdrvMailbox.data = TM1637Data.msg;
return true;
}
// /*********************************************************************************************\
// * Clears the display
// \*********************************************************************************************/
void TM1637ClearDisplay(void)
{
if (TM1637 == TM1637Data.display_type)
{
unsigned char arr[] = {0};
for (int i = 0; i < Settings->display_width; i++)
tm1637display->printRaw(arr, 1, i);
}
else if (TM1638 == TM1637Data.display_type)
{
for (int i = 0; i < Settings->display_width; i++)
tm1638display->display7Seg(i, 0);
}
else if (MAX7219 == TM1637Data.display_type)
{
max7219display->clearDisplay(MAX7219_ADDR);
}
}
/*********************************************************************************************\
* Display scrolling text
* Command: DisplayTM1637Data.scroll_text text
\*********************************************************************************************/
bool CmndTM1637ScrollText(void)
{
char sString[SCROLL_MAX_LEN + 1];
char sMaxLoopCount[CMD_MAX_LEN];
uint8_t maxLoopCount = 0;
switch (ArgC())
{
case 2:
subStr(sMaxLoopCount, XdrvMailbox.data, ",", 2);
maxLoopCount = atoi(sMaxLoopCount);
case 1:
subStr(sString, XdrvMailbox.data, ",", 1);
}
if (maxLoopCount < 0)
maxLoopCount = 0;
AddLog(LOG_LEVEL_DEBUG, PSTR("TM7: sString %s, maxLoopCount %d"), sString, maxLoopCount);
TM1637Data.scroll_counter_max = maxLoopCount;
if (strlen(sString) > SCROLL_MAX_LEN)
{
snprintf(TM1637Data.msg, sizeof(TM1637Data.msg), PSTR("Text too long. Length should be less than %d"), SCROLL_MAX_LEN);
XdrvMailbox.data = TM1637Data.msg;
return false;
}
else
{
snprintf(TM1637Data.scroll_text, sizeof(TM1637Data.scroll_text), PSTR(" "));
snprintf(TM1637Data.scroll_text, Settings->display_width + sizeof(TM1637Data.scroll_text), PSTR(" %s"), &sString);
TM1637Data.scroll_text[strlen(sString) + Settings->display_width] = 0;
TM1637Data.scroll_index = 0;
TM1637Data.scroll = true;
TM1637Data.scroll_counter = 0;
return true;
}
}
/*********************************************************************************************\
* Sets the scroll delay for scrolling text.
* Command: DisplayTM1637Data.scroll_delay delay {0-15} // default = 4
\*********************************************************************************************/
bool CmndTM1637ScrollDelay(void)
{
if (ArgC() == 0)
{
XdrvMailbox.payload = TM1637Data.scroll_delay;
return true;
}
if (TM1637Data.scroll_delay < 0)
TM1637Data.scroll_delay = 0;
TM1637Data.scroll_delay = XdrvMailbox.payload;
return true;
}
/*********************************************************************************************\
* Scrolls a given string. Called every 50ms
\*********************************************************************************************/
void TM1637ScrollText(void)
{
if(!TM1637Data.scroll) return;
TM1637Data.iteration++;
if (TM1637Data.scroll_delay)
TM1637Data.iteration = TM1637Data.iteration % TM1637Data.scroll_delay;
else
TM1637Data.iteration = 0;
if (TM1637Data.iteration)
return;
if (TM1637Data.scroll_index > strlen(TM1637Data.scroll_text))
{
TM1637Data.scroll_index = 0;
TM1637Data.scroll_counter++;
if(TM1637Data.scroll_counter_max != 0 && (TM1637Data.scroll_counter >= TM1637Data.scroll_counter_max)) {
TM1637Data.scroll = false;
return;
}
}
uint8_t rawBytes[1];
for (uint32_t i = 0, j = TM1637Data.scroll_index; i < 1 + strlen(TM1637Data.scroll_text); i++, j++)
{
if (i > (Settings->display_width - 1))
{
break;
}
rawBytes[0] = tm1637display->encode(TM1637Data.scroll_text[j]);
bool dotSkipped = false;
if (TM1637Data.scroll_text[j + 1] == '.')
{
dotSkipped = true;
rawBytes[0] = rawBytes[0] | 128;
j++;
}
else if (TM1637Data.scroll_text[j] == '^')
{
rawBytes[0] = 1 | 2 | 32 | 64;
}
if (!dotSkipped && TM1637Data.scroll_text[j] == '.')
{
j++;
TM1637Data.scroll_index++;
rawBytes[0] = tm1637display->encode(TM1637Data.scroll_text[j]);
}
if (TM1637Data.scroll_text[j + 1] == '.')
{
rawBytes[0] = rawBytes[0] | 128;
}
if (TM1637 == TM1637Data.display_type)
{
tm1637display->printRaw(rawBytes, 1, TM1637Data.digit_order[i]);
}
else if (TM1638 == TM1637Data.display_type)
{
tm1638display->display7Seg(i, rawBytes[0]);
}
else if (MAX7219 == TM1637Data.display_type)
{
displayMAX72197Seg(i, rawBytes[0]);
}
}
TM1637Data.scroll_index++;
}
/*********************************************************************************************\
* Displays a horizontal bar graph. Takes a percentage number (0-100) as input
* Command: DisplayLevel level {0-100}
\*********************************************************************************************/
bool CmndTM1637Level(void)
{
uint16_t val = XdrvMailbox.payload;
if ((val < LEVEL_MIN) || (val > LEVEL_MAX))
{
Response_P(PSTR("{\"Error\":\"Level should be a number in the range [%d, %d]\"}"), LEVEL_MIN, LEVEL_MAX);
return false;
}
uint8_t totalBars = 2 * Settings->display_width;
AddLog(LOG_LEVEL_DEBUG, PSTR("TM7: TM1637Data.model_name %s CmndTM1637Level totalBars=%d"), TM1637Data.model_name, totalBars);
float barsToDisplay = totalBars * val / 100.0f;
char txt[5];
ext_snprintf_P(txt, sizeof(txt), PSTR("%*_f"), 1, &barsToDisplay);
AddLog(LOG_LEVEL_DEBUG, PSTR("TM7: TM1637Data.model_name %s CmndTM1637Level barsToDisplay=%s"), TM1637Data.model_name, txt);
char s[4];
ext_snprintf_P(s, sizeof(s), PSTR("%0_f"), &barsToDisplay);
uint8_t numBars = atoi(s);
AddLog(LOG_LEVEL_DEBUG, PSTR("TM7: CmndTM1637Level numBars %d"), numBars);
TM1637ClearDisplay();
uint8_t rawBytes[1];
for (int i = 1; i <= numBars; i++)
{
uint8_t digit = (i - 1) / 2;
uint8_t value = (((i % 2) == 0) ? 54 : 48);
if (TM1637 == TM1637Data.display_type)
{
rawBytes[0] = value;
tm1637display->printRaw(rawBytes, 1, TM1637Data.digit_order[digit]);
}
else if (TM1638 == TM1637Data.display_type)
{
tm1638display->display7Seg(digit, value);
}
else if (MAX7219 == TM1637Data.display_type)
{
displayMAX72197Seg(digit, value);
}
}
return true;
}
/*********************************************************************************************\
* Display arbitrary data on the display module
* Command: DisplayRaw position {0-(Settings->display_width-1)},length {1 to Settings->display_width}, a [, b[, c[, d[...upto Settings->display_width]]]]
* where a,b,c,d... are upto Settings->display_width numbers in the range 0-255, each number (byte)
* corresponding to a single 7-segment digit. Within each byte, bit 0 is segment A,
* bit 1 is segment B etc. The function may either set the entire display
* or any desired part using the length and position parameters.
\*********************************************************************************************/
bool CmndTM1637Raw(void)
{
uint8_t DATA[6] = {0, 0, 0, 0, 0, 0};
char as[CMD_MAX_LEN];
char bs[CMD_MAX_LEN];
char cs[CMD_MAX_LEN];
char ds[CMD_MAX_LEN];
char es[CMD_MAX_LEN];
char fs[CMD_MAX_LEN];
char sLength[CMD_MAX_LEN];
char sPos[CMD_MAX_LEN];
uint32_t position = 0;
uint32_t length = 0;
switch (ArgC())
{
case 8:
subStr(fs, XdrvMailbox.data, ",", 8);
DATA[5] = atoi(fs);
case 7:
subStr(es, XdrvMailbox.data, ",", 7);
DATA[4] = atoi(es);
case 6:
subStr(ds, XdrvMailbox.data, ",", 6);
DATA[3] = atoi(ds);
case 5:
subStr(cs, XdrvMailbox.data, ",", 5);
DATA[2] = atoi(cs);
case 4:
subStr(bs, XdrvMailbox.data, ",", 4);
DATA[1] = atoi(bs);
case 3:
subStr(as, XdrvMailbox.data, ",", 3);
DATA[0] = atoi(as);
case 2:
subStr(sLength, XdrvMailbox.data, ",", 2);
length = atoi(sLength);
case 1:
subStr(sPos, XdrvMailbox.data, ",", 1);
position = atoi(sPos);
}
if (!length)
length = ArgC() - 2;
if (length < 0 || length > Settings->display_width)
length = Settings->display_width;
if (position < 0 || position > (Settings->display_width - 1))
position = 0;
AddLog(LOG_LEVEL_DEBUG, PSTR("TM7: a %d, b %d, c %d, d %d, e %d, f %d, len %d, pos %d"),
DATA[0], DATA[1], DATA[2], DATA[3], DATA[4], DATA[5], length, position);
if (TM1637 == TM1637Data.display_type)
{
uint8_t rawBytes[1];
for (uint32_t i = position; i < position + length; i++)
{
if (i > (Settings->display_width - 1))
break;
rawBytes[0] = DATA[i - position];
tm1637display->printRaw(rawBytes, 1, TM1637Data.digit_order[i]);
}
}
else if (TM1638 == TM1637Data.display_type)
{
for (uint32_t i = position; i < position + length; i++)
{
if (i > 7)
break;
tm1638display->display7Seg(i, DATA[i - position]);
}
}
else if (MAX7219 == TM1637Data.display_type)
{
for (uint32_t i = position; i < position + length; i++)
{
if (i > 7)
break;
displayMAX72197Seg(i, DATA[i - position]);
}
}
return true;
}
/*********************************************************************************************\
* Display a given string.
* Text can be placed at arbitrary location on the display using the length and
* position parameters without affecting the rest of the display.
* Command: DisplayText text [, position {0-(Settings->display_width-1)} [,length {1 to Settings->display_width}]]
\*********************************************************************************************/
bool CmndTM1637Text(bool clear)
{
char sString[CMD_MAX_LEN + 1];
char sPosition[CMD_MAX_LEN];
char sLength[CMD_MAX_LEN];
uint8_t length = 0;
uint8_t position = 0;
switch (ArgC())
{
case 3:
subStr(sLength, XdrvMailbox.data, ",", 3);
length = atoi(sLength);
case 2:
subStr(sPosition, XdrvMailbox.data, ",", 2);
position = atoi(sPosition);
case 1:
subStr(sString, XdrvMailbox.data, ",", 1);
}
if ((position < 0) || (position > (Settings->display_width - 1)))
position = 0;
AddLog(LOG_LEVEL_DEBUG, PSTR("TM7: sString %s, pos %d, len %d"), sString, position, length);
if (clear)
TM1637ClearDisplay();
if (!length)
length = strlen(sString);
if ((length < 0) || (length > Settings->display_width))
length = Settings->display_width;
uint32_t i = position;
if (TM1637 == TM1637Data.display_type)
{
uint8_t rawBytes[1];
for (uint32_t j = 0; i < position + length; i++, j++)
{
if (i > (Settings->display_width - 1))
break;
if (sString[j] == 0)
break;
rawBytes[0] = tm1637display->encode(sString[j]);
bool dotSkipped = false;
if (sString[j + 1] == '.')
{
dotSkipped = true;
rawBytes[0] = rawBytes[0] | 128;
j++;
}
else if (sString[j] == '^')
{
rawBytes[0] = 1 | 2 | 32 | 64;
}
if (!dotSkipped && sString[j] == '.')
rawBytes[0] = 128;
tm1637display->printRaw(rawBytes, 1, TM1637Data.digit_order[i]);
}
}
else if (TM1638 == TM1637Data.display_type)
{
for (uint32_t j = 0; i < position + length; i++, j++)
{
if (i > 7)
break;
if (sString[j] == 0)
break;
if (sString[j + 1] == '.')
{
tm1638display->displayASCIIwDot(i, sString[j]);
j++;
}
else if (sString[j] == '^')
{
tm1638display->display7Seg(i, (1 | 2 | 32 | 64));
}
else
tm1638display->displayASCII(i, sString[j]);
}
}
else if (MAX7219 == TM1637Data.display_type)
{
uint8_t rawBytes[1];
for (uint32_t j = 0; i < position + length; i++, j++)
{
if (i > 7)
break;
if (sString[j] == 0)
break;
rawBytes[0] = tm1637display->encode(sString[j]);
bool dotSkipped = false;
if (sString[j + 1] == '.')
{
dotSkipped = true;
rawBytes[0] = rawBytes[0] | 128;
j++;
}
else if (sString[j] == '^')
{
rawBytes[0] = 1 | 2 | 32 | 64;
}
if (!dotSkipped && sString[j] == '.')
rawBytes[0] = 128;
displayMAX72197Seg(i, rawBytes[0]);
}
}
return true;
}
/*********************************************************************************************\
* Displays a clock.
* Command: DisplayClock 1 // 12-hour format
* DisplayClock 2 // 24-hour format
* DisplayClock 0 // turn off clock and clear
\*********************************************************************************************/
bool CmndTM1637Clock(void)
{
TM1637Data.show_clock = XdrvMailbox.payload;
if (ArgC() == 0)
XdrvMailbox.payload = 1;
if (XdrvMailbox.payload > 1) {
TM1637Data.clock_24 = true;
XdrvMailbox.payload = 2;
} else {
TM1637Data.clock_24 = false;
XdrvMailbox.payload = 1;
}
AddLog(LOG_LEVEL_DEBUG, PSTR("TM7: TM1637Data.show_clock %d, TM1637Data.clock_24 %d"), TM1637Data.show_clock, TM1637Data.clock_24);
TM1637ClearDisplay();
return true;
}
/*********************************************************************************************\
* refreshes the time if clock is displayed
\*********************************************************************************************/
void TM1637ShowTime()
{
uint8_t hr = RtcTime.hour;
uint8_t mn = RtcTime.minute;
uint8_t sc = RtcTime.second;
// uint8_t hr = 1;
// uint8_t mn = 0;
char z = ' ';
if (TM1637Data.clock_24)
{
z = '0';
}
else
{
if (hr > 12)
hr -= 12;
if (hr == 0)
hr = 12;
}
char tm[9];
snprintf_P(tm, sizeof(tm), PSTR("%c%d%02d%02d"), z, hr, mn, sc);
if (TM1637 == TM1637Data.display_type)
{
uint8_t rawBytes[1];
for (uint32_t i = 0; i < 4; i++)
{
rawBytes[0] = tm1637display->encode(tm[i]);
if ((millis() % 1000) > 500 && (i == 1))
rawBytes[0] = rawBytes[0] | 128;
tm1637display->printRaw(rawBytes, 1, TM1637Data.digit_order[i]);
}
}
else if (TM1638 == TM1637Data.display_type)
{
for (uint32_t i = 0; i < 4; i++)
{
if ((millis() % 1000) > 500 && (i == 1))
tm1638display->displayASCIIwDot(i, tm[i]);
else
tm1638display->displayASCII(i, tm[i]);
}
}
else if (MAX7219 == TM1637Data.display_type)
{
for (uint32_t i = 0; i < 6; i++)
{
//if ((millis() % 1000) > 500 && (i == 3))
if ((i == 1) || (i == 3))
displayMAX7219ASCIIwDot(i, tm[i]);
else
displayMAX7219ASCII(i, tm[i]);
}
}
}
/*********************************************************************************************\
* This function is called for all Display functions.
\*********************************************************************************************/
bool TM1637MainFunc(uint8_t fn)
{
bool result = false;
if(fn != FUNC_DISPLAY_SCROLLDELAY) TM1637Data.scroll = false;
if (XdrvMailbox.data_len > CMD_MAX_LEN)
{
Response_P(PSTR("{\"Error\":\"Command text too long. Please limit it to %d characters\"}"), CMD_MAX_LEN);
return false;
}
switch (fn)
{
case FUNC_DISPLAY_CLEAR:
result = CmndTM1637Clear();
break;
case FUNC_DISPLAY_NUMBER:
result = CmndTM1637Number(true);
break;
case FUNC_DISPLAY_NUMBERNC:
result = CmndTM1637Number(false);
break;
case FUNC_DISPLAY_FLOAT:
result = CmndTM1637Float(true);
break;
case FUNC_DISPLAY_FLOATNC:
result = CmndTM1637Float(false);
break;
case FUNC_DISPLAY_RAW:
result = CmndTM1637Raw();
break;
case FUNC_DISPLAY_SEVENSEG_TEXT:
result = CmndTM1637Text(true);
break;
case FUNC_DISPLAY_SEVENSEG_TEXTNC:
result = CmndTM1637Text(false);
break;
case FUNC_DISPLAY_LEVEL:
result = CmndTM1637Level();
break;
case FUNC_DISPLAY_SCROLLTEXT:
result = CmndTM1637ScrollText();
break;
case FUNC_DISPLAY_SCROLLDELAY:
result = CmndTM1637ScrollDelay();
break;
case FUNC_DISPLAY_CLOCK:
result = CmndTM1637Clock();
break;
}
return result;
}
void TM1637Dim(void)
{
// GetDisplayDimmer16() = 0 - 15
uint8_t brightness = GetDisplayDimmer16() >> 1; // 0 - 7
if (TM1637 == TM1637Data.display_type)
{
tm1637display->setBacklight(brightness * 12); // 0 - 84
}
else if (TM1638 == TM1637Data.display_type)
{
tm1638display->brightness(brightness); // 0 - 7
}
else if (MAX7219 == TM1637Data.display_type)
{
max7219display->setIntensity(MAX7219_ADDR, brightness); // 0 - 7
}
}
/*********************************************************************************************/
#ifdef USE_DISPLAY_MODES1TO5
void TM1637Print(char *txt)
{
for (uint32_t i = 0; i < Settings->display_cols[0]; i++)
{
if (TM1637 == TM1637Data.display_type)
{
uint8_t rawBytes[1];
rawBytes[0] = tm1637display->encode(txt[i]);
// if ((millis() % 1000) > 500 && (i == 1)) { rawBytes[0] = rawBytes[0] | 128; }
tm1637display->printRaw(rawBytes, 1, TM1637Data.digit_order[i]);
}
else if (TM1638 == TM1637Data.display_type)
{
// if ((millis() % 1000) > 500 && (i == 1)) { tm1638display->displayASCIIwDot(i, txt[i]); }
tm1638display->displayASCII(i, txt[i]);
}
else if (MAX7219 == TM1637Data.display_type)
{
// if ((millis() % 1000) > 500 && (i == 1)) { tm1638display->displayASCIIwDot(i, txt[i]); }
displayMAX7219ASCII(i, txt[i]);
}
}
}
void TM1637Center(char *txt)
{
char line[Settings->display_cols[0] + 2];
int len = strlen(txt);
int offset = 0;
if (len >= Settings->display_cols[0])
{
len = Settings->display_cols[0];
}
else
{
offset = (Settings->display_cols[0] - len) / 2;
}
memset(line, 0x20, Settings->display_cols[0]);
line[Settings->display_cols[0]] = 0;
for (uint32_t i = 0; i < len; i++)
{
line[offset + i] = txt[i];
}
TM1637Print(line);
}
/*
bool TM1637PrintLog(void) {
bool result = false;
disp_refresh--;
if (!disp_refresh) {
disp_refresh = Settings->display_refresh;
if (!disp_screen_buffer_cols) { DisplayAllocScreenBuffer(); }
char* txt = DisplayLogBuffer('\337');
if (txt != nullptr) {
uint8_t last_row = Settings->display_rows -1;
strlcpy(disp_screen_buffer[last_row], txt, disp_screen_buffer_cols);
DisplayFillScreen(last_row);
AddLog(LOG_LEVEL_DEBUG, PSTR(D_LOG_DEBUG "[%s]"), disp_screen_buffer[last_row]);
TM1637Print(disp_screen_buffer[last_row]);
result = true;
}
}
return result;
}
*/
void TM1637Time(void)
{
char line[Settings->display_cols[0] + 1];
if (Settings->display_cols[0] >= 8)
{
snprintf_P(line, sizeof(line), PSTR("%02d %02d %02d"), RtcTime.hour, RtcTime.minute, RtcTime.second);
}
else if (Settings->display_cols[0] >= 6)
{
snprintf_P(line, sizeof(line), PSTR("%02d%02d%02d"), RtcTime.hour, RtcTime.minute, RtcTime.second);
}
else
{
snprintf_P(line, sizeof(line), PSTR("%02d%02d"), RtcTime.hour, RtcTime.minute);
}
TM1637Center(line);
}
void TM1637Date(void)
{
char line[Settings->display_cols[0] + 1];
if (Settings->display_cols[0] >= 8)
{
snprintf_P(line, sizeof(line), PSTR("%02d-%02d-%02d"), RtcTime.day_of_month, RtcTime.month, RtcTime.year - 2000);
}
else if (Settings->display_cols[0] >= 6)
{
snprintf_P(line, sizeof(line), PSTR("%02d%02d%02d"), RtcTime.day_of_month, RtcTime.month, RtcTime.year - 2000);
}
else
{
snprintf_P(line, sizeof(line), PSTR("%02d%02d"), RtcTime.day_of_month, RtcTime.month);
}
TM1637Center(line);
}
void TM1637Refresh(void)
{ // Every second
if (!disp_power || !Settings->display_mode)
{
return;
} // Mode 0 is User text
switch (Settings->display_mode)
{
case 1: // Time
TM1637Time();
break;
case 2: // Date
TM1637Date();
break;
case 3: // Time
if (TasmotaGlobal.uptime % Settings->display_refresh)
{
TM1637Time();
}
else
{
TM1637Date();
}
break;
/*
case 4: // Mqtt
TM1637PrintLog();
break;
case 5: { // Mqtt
if (!TM1637PrintLog()) { TM1637Time(); }
break;
}
*/
}
}
#endif // USE_DISPLAY_MODES1TO5
/*********************************************************************************************\
* Interface
\*********************************************************************************************/
bool Xdsp15(uint8_t function)
{
bool result = false;
if (FUNC_DISPLAY_INIT_DRIVER == function)
{
TM1637Init();
}
else if (TM1637Data.init_done && (XDSP_15 == Settings->display_model))
{
switch (function)
{
case FUNC_DISPLAY_EVERY_50_MSECOND:
if (disp_power && !Settings->display_mode)
{
if (TM1637Data.scroll)
{
TM1637ScrollText();
}
if (TM1637Data.show_clock)
{
TM1637ShowTime();
}
}
break;
#ifdef USE_DISPLAY_MODES1TO5
case FUNC_DISPLAY_EVERY_SECOND:
TM1637Refresh();
break;
#endif // USE_DISPLAY_MODES1TO5
case FUNC_DISPLAY_MODEL:
result = true;
break;
case FUNC_DISPLAY_SEVENSEG_TEXT:
case FUNC_DISPLAY_CLEAR:
case FUNC_DISPLAY_NUMBER:
case FUNC_DISPLAY_FLOAT:
case FUNC_DISPLAY_NUMBERNC:
case FUNC_DISPLAY_FLOATNC:
case FUNC_DISPLAY_RAW:
case FUNC_DISPLAY_LEVEL:
case FUNC_DISPLAY_SEVENSEG_TEXTNC:
case FUNC_DISPLAY_SCROLLTEXT:
case FUNC_DISPLAY_SCROLLDELAY:
case FUNC_DISPLAY_CLOCK:
if (disp_power && !Settings->display_mode)
{
TM1637Data.show_clock = false;
result = TM1637MainFunc(function);
}
break;
case FUNC_DISPLAY_DIM:
TM1637Dim();
break;
case FUNC_DISPLAY_POWER:
if (!disp_power)
{
TM1637ClearDisplay();
}
break;
}
}
return result;
}
#endif // USE_DISPLAY_TM1637
#endif // USE_DISPLAY