Added front light API

Author: bitbank2

src/FastEPD.cpp

@@ -58,6 +58,16 @@ int FASTEPD::loadG5Image(const uint8_t *pG5, int x, int y, int iFG, int iBG, flo
     return bbepLoadG5(&_state, pG5, x, y, iFG, iBG, fScale);
 }
 
+void FASTEPD::setPasses(uint8_t iPartialPasses, uint8_t iFullPasses)
+{
+    if (iPartialPasses > 0 && iPartialPasses < 15) { // reasonable numbers
+        _state.iPartialPasses = iPartialPasses;
+    }
+    if (iFullPasses > 0 && iFullPasses < 15) { // reasonable numbers
+        _state.iFullPasses = iFullPasses;
+    }
+} /* setPasses() */
+
 int FASTEPD::setRotation(int iAngle)
 {
     return bbepSetRotation(&_state, iAngle);
@@ -247,6 +257,15 @@ static uint8_t u8Unicode0, u8Unicode1;
   return 1;
 } /* write() */
 
+void FASTEPD::setBrightness(uint8_t led1, uint8_t led2)
+{
+    bbepSetBrightness(&_state, led1, led2);
+}
+void FASTEPD::initLights(uint8_t led1, uint8_t led2)
+{
+    bbepInitLights(&_state, led1, led2);
+} /* initLights() */
+
 int FASTEPD::initCustomPanel(BBPANELDEF *pPanel, BBPANELPROCS *pProcs)
 {
     _state.iPanelType = BB_PANEL_CUSTOM;

src/FastEPD.h

@@ -178,9 +178,11 @@ typedef struct tag_fastepdstate
     int iPanelType;
     uint8_t wrap, last_error, pwr_on, mode;
     uint8_t shift_data, anti_alias;
+    uint8_t u8LED1, u8LED2;
     int iCursorX, iCursorY;
     int width, height, native_width, native_height;
     int rotation;
+    int iPartialPasses, iFullPasses;
     int iScreenOffset, iOrientation;
     int iFG, iBG; //current color
     int iFont, iFlags;
@@ -209,6 +211,8 @@ class FASTEPD
   public:
     FASTEPD() {memset(&_state, 0, sizeof(_state)); _state.iFont = FONT_8x8; _state.iFG = BBEP_BLACK;}
     int initPanel(int iPanelType);
+    void initLights(uint8_t led1, uint8_t led2 = 0xff);
+    void setBrightness(uint8_t led1, uint8_t led2 = 0);
     int initCustomPanel(BBPANELDEF *pPanel, BBPANELPROCS *pProcs);
     int setPanelSize(int iPanel);
     int setCustomMatrix(const uint8_t *pMatrix, size_t matrix_size);
@@ -226,6 +230,7 @@ class FASTEPD
     int fullUpdate(bool bFast = false, bool bKeepOn = false, BBEPRECT *pRect = NULL);
     int partialUpdate(bool bKeepOn, int iStartRow = 0, int iEndRow = 4095);
     int smoothUpdate(bool bKeepOn, uint8_t u8Color);
+    void setPasses(uint8_t iPartialPasses, uint8_t iFullPasses = 5);
     int setRotation(int iAngle);
     int getRotation(void) { return _state.rotation;}
     void backupPlane(void);

src/FastEPD.inl

@@ -1122,6 +1122,8 @@ int bbepIOInit(FASTEPDSTATE *pState)
     #endif
     int rc = (*(pState->pfnIOInit))(pState);
     if (rc != BBEP_SUCCESS) return rc;
+    pState->iPartialPasses = 4; // N.B. The default number of passes for partial updates
+    pState->iFullPasses = 5; // the default number of passes for smooth and full updates
     // Initialize the ESP32 LCD API to drive parallel data at high speed
     // The code forces the use of a D/C pin, so we must assign it to an unused GPIO on each device
     s3_bus_config.dc_gpio_num = (gpio_num_t)pState->panelDef.ioDCDummy;
@@ -1245,6 +1247,32 @@ int bbepSetPanelSize(FASTEPDSTATE *pState, int width, int height, int flags) {
 return BBEP_SUCCESS;
 } /* setPanelSize() */
 
+//
+// Set the individual brightness of the 1 or 2 front lights
+//
+void bbepSetBrightness(FASTEPDSTATE *pState, uint8_t led1, uint8_t led2)
+{
+    ledcWrite(pState->u8LED1, led1); // PWM (0-255)
+    if (pState->u8LED2 != 0xff) {
+        ledcWrite(pState->u8LED2, led2);
+    }
+} /* bbepSetBrightness() */
+
+//
+// Initialize the front light(s) if present
+//
+void bbepInitLights(FASTEPDSTATE *pState, uint8_t led1, uint8_t led2)
+{
+    pState->u8LED1 = led1;
+    pState->u8LED2 = led2;
+    ledcAttach(led1, 5000, 8); // attach pin to channel 0
+    ledcWrite(led1, 0); // set to off to start
+    if (led2 != 0xff) {
+        ledcAttach(led2, 5000, 8);
+        ledcWrite(led2, 0); // set to off
+    }
+} /* bbepInitLights() */
+
 //
 // Initialize the panel based on the constant name
 // Each name points to a configuration with info about the PCB and possibly a display
@@ -1468,8 +1496,8 @@ int bbepSmoothUpdate(FASTEPDSTATE *pState, bool bKeepOn, uint8_t u8Color)
                 }
             }
         } // for i
-        // Write 5 passes of the black data to the whole display
-        for (pass = 0; pass < 5; pass++) {
+        // Write N passes of the black data to the whole display
+        for (pass = 0; pass < pState->iFullPasses; pass++) {
             bbepRowControl(pState, ROW_START);
             for (i = 0; i < pState->native_height; i++) {
                 s = &pState->pTemp[i * (pState->native_width / 4)];
@@ -1607,8 +1635,8 @@ int bbepFullUpdate(FASTEPDSTATE *pState, bool bFast, bool bKeepOn, BBEPRECT *pRe
             }
             //vTaskDelay(0);
         } // for i
-        // Write 5 passes of the black data to the whole display
-        for (pass = 0; pass < 5; pass++) {
+        // Write N passes of the black data to the whole display
+        for (pass = 0; pass < pState->iFullPasses; pass++) {
             bbepRowControl(pState, ROW_START);
             for (i = 0; i < pState->native_height; i++) {
                 s = &pState->pTemp[i * (pState->native_width / 4)];
@@ -1741,7 +1769,7 @@ int bbepPartialUpdate(FASTEPDSTATE *pState, bool bKeepOn, int iStartLine, int iE
         iStartLine = iEndLine;
         iEndLine = i;
     }
-    for (pass = 0; pass < 4; pass++) { // each pass is about 32ms
+    for (pass = 0; pass < pState->iPartialPasses; pass++) { // each pass is about 32ms
         uint8_t *dp = pState->pTemp;
         int iDelta = pState->native_width / 4; // 2 bits per pixel
         int iSkipped = 0;