status_module.ino

/*
 * Copyright (c) 2023 Marcel Licence
 *
 * 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/>.
 *
 * Dieses Programm ist Freie Software: Sie können es unter den Bedingungen
 * der GNU General Public License, wie von der Free Software Foundation,
 * Version 3 der Lizenz oder (nach Ihrer Wahl) jeder neueren
 * veröffentlichten Version, weiter verteilen und/oder modifizieren.
 *
 * Dieses Programm wird in der Hoffnung bereitgestellt, dass es nützlich sein wird, jedoch
 * OHNE JEDE GEWÄHR,; sogar ohne die implizite
 * Gewähr der MARKTFÄHIGKEIT oder EIGNUNG FÜR EINEN BESTIMMTEN ZWECK.
 * Siehe die GNU General Public License für weitere Einzelheiten.
 *
 * Sie sollten eine Kopie der GNU General Public License zusammen mit diesem
 * Programm erhalten haben. Wenn nicht, siehe <https://www.gnu.org/licenses/>.
 */

/*
 * this file contains the implementation of the terminal output
 * the output is vt100 compatible and you should use a terminal like teraTerm
 *
 * source: https://ttssh2.osdn.jp/index.html.en​
 *
 * Author: Marcel Licence
 */

bool triggerTerminalOutput = true; /*!< necessary for usage without vt100 compliant terminal */

char statusMsg[128] = "\0"; /*!< buffer for top line message */
char currentFile[128] = "\0"; /*!< buffer for filename */

uint32_t statusMsgShowTimer = 0; /*!< counter for timeout to reset top line */

uint32_t currentFileShowTimer = 0;


#define VU_MAX  24 /*!< character length of vu meter */

float statusVuLookup[VU_MAX]; /*!< precalculated lookup */

/*
 * prepares the module
 */
void Status_Setup(void)
{
    /*
     * prepare lookup for log vu meters
     */
    float vuValue = 1.0f;
    for (int i = VU_MAX; i > 0; i--)
    {
        int n = i - 1;

        statusVuLookup[n] = vuValue;

        vuValue *= 1.0f / sqrt(2.0f); /* div by 1/sqrt(2) means 3db */
        vuValue *= 1.0f / sqrt(2.0f);
    }
}

/*
 * function which prints the vu meter "line"
 */
void Status_PrintVu(float *value, uint8_t vuMax)
{
    /*
     * first pick a color
     */
    if (*value >= 0.7071f) /* -3dB */
    {
        Serial.printf("\033[0;31m"); /* red */
    }
    else if (*value >= 0.5) /* -6dB */
    {
        Serial.printf("\033[0;33m"); /* yellow */
    }
    else
    {
        Serial.printf("\033[0;32m"); /* green */
    }

    for (int i = 0; i < vuMax; i++)
    {

        if (statusVuLookup[i + (VU_MAX - vuMax)] <= *value)
        {
            Serial.printf("#");
        }
        else
        {
            Serial.printf(" ");
        }
    }

    Serial.printf("\033[0m"); /* switch back to default */

    *value *= 0.5; /* slowly lower the value */
}


/*
 * refresh complete output
 * 32 character width
 * 14 character height
 */
void Status_PrintAll(void)
{
    char emptyLine[] = "                                ";
#if 0 /* not used */
    char emptyLineMin[] = "                               ";
#endif
    char emptyLineLong[] = "                                                                ";
    Serial.printf("\033[?25l");
    Serial.printf("\033[%d;%dH", 0, 0);
    //Serial.printf("--------------------------------\n");
    Serial.printf("%s%s\n", statusMsg, &emptyLine[strlen(statusMsg)]);
    Serial.printf("--------------------------------\n");

    Serial.printf("inL    ");
    Status_PrintVu(vuInL, 8);

    Serial.printf("  outL   ");
    Status_PrintVu(vuOutL, 8);
    Serial.printf("\n");

    Serial.printf("inR    ");
    Status_PrintVu(vuInR, 8);
    Serial.printf("  outR   ");
    Status_PrintVu(vuOutR, 8);
    Serial.printf("\n");


    Serial.printf("--------------------------------\n");
    char memoryUsedMsg[64];
    sprintf(memoryUsedMsg, "%d of %d bytes used", sampleStorageInPos, sampleStorageLen);
    Serial.printf("%s%s\n", memoryUsedMsg, &emptyLine[strlen(memoryUsedMsg)]);

    float relativeStorageUsage = ((float)sampleStorageInPos) / ((float)sampleStorageLen);
    for (int i = 0; i < 32; i++)
    {
        if (i == (int)(relativeStorageUsage * 32.0f))
        {
            Serial.printf("O");
        }
        else
        {
            if (i > (int)(relativeStorageUsage * 32.0f))
            {
                Serial.printf("_");
            }
            else
            {
                Serial.printf("=");
            }
        }
    }
    Serial.println();

    Serial.printf("%s%s%s", emptyLine, currentFile, &emptyLineLong[strlen(currentFile)]);

#ifdef STATUS_SHOW_BUTTON_TEXT
    Status_ShowButtonText();
#endif
}

uint8_t activeKey = 9;

static char key[6][9] = {"Key1    ", "Key2    ", "Key3    ", "Key4    ", "Key5    ", "Key6    "};

void Status_ShowButtonText()
{


    Serial.printf("\n--------------------------------\n");
    Serial.printf("%s %s %s #####\n", key[0], key[2], key[4]);
    Serial.printf("#### %s %s %s \n", key[1], key[3], key[5]);
}

void Status_SetKeyText(uint8_t keyId, const char *text)
{
    memset(key[keyId], ' ', 8);
    memcpy(key[keyId], text, strlen(text)); /* just copy text without trailing zero */
}

void Status_Process_Sample(uint32_t inc)
{
    statusMsgShowTimer += inc;
    if (statusMsgShowTimer > SAMPLE_RATE * 3)
    {
        statusMsg[0] = 0;
    }

    currentFileShowTimer += inc;
    if (currentFileShowTimer > SAMPLE_RATE * 3)
    {
        currentFile[0] = 0;
    }
}

void Status_Process(void)
{
#ifndef VT100_ENABLED
    if (triggerTerminalOutput)
#endif
    {
        Status_PrintAll();
        triggerTerminalOutput = false;
    }

#ifndef VT100_ENABLED
    if (triggerTerminalOutput)
#endif
    {
        Status_PrintAll();
        triggerTerminalOutput = false;
    }
}

/*
 * update top line message including a float value
 */
void Status_ValueChangedFloat(const char *group, const char *descr, float value)
{
    statusMsgShowTimer = 0;
    sprintf(statusMsg, "%s - %s: %0.3f", group, descr, value);
#ifndef AS5600_ENABLED
    triggerTerminalOutput = true;
#ifdef SCREEN_ENABLED
    Screen_Update();
#endif
#endif
}

void Status_ValueChangedFloat(const char *descr, float value)
{
    statusMsgShowTimer = 0;
    sprintf(statusMsg, "%s: %0.3f", descr, value);
#ifndef AS5600_ENABLED
    triggerTerminalOutput = true;
#ifdef SCREEN_ENABLED
    Screen_Update();
#endif
#endif
}

/*
 * update top line message including an integer value
 */
void Status_ValueChangedInt(const char *group, const char *descr, int value)
{
    statusMsgShowTimer = 0;
    sprintf(statusMsg, "%s - %s: %d", group, descr, value);
#ifndef AS5600_ENABLED
    triggerTerminalOutput = true;
#ifdef SCREEN_ENABLED
    Screen_Update();
#endif
#endif
}

void Status_ValueChangedInt(const char *descr, int value)
{
    statusMsgShowTimer = 0;
    sprintf(statusMsg, "%s: %d", descr, value);
#ifndef AS5600_ENABLED
    triggerTerminalOutput = true;
#ifdef SCREEN_ENABLED
    Screen_Update();
#endif
#endif
}

/*
 * update top line message
 */
void Status_TestMsg(const char *text)
{
    statusMsgShowTimer = 0;
    sprintf(statusMsg, "%s", text);
    triggerTerminalOutput = true;
}

void Status_LogMessage(const char *text)
{
    statusMsgShowTimer = 0;
    sprintf(statusMsg, "%s", text);
    triggerTerminalOutput = true;
}

void Status_FileName(char *text)
{
    memset(currentFile, 0, sizeof(currentFile));
    strcpy(currentFile, text);
    currentFileShowTimer = 0;
}