snapshot

2026-02-12 01:27:25 -08:00
parent b5c81d79f0
commit e9678dd1ea
322 changed files with 297928 additions and 93 deletions
--- a/libraries/GFX_Library_for_Arduino/examples/WiFiPhotoFrame/JpegFunc.h
+++ b/libraries/GFX_Library_for_Arduino/examples/WiFiPhotoFrame/JpegFunc.h
@@ -0,0 +1,118 @@
+/*******************************************************************************
+ * JPEGDEC related function
+ *
+ * Dependent libraries:
+ * JPEGDEC: https://github.com/bitbank2/JPEGDEC.git
+ ******************************************************************************/
+#ifndef _JPEGFUNC_H_
+#define _JPEGFUNC_H_
+
+#include <JPEGDEC.h>
+
+static JPEGDEC _jpeg;
+static int _x, _y, _x_bound, _y_bound;
+
+static void jpegCloseHttpStream(void *pHandle)
+{
+  // printf("jpegCloseHttpStream\n");
+  // WiFiClient *http_stream = (WiFiClient *)pHandle;
+  // do nothing
+}
+
+static int32_t readStream(WiFiClient *http_stream, uint8_t *pBuf, int32_t iLen)
+{
+  uint8_t wait = 0;
+  size_t a = http_stream->available();
+  size_t r = 0;
+  while ((r < iLen) && (wait < 10))
+  {
+    if (a)
+    {
+      wait = 0; // reset wait count once available
+      r += http_stream->readBytes(pBuf + r, iLen - r);
+      // printf("1st byte: %d, 2nd byte: %d, last byte: %d, iLen: %d, r: %d, wait: %d\n", pBuf[0], pBuf[1], pBuf[r - 1], iLen, r, wait);
+    }
+    else
+    {
+      delay(100);
+      wait++;
+    }
+    a = http_stream->available();
+  }
+  return r;
+}
+
+static int32_t jpegReadHttpStream(JPEGFILE *pFile, uint8_t *pBuf, int32_t iLen)
+{
+  // printf("jpegReadHttpStream, iLen: %d\n", iLen);
+  WiFiClient *http_stream = (WiFiClient *)pFile->fHandle;
+  return readStream(http_stream, pBuf, iLen);
+}
+
+static int32_t jpegSeekHttpStream(JPEGFILE *pFile, int32_t iPosition)
+{
+  // printf("jpegSeekHttpStream, pFile->iPos: %d, iPosition: %d\n", pFile->iPos, iPosition);
+  WiFiClient *http_stream = (WiFiClient *)pFile->fHandle;
+  http_stream->readBytes((uint8_t *)nullptr, iPosition - pFile->iPos);
+  return iPosition;
+}
+
+static int jpegOpenHttpStreamWithBuffer(WiFiClient *http_stream, uint8_t *buf, int32_t dataSize, JPEG_DRAW_CALLBACK *jpegDrawCallback)
+{
+  int32_t r = readStream(http_stream, buf, dataSize);
+  if (r != dataSize)
+  {
+    return 0;
+  }
+  return _jpeg.openRAM(buf, dataSize, jpegDrawCallback);
+}
+
+static int jpegOpenHttpStream(WiFiClient *http_stream, int32_t dataSize, JPEG_DRAW_CALLBACK *jpegDrawCallback)
+{
+  return _jpeg.open(http_stream, dataSize, jpegCloseHttpStream, jpegReadHttpStream, jpegSeekHttpStream, jpegDrawCallback);
+}
+
+static int jpegDraw(bool useBigEndian,
+                    int x, int y, int widthLimit, int heightLimit)
+{
+  _x = x;
+  _y = y;
+  _x_bound = _x + widthLimit - 1;
+  _y_bound = _y + heightLimit - 1;
+
+  // scale to fit height
+  int _scale;
+  int iMaxMCUs;
+  float ratio = (float)_jpeg.getHeight() / heightLimit;
+  if (ratio <= 1)
+  {
+    _scale = 0;
+    iMaxMCUs = widthLimit / 16;
+  }
+  else if (ratio <= 2)
+  {
+    _scale = JPEG_SCALE_HALF;
+    iMaxMCUs = widthLimit / 8;
+  }
+  else if (ratio <= 4)
+  {
+    _scale = JPEG_SCALE_QUARTER;
+    iMaxMCUs = widthLimit / 4;
+  }
+  else
+  {
+    _scale = JPEG_SCALE_EIGHTH;
+    iMaxMCUs = widthLimit / 2;
+  }
+  _jpeg.setMaxOutputSize(iMaxMCUs);
+  if (useBigEndian)
+  {
+    _jpeg.setPixelType(RGB565_BIG_ENDIAN);
+  }
+  int decode_result = _jpeg.decode(x, y, _scale);
+  _jpeg.close();
+
+  return decode_result;
+}
+
+#endif // _JPEGFUNC_H_
--- a/libraries/GFX_Library_for_Arduino/examples/WiFiPhotoFrame/WiFiPhotoFrame.ino
+++ b/libraries/GFX_Library_for_Arduino/examples/WiFiPhotoFrame/WiFiPhotoFrame.ino
@@ -0,0 +1,287 @@
+/*******************************************************************************
+ * WiFi Photo Frame
+ * This is a simple IoT photo frame sample
+ * Please find more details at instructables:
+ * https://www.instructables.com/id/Face-Aware-OSD-Photo-Frame/
+ *
+ * Dependent libraries:
+ * JPEGDEC: https://github.com/bitbank2/JPEGDEC.git
+ *
+ * Raspberry Pi Pico W dependent libraries:
+ * HttpClient: https://github.com/moononournation/HttpClient.git
+ *
+ * Setup steps:
+ * 1. Fill your own SSID_NAME, SSID_PASSWORD, HTTP_HOST, HTTP_PORT and HTTP_PATH_TEMPLATE
+ * 2. Change your LCD parameters in Arduino_GFX setting
+ ******************************************************************************/
+
+/* WiFi settings */
+const char *SSID_NAME = "YourAP";
+const char *SSID_PASSWORD = "PleaseInputYourPasswordHere";
+
+const char *HTTP_HOST = "192.168.12.34";                /* Your HTTP photo server host name */
+const uint16_t HTTP_PORT = 5000;                        /* Your HTTP photo server port */
+const char *HTTP_PATH_TEMPLATE = "/OSDPhoto?w=%d&h=%d"; /* Your HTTP photo server URL path template */
+
+const uint16_t HTTP_TIMEOUT = 30000; // in ms, wait a while for server processing
+
+/*******************************************************************************
+ * Start of Arduino_GFX setting
+ *
+ * Arduino_GFX try to find the settings depends on selected board in Arduino IDE
+ * Or you can define the display dev kit not in the board list
+ * Defalult pin list for non display dev kit:
+ * Arduino Nano, Micro and more: CS:  9, DC:  8, RST:  7, BL:  6, SCK: 13, MOSI: 11, MISO: 12
+ * ESP32 various dev board     : CS:  5, DC: 27, RST: 33, BL: 22, SCK: 18, MOSI: 23, MISO: nil
+ * ESP32-C2/3 various dev board: CS:  7, DC:  2, RST:  1, BL:  3, SCK:  4, MOSI:  6, MISO: nil
+ * ESP32-C5 various dev board  : CS: 23, DC: 24, RST: 25, BL: 26, SCK: 10, MOSI:  8, MISO: nil
+ * ESP32-C6 various dev board  : CS: 18, DC: 22, RST: 23, BL: 15, SCK: 21, MOSI: 19, MISO: nil
+ * ESP32-H2 various dev board  : CS:  0, DC: 12, RST:  8, BL: 22, SCK: 10, MOSI: 25, MISO: nil
+ * ESP32-P4 various dev board  : CS: 26, DC: 27, RST: 25, BL: 24, SCK: 36, MOSI: 32, MISO: nil
+ * ESP32-S2 various dev board  : CS: 34, DC: 38, RST: 33, BL: 21, SCK: 36, MOSI: 35, MISO: nil
+ * ESP32-S3 various dev board  : CS: 40, DC: 41, RST: 42, BL: 48, SCK: 36, MOSI: 35, MISO: nil
+ * ESP8266 various dev board   : CS: 15, DC:  4, RST:  2, BL:  5, SCK: 14, MOSI: 13, MISO: 12
+ * Raspberry Pi Pico dev board : CS: 17, DC: 27, RST: 26, BL: 28, SCK: 18, MOSI: 19, MISO: 16
+ * RTL8720 BW16 old patch core : CS: 18, DC: 17, RST:  2, BL: 23, SCK: 19, MOSI: 21, MISO: 20
+ * RTL8720_BW16 Official core  : CS:  9, DC:  8, RST:  6, BL:  3, SCK: 10, MOSI: 12, MISO: 11
+ * RTL8722 dev board           : CS: 18, DC: 17, RST: 22, BL: 23, SCK: 13, MOSI: 11, MISO: 12
+ * RTL8722_mini dev board      : CS: 12, DC: 14, RST: 15, BL: 13, SCK: 11, MOSI:  9, MISO: 10
+ * Seeeduino XIAO dev board    : CS:  3, DC:  2, RST:  1, BL:  0, SCK:  8, MOSI: 10, MISO:  9
+ * Teensy 4.1 dev board        : CS: 39, DC: 41, RST: 40, BL: 22, SCK: 13, MOSI: 11, MISO: 12
+ ******************************************************************************/
+#include <Arduino_GFX_Library.h>
+
+#define GFX_BL DF_GFX_BL // default backlight pin, you may replace DF_GFX_BL to actual backlight pin
+
+/* More dev device declaration: https://github.com/moononournation/Arduino_GFX/wiki/Dev-Device-Declaration */
+#if defined(DISPLAY_DEV_KIT)
+Arduino_GFX *gfx = create_default_Arduino_GFX();
+#else /* !defined(DISPLAY_DEV_KIT) */
+
+/* More data bus class: https://github.com/moononournation/Arduino_GFX/wiki/Data-Bus-Class */
+Arduino_DataBus *bus = create_default_Arduino_DataBus();
+
+/* More display class: https://github.com/moononournation/Arduino_GFX/wiki/Display-Class */
+Arduino_GFX *gfx = new Arduino_ILI9341(bus, DF_GFX_RST, 0 /* rotation */, false /* IPS */);
+
+#endif /* !defined(DISPLAY_DEV_KIT) */
+/*******************************************************************************
+ * End of Arduino_GFX setting
+ ******************************************************************************/
+
+#if defined(ESP32)
+#include <esp_task_wdt.h>
+#include <WiFi.h>
+#include <HTTPClient.h>
+WiFiClient client;
+HTTPClient http;
+#elif defined(ESP8266)
+#include <ESP8266WiFi.h>
+#include <ESP8266HTTPClient.h>
+WiFiClient client;
+HTTPClient http;
+#elif defined(ARDUINO_RASPBERRY_PI_PICO_W)
+#include <WiFi.h>
+#include <WiFiClient.h>
+#include <HttpClient.h>
+WiFiClient client;
+HttpClient http(client);
+#elif defined(RTL8722DM)
+#include <WiFi.h>
+#include <WiFiClient.h>
+#include <HttpClient.h>
+WiFiClient client;
+HttpClient http(client);
+#endif
+
+#include "JpegFunc.h"
+
+// pixel drawing callback
+static int jpegDrawCallback(JPEGDRAW *pDraw)
+{
+  // Serial.printf("Draw pos = %d,%d. size = %d x %d\n", pDraw->x, pDraw->y, pDraw->iWidth, pDraw->iHeight);
+  gfx->draw16bitRGBBitmap(pDraw->x, pDraw->y, pDraw->pPixels, pDraw->iWidth, pDraw->iHeight);
+  return 1;
+}
+
+static unsigned long next_show_millis = 0;
+
+char http_path[1024];
+
+void setup()
+{
+#ifdef DEV_DEVICE_INIT
+  DEV_DEVICE_INIT();
+#endif
+
+  Serial.begin(115200);
+  // Serial.setDebugOutput(true);
+  // while(!Serial);
+  Serial.println("Arduino_GFX WiFi Photo Frame example");
+
+  Serial.println("Init display");
+  if (!gfx->begin())
+  {
+    Serial.println("gfx->begin() failed!");
+  }
+  gfx->fillScreen(RGB565_BLACK);
+
+#ifdef GFX_BL
+  pinMode(GFX_BL, OUTPUT);
+  digitalWrite(GFX_BL, HIGH);
+#endif
+
+  Serial.println("Init WiFi");
+  gfx->println("Init WiFi");
+#if defined(ESP32) || defined(ESP8266)
+  WiFi.mode(WIFI_STA);
+  WiFi.begin(SSID_NAME, SSID_PASSWORD);
+#elif defined(ARDUINO_RASPBERRY_PI_PICO_W)
+  WiFi.mode(WIFI_STA);
+  WiFi.begin(SSID_NAME, SSID_PASSWORD);
+#elif defined(RTL8722DM)
+  WiFi.begin((char *)SSID_NAME, (char *)SSID_PASSWORD);
+#endif
+  while (WiFi.status() != WL_CONNECTED)
+  {
+    delay(500);
+    Serial.print(".");
+    gfx->print(".");
+  }
+  Serial.println(" CONNECTED");
+  gfx->println(" CONNECTED");
+
+  Serial.println("Init HTTP path");
+  gfx->println("Init HTTP path");
+  // setup http_path query value with LCD dimension
+  sprintf(http_path, HTTP_PATH_TEMPLATE, gfx->width(), gfx->height());
+  Serial.println(http_path);
+  gfx->println(http_path);
+
+#if defined(ESP32)
+  Serial.println("Init ESP32 WDT");
+  gfx->println("Init ESP32 WDT");
+  // set WDT timeout a little bit longer than HTTP timeout
+  esp_task_wdt_init((HTTP_TIMEOUT / 1000) + 1, true);
+  enableLoopWDT();
+#endif
+}
+
+void loop()
+{
+  if (millis() < next_show_millis)
+  {
+    // Serial.println("Wait for next minute...");
+    delay(1000);
+  }
+  else
+  {
+    if (WiFi.status() == WL_CONNECTED)
+    {
+      int jpeg_result = 0;
+
+      Serial.printf("[HTTP] begin...\n");
+      http.setTimeout(HTTP_TIMEOUT);
+#if defined(ESP32) || defined(ESP8266)
+      http.begin(client, HTTP_HOST, HTTP_PORT, http_path);
+      int httpCode = http.GET();
+#elif defined(ARDUINO_RASPBERRY_PI_PICO_W) || defined(RTL8722DM)
+      http.get(HTTP_HOST, HTTP_PORT, http_path);
+      int httpCode = http.responseStatusCode();
+      http.skipResponseHeaders();
+#endif
+
+      Serial.printf("[HTTP] GET... code: %d\n", httpCode);
+      gfx->printf("[HTTP] GET... code: %d\n", httpCode);
+      // HTTP header has been send and Server response header has been handled
+      if (httpCode <= 0)
+      {
+#if defined(ESP32) || defined(ESP8266)
+        Serial.printf("[HTTP] GET... failed, error: %s\n", http.errorToString(httpCode).c_str());
+#endif
+      }
+      else
+      {
+        if (httpCode != 200)
+        {
+          Serial.printf("[HTTP] Not OK!\n");
+          gfx->printf("[HTTP] Not OK!\n");
+          delay(5000);
+        }
+        else
+        {
+// get lenght of document(is - 1 when Server sends no Content - Length header)
+#if defined(ESP32) || defined(ESP8266)
+          int len = http.getSize();
+#elif defined(ARDUINO_RASPBERRY_PI_PICO_W) || defined(RTL8722DM)
+          int len = http.contentLength();
+#endif
+          Serial.printf("[HTTP] size: %d\n", len);
+          gfx->printf("[HTTP] size: %d\n", len);
+
+          if (len <= 0)
+          {
+            Serial.printf("[HTTP] Unknow content size: %d\n", len);
+            gfx->printf("[HTTP] Unknow content size: %d\n", len);
+          }
+          else
+          {
+            unsigned long start = millis();
+
+            uint8_t *buf = (uint8_t *)malloc(len);
+            if (buf)
+            {
+#if defined(ESP32) || defined(ESP8266)
+              static WiFiClient *http_stream = http.getStreamPtr();
+              jpeg_result = jpegOpenHttpStreamWithBuffer(http_stream, buf, len, jpegDrawCallback);
+#elif defined(ARDUINO_RASPBERRY_PI_PICO_W) || defined(RTL8722DM)
+              jpeg_result = jpegOpenHttpStreamWithBuffer(&client, buf, len, jpegDrawCallback);
+#endif
+              if (jpeg_result)
+              {
+                jpeg_result = jpegDraw(false /* useBigEndian */,
+                                       0 /* x */, 0 /* y */, gfx->width() /* widthLimit */, gfx->height() /* heightLimit */);
+              }
+              free(buf);
+            }
+            else
+            {
+// get tcp stream
+#if defined(ESP32) || defined(ESP8266)
+              static WiFiClient *http_stream = http.getStreamPtr();
+              jpeg_result = jpegOpenHttpStream(http_stream, len, jpegDrawCallback);
+#elif defined(ARDUINO_RASPBERRY_PI_PICO_W) || defined(RTL8722DM)
+              jpeg_result = jpegOpenHttpStream(&client, len, jpegDrawCallback);
+#endif
+              if (jpeg_result)
+              {
+                jpeg_result = jpegDraw(false /* useBigEndian */,
+                                       0 /* x */, 0 /* y */, gfx->width() /* widthLimit */, gfx->height() /* heightLimit */);
+              }
+            }
+            Serial.printf("Time used: %lu\n", millis() - start);
+          }
+        }
+      }
+#if defined(ESP32) || defined(ESP8266)
+      http.end();
+#elif defined(ARDUINO_RASPBERRY_PI_PICO_W) || defined(RTL8722DM)
+      http.stop();
+#endif
+
+      if (jpeg_result)
+      {
+        next_show_millis = ((millis() / 60000L) + 1) * 60000L; // next minute
+      }
+    }
+  }
+
+#if defined(ESP32)
+  // notify WDT still working
+  feedLoopWDT();
+#elif defined(ESP8266)
+  yield();
+#elif defined(ARDUINO_RASPBERRY_PI_PICO_W)
+  yield();
+#endif
+}