added reset command and ability to control display power -- both need testing

Author: Kirk

src/SparkFun_Qwiic_OLED.h

@@ -162,6 +162,16 @@ class QwiicOLEDBaseClass : public Print { // NOTE: implementing Arduino Print
         return _device.get_height();
     }
 
+    ///////////////////////////////////////////////////////////////////////
+    // reset()
+    //
+    // When called, the system and OLED are reset back to an initial state
+    //
+
+    void reset(void){
+        _device.reset();
+    }
+
     ///////////////////////////////////////////////////////////////////////
     // display()
     //
@@ -322,6 +332,21 @@ class QwiicOLEDBaseClass : public Print { // NOTE: implementing Arduino Print
         _device.scroll(SCROLL_VERT_LEFT, start, stop, interval);
     }
 
+    ///////////////////////////////////////////////////////////////////////
+    // displayPower()
+    //
+    // Used to turn the OLED display on an off. 
+    //
+    // Default value is on.
+    //
+    // Parameter    Description
+    // ---------    -----------------------------
+    // enable       Turn the display on or off - default is on
+
+    void displayPower(bool enable=true){
+
+        _device.display_power(enable);
+    }
     ///////////////////////////////////////////////////////////////////////
     // setFont()
     //

src/qwiic_grssd1306.cpp

@@ -241,31 +241,8 @@ bool QwGrSSD1306::init(void)
     if(!this->QwGrBufferDevice::init())
         return false; // something isn't right
 
-    // Start the device setup - sending commands to device. See command defs in header, and
-    // device datasheet
-    send_dev_command(kCmdDisplayOff);
-
-    send_dev_command(kCmdSetDisplayClockDiv, 0x80);
-    send_dev_command(kCmdSetMultiplex, _viewport.height - 1);
-    send_dev_command(kCmdSetDisplayOffset, 0x0);
-
-    send_dev_command(kCmdSetStartLine | 0x0);
-    send_dev_command(kCmdChargePump, 0x14);
-    send_dev_command(kCmdMemoryMode, 0b10); // Page Addressing mode - see data sheet
-
-    send_dev_command(kCmdNormalDisplay);
-    send_dev_command(kCmdDisplayAllOnResume);
-    send_dev_command(kCmdSegRemap | 0x1);
-
-    send_dev_command(kCmdComScanDec);
-    send_dev_command(kCmdSetComPins, _initHWComPins);
-    send_dev_command(kCmdSetContrast, _initContrast);
-
-    send_dev_command(kCmdSetPreCharge, _initPreCharge);
-    send_dev_command(kCmdSetVComDeselect, _initVCOMDeselect);
-    send_dev_command(kCmdDeactivateScroll);
-
-    send_dev_command(kCmdDisplayOn);
+    // setup the oled device
+    setup_oled_device();
 
     // Finish up setting up this object
 
@@ -279,6 +256,33 @@ bool QwGrSSD1306::init(void)
 
     return true;
 }
+
+////////////////////////////////////////////////////////////////////////////////////
+// reset()
+//
+// Return the OLED system to its initial state
+//
+// Returns true on success, false on failure
+
+bool QwGrSSD1306::reset(void){
+
+    // If we are not in an init state, just call init
+    if(!_isInit)
+        return init();
+
+    // is the device connected?
+    if(!_i2cBus->ping(_i2c_address))
+        return false;
+
+    // setup oled
+    setup_oled_device();
+
+    // Init internal/drawing buffers and device screen buffer
+
+    init_buffers();
+
+    return true;
+}
 ////////////////////////////////////////////////////////////////////////////////////
 // Configuration API
 //
@@ -310,6 +314,41 @@ void QwGrSSD1306::set_contrast(uint8_t contrast){
         send_dev_command(kCmdSetContrast, contrast);
 }
 
+////////////////////////////////////////////////////////////////////////////////////
+// setup_oled_device()
+//
+// Method sends the init/setup commands to the OLED device, placing 
+// it in a state for use by this driver/library.
+
+void QwGrSSD1306::setup_oled_device(void){
+
+    // Start the device setup - sending commands to device. See command defs in header, and
+    // device datasheet
+    send_dev_command(kCmdDisplayOff);
+
+    send_dev_command(kCmdSetDisplayClockDiv, 0x80);
+    send_dev_command(kCmdSetMultiplex, _viewport.height - 1);
+    send_dev_command(kCmdSetDisplayOffset, 0x0);
+
+    send_dev_command(kCmdSetStartLine | 0x0);
+    send_dev_command(kCmdChargePump, 0x14);
+    send_dev_command(kCmdMemoryMode, 0b10); // Page Addressing mode - see data sheet
+
+    send_dev_command(kCmdNormalDisplay);
+    send_dev_command(kCmdDisplayAllOnResume);
+    send_dev_command(kCmdSegRemap | 0x1);
+
+    send_dev_command(kCmdComScanDec);
+    send_dev_command(kCmdSetComPins, _initHWComPins);
+    send_dev_command(kCmdSetContrast, _initContrast);
+
+    send_dev_command(kCmdSetPreCharge, _initPreCharge);
+    send_dev_command(kCmdSetVComDeselect, _initVCOMDeselect);
+    send_dev_command(kCmdDeactivateScroll);
+
+    send_dev_command(kCmdDisplayOn);
+
+}
 ////////////////////////////////////////////////////////////////////////////////////
 // set_comm_bus()
 //
@@ -508,6 +547,19 @@ void QwGrSSD1306::scroll(uint16_t scroll_type, uint8_t start, uint8_t stop, uint
     send_dev_command(kCmdActivateScroll);
 }
 
+////////////////////////////////////////////////////////////////////////////////////
+// display_power()
+//
+// Used to set the power of the screen.
+
+void QwGrSSD1306::display_power(bool enable){
+
+
+    if(!_isInit)
+        return;
+
+    send_dev_command( (enable ? kCmdDisplayOn : kCmdDisplayOff));
+}
 ////////////////////////////////////////////////////////////////////////////////////
 // Drawing Methods
 ////////////////////////////////////////////////////////////////////////////////////

src/qwiic_grssd1306.h

@@ -167,6 +167,7 @@ class QwGrSSD1306 : public QwGrBufferDevice {
     // Device setup
     virtual bool init(void);
     bool is_initialized(void) { return _isInit; };
+    bool reset(void);
 
     // method to set the communication bus this object should use
     void set_comm_bus(QwI2C &theBus, uint8_t id_bus);
@@ -196,6 +197,8 @@ class QwGrSSD1306 : public QwGrBufferDevice {
     void scroll_stop(void);
     void scroll(uint16_t scroll_type, uint8_t start, uint8_t stop, uint8_t interval = SCROLL_INTERVAL_2_FRAMES);
 
+    void display_power(bool enable=true);
+
 protected:
     // Subclasses of this class define the specifics of the device, including size.
     // Subclass needs to define the graphics buffer array - stack based - and pass in
@@ -231,6 +234,7 @@ class QwGrSSD1306 : public QwGrBufferDevice {
     void init_buffers(void); // clear graphics and screen buffer
     void clear_screen_buffer(void);
     void resend_graphics(void);
+    void setup_oled_device(void);
 
     // device communication methods
     void send_dev_command(uint8_t command);