Blackwhitebear8/grovepi
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

first commit

Browse source
This commit is contained in:
pandacraft 2025-03-21 16:04:17 +01:00
commit a5a0434432
1126 changed files with 439481 additions and 0 deletions
Download patch file Download diff file Expand all files Collapse all files

128
Software/Cpp/grove_rgb_lcd/grove_rgb_lcd.cpp Normal file
View file

@ -0,0 +1,128 @@
#include "grove_rgb_lcd.h"
using GrovePi::LCD;
uint8_t LCD::DISPLAY_RGB_ADDR = 0x62;
uint8_t LCD::DISPLAY_TEXT_ADDR = 0x3e;
uint8_t LCD::CLEAR_DISPLAY = 0x01;
uint8_t LCD::DISPLAY_ON = 0x08;
uint8_t LCD::NO_CURSOR = 0x04;
uint8_t LCD::ENABLE_2ROWS = 0x28;
uint8_t LCD::PROGRAM_MODE = 0x80;
uint8_t LCD::NEW_ROW = 0xc0;
uint8_t LCD::DISPLAY_CHAR = 0x40;
uint8_t LCD::MAX_NO_CHARS = 32;
void LCD::connect()
{
// initializing with a random address
// it's just important to get the device file
this->DEVICE_FILE = initDevice(LCD::DISPLAY_TEXT_ADDR);
}
/**
* set rgb color
* if there are writes errors, then it throws exception
* @param red 8-bit
* @param green 8-bit
* @param blue 8-bit
*/
void LCD::setRGB(uint8_t red, uint8_t green, uint8_t blue)
{
this->selectSlave(LCD::DISPLAY_RGB_ADDR);
this->sendCommand(0x00, 0x00);
this->sendCommand(0x01, 0x00);
this->sendCommand(0x08, 0xaa);
this->sendCommand(0x04, red);
this->sendCommand(0x03, green);
this->sendCommand(0x02, blue);
}
/**
* Grove RGB LCD
*
* | Column
* ------------------------------------------------------
* Row | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16
* ------------------------------------------------------
* 1 | x x x x x x x x x x x x x x x x
* 2 | x x x x x x x x x x x x x x x x
* ------------------------------------------------------
*
* Whatever text is sent to the LCD via the [str] variable
* Gets printed on the screen.
* The limit of text is determined by the amount of available
* Characters on the LCD screen.
*
* Every newline char ['\n'] takes the cursor onto the next line
* (aka on the row no. 2) and uses that space
* This means that if we have a text such "Hello\n World!",
* The first 5 characters of the word "Hello" get printed on the first line,
* whilst the rest of the string gets printed onto the 2nd line.
* So, if you use the newline char ['\n'] before the row ends,
* You will end up with less space to put the rest of the characters (aka the last line)
*
* If the text your putting occupies more than the LCD is capable of showing,
* Than the LCD will display only the first 16x2 characters.
*
* @param string of maximum 32 characters excluding the NULL character.
*/
void LCD::setText(const char *str)
{
this->selectSlave(LCD::DISPLAY_TEXT_ADDR);
this->sendCommand(LCD::PROGRAM_MODE, LCD::CLEAR_DISPLAY);
delay(50);
this->sendCommand(LCD::PROGRAM_MODE, LCD::DISPLAY_ON | LCD::NO_CURSOR);
this->sendCommand(LCD::PROGRAM_MODE, LCD::ENABLE_2ROWS);
delay(50);
int length = strlen(str);
bool already_had_newline = false;
for(int i = 0; i < length && i < LCD::MAX_NO_CHARS; i++)
{
if(i == 16 || str[i] == '\n')
{
if(!already_had_newline)
{
already_had_newline = true;
this->sendCommand(LCD::PROGRAM_MODE, LCD::NEW_ROW);
if(str[i] == '\n')
continue;
}
else if(str[i] == '\n')
break;
}
this->sendCommand(LCD::DISPLAY_CHAR, uint8_t(str[i]));
}
}
/**
* function for sending data to GrovePi RGB LCD
* @param mode see the constants defined up top
* @param command see the constants defined up top
*/
void LCD::sendCommand(uint8_t mode, uint8_t command)
{
int error = i2c_smbus_write_byte_data(this->DEVICE_FILE, mode, command);
if(error == -1)
throw I2CError("[I2CError writing data: check LCD wirings]\n");
}
/**
* the LCD has 2 slaves
* 1 for the RGB backlight color
* 1 for the actual text
* therefore there are 2 adresses
* @param slave 7-bit address
*/
void LCD::selectSlave(uint8_t slave)
{
int error = ioctl(this->DEVICE_FILE, I2C_SLAVE, slave);
if(error == -1)
throw I2CError("[I2CError selecting LCD address]\n");
}

56
Software/Cpp/grove_rgb_lcd/grove_rgb_lcd.h Normal file
View file

@ -0,0 +1,56 @@
// Copyright Dexter Industries, 2017
// http://dexterindustries.com/grovepi
#ifndef GROVE_RGB_LCD_H
#define GROVE_RGB_LCD_H
#include <stdio.h>
#include <stdlib.h>
#include <string.h>
#include <unistd.h>
#include <string.h>
#include <linux/i2c-dev.h>
#include <fcntl.h>
#include <sys/ioctl.h>
#include <sys/types.h>
#include <sys/stat.h>
#include <stdbool.h>
#include <stdint.h>
#include "grovepi.h"
namespace GrovePi
{
class LCD
{
public:
LCD() {
};
void connect();
void setRGB(uint8_t red, uint8_t green, uint8_t blue);
void setText(const char *str);
private:
void sendCommand(uint8_t mode, uint8_t command);
void selectSlave(uint8_t slave);
uint8_t DEVICE_FILE;
bool connected;
static uint8_t DISPLAY_RGB_ADDR;
static uint8_t DISPLAY_TEXT_ADDR;
static uint8_t CLEAR_DISPLAY;
static uint8_t DISPLAY_ON;
static uint8_t NO_CURSOR;
static uint8_t ENABLE_2ROWS;
static uint8_t PROGRAM_MODE;
static uint8_t NEW_ROW;
static uint8_t DISPLAY_CHAR;
static uint8_t MAX_NO_CHARS;
};
}
#endif

78
Software/Cpp/grove_rgb_lcd/grove_rgb_lcd_example.cpp Normal file
View file

@ -0,0 +1,78 @@
//
// GrovePi Example for using the Grove - LCD RGB Backlight (http://www.seeedstudio.com/wiki/Grove_-_LCD_RGB_Backlight)
//
// The GrovePi connects the Raspberry Pi and Grove sensors. You can learn more about GrovePi here: http://www.dexterindustries.com/GrovePi
//
// Have a question about this example? Ask on the forums here: http://forum.dexterindustries.com/c/grovepi
//
/*
## License
The MIT License (MIT)
GrovePi for the Raspberry Pi: an open source platform for connecting Grove Sensors to the Raspberry Pi.
Copyright (C) 2017 Dexter Industries
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 "grovepi.h"
#include "grove_rgb_lcd.h"
#include <stdlib.h>
#include <stdio.h>
using namespace GrovePi;
// sudo g++ -Wall grovepi.cpp grove_rgb_lcd.cpp grove_rgb_lcd_example.cpp -o grove_rgb_lcd_example.out -> without grovepicpp package installed
// sudo g++ -Wall -lgrovepicpp grove_rgb_lcd.cpp grove_rgb_lcd_example.cpp -o grove_rgb_lcd_example.out -> with grovepicpp package installed
int main()
{
LCD lcd; // initialize new Grove LCD RGB device
try
{
// connect to the i2c-line
lcd.connect();
// set text and RGB color on the LCD
lcd.setText("Hello world!\nThis is an LCD.");
lcd.setRGB(0, 128, 64);
// continuously change color for roughly 2.5 seconds
for(int value = 0; value < 256; value++)
{
lcd.setRGB(value, 255 - value, 0);
delay(10);
}
// set final color
lcd.setRGB(0, 255, 0);
// and display a last minute text
lcd.setText("Bye bye!\nThis is line 2");
}
catch(I2CError &error)
{
printf(error.detail());
return -1;
}
return 0;
}