added checkComm() function to communicate with host PC

MicroView.cpp

@@ -17,6 +17,9 @@
 
 // Change the total fonts included
 #define TOTALFONTS		7
+#define recvLEN			100
+char serInStr[recvLEN];		// TODO - need to fix a value so that this will not take up too much memory.
+uint8_t serCmd[recvLEN];
 
 // Add the font name as declared in the header file.  Remove as many as possible to get conserve FLASH memory.
 const unsigned char *MicroView::fontsPointer[]={
@@ -157,6 +160,7 @@ void MicroView::begin() {
 
 	command(DISPLAYON);				//--turn on oled panel
 	clear(ALL);						// Erase hardware memory inside the OLED controller to avoid random data in memory.
+	Serial.begin(115200);
 }
 
 void MicroView::command(uint8_t c) {
@@ -233,6 +237,18 @@ void MicroView::clear(uint8_t mode, uint8_t c) {
 	}	
 }
 
+void MicroView::invert(boolean inv) {
+	if (inv)
+	command(INVERTDISPLAY);
+	else
+	command(NORMALDISPLAY);
+}
+
+void MicroView::contrast(uint8_t contrast) {
+	command(SETCONTRAST);			// 0x81
+	command(contrast);
+}
+
 // This routine is to transfer the page buffer to the LCD controller's memory.
 void MicroView::display(void) {
 	uint8_t i, j;
@@ -633,14 +649,14 @@ size_t MicroView::write(uint8_t c) {
 
 	}
 
-	void MicroView::stopScroll(void){
+	void MicroView::scrollStop(void){
 		command(DEACTIVATESCROLL);
 	}
 
 	void MicroView::scrollRight(uint8_t start, uint8_t stop){
 		if (stop<start)		// stop must be larger or equal to start
 		return;
-		stopScroll();		// need to disable scrolling before starting to avoid memory corrupt
+		scrollStop();		// need to disable scrolling before starting to avoid memory corrupt
 		command(RIGHTHORIZONTALSCROLL);
 		command(0x00);
 		command(start);
@@ -650,21 +666,273 @@ size_t MicroView::write(uint8_t c) {
 		command(0xFF);
 		command(ACTIVATESCROLL);
 	}
+	
+	void MicroView::doCmd(uint8_t cmdCount) {
+		// decode command
+		switch (serCmd[0]) {
+		case CMD_CLEAR: {
+			Serial.println("clear");
+			if (cmdCount==1) {
+				clear(serCmd[1]);
+			} else if (cmdCount==2) {
+				clear(serCmd[1], serCmd[2]);
+			}
+			break;
+		}
+		
+		case CMD_INVERT: {
+			Serial.println("invert");
+			if (cmdCount==1) {
+				invert(serCmd[1]);
+			}
+			break;
+		}
+		
+		case CMD_CONTRAST: {
+			Serial.println("contrast");
+			if (cmdCount==1) {
+				contrast(serCmd[1]);
+			}
+			break;
+		}
+		
+		case CMD_DISPLAY: {
+			Serial.println("display");
+			if (cmdCount==0) {
+				display();
+			}
+			break;
+		}
+		
+		case CMD_SETCURSOR: {
+			Serial.println("setCursor");
+			if (cmdCount==2) {
+				setCursor(serCmd[1], serCmd[2]);
+			}
+			break;
+		}
+		
+		case CMD_PIXEL: {
+			Serial.println("pixel");
+			if (cmdCount==2) {
+				pixel(serCmd[1],serCmd[2]);
+				display();
+			} else if (cmdCount=4) {
+				pixel(serCmd[1],serCmd[2],serCmd[3],serCmd[4]);
+				display();
+			}
+			break;
+		}
+		
+		case CMD_LINE: {
+			Serial.println("line");
+			if (cmdCount==4) {
+				line(serCmd[1],serCmd[2],serCmd[3],serCmd[4]);
+				display();
+			} else if (cmdCount==6) {
+				line(serCmd[1],serCmd[2],serCmd[3],serCmd[4],serCmd[5],serCmd[6]);
+				display();
+			}
+			break;
+		}
 
+		case CMD_LINEH: {
+			Serial.println("lineH");
+			if (cmdCount==3) {
+				lineH(serCmd[1], serCmd[2], serCmd[3]);
+				display();
+			} else if (cmdCount==5) {
+				lineH(serCmd[1], serCmd[2], serCmd[3], serCmd[4], serCmd[5]);
+				display();
+			}
+			break;
+		}
+		
+		case CMD_LINEV: {
+			Serial.println("lineV");
+			if (cmdCount==3) {
+				lineV(serCmd[1], serCmd[2], serCmd[3]);
+				display();
+			} else if (cmdCount==5) {
+				lineV(serCmd[1], serCmd[2], serCmd[3], serCmd[4], serCmd[5]);
+				display();
+			}
+			break;
+		}
+		
+		case CMD_RECT: {
+			Serial.println("rect");
+			if (cmdCount==4) {
+				rect(serCmd[1], serCmd[2], serCmd[3], serCmd[4]);
+				display();
+			} else if (cmdCount==6) {
+				rect(serCmd[1], serCmd[2], serCmd[3], serCmd[4], serCmd[5], serCmd[6]);
+				display();
+			}
+			break;
+		}
+
+		case CMD_RECTFILL: {
+			Serial.println("rectFill");
+			if (cmdCount==4) {
+				rectFill(serCmd[1], serCmd[2], serCmd[3], serCmd[4]);
+				display();
+			} else if (cmdCount==6) {
+				rectFill(serCmd[1], serCmd[2], serCmd[3], serCmd[4], serCmd[5], serCmd[6]);
+				display();
+			}
+			break;
+			
+		}
+		
+		case CMD_CIRCLE: {
+			Serial.println("circle");
+			if (cmdCount==3) {
+				circle(serCmd[1], serCmd[2], serCmd[3]);
+				display();
+			} else if (cmdCount==5) {
+				circle(serCmd[1], serCmd[2], serCmd[3], serCmd[4], serCmd[5]);
+				display();
+			}
+			break;
+		}
+
+		case CMD_CIRCLEFILL: {
+			Serial.println("circleFill");
+
+			if (cmdCount==3) {
+				circleFill(serCmd[1], serCmd[2], serCmd[3]);
+				display();
+			} else if (cmdCount==5) {
+				circleFill(serCmd[1], serCmd[2], serCmd[3], serCmd[4], serCmd[5]);
+				display();
+			}
+			break;
+		}
+
+		case CMD_DRAWCHAR: {
+			Serial.println("drawChar");
+			if (cmdCount==3) {
+				drawChar(serCmd[1], serCmd[2], serCmd[3]);
+				display();
+			} else if (cmdCount==5) {
+				drawChar(serCmd[1], serCmd[2], serCmd[3], serCmd[4], serCmd[5]);
+				display();
+			}
+			break;
+		}
+
+		case CMD_DRAWBITMAP: {
+			// TODO
+			
+			break;
+		}
+		
+		case CMD_GETLCDWIDTH: {
+			Serial.println("getLCDWidth");
+			
+			if (cmdCount==0) {
+				Serial.println(getLCDWidth());
+			}
+			break;
+		}
+		
+		case CMD_GETLCDHEIGHT: {
+			Serial.println("getLCDHeight");
+			if (cmdCount==0) {
+				Serial.println(getLCDHeight());
+			}
+			break;
+		}
+		
+		case CMD_SETCOLOR: {
+			Serial.println("setColor");
+			if (cmdCount==1) {
+				setColor(serCmd[1]);
+			}
+			break;
+		}
+		
+		case CMD_SETDRAWMODE: {
+			Serial.println("drawMode");
+			if (cmdCount==1) {
+				setDrawMode(serCmd[1]);
+			}
+			break;
+			
+		}
+		default:
+			break;
+		}
+	}
+	
+	void MicroView::checkComm(void) {
+		int count = readSerial();
+		char *result;
+		uint8_t index=0;
+		int temp;
+		
+		if (count>0) {
+			// process Serial data
+			result=strtok(serInStr,",");
+			if (result !=NULL) {
+				temp=atoi(result);
+				serCmd[index]=(uint8_t)temp & 0xff;		// we only need 8 bit number
+				index++;
+				for (uint8_t i;i<recvLEN;i++) {
+					result=strtok(NULL,",");
+					if (result != NULL) {
+						
+						temp=atoi(result);
+						serCmd[index]=(uint8_t)temp & 0xff;		// we only need 8 bit number
+						index++;
+					}
+					else {
+						break;
+					}
+				}
+/*
+				// debug output
+				Serial.print("command received=");
+				Serial.println(index);
+				for (uint8_t i=0;i<index;i++) {
+					Serial.println(serCmd[i]);
+				}
+*/
+			}
+			doCmd(index-1);	// index-1 is the total parameters count of a command
+		}
+	}
+
+	int MicroView::readSerial(void)
+	{
+		int i=0;
+		if(!Serial.available())
+		return -1;
+
+		while (Serial.available()>0)
+		{
+			if( i < recvLEN)
+			{
+				serInStr[i++] = Serial.read();
+				delay(2);
+			}
+			else
+			break;	
+		}
+		serInStr[i]='\0';
+		return i;
+	}
+
+	// -------------------------------------------------------------------------------------
+	// MicroViewWidget Class - start
+	// -------------------------------------------------------------------------------------
 	MicroViewWidget::MicroViewWidget(uint8_t newx, uint8_t newy, int16_t min, int16_t max) {
 		setX(newx);
 		setY(newy);
 		value=0;
-		//		if (min>max) {
-		//			setMinValue(max);
-		//			setMaxValue(min);
-		//		}
-		//		else {
 		setMinValue(min);
 		setMaxValue(max);
-		//		}
-		//drawFace();
-		//setValue(min);
 	}
 
 	uint8_t MicroViewWidget::getX() { return x; }
@@ -679,12 +947,17 @@ size_t MicroView::write(uint8_t c) {
 
 	void MicroViewWidget::setMinValue(int16_t min) { minValue=min; }
 	void MicroViewWidget::setMaxValue(int16_t max) { maxValue=max; }
+
 	void MicroViewWidget::setValue(int16_t val) { 
-		if (val<=maxValue) { 
+		if ((val<=maxValue) && (val>=minValue)){ 
 			value=val; 
 			this->draw();
 		}
 	}
+	
+	// -------------------------------------------------------------------------------------
+	// MicroViewWidget Class - end
+	// -------------------------------------------------------------------------------------
 
 	// -------------------------------------------------------------------------------------
 	// Slider Widget - start
@@ -823,7 +1096,6 @@ size_t MicroView::write(uint8_t c) {
 		draw();
 	}
 
-
 	void MicroViewGauge::drawFace() {
 		uint8_t offsetX, offsetY, majorLine;
 		float degreeSec, fromSecX, fromSecY, toSecX, toSecY;

MicroView.h

@@ -64,6 +64,28 @@
 #define VERTICALRIGHTHORIZONTALSCROLL	0x29
 #define VERTICALLEFTHORIZONTALSCROLL	0x2A
 
+typedef enum CMD {
+	CMD_CLEAR,			//0
+	CMD_INVERT,			//1
+	CMD_CONTRAST,		//2
+	CMD_DISPLAY,		//3
+	CMD_SETCURSOR,		//4
+	CMD_PIXEL,			//5
+	CMD_LINE,			//6
+	CMD_LINEH,			//7
+	CMD_LINEV,			//8
+	CMD_RECT,			//9
+	CMD_RECTFILL,		//10
+	CMD_CIRCLE,			//11
+	CMD_CIRCLEFILL,		//12
+	CMD_DRAWCHAR,		//13
+	CMD_DRAWBITMAP,		//14
+	CMD_GETLCDWIDTH,	//15
+	CMD_GETLCDHEIGHT,	//16
+	CMD_SETCOLOR,		//17
+	CMD_SETDRAWMODE		//18
+} commCommand_t;
+
 class MicroView : public Print{
 public:
 	MicroView(void) {};
@@ -81,10 +103,11 @@ public:
 	void setColumnAddress(uint8_t add);
 	void setPageAddress(uint8_t add);
 	
-	// LCD Draw functions	
+	// LCD Draw functions
 	void clear(uint8_t mode);
 	void clear(uint8_t mode, uint8_t c);
-	void invert(uint8_t i);
+	void invert(boolean inv);
+	void contrast(uint8_t contrast);
 	void display(void);
 	void setCursor(uint8_t x, uint8_t y);
 	void pixel(uint8_t x, uint8_t y);
@@ -125,7 +148,11 @@ public:
 	void scrollLeft(uint8_t start, uint8_t stop);
 	void scrollVertRight(uint8_t start, uint8_t stop);
 	void scrollVertLeft(uint8_t start, uint8_t stop);
-	void stopScroll(void);
+	void scrollStop(void);
+	
+	// Communication
+	void checkComm(void);
+	void doCmd(uint8_t index);
 	
 private:
 	//uint8_t cs;
@@ -135,6 +162,8 @@ private:
 	uint16_t fontMapWidth;
 	//unsigned char *fontsPointer[TOTALFONTS];
 	static const unsigned char *fontsPointer[];
+	
+	int readSerial(void);
 };
 
 class MicroViewWidget {

README.md

@@ -16,7 +16,7 @@ Arduino library for MicroView.
 2. Start Arduino IDE.
 3. MicroView example is located at, File--->Example--->MicroView--->MicroViewDemo
 
-### Example 1
+### Example 1 - Hello World!
 <pre><code>
 #include &lt;MicroView.h&gt;
 
@@ -30,7 +30,7 @@ void loop() {
 }
 </code></pre>
 
-### Example 2
+### Example 2 - Basic Drawing
 <pre><code>
 #include &lt;MicroView.h&gt;
 
@@ -50,7 +50,7 @@ void loop() {
 }
 </code></pre>
 
-### Example 3
+### Example 3 - Widgets
 <pre><code>
 #include &lt;MicroView.h&gt;
 
@@ -72,8 +72,29 @@ void loop() {
 }
 </code></pre>
 
+### Example 4 - Communication
+<pre><code>
+#include &lt;MicroView.h&gt;
+
+void setup() {
+  uView.begin();
+  uView.clear(PAGE);
+}
+
+void loop() {
+  uView.checkComm();
+}
+</code></pre>
+
 ## History
-**v1.06b:  by JP Liew**
+**v1.07b: 15th February by JP Liew**
+* changed function name stopScroll to scrollStop for consistency
+* added contrast function
+* added invert function
+* added KEYWORD to keywords.txt
+* added checkComm() function to communicate with host PC
+
+**v1.06b: 9th February by JP Liew**
 * fixed Slider negative value not working
 * added round Gauge widget
 * changed Example 3 to show round Gauge

examples/MicroViewDemo/MicroViewDemo.ino

@@ -1,18 +1,17 @@
 #include <MicroView.h>
 #include <Time.h>
 
-//#define PI 3.141592654
 #define clocksize 24
 
-uint8_t onDelay=5;		// This is the on delay in milliseconds, if there is no on delay, the erase will be too fast to clean up the screen.
+uint8_t onDelay=5;		// this is the on delay in milliseconds, if there is no on delay, the erase will be too fast to clean up the screen.
 
 void setup() {
-	uView.begin();		// Begin of MicroView
-	uView.clear(ALL);	// Erase hardware memory inside the OLED controller
-	uView.display();	// Display the content in the buffer memory, by default it is the MicroView logo
+	uView.begin();		// begin of MicroView
+	uView.clear(ALL);	// erase hardware memory inside the OLED controller
+	uView.display();	// display the content in the buffer memory, by default it is the MicroView logo
 	setTime(10,10,01,17,1,2014);
 	delay(500);
-	uView.clear(PAGE);	// Erase the memory buffer, when next uView.display() is called, the OLED will be cleared.
+	uView.clear(PAGE);	// erase the memory buffer, when next uView.display() is called, the OLED will be cleared.
 }
 
 void loop() {
@@ -261,8 +260,6 @@ void loop() {
 		}
 	}
 	uView.clear(PAGE);
-	
-	
 }
 
 

examples/MicroViewSlider/MicroViewSlider.ino

@@ -1,39 +1,30 @@
-#include <SPI.h>
-#include <MicroView.h>
-
-MicroViewWidget *widget[4];
-
-void setup() {
-
-	widget[0] = new MicroViewSlider(0,0,0,100);
-	widget[1] = new MicroViewSlider(0,10,0,150);
-	widget[2] = new MicroViewSlider(0,20,0,50);
-	widget[3] = new MicroViewSlider(0,30,0,200);
-	Serial.begin(115200);
-	Serial.println("start");
-	uView.begin();
-	uView.clear(PAGE);
-	widget[0]->draw();
-	widget[1]->draw();
-	widget[2]->draw();
-	widget[3]->draw();
-}
-
-void loop() {
-	for (int i=0;i<101;i++) {
-		widget[0]->setValue(i);
-		widget[1]->setValue(100-i);
-		widget[2]->setValue(i);
-		widget[3]->setValue(100-i);
-		uView.display();
-	}
-	
-	for(int i=100; i>-1;i--) {
-		widget[0]->setValue(i);
-		widget[1]->setValue(100-i);
-		widget[2]->setValue(i);
-		widget[3]->setValue(100-i);
-		uView.display();
-	}
-	
+#include <MicroView.h>
+
+MicroViewWidget *widget[4];		// declaring an array of 4 MicroViewWidget
+
+void setup() {
+	uView.begin();		// init and start MicroView
+	uView.clear(PAGE);	// erase the memory buffer, when next uView.display() is called, the OLED will be cleared.
+	widget[0] = new MicroViewSlider(0,0,0,100);		// declare widget0 as a Slider at x=0, y=0, min=0, max=100
+	widget[1] = new MicroViewSlider(0,10,0,150);	// declare widget0 as a Slider at x=0, y=10, min=0, max=150
+	widget[2] = new MicroViewSlider(0,20,0,50);		// declare widget0 as a Slider at x=0, y=20, min=0, max=50
+	widget[3] = new MicroViewSlider(0,30,0,200);	// declare widget0 as a Slider at x=0, y=30, min=0, max=200
+}
+
+void loop() {
+	for (int i=0;i<=100;i++) {
+		widget[0]->setValue(i);		// set value i to widget0
+		widget[1]->setValue(100-i);
+		widget[2]->setValue(i);
+		widget[3]->setValue(100-i);
+		uView.display();
+	}
+
+	for(int i=100; i>=0;i--) {
+		widget[0]->setValue(i);
+		widget[1]->setValue(100-i);
+		widget[2]->setValue(i);
+		widget[3]->setValue(100-i);
+		uView.display();
+	}
 }

keywords.txt

@@ -7,18 +7,73 @@
 #######################################
 
 MICROVIEW	KEYWORD1
+uView	KEYWORD1
+MicroViewWidget	KEYWORD1
+MicroViewSlider	KEYWORD1
+MicroViewGauge	KEYWORD1
 
 #######################################
 # Methods and Functions (KEYWORD2)
 #######################################
 
 begin	KEYWORD2
+invert	KEYWORD2
 clear	KEYWORD2
-home	KEYWORD2
+invert	KEYWORD2
+contrast	KEYWORD2
 display	KEYWORD2
+setCursor	KEYWORD2
+pixel	KEYWORD2
+line	KEYWORD2
+lineH	KEYWORD2
+lineV	KEYWORD2
+rect	KEYWORD2
+rectFill	KEYWORD2
+circle	KEYWORD2
+circleFill	KEYWORD2
+drawChar	KEYWORD2
+getLCDWidth	KEYWORD2
+getLCDHeight	KEYWORD2
+setColor	KEYWORD2
+setDrawMode	KEYWORD2
+getFontWidth	KEYWORD2
+getFontHeight	KEYWORD2
+getTotalFonts	KEYWORD2
+getFontType	KEYWORD2
+setFontType	KEYWORD2
+getFontStartChar	KEYWORD2
+getFontTotalChar	KEYWORD2
+scrollRight	KEYWORD2
+scrollLeft	KEYWORD2
+scrollVertRight	KEYWORD2
+scrollVertLeft	KEYWORD2
+scrollStop	KEYWORD2
 
+getX	KEYWORD2
+getY	KEYWORD2
+setX	KEYWORD2
+setY	KEYWORD2
+getMinValue	KEYWORD2
+getMaxValue	KEYWORD2
+setMaxValue	KEYWORD2
+setMinValue	KEYWORD2
+setValue	KEYWORD2
+draw	KEYWORD2
+drawFace	KEYWORD2
+checkComm	KEYWORD2
 
 #######################################
 # Constants (LITERAL1)
 #######################################
 
+BLACK	LITERAL1
+WHITE	LITERAL1
+NORM	LITERAL1
+XOR	LITERAL1
+PAGE	LITERAL1
+ALL	LITERAL1
+WIDGETSTYLE0	LITERAL1
+WIDGETSTYLE1	LITERAL1
+WIDGETSTYLE2	LITERAL1
+
+