Browse Source
Introduce a driver for SSD1320 displays Signed-off-by: Camille BAUD <mail@massdriver.space>pull/89391/head
Camille BAUD
4 months ago
committed by
Benjamin Cabé
7 changed files with 680 additions and 0 deletions
@ -0,0 +1,28 @@ |
|||||||
|
# SSD1320 display controller configuration options |
||||||
|
# Copyright (c) 2025 MASSDRIVER EI (massdriver.space) |
||||||
|
# SPDX-License-Identifier: Apache-2.0 |
||||||
|
|
||||||
|
menuconfig SSD1320 |
||||||
|
bool "SSD1320 display controller driver" |
||||||
|
default y |
||||||
|
depends on DT_HAS_SOLOMON_SSD1320_ENABLED |
||||||
|
select MIPI_DBI if $(dt_compat_on_bus,$(DT_COMPAT_SOLOMON_SSD1320),mipi-dbi) |
||||||
|
select I2C if $(dt_compat_on_bus,$(DT_COMPAT_SOLOMON_SSD1320),i2c) |
||||||
|
help |
||||||
|
Enable driver for SSD1320 display controller. |
||||||
|
|
||||||
|
if SSD1320 |
||||||
|
|
||||||
|
config SSD1320_DEFAULT_CONTRAST |
||||||
|
int "SSD1320 default contrast" |
||||||
|
default 128 |
||||||
|
range 0 255 |
||||||
|
help |
||||||
|
SSD1320 default contrast. |
||||||
|
|
||||||
|
config SSD1320_CONV_BUFFER_LINES |
||||||
|
int "How many lines can the conversion buffer hold" |
||||||
|
default 16 |
||||||
|
range 1 160 |
||||||
|
|
||||||
|
endif # SSD1327 |
||||||
@ -0,0 +1,554 @@ |
|||||||
|
/*
|
||||||
|
* Copyright (c) 2025 MASSDRIVER EI (massdriver.space) |
||||||
|
* |
||||||
|
* SPDX-License-Identifier: Apache-2.0 |
||||||
|
*/ |
||||||
|
|
||||||
|
#include <zephyr/logging/log.h> |
||||||
|
LOG_MODULE_REGISTER(ssd1320, CONFIG_DISPLAY_LOG_LEVEL); |
||||||
|
|
||||||
|
#include <string.h> |
||||||
|
#include <zephyr/device.h> |
||||||
|
#include <zephyr/init.h> |
||||||
|
#include <zephyr/drivers/display.h> |
||||||
|
#include <zephyr/drivers/gpio.h> |
||||||
|
#include <zephyr/drivers/i2c.h> |
||||||
|
#include <zephyr/drivers/mipi_dbi.h> |
||||||
|
#include <zephyr/kernel.h> |
||||||
|
|
||||||
|
#define SSD1320_SET_COMMAND_LOCK 0xFD |
||||||
|
#define SSD1320_UNLOCK_COMMAND 0x12 |
||||||
|
|
||||||
|
#define SSD1320_CONTROL_ALL_BYTES_CMD 0x0 |
||||||
|
#define SSD1320_CONTROL_ALL_BYTES_DATA 0x40 |
||||||
|
|
||||||
|
#define SSD1320_SET_PHASE_LENGTH 0xD9 |
||||||
|
#define SSD1320_SET_OSC_FREQ 0xD5 |
||||||
|
#define SSD1320_LINEAR_LUT 0xBF |
||||||
|
#define SSD1320_SET_PRECHARGE_VOLTAGE 0xBC |
||||||
|
#define SSD1320_SET_VCOMH 0xDB |
||||||
|
#define SSD1320_SET_INTERNAL_IREF 0xAD |
||||||
|
#define SSD1320_SET_DISPLAY_START_LINE 0xA2 |
||||||
|
#define SSD1320_SET_DISPLAY_OFFSET 0xD3 |
||||||
|
#define SSD1320_SET_DISPLAY_RAM 0xA4 |
||||||
|
#define SSD1320_SET_SEGMENT_MAP_REMAPED 0xDA |
||||||
|
#define SSD1320_SET_MULTIPLEX_RATIO 0xA8 |
||||||
|
#define SSD1320_DISPLAY_ON 0xAF |
||||||
|
#define SSD1320_DISPLAY_OFF 0xAE |
||||||
|
#define SSD1320_SET_COLUMN_ADDR 0x21 |
||||||
|
#define SSD1320_SET_ROW_ADDR 0x22 |
||||||
|
#define SSD1320_SET_CONTRAST_CTRL 0x81 |
||||||
|
#define SSD1320_SET_NORMAL_DISPLAY 0xA6 |
||||||
|
#define SSD1320_SET_REVERSE_DISPLAY 0xA7 |
||||||
|
#define SSD1320_SET_COM_ORDER_10 0xC0 |
||||||
|
#define SSD1320_SET_COM_ORDER_01 0xC8 |
||||||
|
#define SSD1320_SET_SEG_ORDER_10 0xA0 |
||||||
|
#define SSD1320_SET_SEG_ORDER_01 0xA1 |
||||||
|
#define SSD1320_SET_GREY_ENHANCE 0xD8 |
||||||
|
#define SSD1320_SET_GREY_ENHANCE_ON 0xD5 |
||||||
|
#define SSD1320_SET_GREY_ENHANCE_OFF 0xF5 |
||||||
|
|
||||||
|
#define SSD1320_RESET_DELAY 10 |
||||||
|
#define SSD1320_MAXIMUM_CMD_LENGTH 16 |
||||||
|
|
||||||
|
typedef int (*ssd1320_write_bus_cmd_fn)(const struct device *dev, const uint8_t cmd, |
||||||
|
const uint8_t *data, size_t len); |
||||||
|
typedef int (*ssd1320_write_pixels_fn)(const struct device *dev, const uint8_t *buf, |
||||||
|
uint32_t pixel_count, |
||||||
|
const struct display_buffer_descriptor *desc); |
||||||
|
|
||||||
|
struct ssd1320_config { |
||||||
|
struct i2c_dt_spec i2c; |
||||||
|
ssd1320_write_bus_cmd_fn write_cmd; |
||||||
|
ssd1320_write_pixels_fn write_pixels; |
||||||
|
const struct device *mipi_dev; |
||||||
|
const struct mipi_dbi_config dbi_config; |
||||||
|
uint16_t height; |
||||||
|
uint16_t width; |
||||||
|
uint8_t oscillator_freq; |
||||||
|
uint8_t start_line; |
||||||
|
uint8_t display_offset; |
||||||
|
uint8_t multiplex_ratio; |
||||||
|
uint8_t internal_iref; |
||||||
|
uint8_t remap_value; |
||||||
|
uint8_t phase_length; |
||||||
|
uint8_t precharge_voltage; |
||||||
|
uint8_t vcomh_voltage; |
||||||
|
bool color_inversion; |
||||||
|
bool greyscale_enhancement; |
||||||
|
bool inv_seg; |
||||||
|
bool inv_com; |
||||||
|
uint8_t *conversion_buf; |
||||||
|
size_t conversion_buf_size; |
||||||
|
}; |
||||||
|
|
||||||
|
struct ssd1320_data { |
||||||
|
uint8_t contrast; |
||||||
|
uint8_t scan_mode; |
||||||
|
}; |
||||||
|
|
||||||
|
static inline int ssd1320_write_bus_cmd_mipi(const struct device *dev, const uint8_t cmd, |
||||||
|
const uint8_t *data, size_t len) |
||||||
|
{ |
||||||
|
const struct ssd1320_config *config = dev->config; |
||||||
|
int err; |
||||||
|
|
||||||
|
/* Values given after the memory register must be sent with pin D/C set to 0. */ |
||||||
|
/* Data is sent as a command following the mipi_cbi api */ |
||||||
|
err = mipi_dbi_command_write(config->mipi_dev, &config->dbi_config, cmd, NULL, 0); |
||||||
|
if (err) { |
||||||
|
return err; |
||||||
|
} |
||||||
|
for (size_t i = 0; i < len; i++) { |
||||||
|
err = mipi_dbi_command_write(config->mipi_dev, &config->dbi_config, data[i], NULL, |
||||||
|
0); |
||||||
|
if (err) { |
||||||
|
return err; |
||||||
|
} |
||||||
|
} |
||||||
|
mipi_dbi_release(config->mipi_dev, &config->dbi_config); |
||||||
|
|
||||||
|
return 0; |
||||||
|
} |
||||||
|
|
||||||
|
static inline int ssd1320_write_bus_cmd_i2c(const struct device *dev, const uint8_t cmd, |
||||||
|
const uint8_t *data, size_t len) |
||||||
|
{ |
||||||
|
const struct ssd1320_config *config = dev->config; |
||||||
|
static uint8_t buf[SSD1320_MAXIMUM_CMD_LENGTH]; |
||||||
|
|
||||||
|
if (len > SSD1320_MAXIMUM_CMD_LENGTH - 1) { |
||||||
|
return -EINVAL; |
||||||
|
} |
||||||
|
|
||||||
|
buf[0] = cmd; |
||||||
|
memcpy(&(buf[1]), data, len); |
||||||
|
|
||||||
|
return i2c_burst_write_dt(&config->i2c, SSD1320_CONTROL_ALL_BYTES_CMD, buf, len + 1); |
||||||
|
} |
||||||
|
|
||||||
|
static inline int ssd1320_set_hardware_config(const struct device *dev) |
||||||
|
{ |
||||||
|
const struct ssd1320_config *config = dev->config; |
||||||
|
uint8_t buf; |
||||||
|
int err; |
||||||
|
|
||||||
|
err = config->write_cmd(dev, SSD1320_SET_DISPLAY_START_LINE, &config->start_line, 1); |
||||||
|
if (err < 0) { |
||||||
|
return err; |
||||||
|
} |
||||||
|
err = config->write_cmd(dev, SSD1320_SET_DISPLAY_OFFSET, &config->display_offset, 1); |
||||||
|
if (err < 0) { |
||||||
|
return err; |
||||||
|
} |
||||||
|
err = config->write_cmd(dev, SSD1320_SET_DISPLAY_RAM, NULL, 0); |
||||||
|
if (err < 0) { |
||||||
|
return err; |
||||||
|
} |
||||||
|
err = config->write_cmd(dev, SSD1320_SET_NORMAL_DISPLAY, NULL, 0); |
||||||
|
if (err < 0) { |
||||||
|
return err; |
||||||
|
} |
||||||
|
err = config->write_cmd( |
||||||
|
dev, config->inv_com ? SSD1320_SET_COM_ORDER_01 : SSD1320_SET_COM_ORDER_10, NULL, |
||||||
|
0); |
||||||
|
if (err < 0) { |
||||||
|
return err; |
||||||
|
} |
||||||
|
err = config->write_cmd( |
||||||
|
dev, config->inv_seg ? SSD1320_SET_SEG_ORDER_01 : SSD1320_SET_SEG_ORDER_10, NULL, |
||||||
|
0); |
||||||
|
if (err < 0) { |
||||||
|
return err; |
||||||
|
} |
||||||
|
err = config->write_cmd(dev, SSD1320_SET_SEGMENT_MAP_REMAPED, &config->remap_value, 1); |
||||||
|
if (err < 0) { |
||||||
|
return err; |
||||||
|
} |
||||||
|
if (config->greyscale_enhancement) { |
||||||
|
buf = SSD1320_SET_GREY_ENHANCE_ON; |
||||||
|
err = config->write_cmd(dev, SSD1320_SET_GREY_ENHANCE, &buf, 1); |
||||||
|
if (err < 0) { |
||||||
|
return err; |
||||||
|
} |
||||||
|
|
||||||
|
/* Undocumented enhancement provided by datasheet */ |
||||||
|
buf = 0x21; |
||||||
|
err = config->write_cmd(dev, 0xF0, &buf, 1); |
||||||
|
if (err < 0) { |
||||||
|
return err; |
||||||
|
} |
||||||
|
} |
||||||
|
err = config->write_cmd(dev, SSD1320_SET_MULTIPLEX_RATIO, &config->multiplex_ratio, 1); |
||||||
|
if (err < 0) { |
||||||
|
return err; |
||||||
|
} |
||||||
|
err = config->write_cmd(dev, SSD1320_SET_PHASE_LENGTH, &config->phase_length, 1); |
||||||
|
if (err < 0) { |
||||||
|
return err; |
||||||
|
} |
||||||
|
err = config->write_cmd(dev, SSD1320_SET_OSC_FREQ, &config->oscillator_freq, 1); |
||||||
|
if (err < 0) { |
||||||
|
return err; |
||||||
|
} |
||||||
|
err = config->write_cmd(dev, SSD1320_LINEAR_LUT, NULL, 0); |
||||||
|
if (err < 0) { |
||||||
|
return err; |
||||||
|
} |
||||||
|
err = config->write_cmd(dev, SSD1320_SET_PRECHARGE_VOLTAGE, &config->precharge_voltage, 1); |
||||||
|
if (err < 0) { |
||||||
|
return err; |
||||||
|
} |
||||||
|
err = config->write_cmd(dev, SSD1320_SET_VCOMH, &config->vcomh_voltage, 1); |
||||||
|
if (err < 0) { |
||||||
|
return err; |
||||||
|
} |
||||||
|
err = config->write_cmd(dev, SSD1320_SET_INTERNAL_IREF, &config->internal_iref, 1); |
||||||
|
if (err < 0) { |
||||||
|
return err; |
||||||
|
} |
||||||
|
buf = SSD1320_UNLOCK_COMMAND; |
||||||
|
return config->write_cmd(dev, SSD1320_SET_COMMAND_LOCK, &buf, 1); |
||||||
|
} |
||||||
|
|
||||||
|
static int ssd1320_resume(const struct device *dev) |
||||||
|
{ |
||||||
|
const struct ssd1320_config *config = dev->config; |
||||||
|
|
||||||
|
return config->write_cmd(dev, SSD1320_DISPLAY_ON, NULL, 0); |
||||||
|
} |
||||||
|
|
||||||
|
static int ssd1320_suspend(const struct device *dev) |
||||||
|
{ |
||||||
|
const struct ssd1320_config *config = dev->config; |
||||||
|
|
||||||
|
return config->write_cmd(dev, SSD1320_DISPLAY_OFF, NULL, 0); |
||||||
|
} |
||||||
|
|
||||||
|
static int ssd1320_set_display(const struct device *dev) |
||||||
|
{ |
||||||
|
const struct ssd1320_config *config = dev->config; |
||||||
|
int err; |
||||||
|
uint8_t x_position[] = {0, config->width - 1}; |
||||||
|
uint8_t y_position[] = {0, config->height - 1}; |
||||||
|
|
||||||
|
err = config->write_cmd(dev, SSD1320_SET_COLUMN_ADDR, x_position, sizeof(x_position)); |
||||||
|
if (err < 0) { |
||||||
|
return err; |
||||||
|
} |
||||||
|
err = config->write_cmd(dev, SSD1320_SET_ROW_ADDR, y_position, sizeof(y_position)); |
||||||
|
if (err < 0) { |
||||||
|
return err; |
||||||
|
} |
||||||
|
return config->write_cmd(dev, SSD1320_SET_SEGMENT_MAP_REMAPED, &config->remap_value, 1); |
||||||
|
} |
||||||
|
|
||||||
|
/* Convert what the conversion buffer can hold to pixelx (3:0) and pixelx+1 (7:4) */ |
||||||
|
static int ssd1320_convert_L_8(const struct device *dev, const uint8_t *buf, int cur_offset, |
||||||
|
uint32_t pixel_count) |
||||||
|
{ |
||||||
|
const struct ssd1320_config *config = dev->config; |
||||||
|
int i = 0; |
||||||
|
|
||||||
|
for (; i / 2 < config->conversion_buf_size && pixel_count > cur_offset + i; i += 2) { |
||||||
|
config->conversion_buf[i / 2] = buf[cur_offset + i] >> 4; |
||||||
|
config->conversion_buf[i / 2] |= (buf[cur_offset + i + 1] >> 4) << 4; |
||||||
|
} |
||||||
|
return i; |
||||||
|
} |
||||||
|
|
||||||
|
#if DT_HAS_COMPAT_ON_BUS_STATUS_OKAY(solomon_ssd1320, mipi_dbi) |
||||||
|
static int ssd1320_write_pixels_mipi(const struct device *dev, const uint8_t *buf, |
||||||
|
uint32_t pixel_count, |
||||||
|
const struct display_buffer_descriptor *desc) |
||||||
|
{ |
||||||
|
const struct ssd1320_config *config = dev->config; |
||||||
|
struct display_buffer_descriptor mipi_desc; |
||||||
|
int ret, i; |
||||||
|
int total = 0; |
||||||
|
|
||||||
|
mipi_desc.pitch = desc->pitch; |
||||||
|
|
||||||
|
while (pixel_count > total) { |
||||||
|
i = ssd1320_convert_L_8(dev, buf, total, pixel_count); |
||||||
|
|
||||||
|
mipi_desc.buf_size = i / 2; |
||||||
|
mipi_desc.width = mipi_desc.buf_size / desc->height; |
||||||
|
mipi_desc.height = mipi_desc.buf_size / desc->width; |
||||||
|
|
||||||
|
/* This is the wrong format, but it doesn't matter to almost all mipi drivers */ |
||||||
|
ret = mipi_dbi_write_display(config->mipi_dev, &config->dbi_config, |
||||||
|
config->conversion_buf, &mipi_desc, PIXEL_FORMAT_L_8); |
||||||
|
if (ret < 0) { |
||||||
|
return ret; |
||||||
|
} |
||||||
|
total += i; |
||||||
|
} |
||||||
|
mipi_dbi_release(config->mipi_dev, &config->dbi_config); |
||||||
|
return 0; |
||||||
|
} |
||||||
|
#endif |
||||||
|
|
||||||
|
#if DT_HAS_COMPAT_ON_BUS_STATUS_OKAY(solomon_ssd1320, i2c) |
||||||
|
static int ssd1320_write_pixels_i2c(const struct device *dev, const uint8_t *buf, |
||||||
|
uint32_t pixel_count, |
||||||
|
const struct display_buffer_descriptor *desc) |
||||||
|
{ |
||||||
|
const struct ssd1320_config *config = dev->config; |
||||||
|
int ret, i; |
||||||
|
int total = 0; |
||||||
|
|
||||||
|
while (pixel_count > total) { |
||||||
|
i = ssd1320_convert_L_8(dev, buf, total, pixel_count); |
||||||
|
|
||||||
|
ret = i2c_burst_write_dt(&config->i2c, SSD1320_CONTROL_ALL_BYTES_DATA, |
||||||
|
config->conversion_buf, i / 2); |
||||||
|
if (ret < 0) { |
||||||
|
return ret; |
||||||
|
} |
||||||
|
total += i; |
||||||
|
} |
||||||
|
return 0; |
||||||
|
} |
||||||
|
#endif |
||||||
|
|
||||||
|
static int ssd1320_write(const struct device *dev, const uint16_t x, const uint16_t y, |
||||||
|
const struct display_buffer_descriptor *desc, const void *buf) |
||||||
|
{ |
||||||
|
const struct ssd1320_config *config = dev->config; |
||||||
|
int err; |
||||||
|
size_t buf_len; |
||||||
|
int32_t pixel_count = desc->width * desc->height; |
||||||
|
uint8_t x_position[] = {x / 2, (x + desc->width - 1) / 2}; |
||||||
|
uint8_t y_position[] = {y, y + desc->height - 1}; |
||||||
|
|
||||||
|
if (desc->pitch != desc->width) { |
||||||
|
LOG_ERR("Pitch is not width"); |
||||||
|
return -EINVAL; |
||||||
|
} |
||||||
|
|
||||||
|
/* Following the datasheet, in the GDDRAM, two segment are split in one register */ |
||||||
|
buf_len = MIN(desc->buf_size, desc->height * desc->width / 2); |
||||||
|
if (buf == NULL || buf_len == 0U) { |
||||||
|
LOG_ERR("Display buffer is not available"); |
||||||
|
return -EINVAL; |
||||||
|
} |
||||||
|
|
||||||
|
if ((x & 1) != 0U) { |
||||||
|
LOG_ERR("Unsupported origin"); |
||||||
|
return -EINVAL; |
||||||
|
} |
||||||
|
|
||||||
|
LOG_DBG("x %u, y %u, pitch %u, width %u, height %u, buf_len %u", x, y, desc->pitch, |
||||||
|
desc->width, desc->height, buf_len); |
||||||
|
|
||||||
|
err = config->write_cmd(dev, SSD1320_SET_COLUMN_ADDR, x_position, sizeof(x_position)); |
||||||
|
if (err) { |
||||||
|
return err; |
||||||
|
} |
||||||
|
|
||||||
|
err = config->write_cmd(dev, SSD1320_SET_ROW_ADDR, y_position, sizeof(y_position)); |
||||||
|
if (err) { |
||||||
|
return err; |
||||||
|
} |
||||||
|
|
||||||
|
return config->write_pixels(dev, buf, pixel_count, desc); |
||||||
|
} |
||||||
|
|
||||||
|
static int ssd1320_set_contrast(const struct device *dev, const uint8_t contrast) |
||||||
|
{ |
||||||
|
const struct ssd1320_config *config = dev->config; |
||||||
|
|
||||||
|
return config->write_cmd(dev, SSD1320_SET_CONTRAST_CTRL, &contrast, 1); |
||||||
|
} |
||||||
|
|
||||||
|
static void ssd1320_get_capabilities(const struct device *dev, struct display_capabilities *caps) |
||||||
|
{ |
||||||
|
const struct ssd1320_config *config = dev->config; |
||||||
|
|
||||||
|
memset(caps, 0, sizeof(struct display_capabilities)); |
||||||
|
caps->x_resolution = config->width; |
||||||
|
caps->y_resolution = config->height; |
||||||
|
caps->supported_pixel_formats = PIXEL_FORMAT_L_8; |
||||||
|
caps->current_pixel_format = PIXEL_FORMAT_L_8; |
||||||
|
caps->screen_info = 0; |
||||||
|
} |
||||||
|
|
||||||
|
static int ssd1320_set_pixel_format(const struct device *dev, const enum display_pixel_format pf) |
||||||
|
{ |
||||||
|
if (pf == PIXEL_FORMAT_L_8) { |
||||||
|
return 0; |
||||||
|
} |
||||||
|
LOG_ERR("Unsupported pixel format"); |
||||||
|
return -ENOTSUP; |
||||||
|
} |
||||||
|
|
||||||
|
static int ssd1320_init_device(const struct device *dev) |
||||||
|
{ |
||||||
|
const struct ssd1320_config *config = dev->config; |
||||||
|
uint8_t buf; |
||||||
|
int err; |
||||||
|
|
||||||
|
/* Turn display off */ |
||||||
|
err = ssd1320_suspend(dev); |
||||||
|
if (err < 0) { |
||||||
|
return err; |
||||||
|
} |
||||||
|
|
||||||
|
err = ssd1320_set_display(dev); |
||||||
|
if (err < 0) { |
||||||
|
return err; |
||||||
|
} |
||||||
|
|
||||||
|
err = ssd1320_set_contrast(dev, CONFIG_SSD1320_DEFAULT_CONTRAST); |
||||||
|
if (err < 0) { |
||||||
|
return err; |
||||||
|
} |
||||||
|
|
||||||
|
err = ssd1320_set_hardware_config(dev); |
||||||
|
if (err < 0) { |
||||||
|
return err; |
||||||
|
} |
||||||
|
|
||||||
|
buf = (config->color_inversion ? SSD1320_SET_REVERSE_DISPLAY : SSD1320_SET_NORMAL_DISPLAY); |
||||||
|
err = config->write_cmd(dev, buf, NULL, 0); |
||||||
|
if (err < 0) { |
||||||
|
return err; |
||||||
|
} |
||||||
|
|
||||||
|
return ssd1320_resume(dev); |
||||||
|
} |
||||||
|
|
||||||
|
#if DT_HAS_COMPAT_ON_BUS_STATUS_OKAY(solomon_ssd1320, mipi_dbi) |
||||||
|
static int ssd1320_init(const struct device *dev) |
||||||
|
{ |
||||||
|
const struct ssd1320_config *config = dev->config; |
||||||
|
int err; |
||||||
|
|
||||||
|
LOG_DBG("Initializing device"); |
||||||
|
|
||||||
|
if (!device_is_ready(config->mipi_dev)) { |
||||||
|
LOG_ERR("MIPI Device not ready!"); |
||||||
|
return -EINVAL; |
||||||
|
} |
||||||
|
|
||||||
|
if (mipi_dbi_reset(config->mipi_dev, SSD1320_RESET_DELAY)) { |
||||||
|
LOG_ERR("Failed to reset device!"); |
||||||
|
return -EIO; |
||||||
|
} |
||||||
|
k_msleep(SSD1320_RESET_DELAY); |
||||||
|
|
||||||
|
err = ssd1320_init_device(dev); |
||||||
|
if (err < 0) { |
||||||
|
LOG_ERR("Failed to initialize device! %d", err); |
||||||
|
return err; |
||||||
|
} |
||||||
|
|
||||||
|
return 0; |
||||||
|
} |
||||||
|
#endif |
||||||
|
|
||||||
|
#if DT_HAS_COMPAT_ON_BUS_STATUS_OKAY(solomon_ssd1320, i2c) |
||||||
|
static int ssd1320_init_i2c(const struct device *dev) |
||||||
|
{ |
||||||
|
const struct ssd1320_config *config = dev->config; |
||||||
|
int err; |
||||||
|
|
||||||
|
LOG_DBG("Initializing device"); |
||||||
|
|
||||||
|
if (!i2c_is_ready_dt(&config->i2c)) { |
||||||
|
LOG_ERR("I2C Device not ready!"); |
||||||
|
return -EINVAL; |
||||||
|
} |
||||||
|
|
||||||
|
err = ssd1320_init_device(dev); |
||||||
|
if (err < 0) { |
||||||
|
LOG_ERR("Failed to initialize device! %d", err); |
||||||
|
return err; |
||||||
|
} |
||||||
|
|
||||||
|
return 0; |
||||||
|
} |
||||||
|
#endif |
||||||
|
|
||||||
|
static DEVICE_API(display, ssd1320_driver_api) = { |
||||||
|
.blanking_on = ssd1320_suspend, |
||||||
|
.blanking_off = ssd1320_resume, |
||||||
|
.write = ssd1320_write, |
||||||
|
.set_contrast = ssd1320_set_contrast, |
||||||
|
.get_capabilities = ssd1320_get_capabilities, |
||||||
|
.set_pixel_format = ssd1320_set_pixel_format, |
||||||
|
}; |
||||||
|
|
||||||
|
#define SSD1320_WORD_SIZE(inst) \ |
||||||
|
((DT_STRING_UPPER_TOKEN(inst, mipi_mode) == MIPI_DBI_MODE_SPI_4WIRE) ? SPI_WORD_SET(8) \ |
||||||
|
: SPI_WORD_SET(9)) |
||||||
|
|
||||||
|
#define SSD1320_CONV_BUFFER_SIZE(node_id) \ |
||||||
|
DIV_ROUND_UP(DT_PROP(node_id, width) * CONFIG_SSD1320_CONV_BUFFER_LINES, 2) |
||||||
|
|
||||||
|
#define SSD1320_DEFINE_I2C(node_id) \ |
||||||
|
static uint8_t conversion_buf##node_id[SSD1320_CONV_BUFFER_SIZE(node_id)]; \ |
||||||
|
static struct ssd1320_data data##node_id; \ |
||||||
|
static const struct ssd1320_config config##node_id = { \ |
||||||
|
.i2c = I2C_DT_SPEC_GET(node_id), \ |
||||||
|
.height = DT_PROP(node_id, height), \ |
||||||
|
.width = DT_PROP(node_id, width), \ |
||||||
|
.oscillator_freq = DT_PROP(node_id, oscillator_freq), \ |
||||||
|
.display_offset = DT_PROP(node_id, display_offset), \ |
||||||
|
.start_line = DT_PROP(node_id, start_line), \ |
||||||
|
.multiplex_ratio = DT_PROP(node_id, multiplex_ratio), \ |
||||||
|
.remap_value = DT_PROP(node_id, remap_value), \ |
||||||
|
.color_inversion = DT_PROP(node_id, inversion_on), \ |
||||||
|
.phase_length = DT_PROP(node_id, phase_length), \ |
||||||
|
.internal_iref = DT_PROP(node_id, internal_iref), \ |
||||||
|
.precharge_voltage = DT_PROP(node_id, precharge_voltage), \ |
||||||
|
.vcomh_voltage = DT_PROP(node_id, vcomh_voltage), \ |
||||||
|
.greyscale_enhancement = DT_PROP(node_id, greyscale_enhancement), \ |
||||||
|
.inv_seg = DT_PROP(node_id, inv_seg), \ |
||||||
|
.inv_com = DT_PROP(node_id, inv_com), \ |
||||||
|
.write_cmd = ssd1320_write_bus_cmd_i2c, \ |
||||||
|
.write_pixels = ssd1320_write_pixels_i2c, \ |
||||||
|
.conversion_buf = conversion_buf##node_id, \ |
||||||
|
.conversion_buf_size = sizeof(conversion_buf##node_id), \ |
||||||
|
}; \ |
||||||
|
\ |
||||||
|
DEVICE_DT_DEFINE(node_id, ssd1320_init_i2c, NULL, &data##node_id, &config##node_id, \ |
||||||
|
POST_KERNEL, CONFIG_DISPLAY_INIT_PRIORITY, &ssd1320_driver_api); |
||||||
|
|
||||||
|
#define SSD1320_DEFINE_MIPI(node_id) \ |
||||||
|
static uint8_t conversion_buf##node_id[SSD1320_CONV_BUFFER_SIZE(node_id)]; \ |
||||||
|
static struct ssd1320_data data##node_id; \ |
||||||
|
static const struct ssd1320_config config##node_id = { \ |
||||||
|
.mipi_dev = DEVICE_DT_GET(DT_PARENT(node_id)), \ |
||||||
|
.dbi_config = MIPI_DBI_CONFIG_DT( \ |
||||||
|
node_id, SSD1320_WORD_SIZE(node_id) | SPI_OP_MODE_MASTER, 0), \ |
||||||
|
.height = DT_PROP(node_id, height), \ |
||||||
|
.width = DT_PROP(node_id, width), \ |
||||||
|
.oscillator_freq = DT_PROP(node_id, oscillator_freq), \ |
||||||
|
.display_offset = DT_PROP(node_id, display_offset), \ |
||||||
|
.start_line = DT_PROP(node_id, start_line), \ |
||||||
|
.multiplex_ratio = DT_PROP(node_id, multiplex_ratio), \ |
||||||
|
.remap_value = DT_PROP(node_id, remap_value), \ |
||||||
|
.color_inversion = DT_PROP(node_id, inversion_on), \ |
||||||
|
.phase_length = DT_PROP(node_id, phase_length), \ |
||||||
|
.internal_iref = DT_PROP(node_id, internal_iref), \ |
||||||
|
.precharge_voltage = DT_PROP(node_id, precharge_voltage), \ |
||||||
|
.vcomh_voltage = DT_PROP(node_id, vcomh_voltage), \ |
||||||
|
.greyscale_enhancement = DT_PROP(node_id, greyscale_enhancement), \ |
||||||
|
.inv_seg = DT_PROP(node_id, inv_seg), \ |
||||||
|
.inv_com = DT_PROP(node_id, inv_com), \ |
||||||
|
.write_cmd = ssd1320_write_bus_cmd_mipi, \ |
||||||
|
.write_pixels = ssd1320_write_pixels_mipi, \ |
||||||
|
.conversion_buf = conversion_buf##node_id, \ |
||||||
|
.conversion_buf_size = sizeof(conversion_buf##node_id), \ |
||||||
|
}; \ |
||||||
|
\ |
||||||
|
DEVICE_DT_DEFINE(node_id, ssd1320_init, NULL, &data##node_id, &config##node_id, \ |
||||||
|
POST_KERNEL, CONFIG_DISPLAY_INIT_PRIORITY, &ssd1320_driver_api); |
||||||
|
|
||||||
|
#define SSD1320_DEFINE(node_id) \ |
||||||
|
COND_CODE_1(DT_ON_BUS(node_id, i2c), \ |
||||||
|
(SSD1320_DEFINE_I2C(node_id)), (SSD1320_DEFINE_MIPI(node_id))) |
||||||
|
|
||||||
|
DT_FOREACH_STATUS_OKAY(solomon_ssd1320, SSD1320_DEFINE) |
||||||
@ -0,0 +1,80 @@ |
|||||||
|
# Copyright (c) 2025 MASSDRIVER EI (massdriver.space) |
||||||
|
# SPDX-License-Identifier: Apache-2.0 |
||||||
|
|
||||||
|
include: display-controller.yaml |
||||||
|
|
||||||
|
properties: |
||||||
|
oscillator-freq: |
||||||
|
type: int |
||||||
|
required: true |
||||||
|
description: Front clock divider (3:0) / oscillator frequency (7:4). It can be set to 0x0. |
||||||
|
If you get weird scanlines, increase oscillator frequency and play with phase length values, |
||||||
|
for example set this to 0x70. Note this increases power consumption. |
||||||
|
|
||||||
|
display-offset: |
||||||
|
type: int |
||||||
|
required: true |
||||||
|
description: Vertical offset by com from 0 ~ 159. Typically 160 - height. |
||||||
|
|
||||||
|
start-line: |
||||||
|
type: int |
||||||
|
required: true |
||||||
|
description: Start line of display RAM to be displayed by selecting a value from 0 to 159. |
||||||
|
Typically 0. |
||||||
|
|
||||||
|
multiplex-ratio: |
||||||
|
type: int |
||||||
|
required: true |
||||||
|
description: Multiplex ratio from 15MUX to 159MUX. Typically same value as height - 1. |
||||||
|
|
||||||
|
remap-value: |
||||||
|
type: int |
||||||
|
required: true |
||||||
|
description: Remap register |
||||||
|
|
||||||
|
Has multiple configurations (see each bit setting in the datasheet) |
||||||
|
- A[1] must be 1 |
||||||
|
- Sequential (0) or Alternative (Odd/Even) SEGs (A[4]) |
||||||
|
- Disable or Enable SEG left/right remap (A[5]) |
||||||
|
|
||||||
|
A[4] is needed when display has striping. |
||||||
|
|
||||||
|
phase-length: |
||||||
|
type: int |
||||||
|
required: true |
||||||
|
description: Phase Length for segment charging (7:4) and discharging (3:0). |
||||||
|
Good values to try first are 0x1f and 0xf1. |
||||||
|
|
||||||
|
internal-iref: |
||||||
|
type: int |
||||||
|
default: 0x10 |
||||||
|
description: Internal or external iref. 0x0 is External, 0x10 Internal. |
||||||
|
Most displays use Internal. |
||||||
|
|
||||||
|
precharge-voltage: |
||||||
|
type: int |
||||||
|
default: 0x1E |
||||||
|
description: Set precharge voltage (4:0) from 0.10 x VCC to 0.5113 x VCC (0x1F). |
||||||
|
0x1E is the reset default. |
||||||
|
|
||||||
|
vcomh-voltage: |
||||||
|
type: int |
||||||
|
default: 0x20 |
||||||
|
description: Set COM deselect voltage (5:3) from 0.72 x VCC (0x0) to 0.84 x VCC (0x30) |
||||||
|
0x20 is the reset default. |
||||||
|
|
||||||
|
inversion-on: |
||||||
|
type: boolean |
||||||
|
description: Turn on display color inverting |
||||||
|
|
||||||
|
greyscale-enhancement: |
||||||
|
type: boolean |
||||||
|
description: Enable low greyscale enhancement, partially undocumented. |
||||||
|
|
||||||
|
inv-seg: |
||||||
|
type: boolean |
||||||
|
description: Invert segment order |
||||||
|
|
||||||
|
inv-com: |
||||||
|
type: boolean |
||||||
|
description: Invert COM order |
||||||
@ -0,0 +1,8 @@ |
|||||||
|
# Copyright (c) 2025 MASSDRIVER EI (massdriver.space) |
||||||
|
# SPDX-License-Identifier: Apache-2.0 |
||||||
|
|
||||||
|
description: SSD1320 160x160 dot-matrix display controller on I2C bus |
||||||
|
|
||||||
|
include: ["solomon,ssd1320-common.yaml", "i2c-device.yaml"] |
||||||
|
|
||||||
|
compatible: "solomon,ssd1320" |
||||||
@ -0,0 +1,8 @@ |
|||||||
|
# Copyright (c) 2025 MASSDRIVER EI (massdriver.space) |
||||||
|
# SPDX-License-Identifier: Apache-2.0 |
||||||
|
|
||||||
|
description: SSD1320 160x160 dot-matrix display controller on MIPI_DBI or SPI bus |
||||||
|
|
||||||
|
include: ["solomon,ssd1320-common.yaml", "mipi-dbi-spi-device.yaml"] |
||||||
|
|
||||||
|
compatible: "solomon,ssd1320" |
||||||
Loading…
Reference in new issue