dan
/
epaper
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity
Browse Source

fleshed out simple API; able to display on Waveshare 4.2in (B) display

master
Daniel Peter Chokola 3 years ago
parent
d1d0483aef
commit
7edb8e5f97
15 changed files with 1362 additions and 334 deletions
Whitespace
Show all changes Ignore whitespace when comparing lines Ignore changes in amount of whitespace Ignore changes in whitespace at EOL
Unified View
Diff Options
Show Stats Download Patch File Download Diff File
  1. 3
      .vscode/launch.json
  2. 9
      .vscode/settings.json
  3. 20
      CMakeLists.txt
  4. 69
      epaper.c
  5. 10
      epd/CMakeLists.txt
  6. 11
      epd/epd.c
  7. 34
      epd/epd.h
  8. 1112
      epd/epd_4p2mono.c
  9. 15
      epd/epd_4p2mono.h
  10. 85
      epd0.c
  11. 30
      epd0.h
  12. 241
      epd_4p2b.h
  13. 19
      inc/libepd/epd.h
  14. 21
      inc/libepd/private/priv_epd.h
  15. 15
      src/libepd/epd.c

3
.vscode/launch.json vendored
Unescape View File

@ -23,7 +23,8 @@
"postRestartCommands": [ "postRestartCommands": [
"break main", "break main",
"continue" "continue"
] ],
"searchDir": ["/scratch/projects/pico/openocd/tcl/"]
} }
] ]
} }

9
.vscode/settings.json vendored
Unescape View File

@ -13,4 +13,13 @@
"visibility": "hidden" "visibility": "hidden"
}, },
}, },
"cmake.buildBeforeRun": true,
"C_Cpp.default.configurationProvider": "ms-vscode.cmake-tools",
"cortex-debug.openocdPath": "/opt/pico/bin/openocd",
"files.associations": {
"epd0.h": "c",
"stdlib.h": "c",
"epd.h": "c",
"stddef.h": "c"
}
} }

20
CMakeLists.txt
Unescape View File

@ -7,7 +7,7 @@ set(CMAKE_CXX_STANDARD 17)
# Initialise pico_sdk from installed location # Initialise pico_sdk from installed location
# (note this can come from environment, CMake cache etc) # (note this can come from environment, CMake cache etc)
set(PICO_SDK_PATH "/home/dan/pico/pico-sdk") include($ENV{PICO_SDK_PATH}/external/pico_sdk_import.cmake)
# Pull in Raspberry Pi Pico SDK (must be before project) # Pull in Raspberry Pi Pico SDK (must be before project)
include(pico_sdk_import.cmake) include(pico_sdk_import.cmake)
@ -17,26 +17,28 @@ project(epaper C CXX ASM)
# Initialise the Raspberry Pi Pico SDK # Initialise the Raspberry Pi Pico SDK
pico_sdk_init() pico_sdk_init()
add_subdirectory(./epd)
# Add executable. Default name is the project name, version 0.1 # Add executable. Default name is the project name, version 0.1
add_executable(epaper epaper.c ) add_executable(${PROJECT_NAME} epaper.c epd0.c)
pico_set_program_name(epaper "epaper") pico_set_program_name(${PROJECT_NAME} "epaper")
pico_set_program_version(epaper "0.1") pico_set_program_version(${PROJECT_NAME} "0.1")
pico_enable_stdio_uart(epaper 1) pico_enable_stdio_uart(${PROJECT_NAME} 1)
pico_enable_stdio_usb(epaper 0) pico_enable_stdio_usb(${PROJECT_NAME} 0)
# Add the standard library to the build # Add the standard library to the build
target_link_libraries(epaper pico_stdlib) target_link_libraries(${PROJECT_NAME} pico_stdlib epd)
# Add any user requested libraries # Add any user requested libraries
target_link_libraries(epaper target_link_libraries(${PROJECT_NAME}
hardware_spi hardware_spi
hardware_dma hardware_dma
hardware_pio hardware_pio
hardware_timer hardware_timer
) )
pico_add_extra_outputs(epaper) pico_add_extra_outputs(${PROJECT_NAME})

69
epaper.c
Unescape View File

@ -4,45 +4,60 @@
#include "hardware/dma.h" #include "hardware/dma.h"
#include "hardware/pio.h" #include "hardware/pio.h"
#include "hardware/timer.h" #include "hardware/timer.h"
#include "epd0.h"
#include "epd/epd_4p2mono.h"
// SPI Defines /* Function Declarations */
// We are going to use SPI 0, and allocate it to the following GPIO pins static bool timer_callback(repeating_timer_t *timer);
// Pins can be changed, see the GPIO function select table in the datasheet for information on GPIO assignments
#define SPI_PORT spi0
#define PIN_MISO 16
#define PIN_CS 17
#define PIN_SCK 18
#define PIN_MOSI 19
int64_t alarm_callback(alarm_id_t id, void *user_data) { /* Function Definitions */
// Put your timeout handler code in here static inline void spi_cs_assert()
return 0; {
gpio_put(EPD0_PIN_CS, 0);
}
static inline void spi_cs_deassert()
{
gpio_put(EPD0_PIN_CS, 1);
}
static inline void spi_write_byte(uint8_t b)
{
spi_cs_assert();
spi_write_blocking(EPD0_SPI_PORT, &b, 1);
spi_cs_deassert();
}
static inline void spi_read_busy()
{
do
{
spi_write_byte(0x71);
}
while (gpio_get(EPD0_PIN_BUSY));
} }
int main() int main()
{ {
stdio_init_all(); repeating_timer_t timer;
// SPI initialisation. This example will use SPI at 1MHz.
spi_init(SPI_PORT, 1000*1000);
gpio_set_function(PIN_MISO, GPIO_FUNC_SPI);
gpio_set_function(PIN_CS, GPIO_FUNC_SIO);
gpio_set_function(PIN_SCK, GPIO_FUNC_SPI);
gpio_set_function(PIN_MOSI, GPIO_FUNC_SPI);
// Chip select is active-low, so we'll initialise it to a driven-high state stdio_init_all();
gpio_set_dir(PIN_CS, GPIO_OUT);
gpio_put(PIN_CS, 1);
epd0_init();
epd_4p2mono_init(&epd0);
epd_4p2mono_clear(&epd0);
epd_4p2mono_testpattern(&epd0);
epd_4p2mono_testimg(&epd0);
// Timer example code - This example fires off the callback after 2000ms
add_repeating_timer_ms(2000, timer_callback, NULL, &timer);
for(;;);
// Timer example code - This example fires off the callback after 2000ms return 0;
add_alarm_in_ms(2000, alarm_callback, NULL, false); }
static bool timer_callback(repeating_timer_t *timer)
{
// Put your timeout handler code in here
puts("Hello, world!"); puts("Hello, world!");
return 0; return true;
} }

10
epd/CMakeLists.txt
Unescape View File

@ -0,0 +1,10 @@
cmake_minimum_required(VERSION 3.13)
set(CMAKE_C_STANDARD 11)
set(CMAKE_CXX_STANDARD 17)
project(epd C CXX ASM)
file(GLOB FILES *.c *.h)
add_library(${PROJECT_NAME} ${FILES})

11
epd/epd.c
Unescape View File

@ -0,0 +1,11 @@
/* epd.c - E-Paper Display library API */
/* Includes */
#include "epd.h"
#include "string.h"
/* Function Definitions */
void epd_init(epd_t *epd, epd_config_t *cfg)
{
memcpy(&(epd->cfg), cfg, sizeof(epd_config_t));
}

34
epd/epd.h
Unescape View File

@ -0,0 +1,34 @@
/* epd.h - E-Paper Display library API */
#ifndef EPD_H_
#define EPD_H_
/* Includes */
#include "stddef.h"
#include "stdint.h"
#include "stdbool.h"
/* Data Structures */
typedef int (*epd_spi_write)(const uint8_t *, size_t, void *);
typedef void (*epd_spi_cs)(bool, void *);
typedef void (*epd_gpo_dc)(bool, void *);
typedef void (*epd_gpo_rst)(bool, void *);
typedef bool (*epd_gpi_busy)(void *);
typedef void (*epd_sleep_ms)(uint32_t, void *);
typedef struct epd_config_s {
epd_spi_write spi_write;
epd_spi_cs spi_cs;
epd_gpo_dc dc;
epd_gpo_rst rst;
epd_gpi_busy busy;
epd_sleep_ms sleep_ms;
void *udata;
} epd_config_t;
typedef struct epd_s {
epd_config_t cfg;
} epd_t;
/* Function Prototypes */
void epd_init(epd_t *epd, epd_config_t *cfg);
#endif /* EPD_H_ */

1112
epd/epd_4p2mono.c
View File

File diff suppressed because it is too large Load Diff

15
epd/epd_4p2mono.h
Unescape View File

@ -0,0 +1,15 @@
/* epd.h - E-Paper Display library API */
#ifndef EPD_4P2MONO_H_
#define EPD_4P2MONO_H_
/* Includes */
#include "epd.h"
/* Function Prototypes */
void epd_4p2mono_init(epd_t *epd);
void epd_4p2mono_clear(epd_t *epd);
void epd_4p2mono_testpattern(epd_t *epd);
void epd_4p2mono_testimg(epd_t *epd);
#endif /* EPD_4P2MONO_H_ */

85
epd0.c
Unescape View File

@ -0,0 +1,85 @@
/* epd0.c - Instantiate E-Paper Display 0 */
/* Includes */
#include <stdio.h>
#include "pico/stdlib.h"
#include "hardware/spi.h"
#include "epd/epd.h"
#include "epd0.h"
/* Definitions */
/* Data Structures */
/* Global Variables */
epd_t epd0;
/* Function Prototypes */
static int epd0_spi_write(const uint8_t *buf, size_t len, void *udata);
static void epd0_spi_cs(bool state, void *udata);
static void epd0_gpo_rst(bool state, void *udata);
static void epd0_gpo_dc(bool state, void *udata);
static bool epd0_gpo_busy(void *udata);
static void epd0_sleep_ms(uint32_t ms, void *udata);
/* Function Definitions */
void epd0_init()
{
epd_config_t epd0_cfg = {
.spi_write = epd0_spi_write,
.spi_cs = epd0_spi_cs,
.rst = epd0_gpo_rst,
.dc = epd0_gpo_dc,
.busy = epd0_gpo_busy,
.sleep_ms = epd0_sleep_ms,
.udata = NULL
};
/* SPI initialisation. This example will use SPI at 1MHz. */
spi_init(EPD0_SPI_PORT, 1000*1000);
gpio_set_function(EPD0_PIN_MISO, GPIO_FUNC_SPI);
gpio_set_function(EPD0_PIN_CS, GPIO_FUNC_SIO);
gpio_set_function(EPD0_PIN_SCK, GPIO_FUNC_SPI);
gpio_set_function(EPD0_PIN_MOSI, GPIO_FUNC_SPI);
/* initialize other display pins */
gpio_set_function(EPD0_PIN_RST, GPIO_FUNC_SIO);
gpio_set_function(EPD0_PIN_BUSY, GPIO_FUNC_SIO);
gpio_set_function(EPD0_PIN_DC, GPIO_FUNC_SIO);
gpio_set_dir(EPD0_PIN_CS, GPIO_OUT);
gpio_set_dir(EPD0_PIN_RST, GPIO_OUT);
gpio_set_dir(EPD0_PIN_BUSY, GPIO_IN);
gpio_set_dir(EPD0_PIN_DC, GPIO_OUT);
/* initialize epd0 */
epd_init(&epd0, &epd0_cfg);
}
static int epd0_spi_write(const uint8_t *buf, size_t len, void *udata)
{
return spi_write_blocking(EPD0_SPI_PORT, buf, len);
}
static void epd0_spi_cs(bool state, void *udata)
{
gpio_put(EPD0_PIN_CS, state ? 0 : 1);
}
static void epd0_gpo_rst(bool state, void *udata)
{
gpio_put(EPD0_PIN_RST, state ? 0 : 1);
}
static void epd0_gpo_dc(bool state, void *udata)
{
gpio_put(EPD0_PIN_DC, state ? 1 : 0);
}
static bool epd0_gpo_busy(void *udata)
{
return gpio_get(EPD0_PIN_BUSY);
}
static void epd0_sleep_ms(uint32_t ms, void *udata)
{
sleep_ms(ms);
}

30
epd0.h
Unescape View File

@ -0,0 +1,30 @@
/* epd0.h - Instantiate E-Paper Display 0 */
#ifndef EPD0_H_
#define EPD0_H_
/* Includes */
#include <stdio.h>
#include "pico/stdlib.h"
#include "hardware/spi.h"
#include "epd/epd.h"
/* Definitions */
#define EPD0_SPI_PORT spi0
#define EPD0_PIN_SCK 2
#define EPD0_PIN_MOSI 3
#define EPD0_PIN_MISO 4
#define EPD0_PIN_CS 5
#define EPD0_PIN_DC 6
#define EPD0_PIN_RST 7
#define EPD0_PIN_BUSY 8
/* Data Structures */
/* Global Variables */
extern epd_t epd0;
/* Function Prototypes */
void epd0_init();
#endif /* EPD0_H_ */

241
epd_4p2b.h
Unescape View File

@ -1,241 +0,0 @@
#include "stdint.h"
/* Definitions */
#define CMD_PSR (0x00) /* panel settings */
#define CMD_PWR (0x01) /* power settings */
#define CMD_POF (0x02) /* power off */
#define CMD_PFS (0x03) /* power off sequence settings */
#define CMD_PON (0x04) /* power on */
#define CMD_PMES (0x05) /* power on measure */
#define CMD_BTST (0x06) /* booster soft-start */
#define CMD_DSLP (0x07) /* deep sleep */
#define CMD_DTM1 (0x10) /* display start transmission 1 (white/black data) */
#define CMD_DSP (0x11) /* data stop */
#define CMD_DRF (0x12) /* display refresh */
#define CMD_DTM2 (0x13) /* display start transmission 2 (red data) */
#define CMD_PLL (0x30) /* PLL control */
#define CMD_TSC (0x40) /* temperature sensor calibration */
#define CMD_TSE (0x41) /* temperature sensor selection */
#define CMD_TSW (0x42) /* temperature sensor write */
#define CMD_TSR (0x43) /* temperature sensor read */
#define CMD_CDI (0x50) /* VCOM and data interval settings */
#define CMD_LPD (0x51) /* low power detection */
#define CMD_TCON (0x60) /* TCON settings */
#define CMD_TRES (0x61) /* resolution settings */
#define CMD_GSST (0x65) /* GSST settings */
#define CMD_REV (0x70) /* revision */
#define CMD_FLG (0x71) /* get status */
#define CMD_VCOM (0x80) /* auto-measurement */
#define CMD_VV (0x81) /* read VCOM value */
#define CMD_VDCS (0x82) /* VCOM_DC settings */
#define CMD_PTL (0x90) /* partial window */
#define CMD_PTIN (0x91) /* partial in */
#define CMD_PTOUT (0x92) /* partial out */
#define CMD_PGM (0xa0) /* program mode */
#define CMD_APG (0xa1) /* active programming */
#define CMD_ROTP (0xa2) /* read OTP */
#define CMD_CCSET (0xe0) /* cascade settings */
#define CMD_PWS (0xe3) /* power saving */
#define CMD_LPSEL (0xe4) /* LPD selection */
#define CMD_TSSET (0xe5) /* force temperature */
/* Data Structures */
typedef union psr_u = {
struct __attribute__((packed)) psr_s = {
uint8_t rst_n : 1, /* soft reset */
uint8_t shd_n : 1, /* booster switch */
uint8_t shl : 1, /* horizontal scan direction */
uint8_t ud : 1, /* vertical scan direction */
uint8_t _na0 : 1, /* don't care */
uint8_t reg : 1, /* B/W/R or B/W */
uint8_t res : 2 /* display resolution */
} field,
uint8_t u8
} psr_t;
typedef union pwr_u = {
struct __attribute__((packed)) pwr_s = {
uint8_t vdhr : 6, /* internal VDHR power selection for red pixel */
uint8_t _na4 : 2, /* don't care */
uint8_t vdl : 6, /* internal VDL power selectrion for B/W pixel */
uint8_t _na3 : 2, /* don't care */
uint8_t vdh : 6, /* internal VDH power selection for B/W pixel */
uint8_t _na2 : 2, /* don't care */
uint8_t vghl_lv : 2, /* VGH/VGL voltage level selection */
uint8_t vcom_hv : 1, /* VCOM voltage level */
uint8_t _na1 : 5, /* don't care */
uint8_t vdg_en : 1, /* gate power selection */
uint8_t vds_en : 1, /* source power selection */
uint8_t _na0 : 6 , /* don't care */
} field,
uint8_t u8[5];
} pwr_t;
typedef union pfs_u = {
struct __attribute__((packed)) pfs_s = {
uint8_t _na1 : 4, /* don't care */
uint8_t t_vds_off : 2, /* power off sequence of VDH and VDL */
uint8_t _na0 : 2 /* don't care */
} field,
uint8_t u8
} pfs_t;
typedef union btst_u = {
struct __attribute__((packed)) btst_s = {
uint8_t bt_phc : 6, /* phase C: drive strength / minimum GDR off time */
uint8_t _na0 : 2, /* display resolution */
uint8_t bt_phb : 8, /* phase B: soft-start period / drive strength / minimum GDR off time */
uint8_t bt_pha : 8 /* phase A: soft-start period / drive strength / minimum GDR off time */
} field,
uint8_t u8[3]
} btst_t;
typedef union pll_u = {
struct __attribute__((packed)) pll_s = {
uint8_t n : 3, /* N: 1-7 */
uint8_t m : 3, /* M: 1-7 */
uint8_t _na0 : 2 /* don't care */
} field,
uint8_t u8
} pll_t;
typedef uint16_t tsc_t;
typedef union tse_u = {
struct tse_t = {
uint8_t to : 4, /* temperature offset */
uint8_t _na0 : 3, /* don't care */
uint8_t tse : 1 /* internal temperature sensor switch */
} field,
uint8_t u8
} tse_t;
typedef union tsw_u = {
struct __attribute__((packed)) tsw_s = {
uint8_t wlsb : 8, /* LSB of data to write to external temperature sensor */
uint8_t wmsb : 8, /* MSB of data to write to external temperature sensor */
uint8_t wattr : 8 /* I2C write byte number */
} field,
uint8_t u8[3]
} tsw_t;
typedef union tsr_u = {
struct __attribute__((packed)) tsr_s = {
uint8_t rlsb : 8, /* LSB of data to read from external temperature sensor */
uint8_t rmsb : 8 /* MSB of data to read from external temperature sensor */
} field,
uint8_t u8[2]
} tsr_t;
typedef union cdi_u = {
struct __attribute__((packed)) cdi_s = {
uint8_t cdi : 4, /* VCOM and data interval */
uint8_t ddx : 2, /* data polarity */
uint8_t vbd : 2 /* border data selection */
} field,
uint8_t u8
} cdi_t;
typedef union lpd_u = {
struct __attribute__((packed)) lpd_s = {
uint8_t lpd : 1, /* low power detection flag */
uint8_t _na0 : 7 /* don't care */
} field,
uint8_t u8
} lpd_t;
typedef union tcon_u = {
struct __attribute__((packed)) tcon_s = {
uint8_t g2s : 8, /* gate to source dead time */
uint8_t s2g : 8 /* source to gate dead time */
} field,
uint8_t u8[2]
} tcon_t;
typedef union tres_u = {
struct __attribute__((packed)) tres_s = {
uint16_t _na1 : 7, /* don't care */
uint16_t hres : 9, /* horizontal resolution */
uint16_t _na0 : 7, /* don't care */
uint16_t vres : 9 /* vertical resolution */
} field,
uint8_t u8[4],
uint16_t u16[2],
uint32_t u32
} tres_t;
typedef union gsst_u = {
struct __attribute__((packed)) gsst_s = {
uint16_t _na1 : 7, /* don't care */
uint16_t hst : 9, /* first active source */
uint16_t _na0 : 7, /* don't care */
uint16_t vst : 9 /* first active gate */
} field,
uint8_t u8[4],
uint16_t u16[2],
uint32_t u32
} gsst_t;
typedef uint8_t rev_t;
typedef union flg_u = {
struct __attribute__((packed)) flg_s = {
uint8_t busy_n : 1, /* driver busy status */
uint8_t pof : 1, /* power off status */
uint8_t pon : 1, /* power on status */
uint8_t date_flag : 1, /* driver has received one frame of data */
uint8_t i2c_busyn : 1, /* I2C master busy */
uint8_t i2c_err : 1, /* I2C master error */
uint8_t ptl_flag : 1, /* partial display status */
uint8_t _na0 : 1 /* don't care */
} field,
uint8_t u8
} flg_t;
typedef union amv_u = {
struct __attribute__((packed)) amv_s = {
uint8_t amve : 1, /* auto measure VCOM (AMV) enable */
uint8_t amv : 1, /* analog signal */
uint8_t amvs : 1, /* source output of AMV */
uint8_t xon : 1, /* status of gates during AMV */
uint8_t amvt : 2, /* AMV time */
uint8_t _na0 : 2 /* don't care */
} field,
uint8_t u8
} amv_t;
typedef union vv_u = {
struct __attribute__((packed)) vv_s = {
uint8_t vv : 6, /* VCOM value */
uint8_t _na0 : 2 /* don't care */
} field,
uint8_t u8
} vv_t;
typedef union vcds_u = {
struct __attribute__((packed)) vcds_s = {
uint8_t vcds : 6, /* VCOM_DC value */
uint8_t _na0 : 2 /* don't care */
} field,
uint8_t u8
} vcds_t;
typedef union ptl_u = {
struct __attribute__((packed)) ptl_s = {
uint8_t pt_scan : 1, /* limit scan inside partial window */
uint8_t _na4 : 7, /* don't care */
uint16_t vred : 9, /* vertical end line */
uint16_t _na3 : 7, /* don't care */
uint16_t vrst : 9, /* vertical start line */
uint16_t _na2 : 7, /* don't care */
uint16_t hred : 9, /* horizontal end line */
uint16_t _na1 : 7, /* don't care */
uint16_t hrst : 9, /* horizontal start line */
uint16_t _na0 : 7 /* don't care */
} field,
uint8_t u8[5]
} ptl_t;
typedef union ccset_u = {
struct __attribute__((packed)) ccset_s = {
uint8_t ccen : 1, /* output clock enable */
uint8_t tsfix : 1, /* set the slave temperature equal to the master */
uint8_t _na0 : 6 /* don't care */
} field,
uint8_t u8
} ccset_t;
typedef union pws_u = {
struct __attribute__((packed)) pws_s = {
uint8_t sd_w : 4, /* source power saving width */
uint8_t vcom_w : 4 /* VCOM power saving width */
} field,
uint8_t u8
} pws_t;
typedef union lpsel_u = {
struct __attribute__((packed)) lpsel_s = {
uint8_t lp_sel : 2, /* LPD level setting */
uint8_t lpmd : 1, /* low power / panel break detection */
uint8_t _na0 : 5 /* don't care */
} field,
uint8_t u8
} lpsel_t;

19
inc/libepd/epd.h
Unescape View File

@ -1,19 +0,0 @@
/* epd.h - E-Paper Display library API */
#ifndef EPD_H_
#define EPD_H_
/* Includes */
#include "stdint.h"
/* Definitions */
/* Data Structures */
typedef struct epd_s epd_t;
typedef void (*epd_spi_write)(const uint8_t *, size_t, void *);
typedef void (*epd_spi_cs)(const uint8_t, void *);
typedef void (*epd_dc)(const uint8_t, void *);
/* Function Prototypes */
#endif /* EPD_H_ */

21
inc/libepd/private/priv_epd.h
Unescape View File

@ -1,21 +0,0 @@
/* priv_epd.h - private definitions for libepd */
#ifndef PRIV_EPD_H_
#define PRIV_EPD_H_
/* Includes */
#include "epd.h"
/* Definitions */
/* Data Structures */
struct epd_s {
epd_spi_write spi_write,
epd_spi_cs spi_cs,
epd_dc dc,
void *udata
};
/* Function Prototypes */
#endif /* PRIV_EPD_H_ */

15
src/libepd/epd.c
Unescape View File

@ -1,15 +0,0 @@
/* epd.h - E-Paper Display library API */
/* Includes */
#include "epd.h"
#include "priv_epd.h"
/* Definitions */
/* Data Structures */
/* Global Variables */
/* Function Prototypes */
/* Function Definitions */
Write Preview
Loading…
Cancel
Save