First version released

Author: BugerDread

examples/esp8266-hw-spi-max7219-7seg-demo/esp8266-hw-spi-max7219-7seg.ino

@@ -0,0 +1,77 @@
+
+/* Include DigitLedDisplay Library */
+#include "DigitLedDisplay.h"
+
+/* Arduino Pin to Display Pin
+   7 to DIN,
+   6 to CS,
+   5 to CLK */
+DigitLedDisplay ld = DigitLedDisplay(7, 5, 6);
+
+void setup() {
+
+  /* Set the brightness min:1, max:15 */
+  ld.setBright(10);
+
+  /* Set the digit count */
+  ld.setDigitLimit(8);
+
+}
+
+void loop() {
+
+  /* Prints data to the display */
+  ld.printDigit(12345678);
+  delay(500);
+  ld.clear();
+
+  ld.printDigit(22222222);
+  delay(500);
+  ld.clear();
+
+  ld.printDigit(44444444);
+  delay(500);
+  ld.clear();
+
+  for (int i = 0; i < 100; i++) {
+    ld.printDigit(i);
+
+    /* Start From Digit 4 */
+    ld.printDigit(i, 4);
+    delay(50);
+  }
+
+  for (int i = 0; i <= 10; i++) {
+    /* Display off */
+    ld.off();
+    delay(150);
+
+    /* Display on */
+    ld.on();
+    delay(150);
+  }
+
+  /* Clear all display value */
+  ld.clear();
+  delay(500);
+
+  for (long i = 0; i < 100; i++) {
+    ld.printDigit(i);
+    delay(25);
+  }
+
+  for (int i = 0; i <= 20; i++) {
+    /* Select Digit 5 and write B01100011 */
+    ld.write(5, B01100011);
+    delay(200);
+
+    /* Select Digit 5 and write B00011101 */
+    ld.write(5, B00011101);
+    delay(200);
+  }
+
+  /* Clear all display value */
+  ld.clear();
+  delay(500);
+
+}

keywords.txt

@@ -0,0 +1,25 @@
+#######################################
+# Syntax Coloring Map For DigitLedDisplay
+#######################################
+
+#######################################
+# Datatypes (KEYWORD1)
+#######################################
+
+BgrMax7seg	KEYWORD1
+
+#######################################
+# Methods and Functions (KEYWORD2)
+#######################################
+
+clear	KEYWORD2
+setBright	KEYWORD2
+setDigitLimit	KEYWORD2
+on	KEYWORD2
+off	KEYWORD2
+printDigit	KEYWORD2
+write	KEYWORD2
+
+#######################################
+# Constants (LITERAL1)
+#######################################

library.properties

@@ -0,0 +1,10 @@
+name=ESP8266-HW-SPI-MAX7219-7seg
+version=2.0.0
+author=Buger - based on Ozhan Duran <[email protected]>
+maintainer=Buger
+sentence=Multi MAX7219 7-Segment LED Display HW SPI Lib
+paragraph=Librery to use 1 or more MAX7219 7segment modules with ESP8266 over HW SPI
+category=Display
+url=http://buger.dread.cz
+architectures=*
+includes=esp8266-hw-spi-max7219-7seg.h

src/esp8266-hw-spi-max7219-7seg.cpp

@@ -0,0 +1,103 @@
+#include "esp8266-hw-spi-max7219-7seg.h"
+#include <SPI.h>
+
+
+#define DECODEMODE_ADDR 9
+#define BRIGHTNESS_ADDR	10
+#define SCANLIMIT_ADDR	11
+#define SHUTDOWN_ADDR	12
+#define DISPLAYTEST_ADDR 15
+#define NOOP_ADDR		0
+
+
+// init HW SPI
+BgrMax7seg::BgrMax7seg(uint32_t spiFreq, int csPin, int dispAmount) {
+	CS_PIN = csPin;
+	_dispAmount = dispAmount;
+	pinMode(CS_PIN, OUTPUT);
+	digitalWrite(CS_PIN, HIGH);
+	SPI.begin();
+	SPI.beginTransaction(SPISettings(spiFreq, MSBFIRST, SPI_MODE0));
+}
+
+void BgrMax7seg::setBright(int brightness, int module) { // set brightness 
+    if (brightness>=0 && brightness<16)	
+        write(BRIGHTNESS_ADDR, brightness, module);
+}
+
+void BgrMax7seg::init() { //init all modules with scanlimit, TODO: remove scanlimit at all
+	write(DISPLAYTEST_ADDR, 0, ALL_MODULES);	//turn off display test on all
+	write(SCANLIMIT_ADDR, 7, ALL_MODULES);		//sanlimit to all 8 digits (=7)
+	write(DECODEMODE_ADDR, 0, ALL_MODULES);		//turn off decode mode
+	clear(ALL_MODULES);							//clear all modules
+	write(SHUTDOWN_ADDR, 1, ALL_MODULES);		//turn all modules on
+}
+
+void BgrMax7seg::on(int module) {
+	write(SHUTDOWN_ADDR, 0x01, module);
+}
+
+void BgrMax7seg::off(int module) {
+	write(SHUTDOWN_ADDR, 0x00, module);
+}
+
+void BgrMax7seg::clear(int module) {
+  for (int i = 1; i <=8; i++) {
+	write(i, B00000000, module);
+  }
+}
+
+void BgrMax7seg::table(byte address, int val, bool point, int module) {
+	byte tableValue;
+	tableValue = pgm_read_byte_near(segTable + val);
+	if (point) {
+		tableValue += 128;	//decimal point 
+	}
+	write(address, tableValue, module);
+}
+
+void BgrMax7seg::write(volatile byte address, volatile byte data, volatile int module) { //when module == 0 send data to all of them
+	digitalWrite(CS_PIN, LOW);
+	for (int i = _dispAmount; i >= 1; i--) {
+		if ((module == 0) or (module == i)) {
+			SPI.transfer(address);
+			SPI.transfer(data);
+		} else {
+			SPI.transfer(NOOP_ADDR);
+			SPI.transfer(NOOP_ADDR);
+		}
+	}
+	digitalWrite(CS_PIN, HIGH);
+}
+
+void BgrMax7seg::print(String figure, int module) {
+	figure.toUpperCase();			//we know only upperacase chars
+	bool point = false;
+	int len = figure.length();
+	int position = len - 1;			//string are indexed from 0 => -1 and we start from the end
+
+	for(int i = 1; i <= 8; i++) {	//
+		if (position >= 0) {	
+			// we are not outside  of the string
+			if (figure[position] == '.') {
+				if (position > 0) {
+					position--;
+					point = true;
+				}
+			} else {	//no point
+				point = false;
+			}
+			if (figure[position] == ' ') {	//space is not in table
+				write(i, point * 128, module);
+			} else { 	//search the table
+				int parseInt = figure[position] - '-';	// first character of the segTable needs to be here
+				table(i, parseInt, point, module);
+			}
+			position--;
+		} else {
+		// will print space
+			write(i, 0, module);
+		}		
+
+	}
+}

src/esp8266-hw-spi-max7219-7seg.h

@@ -0,0 +1,48 @@
+#ifndef esp8266-hw-spi-max7219-7seg_h
+#define esp8266-hw-spi-max7219-7seg_h
+
+#if (ARDUINO >= 100)
+#include <Arduino.h>
+#else
+#include <WProgram.h>
+#endif
+
+#define ALL_MODULES		0	//use as module number to send to all
+
+const static byte segTable [] PROGMEM = { // starting from 0
+	1,		// -
+	128,	// .
+	0,		// /
+    126, 	// 0
+	48,		// 1
+	109,	// 2
+	121,	// 3
+	51,		// 4
+	91,		// 5
+	95,		// 6
+	112,	// 7
+	127,	// 8
+	123,	// 9
+	0, 0, 0, 0, 0, 0, 0,	// : ; < = > ? @ - will not display these
+	119, 31, 78, 61, 79, 71, 95, 23, 48, 60, 87, 14, 84, 21, 126, 103, 115, 5, 91, 15, 62, 62, 42, 55, 59, 109	// A .. Z
+};
+
+class BgrMax7seg
+{
+	private:
+		int CS_PIN;
+		int _digitLimit;
+		int _dispAmount;
+		void table(byte address, int val, bool point, int module);	
+	public:
+		BgrMax7seg(uint32_t spiFreq, int csPin, int dispAmount = 1);	//dispAmount = number of connected modules
+		void setBright(int brightness, int module = 1);
+		void init();
+		void print(String figure, int module = 1);
+		void write(byte address, byte data, int module = 1);
+		void clear(int module = 1);
+		void on(int module = 1);
+		void off(int module = 1);		
+};
+
+#endif	//esp8266-hw-spi-max7219-7seg.h