CalvinBackup/Embedded-Hacking
1
0
Fork 0
mirror of https://github.com/mytechnotalent/Embedded-Hacking.git synced 2026-08-19 09:27:17 +02:00
Code Issues Packages Projects Releases Wiki Activity

Updated Drivers

Browse Source
This commit is contained in:
Kevin Thomas
2026-03-23 09:33:04 -04:00
parent 6ee30d0520
commit 91faba6800
31 changed files with 827 additions and 337 deletions
Download Patch File Download Diff File Expand all files Collapse all files
drivers/0x08_lcd1602/0x08_lcd1602.c
+33 -14
View File
@@ -51,26 +51,45 @@
#define I2C_BAUD_HZ 100000
#define LCD_I2C_ADDR 0x27
int main(void) {
stdio_init_all();
lcd_init(I2C_PORT, I2C_SDA_PIN, I2C_SCL_PIN, I2C_BAUD_HZ,
LCD_I2C_ADDR, 4, 0x08);
/**
* @brief Initialize the LCD, display the title, and log over UART
*/
static void _setup_display(void) {
lcd_init(I2C_PORT, I2C_SDA_PIN, I2C_SCL_PIN, I2C_BAUD_HZ, LCD_I2C_ADDR, 4, 0x08);
lcd_set_cursor(0, 0);
lcd_puts("Reverse Eng.");
printf("LCD 1602 driver initialized at I2C addr 0x%02X\r\n", LCD_I2C_ADDR);
}
uint32_t count = 0;
/**
* @brief Format and display the next counter value on LCD line 1
*
* @param count Pointer to the running counter (post-incremented)
*/
static void _update_counter(uint32_t *count) {
char buf[17];
snprintf(buf, sizeof(buf), "Count: %6lu", (*count)++);
lcd_set_cursor(1, 0);
lcd_puts(buf);
printf("%s\r\n", buf);
sleep_ms(1000);
}
while (true) {
snprintf(buf, sizeof(buf), "Count: %6lu", count++);
lcd_set_cursor(1, 0);
lcd_puts(buf);
printf("%s\r\n", buf);
sleep_ms(1000);
}
/**
* @brief Application entry point for the LCD 1602 counter demo
*
* Initializes the LCD over I2C with a static title on line 0 and
* continuously increments a counter on line 1 every second.
*
* @return int Does not return
*/
int main(void) {
stdio_init_all();
_setup_display();
uint32_t count = 0;
while (true)
_update_counter(&count);
}
drivers/0x08_lcd1602/lcd1602.c
+84 -47
View File
@@ -33,10 +33,17 @@
#include "pico/stdlib.h"
#include "hardware/i2c.h"
static i2c_inst_t *get_i2c_inst(uint8_t port) {
/**
* @brief Map an I2C port number to its hardware instance pointer
*
* @param port I2C port number (0 for i2c0, 1 for i2c1)
* @return i2c_inst_t* Pointer to the corresponding I2C hardware instance
*/
static i2c_inst_t *_get_i2c_inst(uint8_t port) {
return port == 0 ? i2c0 : i2c1;
}
static i2c_inst_t *lcd_i2c = NULL;
static uint8_t lcd_addr = 0x27;
static int lcd_nibble_shift = 4;
@@ -47,109 +54,139 @@ static uint8_t lcd_backlight_mask = 0x08;
#define PIN_RW 0x02
#define PIN_EN 0x04
/**
* @brief Write one raw byte to the PCF8574 expander over I2C
*
* @param data Output byte to send to the expander
*/
static void pcf_write_byte(uint8_t data) {
static void _pcf_write_byte(uint8_t data) {
if (!lcd_i2c) return;
i2c_write_blocking(lcd_i2c, lcd_addr, &data, 1, false);
}
/**
* @brief Toggle EN to latch a nibble into the LCD controller
*
* @param data Current control/data bus byte (with RS and backlight already set)
*/
static void pcf_pulse_enable(uint8_t data) {
pcf_write_byte(data | PIN_EN);
static void _pcf_pulse_enable(uint8_t data) {
_pcf_write_byte(data | PIN_EN);
sleep_us(1);
pcf_write_byte(data & ~PIN_EN);
_pcf_write_byte(data & ~PIN_EN);
sleep_us(50);
}
/**
* @brief Write one 4-bit nibble to the LCD
*
* @param nibble Lower 4 bits to write
* @param mode 0 for command, non-zero for character data
*/
static void lcd_write4(uint8_t nibble, uint8_t mode) {
static void _lcd_write4(uint8_t nibble, uint8_t mode) {
uint8_t data = (nibble & 0x0F) << lcd_nibble_shift;
data |= mode ? PIN_RS : 0;
data |= lcd_backlight_mask;
pcf_pulse_enable(data);
_pcf_pulse_enable(data);
}
/**
* @brief Send one full 8-bit command/data value as two nibbles
*
* @param value Byte to send to the LCD
* @param mode 0 for command, non-zero for character data
*/
static void lcd_send(uint8_t value, uint8_t mode) {
lcd_write4((value >> 4) & 0x0F, mode);
lcd_write4(value & 0x0F, mode);
static void _lcd_send(uint8_t value, uint8_t mode) {
_lcd_write4((value >> 4) & 0x0F, mode);
_lcd_write4(value & 0x0F, mode);
}
/**
* @brief Store LCD driver configuration in module-level state
*
* @param i2c_port I2C port number (0 or 1)
* @param pcf_addr 7-bit PCF8574 address
* @param nibble_shift Bit shift for 4-bit nibbles
* @param backlight_mask Backlight control bit mask
*/
static void _lcd_store_config(uint8_t i2c_port, uint8_t pcf_addr,
int nibble_shift, uint8_t backlight_mask) {
lcd_i2c = _get_i2c_inst(i2c_port);
lcd_addr = pcf_addr;
lcd_nibble_shift = nibble_shift;
lcd_backlight_mask = backlight_mask;
}
/**
* @brief Execute the HD44780 4-bit mode power-on reset sequence
*/
static void _lcd_hd44780_reset(void) {
_lcd_write4(0x03, 0);
sleep_ms(5);
_lcd_write4(0x03, 0);
sleep_us(150);
_lcd_write4(0x03, 0);
sleep_us(150);
_lcd_write4(0x02, 0);
sleep_us(150);
}
/**
* @brief Send post-reset configuration commands to the HD44780
*
* Sets 4-bit mode with 2 display lines, turns the display on with
* cursor hidden, clears the screen, and selects left-to-right entry mode.
*/
static void _lcd_hd44780_configure(void) {
_lcd_send(0x28, 0);
_lcd_send(0x0C, 0);
_lcd_send(0x01, 0);
sleep_ms(2);
_lcd_send(0x06, 0);
}
void lcd_i2c_init(uint8_t i2c_port, uint8_t pcf_addr, int nibble_shift,
uint8_t backlight_mask) {
_lcd_store_config(i2c_port, pcf_addr, nibble_shift, backlight_mask);
_lcd_hd44780_reset();
_lcd_hd44780_configure();
}
void lcd_init(uint8_t i2c_port, uint32_t sda_pin, uint32_t scl_pin,
uint32_t baud_hz, uint8_t pcf_addr, int nibble_shift,
uint8_t backlight_mask) {
i2c_inst_t *i2c = get_i2c_inst(i2c_port);
i2c_inst_t *i2c = _get_i2c_inst(i2c_port);
i2c_init(i2c, baud_hz);
gpio_set_function(sda_pin, GPIO_FUNC_I2C);
gpio_set_function(scl_pin, GPIO_FUNC_I2C);
gpio_pull_up(sda_pin);
gpio_pull_up(scl_pin);
lcd_i2c_init(i2c_port, pcf_addr, nibble_shift, backlight_mask);
}
void lcd_i2c_init(uint8_t i2c_port, uint8_t pcf_addr, int nibble_shift, uint8_t backlight_mask) {
lcd_i2c = get_i2c_inst(i2c_port);
lcd_addr = pcf_addr;
lcd_nibble_shift = nibble_shift;
lcd_backlight_mask = backlight_mask;
// Follow init sequence for HD44780 in 4-bit mode
lcd_write4(0x03, 0);
sleep_ms(5);
lcd_write4(0x03, 0);
sleep_us(150);
lcd_write4(0x03, 0);
sleep_us(150);
lcd_write4(0x02, 0);
sleep_us(150);
// Function set: 4-bit, 2 lines
lcd_send(0x28, 0);
// Display on, cursor off
lcd_send(0x0C, 0);
// Clear
lcd_send(0x01, 0);
sleep_ms(2);
// Entry mode set
lcd_send(0x06, 0);
}
void lcd_clear(void) {
lcd_send(0x01, 0);
_lcd_send(0x01, 0);
sleep_ms(2);
}
void lcd_set_cursor(int line, int position) {
const uint8_t row_offsets[] = {0x00, 0x40};
if (line > 1) line = 1;
lcd_send(0x80 | (position + row_offsets[line]), 0);
_lcd_send(0x80 | (position + row_offsets[line]), 0);
}
void lcd_puts(const char *s) {
while (*s) {
lcd_send((uint8_t)*s++, 1);
}
while (*s)
_lcd_send((uint8_t)*s++, 1);
}