mirror of https://github.com/arendst/Tasmota.git
863 lines
30 KiB
C++
863 lines
30 KiB
C++
/*
|
|
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 <http://www.gnu.org/licenses/>.
|
|
*/
|
|
|
|
#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- and TM1638-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"
|
|
|
|
|
|
Once the GPIO configuration is saved and the ESP8266/ESP32 module restarts, set the Display Model to 15
|
|
using the command "DisplayModel 15"
|
|
|
|
If your display is a TM1637 with 6 digits, set Display Columns to the number of digits your
|
|
display has, using the command "DisplayCols 6" and restart the ESP module.
|
|
|
|
After the ESP8266/ESP32 module restarts again, the following "Display" commands can be used:
|
|
|
|
|
|
DisplayClear
|
|
|
|
Clears the display, command: "DisplayClear"
|
|
|
|
|
|
DisplayNumber num [,position {0-(TM1637Data.num_digits-1))} [,leading_zeros {0|1} [,length {1 to TM1637Data.num_digits}]]]
|
|
|
|
Clears and then displays number without decimal. command e.g., "DisplayNumber 1234"
|
|
Control 'leading zeros', 'length' and 'position' with "DisplayNumber 1234, <position>, <leadingZeros>, <length>"
|
|
'leading zeros' can be 1 or 0 (default), 'length' can be 1 to TM1637Data.num_digits, 'position' can be 0 (left-most) to TM1637Data.num_digits (right-most).
|
|
See function description below for more details.
|
|
|
|
DisplayNumberNC num [,position {0-(TM1637Data.num_digits-1))} [,leading_zeros {0|1} [,length {1 to TM1637Data.num_digits}]]]
|
|
|
|
Display integer number as above, but without clearing first. e.g., "DisplayNumberNC 1234". Usage is same as above.
|
|
|
|
|
|
|
|
DisplayFloat num [,position {0-(TM1637Data.num_digits-1)} [,precision {0-TM1637Data.num_digits} [,length {1 to TM1637Data.num_digits}]]]
|
|
|
|
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-(TM1637Data.num_digits-1)} [,precision {0-TM1637Data.num_digits} [,length {1 to TM1637Data.num_digits}]]]
|
|
|
|
Displays float (with decimal point) as above, but without clearing first. command e.g., "DisplayFloatNC 12.34"
|
|
See function description below for more details.
|
|
|
|
|
|
|
|
DisplayBrightness num {1-8}
|
|
|
|
Set brightness (1 to 8) command e.g., "DisplayBrightness 2"
|
|
|
|
|
|
|
|
DisplayRaw position {0-(TM1637Data.num_digits-1)},length {1 to TM1637Data.num_digits}, num1 [, num2[, num3[, num4[, ...upto TM1637Data.num_digits numbers]]]]]
|
|
|
|
Takes upto TM1637Data.num_digits 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-(TM1637Data.num_digits-1)} [,length {1 to TM1637Data.num_digits}]]
|
|
|
|
Clears and then displays basic text. command e.g., "DisplayText ajith vasudevan"
|
|
Control 'length' and 'position' with "DisplayText <text>, <position>, <length>"
|
|
'length' can be 1 to TM1637Data.num_digits, 'position' can be 0 (left-most) to TM1637Data.num_digits-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-TM1637Data.num_digits-1} [,length {1 to TM1637Data.num_digits}]]
|
|
|
|
Clears first, then displays text. Usage is same as above.
|
|
|
|
|
|
|
|
DisplayScrollText text
|
|
|
|
Displays scrolling text.
|
|
|
|
|
|
|
|
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
|
|
|
|
|
|
|
|
|
|
\*********************************************************************************************/
|
|
|
|
#define XDSP_15 15
|
|
|
|
#define BRIGHTNESS_MIN 1
|
|
#define BRIGHTNESS_MAX 8
|
|
#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
|
|
|
|
#include "SevenSegmentTM1637.h"
|
|
#include <TM1638plus.h>
|
|
|
|
SevenSegmentTM1637 *tm1637display;
|
|
TM1638plus *tm1638display;
|
|
|
|
enum display_types { TM1637, TM1638 };
|
|
|
|
struct {
|
|
char scroll_text[CMD_MAX_LEN];
|
|
char msg[60];
|
|
char model_name[8];
|
|
uint8_t num_digits = 4;
|
|
uint8_t scroll_delay = 4;
|
|
uint8_t scroll_index = 0;
|
|
uint8_t iteration = 0;
|
|
uint8_t brightness = 5;
|
|
uint8_t buttons;
|
|
uint8_t display_type = TM1637;
|
|
uint8_t prev_buttons;
|
|
|
|
bool init_done = false;
|
|
bool scroll = false;
|
|
bool show_clock = false;
|
|
bool clock_24 = false;
|
|
bool LED[8] = {false, false, false, false, false, false, false, false};
|
|
} TM1637Data;
|
|
|
|
/*********************************************************************************************\
|
|
* Init function
|
|
\*********************************************************************************************/
|
|
|
|
void TM1637Init(void) {
|
|
if (PinUsed(GPIO_TM1638CLK) && PinUsed(GPIO_TM1638DIO) && PinUsed(GPIO_TM1638STB)) {
|
|
TM1637Data.display_type = TM1638;
|
|
TM1637Data.num_digits = 8;
|
|
}
|
|
else if (PinUsed(GPIO_TM1637CLK) && PinUsed(GPIO_TM1637DIO)) {
|
|
TM1637Data.display_type = TM1637;
|
|
if (Settings.display_cols[0] <= 6) {
|
|
TM1637Data.num_digits = Settings.display_cols[0];
|
|
} else {
|
|
TM1637Data.num_digits = 4;
|
|
}
|
|
}
|
|
else {
|
|
return;
|
|
}
|
|
|
|
Settings.display_model = XDSP_15;
|
|
|
|
if (TM1637 == TM1637Data.display_type) {
|
|
strcpy_P(TM1637Data.model_name, PSTR("TM1637"));
|
|
tm1637display = new SevenSegmentTM1637(Pin(GPIO_TM1637CLK), Pin(GPIO_TM1637DIO));
|
|
tm1637display->begin(TM1637Data.num_digits, 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 );
|
|
TM1637Data.num_digits = 8;
|
|
tm1638display->displayBegin();
|
|
}
|
|
TM1637ClearDisplay();
|
|
TM1637Data.brightness = (Settings.display_dimmer ? Settings.display_dimmer : TM1637Data.brightness);
|
|
TM1637SetBrightness(TM1637Data.brightness);
|
|
TM1637Data.init_done = true;
|
|
AddLog(LOG_LEVEL_INFO, PSTR("DSP: %s with %d digits"), TM1637Data.model_name, TM1637Data.num_digits);
|
|
}
|
|
|
|
/*********************************************************************************************\
|
|
* 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-(TM1637Data.num_digits-1)} [,leading_zeros {0|1} [,length {1 to TM1637Data.num_digits}]]]
|
|
* DisplayNumberNC num [,position {0-(TM1637Data.num_digits-1)} [,leading_zeros {0|1} [,length {1 to TM1637Data.num_digits}]]] // "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 > (TM1637Data.num_digits-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 > TM1637Data.num_digits)) length = TM1637Data.num_digits;
|
|
|
|
char pad = (leadingzeros ? '0': ' ');
|
|
uint32_t i = position;
|
|
uint8_t rawBytes[1];
|
|
|
|
for(; i<position + (length - strlen(txt)); i++) {
|
|
if(i>TM1637Data.num_digits) break;
|
|
if(TM1637Data.display_type == TM1637) { rawBytes[0] = tm1637display->encode(pad); tm1637display->printRaw(rawBytes, 1, i); }
|
|
else if(TM1637Data.display_type == TM1638) tm1638display->displayASCII(i, pad);
|
|
}
|
|
|
|
for(uint32_t j = 0; i< position + length; i++, j++) {
|
|
if(i>TM1637Data.num_digits) break;
|
|
if(txt[j] == 0) break;
|
|
if(TM1637Data.display_type == TM1637) { rawBytes[0] = tm1637display->encode(txt[j]); tm1637display->printRaw(rawBytes, 1, i); }
|
|
else if(TM1637Data.display_type == TM1638) tm1638display->displayASCII(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-(TM1637Data.num_digits-1)} [,precision {0-TM1637Data.num_digits} [,length {1 to TM1637Data.num_digits}]]]
|
|
* DisplayFloatNC num [,position {0-(TM1637Data.num_digits-1)} [,precision {0-TM1637Data.num_digits} [,length {1 to TM1637Data.num_digits}]]] // "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 = TM1637Data.num_digits;
|
|
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 > (TM1637Data.num_digits-1))) position = 0;
|
|
if((precision < 0) || (precision > TM1637Data.num_digits)) precision = TM1637Data.num_digits;
|
|
|
|
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 > TM1637Data.num_digits)) length = TM1637Data.num_digits;
|
|
|
|
AddLog(LOG_LEVEL_DEBUG, PSTR("TM7: num %4_f, prec %d, len %d"), &fnum, precision, length);
|
|
|
|
if(TM1637Data.display_type == TM1637) {
|
|
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) > TM1637Data.num_digits) break;
|
|
tm1637display->printRaw(rawBytes, 1, j+position);
|
|
}
|
|
} else if(TM1637Data.display_type == TM1638) {
|
|
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]);
|
|
}
|
|
}
|
|
|
|
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(TM1637Data.display_type == TM1637) {
|
|
unsigned char arr[] = {0};
|
|
for(int i=0; i<TM1637Data.num_digits; i++) tm1637display->printRaw(arr, 1, i);
|
|
} else if(TM1637Data.display_type == TM1638) {
|
|
for(int i=0; i<TM1637Data.num_digits; i++) tm1638display->display7Seg(i, 0);
|
|
}
|
|
}
|
|
|
|
|
|
/*********************************************************************************************\
|
|
* Display scrolling text
|
|
* Command: DisplayTM1637Data.scroll_text text
|
|
\*********************************************************************************************/
|
|
bool CmndTM1637ScrollText(void) {
|
|
|
|
AddLog(LOG_LEVEL_DEBUG, PSTR("TM7: Text %s"), XdrvMailbox.data);
|
|
|
|
if(XdrvMailbox.data_len > 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, sizeof(TM1637Data.scroll_text), PSTR("%s"), XdrvMailbox.data);
|
|
TM1637Data.scroll_text[XdrvMailbox.data_len] = 0;
|
|
TM1637Data.scroll_index = 0;
|
|
TM1637Data.scroll = true;
|
|
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) {
|
|
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= false;
|
|
TM1637Data.scroll_index = 0;
|
|
return;
|
|
}
|
|
uint8_t rawBytes[1];
|
|
for(uint32_t i=0, j=TM1637Data.scroll_index; i< 1 + strlen(TM1637Data.scroll_text); i++, j++) {
|
|
if(i > (TM1637Data.num_digits-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(TM1637Data.display_type == TM1637) {
|
|
tm1637display->printRaw(rawBytes, 1, i);
|
|
} else if(TM1637Data.display_type == TM1638) {
|
|
tm1638display->display7Seg(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*TM1637Data.num_digits;
|
|
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(TM1637Data.display_type == TM1637) {
|
|
rawBytes[0] = value;
|
|
tm1637display->printRaw(rawBytes, 1, digit);
|
|
} else if(TM1637Data.display_type == TM1638) {
|
|
tm1638display->display7Seg(digit, value);
|
|
}
|
|
|
|
}
|
|
return true;
|
|
}
|
|
|
|
/*********************************************************************************************\
|
|
* Display arbitrary data on the display module
|
|
* Command: DisplayRaw position {0-(TM1637Data.num_digits-1)},length {1 to TM1637Data.num_digits}, a [, b[, c[, d[...upto TM1637Data.num_digits]]]]
|
|
* where a,b,c,d... are upto TM1637Data.num_digits 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 > TM1637Data.num_digits) length = TM1637Data.num_digits;
|
|
if(position < 0 || position > (TM1637Data.num_digits-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(TM1637Data.display_type == TM1637) {
|
|
uint8_t rawBytes[1];
|
|
for(uint32_t i=position; i<position+length; i++ ) {
|
|
if(i>(TM1637Data.num_digits-1)) break;
|
|
rawBytes[0] = DATA[i-position];
|
|
tm1637display->printRaw(rawBytes, 1, i);
|
|
}
|
|
} else if(TM1637Data.display_type == TM1638) {
|
|
for(uint32_t i=position; i<position+length; i++ ) {
|
|
if(i>7) break;
|
|
tm1638display->display7Seg(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-(TM1637Data.num_digits-1)} [,length {1 to TM1637Data.num_digits}]]
|
|
\*********************************************************************************************/
|
|
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 > (TM1637Data.num_digits-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 > TM1637Data.num_digits)) length = TM1637Data.num_digits;
|
|
|
|
uint32_t i = position;
|
|
if(TM1637Data.display_type == TM1637) {
|
|
uint8_t rawBytes[1];
|
|
for(uint32_t j = 0; i< position + length; i++, j++) {
|
|
if(i > (TM1637Data.num_digits-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, i);
|
|
}
|
|
} else if(TM1637Data.display_type == TM1638) {
|
|
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]);
|
|
}
|
|
}
|
|
|
|
return true;
|
|
}
|
|
|
|
|
|
/*********************************************************************************************\
|
|
* Sets brightness of the display.
|
|
* Command: DisplayBrightness {1-8}
|
|
\*********************************************************************************************/
|
|
bool CmndTM1637Brightness(void) {
|
|
|
|
uint16_t val = XdrvMailbox.payload;
|
|
if(ArgC() == 0) {
|
|
XdrvMailbox.payload = TM1637Data.brightness;
|
|
return true;
|
|
}
|
|
|
|
if((val < BRIGHTNESS_MIN) || (val > BRIGHTNESS_MAX)) {
|
|
Response_P(PSTR("{\"Error\":\"Brightness should be a number in the range [%d, %d]\"}"), BRIGHTNESS_MIN, BRIGHTNESS_MAX);
|
|
return false;
|
|
}
|
|
TM1637Data.brightness = val;
|
|
TM1637SetBrightness(TM1637Data.brightness);
|
|
return true;
|
|
}
|
|
|
|
|
|
|
|
void TM1637SetBrightness(uint8_t val) {
|
|
if((val < BRIGHTNESS_MIN) || (val > BRIGHTNESS_MAX)) val = 5;
|
|
Settings.display_dimmer = val;
|
|
if(TM1637Data.display_type == TM1637) tm1637display->setBacklight(val*10);
|
|
else if(TM1637Data.display_type == TM1638) tm1638display->brightness(val-1);
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
/*********************************************************************************************\
|
|
* 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;
|
|
else if(XdrvMailbox.payload == 1) TM1637Data.clock_24 = false;
|
|
|
|
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 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[5];
|
|
if(hr < 10) {
|
|
if(mn < 10) snprintf(tm, sizeof(tm), PSTR("%c%d0%d"), z, hr, mn);
|
|
else snprintf(tm, sizeof(tm), PSTR("%c%d%d"), z, hr, mn);
|
|
} else {
|
|
if(mn < 10) snprintf(tm, sizeof(tm), PSTR("%d0%d"), hr, mn);
|
|
else snprintf(tm, sizeof(tm), PSTR("%d%d"), hr, mn);
|
|
}
|
|
|
|
if(TM1637Data.display_type == TM1637) {
|
|
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, i);
|
|
}
|
|
} else if(TM1637Data.display_type == TM1638) {
|
|
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]);
|
|
}
|
|
}
|
|
|
|
}
|
|
|
|
|
|
/*********************************************************************************************\
|
|
* This function is called for all Display functions.
|
|
\*********************************************************************************************/
|
|
bool TM1637MainFunc(uint8_t fn) {
|
|
bool result = 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_BRIGHTNESS:
|
|
result = CmndTM1637Brightness();
|
|
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;
|
|
}
|
|
|
|
|
|
/*********************************************************************************************\
|
|
* 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_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:
|
|
TM1637Data.show_clock = false;
|
|
case FUNC_DISPLAY_BRIGHTNESS:
|
|
result = TM1637MainFunc(function);
|
|
break;
|
|
case FUNC_DISPLAY_EVERY_50_MSECOND:
|
|
if(TM1637Data.scroll) TM1637ScrollText();
|
|
if(TM1637Data.show_clock) TM1637ShowTime();
|
|
break;
|
|
}
|
|
}
|
|
return result;
|
|
}
|
|
|
|
#endif // USE_DISPLAY_TM1637
|
|
#endif // USE_DISPLAY
|