version 1.7.1

Author: gavinlyonsrepo

Makefile

@@ -26,7 +26,7 @@ SRCS = $(wildcard $(SRC)/*.cpp)
 OBJS = $(patsubst $(SRC)%.cpp,  $(OBJ)/%.o, $(SRCS))
 
 CXX=g++
-CCFLAGS= -Ofast -mfpu=vfp -mfloat-abi=hard -march=armv6zk -mtune=arm1176jzf-s -Iinclude/
+CCFLAGS= -march=native -mtune=native -mcpu=native  -Iinclude/
 LDFLAGS= -lbcm2835
 
 # make

README.md

@@ -15,7 +15,7 @@
 	* [Bitmaps](#bitmaps)
 	* [User Adjustments](#user-adjustments)
   * [Notes and Issues](#notes-and-issues)
-	* [Compilation problems](#compilation-problems)
+
 
 ## Overview
 
@@ -36,13 +36,14 @@
 
 * This is a port of my [Arduino library](https://github.com/gavinlyonsrepo/ERM19264_UC1609)
     More details there as well as link to the API(There are some differences between this port and Arduino library most notably use of glyph fonts)
-    
-* Development Toolchain :: 
-	1. Raspberry PI 3 model b, 
-	2. C++ complier g++ (Raspbian 8.3.0-6)
-	3. Raspbian 10 buster  OS, 32 bit.
-	4. bcm2835 Library 1.71 (Dependency)
-    
+
+* Development Tool chain. 
+	1. Raspberry PI 3 model b
+	2. C++, g++ (Debian 12.2.0) 
+	3. Raspbian , Debian 12 bookworm OS, , 64 bit.
+	4. kernel : aarch64 Linux 6.1.0-rpi7-rpi-v8
+	5. bcm2835 Library 1.73 dependency. Provides low level I2C bus, delays and GPIO control.
+
 ## Output
 
 Output Screenshots, From left to right top to bottom.
@@ -59,25 +60,23 @@ Output Screenshots, From left to right top to bottom.
 ## Installation
 
 
-1. Make sure SPI bus is enabled on your raspberry PI
-
-2. Install the dependency bcm2835 Library if not installed (at time of writing latest version is 1.68.)
+1. Install the dependency bcm2835 Library if not installed (at time of writing latest version is 1.73)
 	* The bcm2835 library is a dependency and provides SPI bus, delays and GPIO control.
 	* Install the C libraries of bcm2835, [Installation instructions here](http://www.airspayce.com/mikem/bcm2835/)
 
-3. Download the ERM19264_UC1609_RPI library 
+2. Download the ERM19264_UC1609_RPI library 
 	* Open a Terminal in a folder where you want to download,build & test library
 	* Run following command to download from github.
 
 ```sh
-curl -sL https://github.com/gavinlyonsrepo/ERM19264_UC1609_RPI/archive/1.7.tar.gz | tar xz
+curl -sL https://github.com/gavinlyonsrepo/ERM19264_UC1609_RPI/archive/1.7.1.tar.gz | tar xz
 ```
 
-4. Run "make" to run the makefile to install library, it will be 
+3. Run "make" to run the makefile to install library, it will be 
     installed to usr/lib and usr/include
 
 ```sh
-cd ERM19264_UC1609_RPI-1.7
+cd ERM19264_UC1609_RPI-1.7.1
 make
 sudo make install 
 ```
@@ -97,7 +96,9 @@ make run
 ```
 
 2. There are seven examples files to try out. 
-To decide which one the makefile builds simply edit "SRC" variable at top of the makefile in examples folder. In the "User SRC directory Option Section". Pick an example "SRC" directory path and ONE ONLY. Comment out the rest and repeat step 1.
+To decide which one the makefile builds simply edit "SRC" variable at top of the makefile in examples folder. 
+In the "User SRC directory Option Section". Pick an example "SRC" directory path and ONE ONLY.
+ Comment out the rest and repeat step 1.
 
 
 ## Hardware
@@ -112,18 +113,23 @@ There are 3 different colours in range, Parts used purchased from [ebay](https:/
 2. ERM19264FS-5 V3 LCD Display  UC1609C controller , black on white
 3. ERM19264DNS-5 V3 LCD Display  UC1609C controller white on black
 
-The UC1609 controller chip is a 3.3V device but the ERM LCD module has a "662k" 3.3V regulator at back.
-So the ERM LCD module will run at 5V as well if this is present.
-It was always run it at 3.3V during testing.
-
+Wiring Diagram from supplier showing connection to RPI.
 
 ![ ERM19264 ](https://github.com/gavinlyonsrepo/ERM19264_UC1609_RPI/blob/main/extras/image/wiring.png)
 
+This wiring Diagram from the manufacturer showing hardware setup connected to an ~8051 MCU, showing both 3.3 volt and 5 volt systems.
+Note status of J1 PCB jumper.
+
+![ ERM192642 ](https://github.com/gavinlyonsrepo/ERM19264_UC1609/blob/main/extras/image/connect.jpg)
+
 ## Software
 
 ### SPI
 
-Hardware and software SPI. Two different class constructors. User can pick the relevant constructor, see examples files. Hardware SPI is recommended, far faster and more reliable but Software SPI allows for more flexible GPIO selection. When running Software SPI it may be necessary on very high frequency MCU's to change the UC1609_HIGHFREQ_DELAY define, It is a microsecond delay by default it is at 0.
+Hardware and software SPI. Two different class constructors. User can pick the relevant constructor, 
+see examples files. Hardware SPI is recommended, far faster and more reliable but Software SPI allows 
+for more flexible GPIO selection. When running Software SPI it may be necessary on very high 
+frequency MCU's to change the LCD_HighFreqDelaySet method, It is a microsecond delay by default it is at 0.
 
 The SPI settings are in LCDSPIon function.
 Speed is currently at BCM2835_SPI_CLOCK_DIVIDER_64. 
@@ -166,7 +172,6 @@ The glyph-fonts use 3 special functions: setFontGlyph drawCharGlyph drawTextGlyp
 They cannot currently use the print class, also cannot be inverted.
 Inverting only works with the standard fonts because the characters are a uniform size. It's not a sensible thing to do with proportionally-spaced fonts with glyphs of varying sizes and that may overlap.  
 
-
 ### Bitmaps
 
 There is a few different ways of displaying bitmaps, 
@@ -203,9 +208,3 @@ It is also possible for user to change LCD bias ,  Temperature coefficient, fram
 
 ## Notes and Issues
 
-### Compilation problems
-
-Note the toolchain used in overview section, If you have trouble compiling on other 
-platforms or OS. For example 64-bit OS, user may need to remove or edit
-some of the CCFLAGS in root directory Makefile to allow for Compilation, if you see them throwing errors
-See [pull request on SSD1306 project](https://github.com/gavinlyonsrepo/SSD1306_OLED_RPI/pull/2) for details

examples/src/BITMAP/main.cpp

@@ -5,7 +5,6 @@
 // URL: https://github.com/gavinlyonsrepo/ERM19264_UC1609_RPI
 // *****************************
 
-
 #include <bcm2835.h>
 #include <time.h>
 #include <stdio.h>
@@ -25,25 +24,58 @@ const uint8_t RAMaddressCtrl = 0x02; // RAM address control: Range 0-7, optional
 ERM19264_UC1609 myLCD(myLCDwidth ,myLCDheight, RST, CD) ;
 
 // =============== Function prototype ================
-void setup(void);
-void myLoop(void);
-void EndTest(void);
+
 void Test1(void);
 void Test2(void);
 void Test3(void);
 void Test4(void);
 void Test5(void);
+bool setup(void);
+void myLoop(void);
+void EndTest(void);
 
 // ======================= Main ===================
 int main(int argc, char **argv) 
 {
-	if(!bcm2835_init()){return -1;}
-
-	setup();
+	if(!setup()) {return -1;}
 	myLoop();
 	EndTest();
+
 	return 0;
 }
+// ======================= End of main  ===================
+
+// ===================== Function Space =====================
+bool setup() {
+	printf("LCD Test Begin\r\n");
+	// Check if Bcm28235 lib installed and print version.
+	if(!bcm2835_init())
+	{
+		printf("Error 1201: init bcm2835 library , Is it installed ?\r\n");
+		return false;
+	}else
+	{
+		printf("bcm2835 library Version Number :: %u\r\n",bcm2835_version());
+		bcm2835_delay(100);
+	}
+
+	if(!myLCD.LCDbegin(RAMaddressCtrl, LCDcontrast, SPICLK_FREQ , SPI_CE_PIN))  // initialize the LCD
+	{
+		printf("Error 1202: bcm2835_spi_begin :Cannot start spi, Running as root?\n");
+		return false;
+	}
+	printf("ERM19264 Library version number :: %u \r\n", myLCD.LCDLibVerNumGet());
+	myLCD.LCDFillScreen(0x33); // display splash screen bars, optional for effect
+	bcm2835_delay(1500);
+	return true;
+}
+
+void EndTest()
+{
+	myLCD.LCDPowerDown();
+	bcm2835_close(); // Close library, deallocating allocated memory & closing /dev/mem
+	printf("LCD End\r\n");
+}
 
 //192x64px bitmap,'UC1609' SW used to make https://javl.github.io/image2cpp/ vertical addressing
 uint8_t fullScreenBuffer[1537] = {
@@ -166,15 +198,6 @@ const uint8_t  BatIcon[16] =
 	0xfe, 0x02, 0x92, 0x0a, 0x54, 0x2a, 0x38, 0xaa, 0x12, 0xaa, 0x12, 0xaa, 0x12, 0xaa, 0x12, 0xaa
 	};
 
-void setup()
-{
-	printf("LCD Begin\r\n");
-	bcm2835_delay(50);
-	myLCD.LCDbegin(RAMaddressCtrl , LCDcontrast, SPICLK_FREQ , SPI_CE_PIN); // initialize the LCD
-	myLCD.LCDFillScreen(0xFF); // Clears screen with 1's (i.e fills it)
-	bcm2835_delay(2000);
-}
-
 void myLoop()
 {
 	Test1(); // Method (1) LCD bitmap method
@@ -184,17 +207,11 @@ void myLoop()
 	Test5(); // Method (5) Drawbitmap to buffer method, horizontal addressing
 }
 
-void EndTest()
-{
-	myLCD.LCDPowerDown();
-	bcm2835_close(); // Close library & /dev/mem, deallocating any allocated memory 
-	printf("LCD End\r\n");
-}
-
 
 void Test1(void)
 {
 	// Method (1) LCD bitmap method , writes data directly to screen
+	printf("Test1: LCDBitmap method , Full screen\n");
 	myLCD.LCDBitmap(0, 0 , myLCDwidth, myLCDheight, fullScreenBuffer);
 	bcm2835_delay(5000);
 	myLCD.LCDFillScreen(0x00); 
@@ -205,6 +222,7 @@ void Test2(void)
 	// Method (2) LCD buffer method, writes data directly to screen
 	// This function is called internally by LCDupdate to print buffer
 	// to screen but can be called externally as well as shown.
+	printf("Test2: LCDBuffer method , Two icons\n");
 	myLCD.LCDBuffer(0, 0, 16, 8, (uint8_t*)SignalIcon);
 	myLCD.LCDBuffer(176, 0, 16, 8, (uint8_t*)BatIcon);
 	bcm2835_delay(5000);
@@ -213,17 +231,29 @@ void Test2(void)
 
 void Test3(void)
 {
+	printf("Test3: LCDupdate method ,  full screen\n");
 	myLCD.LCDbufferScreen = (uint8_t*) &fullScreenBuffer;
+	if(myLCD.LCDbufferScreen== nullptr) // check if pointer is still = null
+	{
+		printf("Error 1203 :: Problem assigning buffer pointer\r\n");
+		exit(-1);
+	}
 	myLCD.LCDupdate();
 	bcm2835_delay(5000);
 	myLCD.LCDFillScreen(0x00); 
 }
 
 void Test4(void)
 {
+	printf("Test4:setDrawBitmapAddr method ,  2 icons Data Vertical addressed \n");
 	myLCD.LCDbufferScreen = (uint8_t*) &fullScreenBuffer;
+	if(myLCD.LCDbufferScreen== nullptr) // check if pointer is still = null
+	{
+		printf("Error 1204 :: Problem assigning buffer pointer\r\n");
+		exit(-1);
+	}
 	myLCD.LCDclearBuffer();   // Clear buffer
-	myLCD.setDrawBitmapAddr(true); // for Bitmap Data Vertical  addressed
+	myLCD.setDrawBitmapAddr(true); // for Bitmap Data Vertical addressed
 	myLCD.drawBitmap(0,   5, SignalIcon, 16, 8, FOREGROUND, BACKGROUND);
 	myLCD.drawBitmap(150, 5, BatIcon, 16, 8 , FOREGROUND, BACKGROUND);
 
@@ -233,10 +263,15 @@ void Test4(void)
 
 void Test5(void)
 {
+	printf("Test5:setDrawBitmapAddr method ,  3 icons Data Horizontal addressed \n");
 	myLCD.LCDbufferScreen = (uint8_t*) &fullScreenBuffer;
-	myLCD.LCDclearBuffer();   // Clear active buffer
-
-	myLCD.setDrawBitmapAddr(false); // for Bitmap Data Horziontal addressed
+	if(myLCD.LCDbufferScreen== nullptr) // check if pointer is still = null
+	{
+		printf("Error 1205 :: Problem assigning buffer pointer\r\n");
+		exit(-1);
+	}
+		myLCD.LCDclearBuffer();   // Clear active buffer
+	myLCD.setDrawBitmapAddr(false); // for Bitmap Data Horizontal addressed
 	myLCD.drawBitmap(10, 25, SignalIconHa, 16, 8, FOREGROUND, BACKGROUND);
 	myLCD.drawBitmap(100, 20, SignalIconHa, 16, 8, BACKGROUND, FOREGROUND);
 	myLCD.drawBitmap(60, 20, SignalIconHa, 16, 8, BACKGROUND, FOREGROUND);

examples/src/FONTS_GLYPH/main.cpp

@@ -35,17 +35,15 @@ ERM19264_UC1609 myLCD(myLCDwidth ,myLCDheight, RST, CD );
 #define MY_TEST_DELAY1 bcm2835_delay(1000)
 
 // =============== Function prototype ================
-void setup(void);
+bool setup(void);
 void myTest(void);
 void EndTest(void);
 void testReset(void);
 
 // ======================= Main ===================
 int main(int argc, char **argv)
 {
-	if(!bcm2835_init()) {return -1;}
-
-	setup();
+	if(!setup()) {return -1;}
 	myTest();
 	EndTest();
 
@@ -55,18 +53,34 @@ int main(int argc, char **argv)
 
 
 // ===================== Function Space =====================
-void setup() {
-	bcm2835_delay(50);
-	printf("LCD Begin\r\n");
-	myLCD.LCDbegin(RAMaddressCtrl, LCDcontrast, SPICLK_FREQ , SPI_CE_PIN); // initialize the LCD
-	myLCD.LCDFillScreen(0x33); // splash screen bars
+bool setup() {
+	printf("LCD Test Begin\r\n");
+	// Check if Bcm28235 lib installed and print version.
+	if(!bcm2835_init())
+	{
+		printf("Error 1201: init bcm2835 library , Is it installed ?\r\n");
+		return false;
+	}else
+	{
+		printf("bcm2835 library Version Number :: %u\r\n",bcm2835_version());
+		bcm2835_delay(100);
+	}
+
+	if(!myLCD.LCDbegin(RAMaddressCtrl, LCDcontrast, SPICLK_FREQ , SPI_CE_PIN))  // initialize the LCD
+	{
+		printf("Error 1202: bcm2835_spi_begin :Cannot start spi, Running as root?\n");
+		return false;
+	}
+	printf("ERM19264 Library version number :: %u \r\n", myLCD.LCDLibVerNumGet());
+	myLCD.LCDFillScreen(0x33); // display splash screen bars, optional for effect
 	bcm2835_delay(1500);
+	return true;
 }
 
 void EndTest()
 {
 	myLCD.LCDPowerDown();
-	bcm2835_close(); // Close the library
+	bcm2835_close(); // Close library, deallocating allocated memory & closing /dev/mem
 	printf("LCD End\r\n");
 }
 
@@ -75,6 +89,12 @@ void myTest() {
 	// define a buffer to cover whole screen
 	uint8_t screenBuffer[myLCDwidth * (myLCDheight/8)]; 
 	myLCD.LCDbufferScreen = (uint8_t*) &screenBuffer;
+	if(myLCD.LCDbufferScreen== nullptr) // check if pointer is still = null
+	{
+		printf("Error 1203 :: Problem assigning buffer pointer\r\n");
+		exit(-1);
+	}
+	
 	myLCD.LCDclearBuffer();   // Clear buffer
 
 	// Test 1 Font FreeSans12pt7b
@@ -97,7 +117,7 @@ void myTest() {
 	myLCD.drawCharGlyph(10, 62, '!', FOREGROUND, 1);
 	testReset();
 
-	// Test 4 Font FreeSErif18pt7b
+	// Test 4 Font FreeSerif18pt7b
 	txt = "Free Serif     18pt7b";
 	myLCD.setFontGlyph(&FreeSerif18pt7b);
 	myLCD.drawTextGlyph(0, 26, txt, FOREGROUND, 1);