NetBurner 3.5.6
PDF Version
qwiic_oled_1in3.h
1// qwiic_oled_1in3.h
2//
3// This is a library written for SparkFun Qwiic OLED boards that use the SSD1306.
4//
5// SparkFun sells these at its website: www.sparkfun.com
6//
7// Do you like this library? Help support SparkFun. Buy a board!
8//
9// Micro OLED https://www.sparkfun.com/products/14532
10// Transparent OLED https://www.sparkfun.com/products/15173
11// "Narrow" OLED https://www.sparkfun.com/products/17153
12// 1.3" OLED https://www.sparkfun.com/products/23453
13//
14//
15// Written by Kirk Benell @ SparkFun Electronics, March 2022
16//
17// This library configures and draws graphics to OLED boards that use the
18// SSD1306 display hardware. The library only supports I2C.
19//
20// Repository:
21// https://github.com/sparkfun/SparkFun_Qwiic_OLED_Arduino_Library
22//
23// Documentation:
24// https://sparkfun.github.io/SparkFun_Qwiic_OLED_Arduino_Library/
25//
26//
27// SparkFun code, firmware, and software is released under the MIT License(http://opensource.org/licenses/MIT).
28//
29// SPDX-License-Identifier: MIT
30//
31// The MIT License (MIT)
32//
33// Copyright (c) 2022 SparkFun Electronics
34// Permission is hereby granted, free of charge, to any person obtaining a copy of this software and
35// associated documentation files (the "Software"), to deal in the Software without restriction,
36// including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense,
37// and/or sell copies of the Software, and to permit persons to whom the Software is furnished to
38// do so, subject to the following conditions:
39// The above copyright notice and this permission notice shall be included in all copies or substantial
40// portions of the Software.
41// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT
42// NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
43// IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
44// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
45// SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
46
47// Implementation for the 1.3" OLED device
48
49#pragma once
50
51#include "qwiic_grssd1306.h"
52
54// Set the defaults for the SparkFun Qwiic MicroOLED
55
56#define kOLED1in3Width 128
57#define kOLED1in3Height 64
58
59#define kOLED1in3XOffset 0
60#define kOLED1in3YOffset 0
61
62// Parameters for this device
63#define kOLED1in3PinConfig 0x12
64#define kOLED1in3PreCharge 0xF1
65#define kOLED1in3VCOM 0x40
66#define kOLED1in3Contrast 0xCF
67
68#define kOLED1in3DefaultAddress 0x3D
69#define kOLED1in3AltAddress 0x3C
70
71class QwOLED1in3 : public QwGrSSD1306 {
72
73public:
74 // Constructor - setup the viewport and default address for this device.
75 QwOLED1in3()
76 : QwGrSSD1306(kOLED1in3XOffset, kOLED1in3YOffset, kOLED1in3Width, kOLED1in3Height)
77 {
78 default_address = kOLED1in3DefaultAddress;
79 };
80
81 // set up the specific device settings
82 bool init(void)
83 {
84
85 setBuffer(m_graphicsBuffer); // The buffer to use
86
87 setCommPins(kOLED1in3PinConfig);
88 setPreCharge(kOLED1in3PreCharge);
89 setVcomDeselect(kOLED1in3VCOM);
90 setContrast(kOLED1in3Contrast);
91
92 // Call the super class to do all the work
93 return this->QwGrSSD1306::init();
94 };
95
96private:
97 // Graphics buffer for this device.
98 uint8_t m_graphicsBuffer[kOLED1in3Width * kOLED1in3Height / 8];
99};