This commit is contained in:
2022-10-30 23:00:53 +01:00
commit 7f087ae854
226 changed files with 27881 additions and 0 deletions
+225
View File
@@ -0,0 +1,225 @@
/*
MIT License
Copyright (c) 2018-2021, Alexey Dynda
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation 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
furnished 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 FOR 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.
*/
/*
* @file hal/arduino/io.h SSD1306 ARDUINO IO communication functions
*/
#ifndef _SSD1306_ARDUINO_IO_H_
#define _SSD1306_ARDUINO_IO_H_
#if defined(ARDUINO_ARCH_STM32) // stm32duino support
#include <Arduino.h>
#include <avr/pgmspace.h>
#elif defined(ESP8266) || defined(ESP32) || defined(ESP31B) // esp arduino support
#include <Arduino.h>
#include <pgmspace.h>
#else // AVR support
#include <Arduino.h>
#if !defined(ARDUINO_ARCH_SAMD) && defined(__AVR__)
#include <avr/sleep.h>
#include <avr/pgmspace.h>
#include <avr/interrupt.h>
#elif defined(ARDUINO_ARCH_SAMD)
#include <api/deprecated-avr-comp/avr/pgmspace.h>
#include <api/deprecated-avr-comp/avr/interrupt.h>
#else
#include <avr/pgmspace.h>
#include <avr/interrupt.h>
#endif
#endif
#if defined(ARDUINO_ARCH_STM32)
/** The macro is defined when i2c Wire library is available */
#define CONFIG_PLATFORM_I2C_AVAILABLE
/** The macro is defined when Wire library speed can be configured */
#define SSD1306_WIRE_CLOCK_CONFIGURABLE
/** The macro is defined when SPI library is available */
#define CONFIG_PLATFORM_SPI_AVAILABLE
/** The macro is defined when STM32 i2c implementation is available */
#define CONFIG_STM32_I2C_AVAILABLE
#elif defined(ARDUINO_AVR_DIGISPARK) || defined(ARDUINO_AVR_DIGISPARKPRO)
/** The macro is defined when i2c Wire library is available */
#define CONFIG_PLATFORM_I2C_AVAILABLE
#if defined(ARDUINO_AVR_DIGISPARKPRO)
/** The macro is defined when SPI library is available */
#define CONFIG_PLATFORM_SPI_AVAILABLE
#else
/** The macro is defined when software i2c implementation is available */
#define CONFIG_SOFTWARE_I2C_AVAILABLE
/* Define lcdint as smallest types to reduce memo usage on tiny controllers. *
* Remember, that this can cause issues with large lcd displays, i.e. 320x240*/
#define LCDINT_TYPES_DEFINED
typedef int8_t lcdint_t;
typedef uint8_t lcduint_t;
#endif
#elif defined(ARDUINO_AVR_ATTINYX5) || defined(ARDUINO_AVR_ATTINYX4)
/** The macro is defined when software i2c implementation is available */
#define CONFIG_SOFTWARE_I2C_AVAILABLE
/** The macro is defined when i2c Wire library is available */
#define CONFIG_PLATFORM_I2C_AVAILABLE
/** The macro is defined when USI module is available for use */
#define CONFIG_USI_SPI_AVAILABLE
/** The macro is defined when SPI library is available */
#define CONFIG_PLATFORM_SPI_AVAILABLE
/** Define lcdint as smallest types to reduce memo usage on tiny controllers. *
* Remember, that this can cause issues with large lcd displays, i.e. 320x240*/
#define LCDINT_TYPES_DEFINED
/** This is for Attiny controllers */
typedef int8_t lcdint_t;
/** This is for Attiny controllers */
typedef uint8_t lcduint_t;
/** The macro is defined when micro controller doesn't support multiplication operation */
#define CONFIG_MULTIPLICATION_NOT_SUPPORTED
#elif defined(__AVR_ATtinyxy4__) || defined(__AVR_ATtinyxy2__) || defined(__AVR_ATtinyxy6__) || defined(__AVR_ATtinyxy7__)
/** The macro is defined when i2c Wire library is available */
#define CONFIG_PLATFORM_I2C_AVAILABLE
/** The macro is defined when Wire library speed can be configured */
// Note: Might work for faster draw. But it does brick some devices that can't run at these speeds.
// Leaving it off for now
//#define SSD1306_WIRE_CLOCK_CONFIGURABLE
/** The macro is defined when SPI library is available */
#define CONFIG_PLATFORM_SPI_AVAILABLE
/** Define lcdint as smallest types to reduce memo usage on tiny controllers. *
* Remember, that this can cause issues with large lcd displays, i.e. 320x240*/
#define LCDINT_TYPES_DEFINED
/** This is for Attiny controllers */
typedef int8_t lcdint_t;
/** This is for Attiny controllers */
typedef uint8_t lcduint_t;
/** The macro is defined when micro controller doesn't support multiplication operation */
//#define CONFIG_MULTIPLICATION_NOT_SUPPORTED
#elif defined(__AVR_ATtiny25__) || defined(__AVR_ATtiny45__) || defined(__AVR_ATtiny85__) || \
defined(__AVR_ATtiny24__) || defined(__AVR_ATtiny44__) || defined(__AVR_ATtiny84__)
/** The macro is defined when software i2c implementation is available */
#define CONFIG_SOFTWARE_I2C_AVAILABLE
/** The macro is defined when USI module is available for use */
#define CONFIG_USI_SPI_AVAILABLE
/** Define lcdint as smallest types to reduce memo usage on tiny controllers. *
* Remember, that this can cause issues with large lcd displays, i.e. 320x240*/
#define LCDINT_TYPES_DEFINED
/** This is for Attiny controllers */
typedef int8_t lcdint_t;
/** This is for Attiny controllers */
typedef uint8_t lcduint_t;
/** The macro is defined when micro controller doesn't support multiplication operation */
#define CONFIG_MULTIPLICATION_NOT_SUPPORTED
#elif defined(ESP8266) || defined(ESP32) || defined(ESP31B) || \
defined(ARDUINO_ARCH_SAMD) || defined(ARDUINO_ARCH_SAM)
/* SW implementation of i2c isn't supported on ESP platforms */
/** The macro is defined when i2c Wire library is available */
#define CONFIG_PLATFORM_I2C_AVAILABLE
/** The macro is defined when Wire library speed can be configured */
#define SSD1306_WIRE_CLOCK_CONFIGURABLE
/** The macro is defined when SPI library is available */
#define CONFIG_PLATFORM_SPI_AVAILABLE
#if defined(ESP32)
/** The macro is defined when composite audio support is available */
#define CONFIG_VGA_AVAILABLE
#endif
#elif defined(__AVR_ATmega328P__) || defined(__AVR_ATmega328PB__)
/** The macro is defined when i2c Wire library is available */
#define CONFIG_SOFTWARE_I2C_AVAILABLE
/** The macro is defined when i2c Wire library is available */
#define CONFIG_PLATFORM_I2C_AVAILABLE
/** The macro is defined when Wire library speed can be configured */
#define SSD1306_WIRE_CLOCK_CONFIGURABLE
/** The macro is defined when TWI module is available (ATTINY) */
#define CONFIG_TWI_I2C_AVAILABLE
/** The macro is defined when SPI library is available */
#define CONFIG_PLATFORM_SPI_AVAILABLE
/** The macro is defined when SPI module is available (ATMEGA) */
#define CONFIG_AVR_SPI_AVAILABLE
/** The macro is defined when UART module is available */
#define CONFIG_AVR_UART_AVAILABLE
/** The macro is defined when VGA monitor control is available directly from controller */
#define CONFIG_VGA_AVAILABLE
#if defined(__AVR_ATmega328PB__) && !defined(WIRE_INTERFACES_COUNT)
#define WIRE_INTERFACES_COUNT 2
#endif
#elif defined(__AVR_ATmega2560__) || defined(__AVR_ATmega1280__)
/** The macro is defined when i2c Wire library is available */
#define CONFIG_SOFTWARE_I2C_AVAILABLE
/** The macro is defined when i2c Wire library is available */
#define CONFIG_PLATFORM_I2C_AVAILABLE
/** The macro is defined when Wire library speed can be configured */
#define SSD1306_WIRE_CLOCK_CONFIGURABLE
/** The macro is defined when TWI module is available (ATTINY) */
#define CONFIG_TWI_I2C_AVAILABLE
/** The macro is defined when SPI library is available */
#define CONFIG_PLATFORM_SPI_AVAILABLE
// Disable internal AVR SPI implementation for ATMEGA 2560 since,
// it doesn't work for now
// #define CONFIG_AVR_SPI_AVAILABLE
#elif defined(NRF52) || defined(NRF5)
/** The macro is defined when i2c Wire library is available */
#define CONFIG_PLATFORM_I2C_AVAILABLE
/** The macro is defined when Wire library speed can be configured */
#define SSD1306_WIRE_CLOCK_CONFIGURABLE
/** The macro is defined when SPI library is available */
#define CONFIG_PLATFORM_SPI_AVAILABLE
#elif defined(__AVR_ATmega4808__) || defined(__AVR_ATmega3208__) || defined(__AVR_ATmega1608__)
/** The macro is defined when i2c Wire library is available */
#define CONFIG_PLATFORM_I2C_AVAILABLE
/** The macro is defined when Wire library speed can be configured */
#define SSD1306_WIRE_CLOCK_CONFIGURABLE
/** The macro is defined when SPI library is available */
#define CONFIG_PLATFORM_SPI_AVAILABLE
#else
/** The macro is defined when i2c Wire library is available */
#define CONFIG_SOFTWARE_I2C_AVAILABLE
/** The macro is defined when i2c Wire library is available */
#define CONFIG_PLATFORM_I2C_AVAILABLE
/** The macro is defined when Wire library speed can be configured */
#define SSD1306_WIRE_CLOCK_CONFIGURABLE
/** The macro is defined when TWI module is available (ATTINY) */
#define CONFIG_TWI_I2C_AVAILABLE
/** The macro is defined when SPI library is available */
#define CONFIG_PLATFORM_SPI_AVAILABLE
/** The macro is defined when SPI module is available (ATMEGA) */
#define CONFIG_AVR_SPI_AVAILABLE
#endif
//#ifdef CONFIG_PLATFORM_I2C_AVAILABLE
//#ifdef __cplusplus
//#include <Wire.h>
//#endif
//#endif
#endif // _SSD1306_ARDUINO_IO_H_
@@ -0,0 +1,220 @@
/*
MIT License
Copyright (c) 2016-2021, Alexey Dynda
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation 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
furnished 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 FOR 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 "ssd1306_hal/io.h"
#include "intf/ssd1306_interface.h"
#include "intf/i2c/ssd1306_i2c.h"
#include "intf/spi/ssd1306_spi.h"
#include "lcd/lcd_common.h"
#if defined(ARDUINO) && !defined(ENERGIA)
//////////////////////////////////////////////////////////////////////////////////
// ARDUINO I2C IMPLEMENTATION
//////////////////////////////////////////////////////////////////////////////////
#if defined(CONFIG_PLATFORM_I2C_AVAILABLE) && \
defined(CONFIG_PLATFORM_I2C_ENABLE)
#include <Wire.h>
#if defined( WIRE_INTERFACES_COUNT ) && WIRE_INTERFACES_COUNT > 1
#include <Wire1.h>
#endif
static uint8_t s_bytesWritten = 0;
static uint8_t s_sa = SSD1306_SA;
static TwoWire *s_i2c = nullptr;
static void ssd1306_i2cStart_Wire(void)
{
s_i2c->beginTransmission(s_sa);
s_bytesWritten = 0;
}
static void ssd1306_i2cStop_Wire(void)
{
s_i2c->endTransmission();
}
/**
* Inputs: SCL is LOW, SDA is has no meaning
* Outputs: SCL is LOW
*/
static void ssd1306_i2cSendByte_Wire(uint8_t data)
{
// Do not write too many bytes for standard Wire.h. It may become broken
#if defined(ESP32) || defined(ESP31B)
if (s_bytesWritten >= (I2C_BUFFER_LENGTH >> 4))
#elif defined(ARDUINO_ARCH_SAMD)
if (s_bytesWritten >= 64)
#elif defined(BUFFER_LENGTH)
if (s_bytesWritten >= (BUFFER_LENGTH - 2))
#elif defined(SERIAL_BUFFER_LENGTH)
if (s_bytesWritten >= (SERIAL_BUFFER_LENGTH - 2))
#elif defined(USI_BUF_SIZE)
if (s_bytesWritten >= (USI_BUF_SIZE -2))
#else
if ( s_i2c->write(data) != 0 )
{
s_bytesWritten++;
return;
}
#endif
{
ssd1306_i2cStop_Wire();
ssd1306_i2cStart_Wire();
ssd1306_i2cSendByte_Wire(0x40);
/* Commands never require many bytes. Thus assume that user tries to send data */
}
s_i2c->write(data);
s_bytesWritten++;
}
static void ssd1306_i2cSendBytes_Wire(const uint8_t *buffer, uint16_t size)
{
while (size--)
{
ssd1306_i2cSendByte_Wire(*buffer);
buffer++;
}
}
static void ssd1306_i2cClose_Wire()
{
}
void ssd1306_platform_i2cInit(int8_t busId, uint8_t addr, ssd1306_platform_i2cConfig_t * cfg)
{
#if defined(ESP8266) || defined(ESP32) || defined(ESP31B)
if ((cfg->scl >= 0) && (cfg->sda >=0))
{
s_i2c = &Wire;
s_i2c->begin(cfg->sda, cfg->scl);
}
else
#endif
{
#if !defined( WIRE_INTERFACES_COUNT )
s_i2c = &Wire;
#elif WIRE_INTERFACES_COUNT < 2
s_i2c = &Wire;
#elif WIRE_INTERFACES_COUNT < 3
if ( busId == 0 )
{
s_i2c = &Wire;
}
else
{
s_i2c = &Wire1;
}
#endif
s_i2c->begin();
}
#ifdef SSD1306_WIRE_CLOCK_CONFIGURABLE
s_i2c->setClock(400000);
#endif
if (addr) s_sa = addr;
ssd1306_intf.spi = 0;
ssd1306_intf.start = ssd1306_i2cStart_Wire;
ssd1306_intf.stop = ssd1306_i2cStop_Wire;
ssd1306_intf.send = ssd1306_i2cSendByte_Wire;
ssd1306_intf.send_buffer = ssd1306_i2cSendBytes_Wire;
ssd1306_intf.close = ssd1306_i2cClose_Wire;
}
#endif // CONFIG_PLATFORM_I2C_AVAILABLE
//////////////////////////////////////////////////////////////////////////////////
// ARDUINO SPI IMPLEMENTATION
//////////////////////////////////////////////////////////////////////////////////
#if defined(CONFIG_PLATFORM_SPI_AVAILABLE) && defined(CONFIG_PLATFORM_SPI_ENABLE)
/* STANDARD branch */
#include <SPI.h>
static void ssd1306_spiClose_hw()
{
}
static void ssd1306_spiStart_hw()
{
/* anyway, oled ssd1331 cannot work faster, clock cycle should be > 150ns: *
* 1s / 150ns ~ 6.7MHz */
SPI.beginTransaction(SPISettings(s_ssd1306_spi_clock, MSBFIRST, SPI_MODE0));
if (s_ssd1306_cs >= 0)
{
digitalWrite(s_ssd1306_cs,LOW);
}
}
static void ssd1306_spiStop_hw()
{
if (ssd1306_lcd.type == LCD_TYPE_PCD8544)
{
digitalWrite(s_ssd1306_dc, LOW);
SPI.transfer( 0x00 ); // Send NOP command to allow last data byte to pass (bug in PCD8544?)
// ssd1306 E3h is NOP command
}
if (s_ssd1306_cs >= 0)
{
digitalWrite(s_ssd1306_cs, HIGH);
}
SPI.endTransaction();
}
static void ssd1306_spiSendByte_hw(uint8_t data)
{
SPI.transfer(data);
}
static void ssd1306_spiSendBytes_hw(const uint8_t *buffer, uint16_t size)
{
/* Do not use SPI.transfer(buffer, size)! this method corrupts buffer content */
while (size--)
{
SPI.transfer(*buffer);
buffer++;
};
}
void ssd1306_platform_spiInit(int8_t busId, int8_t cesPin, int8_t dcPin)
{
if (cesPin >=0) pinMode(cesPin, OUTPUT);
if (dcPin >= 0) pinMode(dcPin, OUTPUT);
if (cesPin) s_ssd1306_cs = cesPin;
if (dcPin) s_ssd1306_dc = dcPin;
SPI.begin();
ssd1306_intf.spi = 1;
ssd1306_intf.start = ssd1306_spiStart_hw;
ssd1306_intf.stop = ssd1306_spiStop_hw;
ssd1306_intf.send = ssd1306_spiSendByte_hw;
ssd1306_intf.send_buffer = ssd1306_spiSendBytes_hw;
ssd1306_intf.close = ssd1306_spiClose_hw;
}
#endif // CONFIG_PLATFORM_SPI_AVAILABLE
#endif // ARDUINO