epaper 0.1.0 → 0.1.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6e0f498046b4d5c078b12a20a7ffd0b3d967e76ad5d2a97368acb0afd149be06
-  data.tar.gz: ffb09a8f38e6be03bc25ceabaf95a2d1a6b2b10a1e8fa64a5ae8e3f490547e56
+  metadata.gz: 18072d9581c0211fb2ffadcf529f31e2937dac5a8d71353a83d1b99301a2978c
+  data.tar.gz: d6321cea5dbe732f1204951ce8e1717e798bb344614bc9ccb590ad7311aea337
 SHA512:
-  metadata.gz: 33e9c374dd89dd33e7418a173820c0fb785ca41024f72cc07d0ee2127e6343ded4b947fe41b4dc7e9b7e1702a33fb79b79654b8d3496724309e45b97ff42608b
-  data.tar.gz: 2810b2b7e8adffacd8a4355a26ba4152e04ab0aa4beb7016737720452b923db55f8d4ff5957b867f6c8c6ffeaa0567149e6f88632ce0746eca1105136fe23b8a
+  metadata.gz: e6569536588da5aac3492ccbe3d48947720df4c0f0390480704bdbda62ed2b6ad8b06bed1631f14112a9c3a00282de68586f7a7cc37b176fdd230b1acee7a9f1
+  data.tar.gz: ca00dbd0d90ff8878c184a4d6e2c4a61911f9b83fa4acafc85c5f5be7f0c7083bfc0dd10d023031130d4065483d4951d33a054ec6fcd5c8a98f4b9365b0165e2

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    epaper (0.1.0)
+    epaper (0.1.3)
       octokit (~> 4.22.0)
       rmagick (~> 4.2.4)
 

data/Rakefile

@@ -23,7 +23,7 @@ Rake::ExtensionTask.new("epaper", GEMSPEC) do |ext|
   ext.lib_dir = "lib/epaper"
 end
 
-task default: %i[fetch_waveshare_files clobber compile]
+task default: %i[clobber compile]
 
 task :fetch_waveshare_files do
   WaveshareFetcher.new.call

data/ext/epaper/DEV_Config.c

@@ -0,0 +1,385 @@
+/*****************************************************************************
+* | File      	:   DEV_Config.c
+* | Author      :   Waveshare team
+* | Function    :   Hardware underlying interface
+* | Info        :
+*----------------
+* |	This version:   V3.0
+* | Date        :   2019-07-31
+* | Info        :   
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documnetation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of theex Software, and to permit persons to  whom the Software is
+# furished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in
+# all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS OR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+# THE SOFTWARE.
+#
+******************************************************************************/
+#include "DEV_Config.h"
+#include <fcntl.h>
+
+/**
+ * GPIO
+**/
+int EPD_RST_PIN;
+int EPD_DC_PIN;
+int EPD_CS_PIN;
+int EPD_BUSY_PIN;
+
+/**
+ * GPIO read and write
+**/
+void DEV_Digital_Write(UWORD Pin, UBYTE Value)
+{
+#ifdef RPI
+#ifdef USE_BCM2835_LIB
+	bcm2835_gpio_write(Pin, Value);
+#elif USE_WIRINGPI_LIB
+	digitalWrite(Pin, Value);
+#elif USE_DEV_LIB
+	SYSFS_GPIO_Write(Pin, Value);
+#endif
+#endif
+
+#ifdef JETSON
+#ifdef USE_DEV_LIB
+	SYSFS_GPIO_Write(Pin, Value);
+#elif USE_HARDWARE_LIB
+	Debug("not support");
+#endif
+#endif
+}
+
+UBYTE DEV_Digital_Read(UWORD Pin)
+{
+	UBYTE Read_value = 0;
+#ifdef RPI
+#ifdef USE_BCM2835_LIB
+	Read_value = bcm2835_gpio_lev(Pin);
+#elif USE_WIRINGPI_LIB
+	Read_value = digitalRead(Pin);
+#elif USE_DEV_LIB
+	Read_value = SYSFS_GPIO_Read(Pin);
+#endif
+#endif
+
+#ifdef JETSON
+#ifdef USE_DEV_LIB
+	Read_value = SYSFS_GPIO_Read(Pin);
+#elif USE_HARDWARE_LIB
+	Debug("not support");
+#endif
+#endif
+	return Read_value;
+}
+
+/**
+ * SPI
+**/
+void DEV_SPI_WriteByte(uint8_t Value)
+{
+#ifdef RPI
+#ifdef USE_BCM2835_LIB
+	bcm2835_spi_transfer(Value);
+#elif USE_WIRINGPI_LIB
+	wiringPiSPIDataRW(0,&Value,1);
+#elif USE_DEV_LIB
+	DEV_HARDWARE_SPI_TransferByte(Value);
+#endif
+#endif
+
+#ifdef JETSON
+#ifdef USE_DEV_LIB
+	SYSFS_software_spi_transfer(Value);
+#elif USE_HARDWARE_LIB
+	Debug("not support");
+#endif
+#endif
+}
+
+void DEV_SPI_Write_nByte(uint8_t *pData, uint32_t Len)
+{
+#ifdef RPI
+#ifdef USE_BCM2835_LIB
+	char rData[Len];
+	bcm2835_spi_transfernb((char *)pData,rData,Len);
+#elif USE_WIRINGPI_LIB
+	wiringPiSPIDataRW(0, pData, Len);
+#elif USE_DEV_LIB
+	DEV_HARDWARE_SPI_Transfer(pData, Len);
+#endif
+#endif
+
+#ifdef JETSON
+#ifdef USE_DEV_LIB
+	//JETSON nano waits for hardware SPI
+	Debug("not support");
+#elif USE_HARDWARE_LIB
+	Debug("not support");
+#endif
+#endif
+}
+
+/**
+ * GPIO Mode
+**/
+void DEV_GPIO_Mode(UWORD Pin, UWORD Mode)
+{
+#ifdef RPI
+#ifdef USE_BCM2835_LIB
+	if(Mode == 0 || Mode == BCM2835_GPIO_FSEL_INPT) {
+		bcm2835_gpio_fsel(Pin, BCM2835_GPIO_FSEL_INPT);
+	} else {
+		bcm2835_gpio_fsel(Pin, BCM2835_GPIO_FSEL_OUTP);
+	}
+#elif USE_WIRINGPI_LIB
+	if(Mode == 0 || Mode == INPUT) {
+		pinMode(Pin, INPUT);
+		pullUpDnControl(Pin, PUD_UP);
+	} else {
+		pinMode(Pin, OUTPUT);
+		// Debug (" %d OUT \r\n",Pin);
+	}
+#elif USE_DEV_LIB
+	SYSFS_GPIO_Export(Pin);
+	if(Mode == 0 || Mode == SYSFS_GPIO_IN) {
+		SYSFS_GPIO_Direction(Pin, SYSFS_GPIO_IN);
+		// Debug("IN Pin = %d\r\n",Pin);
+	} else {
+		SYSFS_GPIO_Direction(Pin, SYSFS_GPIO_OUT);
+		// Debug("OUT Pin = %d\r\n",Pin);
+	}
+#endif
+#endif
+
+#ifdef JETSON
+#ifdef USE_DEV_LIB
+	SYSFS_GPIO_Export(Pin);
+	SYSFS_GPIO_Direction(Pin, Mode);
+#elif USE_HARDWARE_LIB
+	Debug("not support");
+#endif
+#endif
+}
+
+/**
+ * delay x ms
+**/
+void DEV_Delay_ms(UDOUBLE xms)
+{
+#ifdef RPI
+#ifdef USE_BCM2835_LIB
+	bcm2835_delay(xms);
+#elif USE_WIRINGPI_LIB
+	delay(xms);
+#elif USE_DEV_LIB
+	UDOUBLE i;
+	for(i=0; i < xms; i++) {
+		usleep(1000);
+	}
+#endif
+#endif
+
+#ifdef JETSON
+	UDOUBLE i;
+	for(i=0; i < xms; i++) {
+		usleep(1000);
+	}
+#endif
+}
+
+static int DEV_Equipment_Testing(void)
+{
+	int i;
+	int fd;
+	char value_str[20];
+	fd = open("/etc/issue", O_RDONLY);
+    printf("Current environment: ");
+	while(1) {
+		if (fd < 0) {
+			Debug( "Read failed Pin\n");
+			return -1;
+		}
+		for(i=0;; i++) {
+			if (read(fd, &value_str[i], 1) < 0) {
+				Debug( "failed to read value!\n");
+				return -1;
+			}
+			if(value_str[i] ==32) {
+				printf("\r\n");
+				break;
+			}
+			printf("%c",value_str[i]);
+		}
+		break;
+	}
+#ifdef RPI
+	if(i<5) {
+		printf("Unrecognizable\r\n");
+	} else {
+		char RPI_System[10]   = {"Raspbian"};
+		for(i=0; i<6; i++) {
+			if(RPI_System[i]!= value_str[i]) {
+				printf("Please make JETSON !!!!!!!!!!\r\n");
+				return -1;
+			}
+		}
+	}
+#endif
+#ifdef JETSON
+	if(i<5) {
+		Debug("Unrecognizable\r\n");
+	} else {
+		char JETSON_System[10]= {"Ubuntu"};
+		for(i=0; i<6; i++) {
+			if(JETSON_System[i]!= value_str[i] ) {
+				printf("Please make RPI !!!!!!!!!!\r\n");
+				return -1;
+			}
+		}
+	}
+#endif
+	return 0;
+}
+
+
+
+void DEV_GPIO_Init(void)
+{
+#ifdef RPI
+	EPD_RST_PIN     = 17;
+	EPD_DC_PIN      = 25;
+	EPD_CS_PIN      = 8;
+	EPD_BUSY_PIN    = 24;
+#elif JETSON
+	EPD_RST_PIN     = GPIO17;
+	EPD_DC_PIN      = GPIO25;
+	EPD_CS_PIN      = SPI0_CS0;
+	EPD_BUSY_PIN    = GPIO24;
+#endif
+
+	DEV_GPIO_Mode(EPD_RST_PIN, 1);
+	DEV_GPIO_Mode(EPD_DC_PIN, 1);
+	DEV_GPIO_Mode(EPD_CS_PIN, 1);
+	DEV_GPIO_Mode(EPD_BUSY_PIN, 0);
+
+	DEV_Digital_Write(EPD_CS_PIN, 1);
+}
+/******************************************************************************
+function:	Module Initialize, the library and initialize the pins, SPI protocol
+parameter:
+Info:
+******************************************************************************/
+UBYTE DEV_Module_Init(void)
+{
+    printf("/***********************************/ \r\n");
+	if(DEV_Equipment_Testing() < 0) {
+		return 1;
+	}
+#ifdef RPI
+#ifdef USE_BCM2835_LIB
+	if(!bcm2835_init()) {
+		printf("bcm2835 init failed  !!! \r\n");
+		return 1;
+	} else {
+		printf("bcm2835 init success !!! \r\n");
+	}
+
+	// GPIO Config
+	DEV_GPIO_Init();
+
+	bcm2835_spi_begin();                                         //Start spi interface, set spi pin for the reuse function
+	bcm2835_spi_setBitOrder(BCM2835_SPI_BIT_ORDER_MSBFIRST);     //High first transmission
+	bcm2835_spi_setDataMode(BCM2835_SPI_MODE0);                  //spi mode 0
+	bcm2835_spi_setClockDivider(BCM2835_SPI_CLOCK_DIVIDER_128);  //Frequency
+	bcm2835_spi_chipSelect(BCM2835_SPI_CS0);                     //set CE0
+	bcm2835_spi_setChipSelectPolarity(BCM2835_SPI_CS0, LOW);     //enable cs0
+
+#elif USE_WIRINGPI_LIB
+	//if(wiringPiSetup() < 0)//use wiringpi Pin number table
+	if(wiringPiSetupGpio() < 0) { //use BCM2835 Pin number table
+		printf("set wiringPi lib failed	!!! \r\n");
+		return 1;
+	} else {
+		printf("set wiringPi lib success !!! \r\n");
+	}
+
+	// GPIO Config
+	DEV_GPIO_Init();
+	wiringPiSPISetup(0,10000000);
+	// wiringPiSPISetupMode(0, 32000000, 0);
+#elif USE_DEV_LIB
+	printf("Write and read /dev/spidev0.0 \r\n");
+	DEV_GPIO_Init();
+	DEV_HARDWARE_SPI_begin("/dev/spidev0.0");
+    DEV_HARDWARE_SPI_setSpeed(10000000);
+#endif
+
+#elif JETSON
+#ifdef USE_DEV_LIB
+	DEV_GPIO_Init();
+	printf("Software spi\r\n");
+	SYSFS_software_spi_begin();
+	SYSFS_software_spi_setBitOrder(SOFTWARE_SPI_MSBFIRST);
+	SYSFS_software_spi_setDataMode(SOFTWARE_SPI_Mode0);
+	SYSFS_software_spi_setClockDivider(SOFTWARE_SPI_CLOCK_DIV4);
+#elif USE_HARDWARE_LIB
+	printf("Write and read /dev/spidev0.0 \r\n");
+	DEV_GPIO_Init();
+	DEV_HARDWARE_SPI_begin("/dev/spidev0.0");
+#endif
+
+#endif
+    printf("/***********************************/ \r\n");
+	return 0;
+}
+
+/******************************************************************************
+function:	Module exits, closes SPI and BCM2835 library
+parameter:
+Info:
+******************************************************************************/
+void DEV_Module_Exit(void)
+{
+#ifdef RPI
+#ifdef USE_BCM2835_LIB
+	DEV_Digital_Write(EPD_CS_PIN, LOW);
+	DEV_Digital_Write(EPD_DC_PIN, LOW);
+	DEV_Digital_Write(EPD_RST_PIN, LOW);
+
+	bcm2835_spi_end();
+	bcm2835_close();
+#elif USE_WIRINGPI_LIB
+	DEV_Digital_Write(EPD_CS_PIN, 0);
+	DEV_Digital_Write(EPD_DC_PIN, 0);
+	DEV_Digital_Write(EPD_RST_PIN, 0);
+#elif USE_DEV_LIB
+	DEV_HARDWARE_SPI_end();
+	DEV_Digital_Write(EPD_CS_PIN, 0);
+	DEV_Digital_Write(EPD_DC_PIN, 0);
+	DEV_Digital_Write(EPD_RST_PIN, 0);
+#endif
+
+#elif JETSON
+#ifdef USE_DEV_LIB
+	SYSFS_GPIO_Unexport(EPD_CS_PIN);
+	SYSFS_GPIO_Unexport(EPD_DC_PIN);
+	SYSFS_GPIO_Unexport(EPD_RST_PIN);
+	SYSFS_GPIO_Unexport(EPD_BUSY_PIN);
+#elif USE_HARDWARE_LIB
+	Debug("not support");
+#endif
+#endif
+}

data/ext/epaper/DEV_Config.h

@@ -0,0 +1,108 @@
+/*****************************************************************************
+* | File      	:   DEV_Config.h
+* | Author      :   Waveshare team
+* | Function    :   Hardware underlying interface
+* | Info        :
+*                Used to shield the underlying layers of each master
+*                and enhance portability
+*----------------
+* |	This version:   V2.0
+* | Date        :   2018-10-30
+* | Info        :
+* 1.add:
+*   UBYTE\UWORD\UDOUBLE
+* 2.Change:
+*   EPD_RST -> EPD_RST_PIN
+*   EPD_DC -> EPD_DC_PIN
+*   EPD_CS -> EPD_CS_PIN
+*   EPD_BUSY -> EPD_BUSY_PIN
+* 3.Remote:
+*   EPD_RST_1\EPD_RST_0
+*   EPD_DC_1\EPD_DC_0
+*   EPD_CS_1\EPD_CS_0
+*   EPD_BUSY_1\EPD_BUSY_0
+* 3.add:
+*   #define DEV_Digital_Write(_pin, _value) bcm2835_GPIOI_write(_pin, _value)
+*   #define DEV_Digital_Read(_pin) bcm2835_GPIOI_lev(_pin)
+*   #define DEV_SPI_WriteByte(__value) bcm2835_spi_transfer(__value)
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documnetation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to  whom the Software is
+# furished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in
+# all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS OR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+# THE SOFTWARE.
+#
+******************************************************************************/
+#ifndef _DEV_CONFIG_H_
+#define _DEV_CONFIG_H_
+
+#include <stdint.h>
+#include <stdio.h>
+#include <unistd.h>
+#include <errno.h>
+#include <stdio.h>
+#include <string.h>
+#include "Debug.h"
+
+#ifdef RPI
+    #ifdef USE_BCM2835_LIB
+        #include <bcm2835.h>
+    #elif USE_WIRINGPI_LIB
+        #include <wiringPi.h>
+        #include <wiringPiSPI.h>
+    #elif USE_DEV_LIB
+        #include "RPI_sysfs_gpio.h"
+        #include "dev_hardware_SPI.h"
+    #endif
+#endif
+
+#ifdef JETSON
+    #ifdef USE_DEV_LIB
+        #include "sysfs_gpio.h"    
+        #include "sysfs_software_spi.h"
+    #elif USE_HARDWARE_LIB
+        
+    #endif
+
+#endif
+
+/**
+ * data
+**/
+#define UBYTE   uint8_t
+#define UWORD   uint16_t
+#define UDOUBLE uint32_t
+
+/**
+ * GPIOI config
+**/
+extern int EPD_RST_PIN;
+extern int EPD_DC_PIN;
+extern int EPD_CS_PIN;
+extern int EPD_BUSY_PIN;
+
+/*------------------------------------------------------------------------------------------------------*/
+void DEV_Digital_Write(UWORD Pin, UBYTE Value);
+UBYTE DEV_Digital_Read(UWORD Pin);
+
+void DEV_SPI_WriteByte(UBYTE Value);
+void DEV_SPI_Write_nByte(uint8_t *pData, uint32_t Len);
+void DEV_Delay_ms(UDOUBLE xms);
+
+UBYTE DEV_Module_Init(void);
+void DEV_Module_Exit(void);
+
+
+#endif

data/ext/epaper/Debug.h

@@ -0,0 +1,47 @@
+/*****************************************************************************
+* | File      	:	Debug.h
+* | Author      :   Waveshare team
+* | Function    :	debug with printf
+* | Info        :
+*   Image scanning
+*      Please use progressive scanning to generate images or fonts
+*----------------
+* |	This version:   V2.0
+* | Date        :   2018-10-30
+* | Info        :   
+*   1.USE_DEBUG -> DEBUG, If you need to see the debug information, 
+*    clear the execution: make DEBUG=-DDEBUG
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documnetation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to  whom the Software is
+# furished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in
+# all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS OR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+# THE SOFTWARE.
+#
+
+******************************************************************************/
+#ifndef __DEBUG_H
+#define __DEBUG_H
+
+#include <stdio.h>
+
+#if DEBUG
+	#define Debug(__info,...) printf("Debug: " __info,##__VA_ARGS__)
+#else
+	#define Debug(__info,...)  
+#endif
+
+#endif
+