Support for user access to SSD1306 commands longer than one byte

Author: mzero

Adafruit_SSD1306.cpp

@@ -493,13 +493,58 @@ void Adafruit_SSD1306::Transaction::data(uint8_t byte) { send(false, byte); }
 /*!
     @brief  Issue a single low-level command directly to the SSD1306
             display, bypassing the library.
-    @param  c
+    @param  cmd
+            Command to issue (0x00 to 0xFF, see datasheet).
+    @return None (void).
+*/
+void Adafruit_SSD1306::ssd1306_command(uint8_t cmd) {
+  Transaction trans(*this);
+  trans.command(cmd);
+}
+
+/*!
+    @brief  Issue a two byte low-level command directly to the SSD1306
+            display, bypassing the library.
+    @param  cmd
+            Command to issue (0x00 to 0xFF, see datasheet).
+    @param  a
+            The second byte of the command.
+    @return None (void).
+*/
+void Adafruit_SSD1306::ssd1306_command(uint8_t cmd, uint8_t a) {
+  Transaction trans(*this);
+  trans.command(cmd, a);
+}
+
+/*!
+    @brief  Issue a three byte low-level command directly to the SSD1306
+            display, bypassing the library.
+    @param  cmd
             Command to issue (0x00 to 0xFF, see datasheet).
+    @param  a
+            The second byte of the command.
+    @param  b
+            The third byte of the command.
+    @return None (void).
+*/
+void Adafruit_SSD1306::ssd1306_command(uint8_t cmd, uint8_t a, uint8_t b) {
+  Transaction trans(*this);
+  trans.command(cmd, a, b);
+}
+
+/*!
+    @brief  Issue a multi byte low-level command directly to the SSD1306
+            display, bypassing the library.
+    @param  cmd
+            Pointer to command bytes to issue.
+    @param  n
+            Number of bytes in the command.
     @return None (void).
 */
-void Adafruit_SSD1306::ssd1306_command(uint8_t c) {
+void Adafruit_SSD1306::ssd1306_command(const uint8_t *cmd, uint8_t n) {
   Transaction trans(*this);
-  trans.command(c);
+  while (n--)
+    trans.command(pgm_read_byte(cmd++));
 }
 
 // ALLOCATE & INIT DISPLAY -------------------------------------------------

Adafruit_SSD1306.h

@@ -156,10 +156,15 @@ class Adafruit_SSD1306 : public Adafruit_GFX {
   void startscrolldiagright(uint8_t start, uint8_t stop);
   void startscrolldiagleft(uint8_t start, uint8_t stop);
   void stopscroll(void);
-  void ssd1306_command(uint8_t c);
   bool getPixel(int16_t x, int16_t y);
   uint8_t *getBuffer(void);
 
+  // low level access to SSD1306 commands
+  void ssd1306_command(uint8_t cmd);
+  void ssd1306_command(uint8_t cmd, uint8_t a);
+  void ssd1306_command(uint8_t cmd, uint8_t a, uint8_t b);
+  void ssd1306_command(const uint8_t *cmd, uint8_t n);
+
 private:
   inline void SPIwrite(uint8_t d) __attribute__((always_inline));
   void drawFastHLineInternal(int16_t x, int16_t y, int16_t w, uint16_t color);