ESP32-PaxCounter/src/display.cpp

#ifdef HAS_DISPLAY

/*

Display-Mask (128 x 64 pixel):

 |          111111
 |0123456789012345
------------------
0|PAX:aabbccddee
1|PAX:aabbccddee
2|B:a.bcV  Sats:ab
3|BLTH:abcde SF:ab
4|WIFI:abcde ch:ab
5|RLIM:abcd abcdKB
6|xxxxxxxxxxxxxxxx
6|20:27:00* 27.Feb
7|yyyyyyyyyyyyyyab
  
line 6: x = Text for LORA status OR time/date
line 7: y = Text for LMIC status; ab = payload queue

*/

// Basic Config
#include "globals.h"
#include <esp_spi_flash.h> // needed for reading ESP32 chip attributes

#define DISPLAY_PAGES (4) // number of display pages

HAS_DISPLAY u8x8(MY_OLED_RST, MY_OLED_SCL, MY_OLED_SDA);

// helper string for converting LoRa spread factor values
#if defined(CFG_eu868)
const char lora_datarate[] = {"1211100908077BFSNA"};
#elif defined(CFG_us915)
const char lora_datarate[] = {"100908078CNA121110090807"};
#elif defined(CFG_as923)
const char lora_datarate[] = {"1211100908077BFSNA"};
#elif defined(CFG_au921)
const char lora_datarate[] = {"1211100908078CNA1211109C8C7C"};
#elif defined(CFG_in866)
const char lora_datarate[] = {"121110090807FSNA"};
#endif

// helper arry for converting month values to text
const char *printmonth[] = {"xxx", "Jan", "Feb", "Mar", "Apr", "May", "Jun",
                            "Jul", "Aug", "Sep", "Oct", "Nov", "Dec"};

uint8_t DisplayIsOn = 0;

// helper function, prints a hex key on display
void DisplayKey(const uint8_t *key, uint8_t len, bool lsb) {
  const uint8_t *p;
  for (uint8_t i = 0; i < len; i++) {
    p = lsb ? key + len - i - 1 : key + i;
    u8x8.printf("%02X", *p);
  }
  u8x8.printf("\n");
}

void init_display(const char *Productname, const char *Version) {

  // block i2c bus access
  if (!I2C_MUTEX_LOCK())
    ESP_LOGV(TAG, "[%0.3f] i2c mutex lock failed", millis() / 1000.0);
  else {
    // show startup screen
    uint8_t buf[32];
    u8x8.begin();
    u8x8.setFont(u8x8_font_chroma48medium8_r);
    u8x8.clear();
    u8x8.setFlipMode(0);
    u8x8.setInverseFont(1);
    u8x8.draw2x2String(0, 0, Productname);
    u8x8.setInverseFont(0);
    u8x8.draw2x2String(2, 2, Productname);
    delay(500);
    u8x8.clear();
    u8x8.setFlipMode(1);
    u8x8.setInverseFont(1);
    u8x8.draw2x2String(0, 0, Productname);
    u8x8.setInverseFont(0);
    u8x8.draw2x2String(2, 2, Productname);
    delay(500);

    u8x8.setFlipMode(0);
    u8x8.clear();

#ifdef DISPLAY_FLIP
    u8x8.setFlipMode(1);
#endif

// Display chip information
#if (VERBOSE)
    esp_chip_info_t chip_info;
    esp_chip_info(&chip_info);
    u8x8.printf("ESP32 %d cores\nWiFi%s%s\n", chip_info.cores,
                (chip_info.features & CHIP_FEATURE_BT) ? "/BT" : "",
                (chip_info.features & CHIP_FEATURE_BLE) ? "/BLE" : "");
    u8x8.printf("ESP Rev.%d\n", chip_info.revision);
    u8x8.printf("%dMB %s Flash\n", spi_flash_get_chip_size() / (1024 * 1024),
                (chip_info.features & CHIP_FEATURE_EMB_FLASH) ? "int."
                                                              : "ext.");
#endif // VERBOSE

    u8x8.print(Productname);
    u8x8.print(" v");
    u8x8.println(PROGVERSION);

#if (HAS_LORA)
    u8x8.println("DEVEUI:");
    os_getDevEui((u1_t *)buf);
    DisplayKey(buf, 8, true);
    delay(3000);
#endif // HAS_LORA
    u8x8.clear();
    u8x8.setPowerSave(!cfg.screenon); // set display off if disabled
    u8x8.draw2x2String(0, 0, "PAX:0");
#if (BLECOUNTER)
    u8x8.setCursor(0, 3);
    u8x8.printf("BLTH:0");
#endif
    u8x8.setCursor(0, 4);
    u8x8.printf("WIFI:0");
    u8x8.setCursor(0, 5);
    u8x8.printf(!cfg.rssilimit ? "RLIM:off " : "RLIM:%d", cfg.rssilimit);

    I2C_MUTEX_UNLOCK(); // release i2c bus access
  }                     // mutex
} // init_display

void refreshTheDisplay(bool nextPage) {

  static uint8_t DisplayPage = 0;

  // if display is switched off we don't refresh it to relax cpu
  if (!DisplayIsOn && (DisplayIsOn == cfg.screenon))
    return;

  const time_t t =
      myTZ.toLocal(now()); // note: call now() here *before* locking mutex!

  // block i2c bus access
  if (!I2C_MUTEX_LOCK())
    ESP_LOGV(TAG, "[%0.3f] i2c mutex lock failed", millis() / 1000.0);
  else {
    // set display on/off according to current device configuration
    if (DisplayIsOn != cfg.screenon) {
      DisplayIsOn = cfg.screenon;
      u8x8.setPowerSave(!cfg.screenon);
    }

    if (nextPage) {
      DisplayPage = (DisplayPage >= DISPLAY_PAGES - 1) ? 0 : (DisplayPage + 1);
      u8x8.clear();
    }

    draw_page(t, DisplayPage);

    I2C_MUTEX_UNLOCK(); // release i2c bus access

  } // mutex
} // refreshDisplay()

void draw_page(time_t t, uint8_t page) {

  char timeState, buff[16];
  uint8_t msgWaiting;
#if (HAS_GPS)
  static bool wasnofix = true;
#endif

  // update counter (lines 0-1)
  snprintf(
      buff, sizeof(buff), "PAX:%-4d",
      (int)macs.size()); // convert 16-bit MAC counter to decimal counter value
  u8x8.draw2x2String(0, 0,
                     buff); // display number on unique macs total Wifi + BLE

  switch (page % DISPLAY_PAGES) {

    // page 0: parameters overview
    // page 1: time
    // page 2: GPS
    // page 3: BME280/680

  case 0:

// update Battery status (line 2)
#ifdef BAT_MEASURE_ADC
    u8x8.setCursor(0, 2);
    u8x8.printf("B:%.2fV", batt_voltage / 1000.0);
#endif

// update GPS status (line 2)
#if (HAS_GPS)
    // have we ever got valid gps data?
    if (gps.passedChecksum() > 0) {
      u8x8.setCursor(9, 2);
      if (!gps.location.isValid()) // if no fix then display Sats value inverse
      {
        u8x8.setInverseFont(1);
        u8x8.printf("Sats:%.2d", gps.satellites.value());
        u8x8.setInverseFont(0);
      } else
        u8x8.printf("Sats:%.2d", gps.satellites.value());
    }
#endif

    // update bluetooth counter + LoRa SF (line 3)
#if (BLECOUNTER)
    u8x8.setCursor(0, 3);
    if (cfg.blescan)
      u8x8.printf("BLTH:%-5d", macs_ble);
    else
      u8x8.printf("%s", "BLTH:off");
#endif

#if (HAS_LORA)
    u8x8.setCursor(11, 3);
    u8x8.printf("SF:");
    if (cfg.adrmode) // if ADR=on then display SF value inverse
      u8x8.setInverseFont(1);
    u8x8.printf("%c%c", lora_datarate[LMIC.datarate * 2],
                lora_datarate[LMIC.datarate * 2 + 1]);
    if (cfg.adrmode) // switch off inverse if it was turned on
      u8x8.setInverseFont(0);
#endif // HAS_LORA

    // line 4: update wifi counter + channel display
    u8x8.setCursor(0, 4);
    u8x8.printf("WIFI:%-5d", macs_wifi);
    u8x8.setCursor(11, 4);
    u8x8.printf("ch:%02d", channel);

    // line 5: update RSSI limiter status & free memory display
    u8x8.setCursor(0, 5);
    u8x8.printf(!cfg.rssilimit ? "RLIM:off " : "RLIM:%-4d", cfg.rssilimit);
    u8x8.setCursor(10, 5);
    u8x8.printf("%4dKB", getFreeRAM() / 1024);

    // line 6: update time-of-day or LoRa status display
    u8x8.setCursor(0, 6);
#if (TIME_SYNC_INTERVAL)
    // we want a systime display instead LoRa status
    timeState = TimePulseTick ? ' ' : timeSetSymbols[timeSource];
    TimePulseTick = false;
// display inverse timeState if clock controller is enabled
#if (defined HAS_DCF77) || (defined HAS_IF482)
    u8x8.printf("%02d:%02d:%02d", hour(t), minute(t), second(t));
    u8x8.setInverseFont(1);
    u8x8.printf("%c", timeState);
    u8x8.setInverseFont(0);
    u8x8.printf(" %2d.%3s", day(t), printmonth[month(t)]);
#else
    u8x8.printf("%02d:%02d:%02d%c %2d.%3s", hour(t), minute(t), second(t),
                timeState, day(t), printmonth[month(t)]);
#endif // HAS_DCF77 || HAS_IF482

#else // update LoRa status display
#if (HAS_LORA)
    u8x8.printf("%-16s", display_line6);
#endif

#endif // TIME_SYNC_INTERVAL

#if (HAS_LORA)
    // line 7: update LMiC event display
    u8x8.setCursor(0, 7);
    u8x8.printf("%-14s", display_line7);

    // update LoRa send queue display
    msgWaiting = uxQueueMessagesWaiting(LoraSendQueue);
    if (msgWaiting) {
      sprintf(buff, "%2d", msgWaiting);
      u8x8.setCursor(14, 7);
      u8x8.printf("%-2s", msgWaiting == SEND_QUEUE_SIZE ? "<>" : buff);
    } else
      u8x8.printf("  ");

#endif // HAS_LORA

    break; // page0

  case 1:

    // line 4-5: update time-of-day
    snprintf(buff, sizeof(buff), "%02d:%02d:%02d", hour(t), minute(t),
             second(t));
    u8x8.draw2x2String(0, 4, buff);

    break; // page1

  case 2:
    // update counter (lines 0-1)
    snprintf(
        buff, sizeof(buff), "PAX:%-4d",
        (int)
            macs.size()); // convert 16-bit MAC counter to decimal counter value
    u8x8.draw2x2String(0, 0,
                       buff); // display number on unique macs total Wifi + BLE

#if (HAS_GPS)
    if (gps.location.age() < 1500) {
      // line 5: clear "No fix"
      if (wasnofix) {
        snprintf(buff, sizeof(buff), "      ");
        u8x8.draw2x2String(2, 5, buff);
        wasnofix = false;
      }
      // line 3-4: GPS latitude
      snprintf(buff, sizeof(buff), "%c%07.4f",
               gps.location.rawLat().negative ? 'S' : 'N', gps.location.lat());
      u8x8.draw2x2String(0, 3, buff);

      // line 6-7: GPS longitude
      snprintf(buff, sizeof(buff), "%c%07.4f",
               gps.location.rawLat().negative ? 'W' : 'E', gps.location.lng());
      u8x8.draw2x2String(0, 6, buff);

    } else {
      snprintf(buff, sizeof(buff), "No fix");
      u8x8.setInverseFont(1);
      u8x8.draw2x2String(2, 5, buff);
      u8x8.setInverseFont(0);
      wasnofix = true;
    }

#else
    snprintf(buff, sizeof(buff), "No GPS");
    u8x8.draw2x2String(2, 5, buff);
#endif

    break; // page2

  case 3:

#if (HAS_BME)
    // line 2-3: Temp
    snprintf(buff, sizeof(buff), "TMP:%-2.1f", bme_status.temperature);
    u8x8.draw2x2String(0, 2, buff);

    // line 4-5: Hum
    snprintf(buff, sizeof(buff), "HUM:%-2.1f", bme_status.humidity);
    u8x8.draw2x2String(0, 4, buff);

#ifdef HAS_BME680
    // line 6-7: IAQ
    snprintf(buff, sizeof(buff), "IAQ:%-3.0f", bme_status.iaq);
    u8x8.draw2x2String(0, 6, buff);
#endif

#else
    snprintf(buff, sizeof(buff), "No BME");
    u8x8.draw2x2String(2, 5, buff);
#endif

    break; // page3

  default:
    break; // default

  } // switch

} // draw_page

#endif // HAS_DISPLAY