From 40b22af0e0bbeb4183adaf83d52dda411720be27 Mon Sep 17 00:00:00 2001
From: Matthias Wegner <19684192+mattywausb@users.noreply.github.com>
Date: Sun, 23 Sep 2018 14:14:59 +0200
Subject: [PATCH 1/5] Added more characters to the charmap, commented charmap,
 added setString including example, added charmap display to example

---
 examples/LCDemo7Segment/LCDemo7Segment.ino | 90 ++++++++++++++++----
 keywords.txt                               |  1 +
 src/LedControl.cpp                         | 35 ++++++--
 src/LedControl.h                           | 97 +++++++++++++++-------
 4 files changed, 171 insertions(+), 52 deletions(-)

diff --git a/examples/LCDemo7Segment/LCDemo7Segment.ino b/examples/LCDemo7Segment/LCDemo7Segment.ino
index a75f32f9..06a4d370 100644
--- a/examples/LCDemo7Segment/LCDemo7Segment.ino
+++ b/examples/LCDemo7Segment/LCDemo7Segment.ino
@@ -3,18 +3,27 @@
 
 /*
  Now we need a LedControl to work with.
- ***** These pin numbers will probably not work with your hardware *****
- pin 12 is connected to the DataIn 
- pin 11 is connected to the CLK 
- pin 10 is connected to LOAD 
+ ***** Check pin numbers will probably not work with your hardware *****
  We have only a single MAX72XX.
  */
-LedControl lc=LedControl(12,11,10,1);
+#define TRACE_ON
+
+#define LC_DATA_PIN 8
+#define LC_LOAD_PIN 7
+#define LC_CLK_PIN 6
+#define LC_MODULE_COUNT 1
+
+LedControl lc=LedControl(LC_DATA_PIN,LC_CLK_PIN,LC_LOAD_PIN,LC_MODULE_COUNT);
 
 /* we always wait a bit between updates of the display */
-unsigned long delaytime=250;
+unsigned long delaytime=500;
 
 void setup() {
+  #ifdef TRACE_ON 
+    char compile_signature[] = "--- START (Build: " __DATE__ " " __TIME__ ") ---";   
+    Serial.begin(9600);
+    Serial.println(compile_signature); 
+  #endif
   /*
    The MAX72XX is in power-saving mode on startup,
    we have to do a wakeup call
@@ -26,30 +35,66 @@ void setup() {
   lc.clearDisplay(0);
 }
 
+/* Loop over demonstration sequences. Comment unnecessary if u like*/
+void loop() { 
+ 
+  writeArduinoOn7Segment(); // expects 1 digit
+  scrollDigits(); // expects 4 digits
+  traverseCodepage(); // expects 8 digits
+  writeArduinoString(); // expects 8 digits
+  writeGoStringOnPositions(); // expects 8 digits
+
+}
+
 
 /*
  This method will display the characters for the
  word "Arduino" one after the other on digit 0. 
  */
+
 void writeArduinoOn7Segment() {
+  lc.clearDisplay(0);
   lc.setChar(0,0,'a',false);
   delay(delaytime);
-  lc.setRow(0,0,0x05);
+  lc.setChar(0,0,'r',false);
   delay(delaytime);
   lc.setChar(0,0,'d',false);
   delay(delaytime);
-  lc.setRow(0,0,0x1c);
+  lc.setChar(0,0,'u',false);
   delay(delaytime);
-  lc.setRow(0,0,B00010000);
+  lc.setChar(0,0,'i',false);
   delay(delaytime);
-  lc.setRow(0,0,0x15);
+  lc.setChar(0,0,'n',false);
   delay(delaytime);
-  lc.setRow(0,0,0x1D);
+  lc.setChar(0,0,'o',false);
   delay(delaytime);
   lc.clearDisplay(0);
   delay(delaytime);
 } 
 
+/*
+ This method will display the String 
+ "Arduino" on a 8 digit 7 Seg display 
+ */
+void writeArduinoString() {
+  lc.setString(0,7,"Arduino");
+  delay(delaytime*5);
+}
+
+/*
+ This method will display the String 
+ "Go" at different locations and demonstrate how the other digirs are preseved 
+ */
+
+void writeGoStringOnPositions() {
+  lc.setString(0,7,"________");
+  for(int i=1;i<8;i++)
+  {
+    lc.setString(0,i,"Go");
+    delay(delaytime);
+  }
+}
+
 /*
   This method will scroll all the hexa-decimal
  numbers and letters on the display. You will need at least
@@ -67,7 +112,24 @@ void scrollDigits() {
   delay(delaytime);
 }
 
-void loop() { 
-  writeArduinoOn7Segment();
-  scrollDigits();
+/*
+  This method will travers over the whole codepage in 4 byte steps
+  showing the characters on the rightside and the offset in decimal on the left
+  */
+
+void traverseCodepage()
+{
+  String offsetAsString;
+  lc.clearDisplay(0);
+  for (int i=0;i<128;i+=4) {
+    offsetAsString=String(i);
+    lc.setString(0,4+offsetAsString.length(),offsetAsString);
+    lc.setChar(0,3,i,false);
+    lc.setChar(0,2,i+1,false);
+    lc.setChar(0,1,i+2,false);
+    lc.setChar(0,0,i+3,false);
+    delay(delaytime*4);
+  }
 }
+
+
diff --git a/keywords.txt b/keywords.txt
index 9d2a94f1..b8b34ba0 100644
--- a/keywords.txt
+++ b/keywords.txt
@@ -21,6 +21,7 @@ setRow		KEYWORD2
 setColumn	KEYWORD2
 setDigit	KEYWORD2
 setChar		KEYWORD2
+setString   KEYWORD2
 
 #######################################
 # Constants (LITERAL1)
diff --git a/src/LedControl.cpp b/src/LedControl.cpp
index e43211fd..43f0537f 100644
--- a/src/LedControl.cpp
+++ b/src/LedControl.cpp
@@ -189,19 +189,42 @@ void LedControl::setChar(int addr, int digit, char value, boolean dp) {
     spiTransfer(addr, digit+1,v);
 }
 
+void LedControl::setString(int addr, int digit, String theString)
+{
+	
+	if(addr<0 || addr>=maxDevices)
+        return;
+    if(digit<0 || digit>7)
+        return;
+	for(int i=0;i<theString.length();i++) 
+	{
+		setChar(addr,digit,theString.charAt(i),0);
+		Serial.print(theString.charAt(i));
+		Serial.println('-');
+		if(--digit<0) 
+		{
+			digit=7;
+			if(++addr>=maxDevices) return;
+		}
+	}
+
+}
+
 void LedControl::spiTransfer(int addr, volatile byte opcode, volatile byte data) {
-    //Create an array with the data to shift out
+    
     int offset=addr*2;
-    int maxbytes=maxDevices*2;
+    int maxbytes=maxDevices*2; // two bytes (opcode+data) for every device
 
-    for(int i=0;i<maxbytes;i++)
-        spidata[i]=(byte)0;
-    //put our device data into the array
+	//Prepare array with the data to shift out 
+	memset(spidata,0,maxbytes);
+	
+    //put our device data into the array (other devices get 0x0000)
     spidata[offset+1]=opcode;
     spidata[offset]=data;
+	
     //enable the line 
     digitalWrite(SPI_CS,LOW);
-    //Now shift out the data 
+    //Now shift out the data (Backwards order necessary) 
     for(int i=maxbytes;i>0;i--)
         shiftOut(SPI_MOSI,SPI_CLK,MSBFIRST,spidata[i-1]);
     //latch the data onto the display
diff --git a/src/LedControl.h b/src/LedControl.h
index cdfaa1f5..c26ccef0 100644
--- a/src/LedControl.h
+++ b/src/LedControl.h
@@ -39,23 +39,35 @@
  * Segments to be switched on for characters and digits on
  * 7-Segment Displays
  */
+ 
+/* The following table is used to translate an ascii byte value 
+ * to the corresponding 7segment bitmap pattern 
+ * To give the easyest usability with the most possible response, lower or upper case versions of
+ * letters are replaced by the other size, when the original size could not be designed properly. 
+ * (Check the Comments to see the replacements)
+ * Also some designs are ambigous (e.g. 2 and Z, 0 and O, ( and C ). 
+ * This must be sovled by giving good context, choosing good words. 
+ * which lies in the responsibility of the final design.
+ * Some other designs are more a possibility, then a real representation, but may be more useful then just blank (e.g. :<=>)
+ */
 const static byte charTable [] PROGMEM  = {
-    B01111110,B00110000,B01101101,B01111001,B00110011,B01011011,B01011111,B01110000,
-    B01111111,B01111011,B01110111,B00011111,B00001101,B00111101,B01001111,B01000111,
-    B00000000,B00000000,B00000000,B00000000,B00000000,B00000000,B00000000,B00000000,
-    B00000000,B00000000,B00000000,B00000000,B00000000,B00000000,B00000000,B00000000,
-    B00000000,B00000000,B00000000,B00000000,B00000000,B00000000,B00000000,B00000000,
-    B00000000,B00000000,B00000000,B00000000,B10000000,B00000001,B10000000,B00000000,
-    B01111110,B00110000,B01101101,B01111001,B00110011,B01011011,B01011111,B01110000,
-    B01111111,B01111011,B00000000,B00000000,B00000000,B00000000,B00000000,B00000000,
-    B00000000,B01110111,B00011111,B00001101,B00111101,B01001111,B01000111,B00000000,
-    B00110111,B00000000,B00000000,B00000000,B00001110,B00000000,B00000000,B00000000,
-    B01100111,B00000000,B00000000,B00000000,B00000000,B00000000,B00000000,B00000000,
-    B00000000,B00000000,B00000000,B00000000,B00000000,B00000000,B00000000,B00001000,
-    B00000000,B01110111,B00011111,B00001101,B00111101,B01001111,B01000111,B00000000,
-    B00110111,B00000000,B00000000,B00000000,B00001110,B00000000,B00010101,B00011101,
-    B01100111,B00000000,B00000000,B00000000,B00000000,B00000000,B00000000,B00000000,
-    B00000000,B00000000,B00000000,B00000000,B00000000,B00000000,B00000000,B00000000
+//      0/8      1/9       2/A       3/B         4/C       5/D       6/E       7/F  
+    B01111110,B00110000,B01101101,B01111001,  B00110011,B01011011,B01011111,B01110000, //  (0) 0123 4567
+    B01111111,B01111011,B01110111,B00011111,  B00001101,B00111101,B01001111,B01000111, //  (8) 89AB CDEF
+	B01100000,B00011000,B00001100,B01000010,  B01101100,B01011010,B00110001,B00000111, // (16) •••• ••••
+    B01000000,B01001000,B01001001,B00000000,  B00000000,B00000000,B00000000,B00000000, // (24) •••• ••••
+    B00000000,B00000000,B00100010,B00000000,  B00000000,B00000000,B00000000,B00100000, // (32)  ×"× ×××'   
+    B01001110,B01111000,B01100011,B00000000,  B10000000,B00000001,B10000000,B00100100, // (40) ()*× ,-./ 
+    B01111110,B00110000,B01101101,B01111001,  B00110011,B01011011,B01011111,B01110000, // (48) 0123 4567
+    B01111111,B01111011,B00001001,B00000000,  B00000000,B01000011,B01000001,B01100001, // (56) 89:× ×<=>
+    B00000000,B01110111,B01111111,B01001110,  B00111101,B01001111,B01000111,B01011111, // (64) ×ABC DEFG
+    B00110111,B00110000,B00111100,B00000000,  B00001110,B00000000,B00010101,B01111110, // (72) HIJ× L×nO
+    B01100111,B00000000,B00000000,B01011011,  B00000000,B00111110,B00000000,B00000000, // (80) P××S ×U××
+    B00000000,B00111011,B01101101,B00000000,  B00000000,B00010010,B01100010,B00001000, // (88) ××YZ ×\^_
+    B00000010,B01110111,B00011111,B00001101,  B00111101,B01001111,B01000111,B01011111, // (96) `Abc dEFG
+    B00010111,B00010000,B00111100,B00000000,  B00110000,B00000000,B00010101,B00011101, //(104) hiJ× l×no
+    B01100111,B00000000,B00000101,B01011011,  B00000000,B00011100,B00000000,B00000000, //(112) P×rS ×u×× 
+    B00000000,B00111011,B01101101,B00000000,  B00000110,B00000000,B00100101,B00000000  //(120) ×YZ× |×~×
 };
 
 class LedControl {
@@ -65,8 +77,8 @@ class LedControl {
         /* Send out a single command to the device */
         void spiTransfer(int addr, byte opcode, byte data);
 
-        /* We keep track of the led-status for all 8 devices in this array */
-        byte status[64];
+        /* led-status for 8 elements with 8 led on up to 8 devices  */
+        byte status[64]; 
         /* Data is shifted out of this pin*/
         int SPI_MOSI;
         /* The clock is signaled on this pin */
@@ -90,7 +102,7 @@ class LedControl {
         /*
          * Gets the number of devices attached to this LedControl.
          * Returns :
-         * int	the number of devices on this LedControl
+         * int	the number of devices on this LedControl (1..n)
          */
         int getDeviceCount();
 
@@ -108,7 +120,7 @@ class LedControl {
          * See datasheet for sideeffects of the scanlimit on the brightness
          * of the display.
          * Params :
-         * addr	address of the display to control
+         * addr	address of the display to control (0..n-1)
          * limit	number of digits to be displayed (1..8)
          */
         void setScanLimit(int addr, int limit);
@@ -116,7 +128,7 @@ class LedControl {
         /* 
          * Set the brightness of the display.
          * Params:
-         * addr		the address of the display to control
+         * addr		the address of the display to control (0..n-1)
          * intensity	the brightness of the display. (0..15)
          */
         void setIntensity(int addr, int intensity);
@@ -131,7 +143,7 @@ class LedControl {
         /* 
          * Set the status of a single Led.
          * Params :
-         * addr	address of the display 
+         * addr	address of the display  (0..n-1)
          * row	the row of the Led (0..7)
          * col	the column of the Led (0..7)
          * state	If true the led is switched on, 
@@ -142,7 +154,7 @@ class LedControl {
         /* 
          * Set all 8 Led's in a row to a new state
          * Params:
-         * addr	address of the display
+         * addr	address of the display (0..n-1)
          * row	row which is to be set (0..7)
          * value	each bit set to 1 will light up the
          *		corresponding Led.
@@ -152,7 +164,7 @@ class LedControl {
         /* 
          * Set all 8 Led's in a column to a new state
          * Params:
-         * addr	address of the display
+         * addr	address of the display (0..n-1)
          * col	column which is to be set (0..7)
          * value	each bit set to 1 will light up the
          *		corresponding Led.
@@ -162,7 +174,7 @@ class LedControl {
         /* 
          * Display a hexadecimal digit on a 7-Segment Display
          * Params:
-         * addr	address of the display
+         * addr	address of the display (0..n-1)
          * digit	the position of the digit on the display (0..7)
          * value	the value to be displayed. (0x00..0x0F)
          * dp	sets the decimal point.
@@ -170,18 +182,39 @@ class LedControl {
         void setDigit(int addr, int digit, byte value, boolean dp);
 
         /* 
-         * Display a character on a 7-Segment display.
-         * There are only a few characters that make sense here :
-         *	'0','1','2','3','4','5','6','7','8','9','0',
-         *  'A','b','c','d','E','F','H','L','P',
-         *  '.','-','_',' ' 
-         * Params:
-         * addr	address of the display
+         * Display a character (according to ascii codepage) on a 7-Segment display.
+         * For the available characters check the char table
+		 * in the upper part of this header file.
+
+		 * Params:
+         * addr	address of the display (0..n-1)
          * digit	the position of the character on the display (0..7)
          * value	the character to be displayed. 
          * dp	sets the decimal point.
          */
         void setChar(int addr, int digit, char value, boolean dp);
+
+        /* 
+         * Display a string  on a 7-Segment display. Starting at th defined the position
+		 * Progressing left to right and ending with the last character. 
+		 * Digits after the string will not be changed)
+         * For the available characters check the char table
+		 * in the upper part of this header file.
+		 * Params:
+         * addr	address of the display the string starts on (0..n-1)
+         * digit	the start position of the string on the display (0..7)
+         * theString	the character to be displayed. 
+         */		
+		void setString(int addr, int startDigit, String theString);
+		
+        /* 
+         * Set all 7 segment dots on a device according to the bitpattern.
+		 * Params:
+         * addr	address of the display (0..n-1)
+         * digit	the start position of the character on the display (0..7)
+         * value	the character to be displayed. 
+         */			
+		void setDots(int addr, byte dotpattern);
 };
 
 #endif	//LedControl.h

From decc3d74df0b7e8785aaf4da00fc86050c03cd5b Mon Sep 17 00:00:00 2001
From: Matthias Wegner <19684192+mattywausb@users.noreply.github.com>
Date: Sun, 23 Sep 2018 15:00:46 +0200
Subject: [PATCH 2/5] Added setting of dots to setString

---
 examples/LCDemo7Segment/LCDemo7Segment.ino | 13 ++++++++-----
 src/LedControl.cpp                         |  8 +++-----
 src/LedControl.h                           | 12 +++---------
 3 files changed, 14 insertions(+), 19 deletions(-)

diff --git a/examples/LCDemo7Segment/LCDemo7Segment.ino b/examples/LCDemo7Segment/LCDemo7Segment.ino
index 06a4d370..b5c224ab 100644
--- a/examples/LCDemo7Segment/LCDemo7Segment.ino
+++ b/examples/LCDemo7Segment/LCDemo7Segment.ino
@@ -40,9 +40,9 @@ void loop() {
  
   writeArduinoOn7Segment(); // expects 1 digit
   scrollDigits(); // expects 4 digits
-  traverseCodepage(); // expects 8 digits
   writeArduinoString(); // expects 8 digits
   writeGoStringOnPositions(); // expects 8 digits
+  traverseCodepage(); // expects 8 digits
 
 }
 
@@ -77,7 +77,7 @@ void writeArduinoOn7Segment() {
  "Arduino" on a 8 digit 7 Seg display 
  */
 void writeArduinoString() {
-  lc.setString(0,7,"Arduino");
+  lc.setString(0,7,"Arduino",0x02);
   delay(delaytime*5);
 }
 
@@ -87,10 +87,10 @@ void writeArduinoString() {
  */
 
 void writeGoStringOnPositions() {
-  lc.setString(0,7,"________");
+  lc.setString(0,7,"________",0x55);
   for(int i=1;i<8;i++)
   {
-    lc.setString(0,i,"Go");
+    lc.setString(0,i,"Go",0x80);
     delay(delaytime);
   }
 }
@@ -121,9 +121,12 @@ void traverseCodepage()
 {
   String offsetAsString;
   lc.clearDisplay(0);
+  lc.setString(0,7,"Codepage",0);
+  delay(delaytime*2);
+  lc.clearDisplay(0);
   for (int i=0;i<128;i+=4) {
     offsetAsString=String(i);
-    lc.setString(0,4+offsetAsString.length(),offsetAsString);
+    lc.setString(0,4+offsetAsString.length(),offsetAsString,0);
     lc.setChar(0,3,i,false);
     lc.setChar(0,2,i+1,false);
     lc.setChar(0,1,i+2,false);
diff --git a/src/LedControl.cpp b/src/LedControl.cpp
index 43f0537f..808a7dff 100644
--- a/src/LedControl.cpp
+++ b/src/LedControl.cpp
@@ -189,7 +189,7 @@ void LedControl::setChar(int addr, int digit, char value, boolean dp) {
     spiTransfer(addr, digit+1,v);
 }
 
-void LedControl::setString(int addr, int digit, String theString)
+void LedControl::setString(int addr, int digit, String theString,uint8_t dotpattern)
 {
 	
 	if(addr<0 || addr>=maxDevices)
@@ -198,16 +198,14 @@ void LedControl::setString(int addr, int digit, String theString)
         return;
 	for(int i=0;i<theString.length();i++) 
 	{
-		setChar(addr,digit,theString.charAt(i),0);
-		Serial.print(theString.charAt(i));
-		Serial.println('-');
+		setChar(addr,digit,theString.charAt(i),(0x80&dotpattern)!=0);
+		dotpattern<<=1;
 		if(--digit<0) 
 		{
 			digit=7;
 			if(++addr>=maxDevices) return;
 		}
 	}
-
 }
 
 void LedControl::spiTransfer(int addr, volatile byte opcode, volatile byte data) {
diff --git a/src/LedControl.h b/src/LedControl.h
index c26ccef0..24f02a59 100644
--- a/src/LedControl.h
+++ b/src/LedControl.h
@@ -204,17 +204,11 @@ class LedControl {
          * addr	address of the display the string starts on (0..n-1)
          * digit	the start position of the string on the display (0..7)
          * theString	the character to be displayed. 
+         * dotpattern	Bitpattern to set the dots additionally along the string starting with the leftmost bit
          */		
-		void setString(int addr, int startDigit, String theString);
+		void setString(int addr, int startDigit, String theString, uint8_t dotpattern);
 		
-        /* 
-         * Set all 7 segment dots on a device according to the bitpattern.
-		 * Params:
-         * addr	address of the display (0..n-1)
-         * digit	the start position of the character on the display (0..7)
-         * value	the character to be displayed. 
-         */			
-		void setDots(int addr, byte dotpattern);
+
 };
 
 #endif	//LedControl.h

From 84f03cfda5cd958299d1f46869295fd1a44bd59d Mon Sep 17 00:00:00 2001
From: Matthias Wegner <19684192+mattywausb@users.noreply.github.com>
Date: Sun, 23 Sep 2018 15:28:18 +0200
Subject: [PATCH 3/5] Patched added t to the characterset, switched I character
 to e and f segment

---
 src/LedControl.h | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/src/LedControl.h b/src/LedControl.h
index 24f02a59..1bf8a784 100644
--- a/src/LedControl.h
+++ b/src/LedControl.h
@@ -61,12 +61,12 @@ const static byte charTable [] PROGMEM  = {
     B01111110,B00110000,B01101101,B01111001,  B00110011,B01011011,B01011111,B01110000, // (48) 0123 4567
     B01111111,B01111011,B00001001,B00000000,  B00000000,B01000011,B01000001,B01100001, // (56) 89:× ×<=>
     B00000000,B01110111,B01111111,B01001110,  B00111101,B01001111,B01000111,B01011111, // (64) ×ABC DEFG
-    B00110111,B00110000,B00111100,B00000000,  B00001110,B00000000,B00010101,B01111110, // (72) HIJ× L×nO
-    B01100111,B00000000,B00000000,B01011011,  B00000000,B00111110,B00000000,B00000000, // (80) P××S ×U××
-    B00000000,B00111011,B01101101,B00000000,  B00000000,B00010010,B01100010,B00001000, // (88) ××YZ ×\^_
+    B00110111,B00000110,B00111100,B00000000,  B00001110,B00000000,B00010101,B01111110, // (72) HIJ× L×nO
+    B01100111,B00000000,B00000000,B01011011,  B00001111,B00111110,B00000000,B00000000, // (80) P××S tU××
+    B00000000,B00111011,B01101101,B00000000,  B00000000,B00010010,B01100010,B00001000, // (88) ×YZ× ×\^_
     B00000010,B01110111,B00011111,B00001101,  B00111101,B01001111,B01000111,B01011111, // (96) `Abc dEFG
     B00010111,B00010000,B00111100,B00000000,  B00110000,B00000000,B00010101,B00011101, //(104) hiJ× l×no
-    B01100111,B00000000,B00000101,B01011011,  B00000000,B00011100,B00000000,B00000000, //(112) P×rS ×u×× 
+    B01100111,B00000000,B00000101,B01011011,  B00001111,B00011100,B00000000,B00000000, //(112) P×rS tu×× 
     B00000000,B00111011,B01101101,B00000000,  B00000110,B00000000,B00100101,B00000000  //(120) ×YZ× |×~×
 };
 

From 8322810fb0ae5094d7e4d7e3aa3d3d731aff4695 Mon Sep 17 00:00:00 2001
From: Matthias Wegner <19684192+mattywausb@users.noreply.github.com>
Date: Wed, 26 Sep 2018 20:44:35 +0200
Subject: [PATCH 4/5] Corrected keyords.txt, Changed G Style (removed g led
 from Letter G)

---
 keywords.txt     | 2 +-
 src/LedControl.h | 4 ++--
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/keywords.txt b/keywords.txt
index b8b34ba0..8fd43417 100644
--- a/keywords.txt
+++ b/keywords.txt
@@ -21,7 +21,7 @@ setRow		KEYWORD2
 setColumn	KEYWORD2
 setDigit	KEYWORD2
 setChar		KEYWORD2
-setString   KEYWORD2
+setString	KEYWORD2
 
 #######################################
 # Constants (LITERAL1)
diff --git a/src/LedControl.h b/src/LedControl.h
index 1bf8a784..a2d54203 100644
--- a/src/LedControl.h
+++ b/src/LedControl.h
@@ -60,11 +60,11 @@ const static byte charTable [] PROGMEM  = {
     B01001110,B01111000,B01100011,B00000000,  B10000000,B00000001,B10000000,B00100100, // (40) ()*× ,-./ 
     B01111110,B00110000,B01101101,B01111001,  B00110011,B01011011,B01011111,B01110000, // (48) 0123 4567
     B01111111,B01111011,B00001001,B00000000,  B00000000,B01000011,B01000001,B01100001, // (56) 89:× ×<=>
-    B00000000,B01110111,B01111111,B01001110,  B00111101,B01001111,B01000111,B01011111, // (64) ×ABC DEFG
+    B00000000,B01110111,B01111111,B01001110,  B00111101,B01001111,B01000111,B01011110, // (64) ×ABC DEFG
     B00110111,B00000110,B00111100,B00000000,  B00001110,B00000000,B00010101,B01111110, // (72) HIJ× L×nO
     B01100111,B00000000,B00000000,B01011011,  B00001111,B00111110,B00000000,B00000000, // (80) P××S tU××
     B00000000,B00111011,B01101101,B00000000,  B00000000,B00010010,B01100010,B00001000, // (88) ×YZ× ×\^_
-    B00000010,B01110111,B00011111,B00001101,  B00111101,B01001111,B01000111,B01011111, // (96) `Abc dEFG
+    B00000010,B01110111,B00011111,B00001101,  B00111101,B01001111,B01000111,B01011110, // (96) `Abc dEFG
     B00010111,B00010000,B00111100,B00000000,  B00110000,B00000000,B00010101,B00011101, //(104) hiJ× l×no
     B01100111,B00000000,B00000101,B01011011,  B00001111,B00011100,B00000000,B00000000, //(112) P×rS tu×× 
     B00000000,B00111011,B01101101,B00000000,  B00000110,B00000000,B00100101,B00000000  //(120) ×YZ× |×~×

From 69a4d1ff4e3dde87a1b0fd64c98e6ba4cc4b0810 Mon Sep 17 00:00:00 2001
From: Matthias Wegner <19684192+mattywausb@users.noreply.github.com>
Date: Sun, 7 Oct 2018 14:27:46 +0200
Subject: [PATCH 5/5] Added rotate180 feature to support devices, that are
 mounted upside down

---
 examples/LCDemo7Segment/LCDemo7Segment.ino |  4 ++-
 src/LedControl.cpp                         | 15 ++++++++++-
 src/LedControl.h                           | 31 ++++++++++++++++------
 3 files changed, 40 insertions(+), 10 deletions(-)

diff --git a/examples/LCDemo7Segment/LCDemo7Segment.ino b/examples/LCDemo7Segment/LCDemo7Segment.ino
index b5c224ab..16c119f8 100644
--- a/examples/LCDemo7Segment/LCDemo7Segment.ino
+++ b/examples/LCDemo7Segment/LCDemo7Segment.ino
@@ -14,6 +14,7 @@
 #define LC_MODULE_COUNT 1
 
 LedControl lc=LedControl(LC_DATA_PIN,LC_CLK_PIN,LC_LOAD_PIN,LC_MODULE_COUNT);
+bool rotate=false;
 
 /* we always wait a bit between updates of the display */
 unsigned long delaytime=500;
@@ -43,7 +44,8 @@ void loop() {
   writeArduinoString(); // expects 8 digits
   writeGoStringOnPositions(); // expects 8 digits
   traverseCodepage(); // expects 8 digits
-
+  rotate=!rotate;
+  lc.setRotate180(0,rotate);
 }
 
 
diff --git a/src/LedControl.cpp b/src/LedControl.cpp
index 808a7dff..0fd68d10 100644
--- a/src/LedControl.cpp
+++ b/src/LedControl.cpp
@@ -43,7 +43,7 @@
 #define OP_SHUTDOWN    12
 #define OP_DISPLAYTEST 15
 
-LedControl::LedControl(int dataPin, int clkPin, int csPin, int numDevices) {
+LedControl::LedControl(int dataPin, int clkPin, int csPin, int numDevices, byte rotate180Flags) {
     SPI_MOSI=dataPin;
     SPI_CLK=clkPin;
     SPI_CS=csPin;
@@ -57,6 +57,7 @@ LedControl::LedControl(int dataPin, int clkPin, int csPin, int numDevices) {
     SPI_MOSI=dataPin;
     for(int i=0;i<64;i++) 
         status[i]=0x00;
+	rotate180=rotate180Flags;
     for(int i=0;i<maxDevices;i++) {
         spiTransfer(i,OP_DISPLAYTEST,0);
         //scanlimit is set to max on startup
@@ -162,6 +163,10 @@ void LedControl::setDigit(int addr, int digit, byte value, boolean dp) {
         return;
     offset=addr*8;
     v=pgm_read_byte_near(charTable + value); 
+	if(bitRead(rotate180,addr)) {
+		digit=7-digit;
+		v=(B01110000&(v<<3))|(B00001110&(v>>3))|(B00000001&v); //Rotate pabcdefg -> pdefabcg
+	}
     if(dp)
         v|=B10000000;
     status[offset+digit]=v;
@@ -183,6 +188,10 @@ void LedControl::setChar(int addr, int digit, char value, boolean dp) {
         index=32;
     }
     v=pgm_read_byte_near(charTable + index); 
+	if(bitRead(rotate180,addr)) {
+		digit=7-digit;
+		v=(B01110000&(v<<3))|(B00001110&(v>>3))|(B00000001&v); //Rotate pabcdefg -> pdefabcg
+	}
     if(dp)
         v|=B10000000;
     status[offset+digit]=v;
@@ -229,4 +238,8 @@ void LedControl::spiTransfer(int addr, volatile byte opcode, volatile byte data)
     digitalWrite(SPI_CS,HIGH);
 }    
 
+void LedControl::setRotate180(int addr, boolean isRotated) {
+	bitWrite(rotate180,addr,isRotated);
+};
+
 
diff --git a/src/LedControl.h b/src/LedControl.h
index a2d54203..4234b13f 100644
--- a/src/LedControl.h
+++ b/src/LedControl.h
@@ -41,7 +41,7 @@
  */
  
 /* The following table is used to translate an ascii byte value 
- * to the corresponding 7segment bitmap pattern 
+ * to the corresponding 7segment bitmap pattern with segmentmapping "pabcdefg"
  * To give the easyest usability with the most possible response, lower or upper case versions of
  * letters are replaced by the other size, when the original size could not be designed properly. 
  * (Check the Comments to see the replacements)
@@ -77,16 +77,19 @@ class LedControl {
         /* Send out a single command to the device */
         void spiTransfer(int addr, byte opcode, byte data);
 
-        /* led-status for 8 elements with 8 led on up to 8 devices  */
+        /* led-status for 8 devices with 8 elements containing 8 leds (7 segments + DP)  */
         byte status[64]; 
+		/* bit flag, if display of device is rotated by 180 degrees */
+		byte rotate180=0;
+		
         /* Data is shifted out of this pin*/
-        int SPI_MOSI;
+        byte SPI_MOSI;
         /* The clock is signaled on this pin */
-        int SPI_CLK;
+        byte SPI_CLK;
         /* This one is driven LOW for chip selectzion */
-        int SPI_CS;
-        /* The maximum number of devices we use */
-        int maxDevices;
+        byte SPI_CS;
+        /* The maximum number of 7 segment devices we use */
+        byte maxDevices;
 
     public:
         /* 
@@ -96,8 +99,9 @@ class LedControl {
          * clockPin		pin for the clock
          * csPin		pin for selecting the device 
          * numDevices	maximum number of devices that can be controled
+		 * rotate180Flags Flag for every device if it is mounted rotated by 180 degrees
          */
-        LedControl(int dataPin, int clkPin, int csPin, int numDevices=1);
+        LedControl(int dataPin, int clkPin, int csPin, int numDevices=1, uint8_t rotate180Flags=0);
 
         /*
          * Gets the number of devices attached to this LedControl.
@@ -207,6 +211,17 @@ class LedControl {
          * dotpattern	Bitpattern to set the dots additionally along the string starting with the leftmost bit
          */		
 		void setString(int addr, int startDigit, String theString, uint8_t dotpattern);
+
+        /* 
+         * Define if the character font and digit adress of a deviceare in  calculated normal
+		 * or for  180 dregee rotated display(Decimal points up)
+
+		 * Params:
+         * addr	address of the display (0..n-1)
+         * isRotated	boolean to set the rotation of the display
+
+         */
+        void setRotate180(int addr, boolean isRotated);
 		
 
 };