Diff: OLED_info.h

Revision:

0:f70b1d60f794

--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/OLED_info.h	Wed Mar 15 19:14:55 2017 +0000
@@ -0,0 +1,288 @@
+/** OLED Screen Info  
+ *  This file contains OLED screen SSD1351-related defines and macros. 
+ * 
+ * Redistribution and use in source and binary forms, with or without modification,
+ * are permitted provided that the following conditions are met:
+ *
+ * Redistributions of source code must retain the above copyright notice, this list
+ * of conditions and the following disclaimer.
+ *
+ * Redistributions in binary form must reproduce the above copyright notice, this
+ * list of conditions and the following disclaimer in the documentation and/or
+ * other materials provided with the distribution.
+ *
+ * Neither the name of NXP, nor the names of its
+ * contributors may be used to endorse or promote products derived from this
+ * software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
+ * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+ * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+ * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR
+ * ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
+ * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+ * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
+ * ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+ * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+ * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ *
+ * visit: http://www.mikroe.com and http://www.nxp.com
+ *
+ * get support at: http://www.mikroe.com/forum and https://community.nxp.com
+ *
+ * Project HEXIWEAR, 2015
+ */
+ 
+#ifndef HG_OLED_INFO
+#define HG_OLED_INFO
+
+// command byte number
+#define CMD_BYTE (1)
+#define DATA_BYTE (0)
+
+#define OLED_COLUMN_OFFSET (16)
+#define OLED_ROW_OFFSET    (0)
+
+#define OLED_SCREEN_WIDTH  (96)
+#define OLED_SCREEN_HEIGHT (96)
+
+#define OLED_SCREEN_WIDTH_END  ( (OLED_SCREEN_WIDTH-1)  + OLED_COLUMN_OFFSET )
+#define OLED_SCREEN_HEIGHT_END ( (OLED_SCREEN_HEIGHT-1) + OLED_ROW_OFFSET )
+
+#define OLED_BYTES_PER_PIXEL ( 2 )
+
+#define OLED_TRANSITION_STEP    ( 1 )
+#define OLED_ACTION_DCON  ( 0xFE )
+#define OLED_ACTION_DCOFF ( 0xFF )
+
+#define OLED_CHAR_WIDTH_AUTO  ( 0xFF )
+#define OLED_CHAR_WIDTH_MAX   ( 0xFE )
+#define OLED_CHAR_WIDTH_NUM   ( 0xFD )
+#define OLED_CHAR_WIDTH_KEEP  ( 0xFC )
+#define OLED_CHAR_HEIGHT_AUTO ( 0xFB )
+#define OLED_CHAR_HEIGHT_KEEP ( 0xFA )
+
+#define OLED_SCREEN_SIZE ( OLED_SCREEN_WIDTH * OLED_SCREEN_HEIGHT )
+#define OLED_GRAM_SIZE ( OLED_SCREEN_WIDTH * OLED_SCREEN_HEIGHT * OLED_BYTES_PER_PIXEL )
+
+#define OLED_TEXT_HALIGN_SHIFT ( 0 )
+#define OLED_TEXT_HALIGN_MASK  ( 0x03 << OLED_TEXT_HALIGN_SHIFT )
+
+#define OLED_TEXT_VALIGN_SHIFT ( 4 )
+#define OLED_TEXT_VALIGN_MASK  ( 0x03 << OLED_TEXT_VALIGN_SHIFT )
+
+#define BMP_HEADER_BYTE_SIZE (6)
+
+
+
+/**
+ * remap settings
+ */
+
+#define REMAP_HORIZONTAL_INCREMENT ( 0 )
+#define REMAP_VERTICAL_INCREMENT   ( 1 << 0 )
+
+#define REMAP_COLUMNS_LEFT_TO_RIGHT ( 0 )
+#define REMAP_COLUMNS_RIGHT_TO_LEFT ( 1 << 1 )
+
+#define REMAP_ORDER_ABC ( 0 )
+#define REMAP_ORDER_CBA ( 1 << 2 )
+
+#define REMAP_SCAN_UP_TO_DOWN ( 0 )
+#define REMAP_SCAN_DOWN_TO_UP ( 1 << 4 )
+
+#define REMAP_COM_SPLIT_ODD_EVEN_DIS ( 0 )
+#define REMAP_COM_SPLIT_ODD_EVEN_EN  ( 1 << 5 )
+
+#define REMAP_COLOR_RGB565 ( 1 << 6 )
+
+#define OLED_REMAP_SETTINGS ( REMAP_ORDER_ABC | REMAP_COM_SPLIT_ODD_EVEN_EN | REMAP_COLOR_RGB565 | REMAP_COLUMNS_LEFT_TO_RIGHT | REMAP_SCAN_UP_TO_DOWN | REMAP_HORIZONTAL_INCREMENT )
+
+/**
+ * macros
+ */
+
+#define OLED_SwapMe(x) x = ( ( x & 0xFF00 ) >> 8 ) | ( ( x & 0x00FF ) << 8 )
+#define OLED_AdjustRowOffset(y)    y += OLED_ROW_OFFSET
+#define OLED_AdjustColumnOffset(x) x += OLED_COLUMN_OFFSET
+
+#define BMP_SkipHeader( imgPtr ) ( (const uint8_t*)(imgPtr) + BMP_HEADER_BYTE_SIZE )
+
+
+#define CheckLimits( x, y, w, h ) ( ( ( x + w - 1 ) > OLED_SCREEN_WIDTH ) || ( x < 0 ) || ( ( y + h - 1 ) > OLED_SCREEN_HEIGHT ) || ( y < 0 ) )
+#define AreCoordsValid( x, y, w, h )    ( 0 == CheckLimits( x, y, w ,h ) )
+#define AreCoordsNotValid( x, y, w, h ) ( 0 != CheckLimits( x, y, w, h ) )
+
+
+/**
+ * set start/end column/row
+ * the 2nd and 3rd byte represent the start and the end address, respectively
+ */
+#define OLED_CMD_SET_COLUMN ( 0x15 )
+#define OLED_CMD_SET_ROW    ( 0x75 )
+
+/**
+ * scanning direction
+ */
+
+#define OLED_DIRECTION_HORIZONTAL (0)
+#define OLED_DIRECTION_VERTICAL   (1)
+
+/**
+ * SPI-related
+ */
+
+#define OLED_SPI_CHUNK (511)
+
+/**
+ * set display
+ */
+#define OLED_CMD_SET_DISPLAY_MODE_ALL_OFF (0xA4)
+#define OLED_CMD_SET_DISPLAY_MODE_ALL_ON  (0xA5)
+#define OLED_CMD_SET_DISPLAY_MODE_NORMAL  (0xA6)
+#define OLED_CMD_SET_DISPLAY_MODE_INVERSE (0xA7)
+
+/**
+ * set lock command
+ * the locked OLED driver MCU interface prohibits all commands
+ * and memory access, except the 0xFD command
+ */
+#define OLED_CMD_SET_CMD_LOCK ( 0xFD /* << 8 */ )
+// unlock OLED driver MCU interface for entering command (default upon reset)
+#define OLED_UNLOCK           (0x12)
+// lock OLED driver MCU interface for entering command
+#define OLED_LOCK             (0x16)
+// commands 0xA2, 0xB1, 0xB3, 0xBB, 0xBE, 0xC1 are inaccessible in both lock and unlock state (default upon reset)
+#define OLED_ACC_TO_CMD_NO    (0xB0)
+// commands 0xA2, 0xB1, 0xB3, 0xBB, 0xBE, 0xC1 are accessible in unlock state
+#define OLED_ACC_TO_CMD_YES   (0xB1)
+
+/**
+ * NOP
+ */
+#define OLED_CMD_NOP (0xD1) // also, 0xE3
+
+/**
+ * set MUX ratio
+ */
+#define OLED_CMD_SET_MUX_RATIO (0xCA)
+
+/**
+ * set re-map / color depth
+ */
+#define OLED_CMD_SET_REMAP ( 0xA0 )
+
+// set horisontal or vertical increment
+#define OLED_ADDR_INC_HOR (0x00)
+#define OLED_ADDR_INC_VER (0x01)
+
+// column address mapping
+#define OLED_COLUMN_ADDR_REMAP_0_TO_SEG0   (0x00)
+#define OLED_COLUMN_ADDR_REMAP_127_TO_SEG0 (0x02)
+
+// color sequence order
+#define OLED_COLOR_SEQ_A_B_C (0x00)
+#define OLED_COLOR_SEQ_C_B_A (0x04)
+
+// scanning order (MR == MUX ratio)
+#define OLED_SCAN_FROM_COM_0_TO_MR (0x00)
+#define OLED_SCAN_FROM_COM_MR_TO_0 (0x10)
+
+// COM splitting to odd and even
+#define OLED_COM_SPLIT_DISABLE (0x00)
+#define OLED_COM_SPLIT_ENABLE  (0x20)
+
+// screen color depth
+#define OLED_COLOR_DEPTH_256    (0x00)
+#define OLED_COLOR_DEPTH_65K    (0x40)
+#define OLED_COLOR_DEPTH_262K_1 (0x80)
+#define OLED_COLOR_DEPTH_262K_2 (0xC0)
+
+/**
+ * set reset (phase 1) / pre-charge (phase 2) period in [DCLK]
+ * this command is locked by command 0xFD by default
+ */
+#define OLED_CMD_SET_RESET_AND_PRECHARGE_PERIOD (0xB1)
+
+#define OLED_RESET_PERIOD_5  (0x02)
+#define OLED_RESET_PERIOD_7  (0x03)
+#define OLED_RESET_PERIOD_9  (0x04)
+#define OLED_RESET_PERIOD_11 (0x05)
+#define OLED_RESET_PERIOD_13 (0x06)
+#define OLED_RESET_PERIOD_15 (0x07)
+#define OLED_RESET_PERIOD_17 (0x08)
+#define OLED_RESET_PERIOD_19 (0x09)
+#define OLED_RESET_PERIOD_21 (0x0A)
+#define OLED_RESET_PERIOD_23 (0x0B)
+#define OLED_RESET_PERIOD_25 (0x0C)
+#define OLED_RESET_PERIOD_27 (0x0D)
+#define OLED_RESET_PERIOD_29 (0x0E)
+#define OLED_RESET_PERIOD_31 (0x0F)
+
+#define OLED_PRECHARGE_PERIOD_3  (0x03)
+#define OLED_PRECHARGE_PERIOD_4  (0x04)
+#define OLED_PRECHARGE_PERIOD_5  (0x05)
+#define OLED_PRECHARGE_PERIOD_6  (0x06)
+#define OLED_PRECHARGE_PERIOD_7  (0x07)
+#define OLED_PRECHARGE_PERIOD_8  (0x08)
+#define OLED_PRECHARGE_PERIOD_9  (0x09)
+#define OLED_PRECHARGE_PERIOD_10 (0x0A)
+#define OLED_PRECHARGE_PERIOD_11 (0x0B)
+#define OLED_PRECHARGE_PERIOD_12 (0x0C)
+#define OLED_PRECHARGE_PERIOD_13 (0x0D)
+#define OLED_PRECHARGE_PERIOD_14 (0x0E)
+#define OLED_PRECHARGE_PERIOD_15 (0x0F)
+
+/**
+ * set front clock divider (divset) / oscillator frequency
+ * this command is locked by command 0xFD by default
+ */
+#define OLED_CMD_SET_OSC_FREQ_AND_CLOCKDIV (0xB3)
+
+// clock divider
+#define OLED_CLOCKDIV_1    (0x00)
+#define OLED_CLOCKDIV_2    (0x01)
+#define OLED_CLOCKDIV_4    (0x02)
+#define OLED_CLOCKDIV_8    (0x03)
+#define OLED_CLOCKDIV_16   (0x04)
+#define OLED_CLOCKDIV_32   (0x05)
+#define OLED_CLOCKDIV_64   (0x06)
+#define OLED_CLOCKDIV_128  (0x07)
+#define OLED_CLOCKDIV_256  (0x08)
+#define OLED_CLOCKDIV_512  (0x09)
+#define OLED_CLOCKDIV_1024 (0x0A)
+
+// oscillator frequency, frequency increases as level increases
+#define OLED_OSC_FREQ (0xB0)
+
+#define OLED_CMD_STARTLINE (0xA1)
+
+#define OLED_CMD_WRITERAM       (0x5C)
+#define OLED_CMD_READRAM        (0x5D)
+#define OLED_CMD_DISPLAYOFFSET  (0xA2)
+#define OLED_CMD_DISPLAYALLOFF  (0xA4)
+#define OLED_CMD_DISPLAYALLON   (0xA5)
+#define OLED_CMD_NORMALDISPLAY  (0xA6)
+#define OLED_CMD_INVERTDISPLAY  (0xA7)
+#define OLED_CMD_FUNCTIONSELECT (0xAB)
+#define OLED_CMD_DISPLAYOFF     (0xAE)
+#define OLED_CMD_DISPLAYON      (0xAF)
+#define OLED_CMD_PRECHARGE      (0xB1)
+#define OLED_CMD_DISPLAYENHANCE (0xB2)
+#define OLED_CMD_SETVSL         (0xB4)
+#define OLED_CMD_SETGPIO        (0xB5)
+#define OLED_CMD_PRECHARGE2     (0xB6)
+#define OLED_CMD_SETGRAY        (0xB8)
+#define OLED_CMD_USELUT         (0xB9)
+#define OLED_CMD_PRECHARGELEVEL (0xBB)
+#define OLED_CMD_VCOMH          (0xBE)
+#define OLED_CMD_CONTRASTABC    (0xC1)
+#define OLED_CMD_CONTRASTMASTER (0xC7)
+#define OLED_CMD_MUXRATIO       (0xCA)
+#define OLED_CMD_COMMANDLOCK    (0xFD)
+#define OLED_CMD_HORIZSCROLL    (0x96)
+#define OLED_CMD_STOPSCROLL     (0x9E)
+#define OLED_CMD_STARTSCROLL    (0x9F)
+
+#endif
+