123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169 |
- // SPDX-License-Identifier: GPL-2.0-only
- /*
- * DRM driver for Solomon SSD130X OLED displays (SPI bus)
- *
- * Copyright 2022 Red Hat Inc.
- * Authors: Javier Martinez Canillas <[email protected]>
- */
- #include <linux/spi/spi.h>
- #include <linux/module.h>
- #include "ssd130x.h"
- #define DRIVER_NAME "ssd130x-spi"
- #define DRIVER_DESC "DRM driver for Solomon SSD130X OLED displays (SPI)"
- struct ssd130x_spi_transport {
- struct spi_device *spi;
- struct gpio_desc *dc;
- };
- /*
- * The regmap bus .write handler, it is just a wrapper around spi_write()
- * but toggling the Data/Command control pin (D/C#). Since for 4-wire SPI
- * a D/C# pin is used, in contrast with I2C where a control byte is sent,
- * prior to every data byte, that contains a bit with the D/C# value.
- *
- * These control bytes are considered registers by the ssd130x core driver
- * and can be used by the ssd130x SPI driver to determine if the data sent
- * is for a command register or for the Graphic Display Data RAM (GDDRAM).
- */
- static int ssd130x_spi_write(void *context, const void *data, size_t count)
- {
- struct ssd130x_spi_transport *t = context;
- struct spi_device *spi = t->spi;
- const u8 *reg = data;
- if (*reg == SSD130X_COMMAND)
- gpiod_set_value_cansleep(t->dc, 0);
- if (*reg == SSD130X_DATA)
- gpiod_set_value_cansleep(t->dc, 1);
- /* Remove control byte since is not used in a 4-wire SPI interface */
- return spi_write(spi, reg + 1, count - 1);
- }
- /* The ssd130x driver does not read registers but regmap expects a .read */
- static int ssd130x_spi_read(void *context, const void *reg, size_t reg_size,
- void *val, size_t val_size)
- {
- return -EOPNOTSUPP;
- }
- static const struct regmap_config ssd130x_spi_regmap_config = {
- .reg_bits = 8,
- .val_bits = 8,
- .write = ssd130x_spi_write,
- .read = ssd130x_spi_read,
- .can_multi_write = true,
- };
- static int ssd130x_spi_probe(struct spi_device *spi)
- {
- struct ssd130x_spi_transport *t;
- struct ssd130x_device *ssd130x;
- struct regmap *regmap;
- struct gpio_desc *dc;
- struct device *dev = &spi->dev;
- dc = devm_gpiod_get(dev, "dc", GPIOD_OUT_LOW);
- if (IS_ERR(dc))
- return dev_err_probe(dev, PTR_ERR(dc),
- "Failed to get dc gpio\n");
- t = devm_kzalloc(dev, sizeof(*t), GFP_KERNEL);
- if (!t)
- return dev_err_probe(dev, -ENOMEM,
- "Failed to allocate SPI transport data\n");
- t->spi = spi;
- t->dc = dc;
- regmap = devm_regmap_init(dev, NULL, t, &ssd130x_spi_regmap_config);
- if (IS_ERR(regmap))
- return PTR_ERR(regmap);
- ssd130x = ssd130x_probe(dev, regmap);
- if (IS_ERR(ssd130x))
- return PTR_ERR(ssd130x);
- spi_set_drvdata(spi, ssd130x);
- return 0;
- }
- static void ssd130x_spi_remove(struct spi_device *spi)
- {
- struct ssd130x_device *ssd130x = spi_get_drvdata(spi);
- ssd130x_remove(ssd130x);
- }
- static void ssd130x_spi_shutdown(struct spi_device *spi)
- {
- struct ssd130x_device *ssd130x = spi_get_drvdata(spi);
- ssd130x_shutdown(ssd130x);
- }
- static const struct of_device_id ssd130x_of_match[] = {
- {
- .compatible = "sinowealth,sh1106",
- .data = &ssd130x_variants[SH1106_ID],
- },
- {
- .compatible = "solomon,ssd1305",
- .data = &ssd130x_variants[SSD1305_ID],
- },
- {
- .compatible = "solomon,ssd1306",
- .data = &ssd130x_variants[SSD1306_ID],
- },
- {
- .compatible = "solomon,ssd1307",
- .data = &ssd130x_variants[SSD1307_ID],
- },
- {
- .compatible = "solomon,ssd1309",
- .data = &ssd130x_variants[SSD1309_ID],
- },
- { /* sentinel */ }
- };
- MODULE_DEVICE_TABLE(of, ssd130x_of_match);
- #if IS_MODULE(CONFIG_DRM_SSD130X_SPI)
- /*
- * The SPI core always reports a MODALIAS uevent of the form "spi:<dev>", even
- * if the device was registered via OF. This means that the module will not be
- * auto loaded, unless it contains an alias that matches the MODALIAS reported.
- *
- * To workaround this issue, add a SPI device ID table. Even when this should
- * not be needed for this driver to match the registered SPI devices.
- */
- static const struct spi_device_id ssd130x_spi_table[] = {
- { "sh1106", SH1106_ID },
- { "ssd1305", SSD1305_ID },
- { "ssd1306", SSD1306_ID },
- { "ssd1307", SSD1307_ID },
- { "ssd1309", SSD1309_ID },
- { /* sentinel */ }
- };
- MODULE_DEVICE_TABLE(spi, ssd130x_spi_table);
- #endif
- static struct spi_driver ssd130x_spi_driver = {
- .driver = {
- .name = DRIVER_NAME,
- .of_match_table = ssd130x_of_match,
- },
- .probe = ssd130x_spi_probe,
- .remove = ssd130x_spi_remove,
- .shutdown = ssd130x_spi_shutdown,
- };
- module_spi_driver(ssd130x_spi_driver);
- MODULE_DESCRIPTION(DRIVER_DESC);
- MODULE_AUTHOR("Javier Martinez Canillas <[email protected]>");
- MODULE_LICENSE("GPL");
- MODULE_IMPORT_NS(DRM_SSD130X);
|