-
Notifications
You must be signed in to change notification settings - Fork 176
[Documentation] #24
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Open
AghaSaad04
wants to merge
5
commits into
arduino-libraries:master
Choose a base branch
from
AghaSaad04:master
base: master
Could not load branches
Branch not found: {{ refName }}
Loading
Could not load tags
Nothing to show
Loading
Are you sure you want to change the base?
Some commits from the old base branch may be removed from the timeline,
and old review comments may become outdated.
Open
[Documentation] #24
Changes from 3 commits
Commits
Show all changes
5 commits
Select commit
Hold shift + click to select a range
File filter
Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,13 @@ | ||
# Contribution Guidlines | ||
|
||
This library is the culmination of the expertise of many members of the open source community who have dedicated their time and hard work. The best way to ask for help or propose a new idea is to [create a new issue](https://github.com/arduino-libraries/LiquidCrystal/issues/new) while creating a Pull Request with your code changes allows you to share your own innovations with the rest of the community. | ||
|
||
The following are some guidelines to observe when creating issues or PRs: | ||
|
||
- Be friendly; it is important that we can all enjoy a safe space as we are all working on the same project and it is okay for people to have different ideas | ||
|
||
- [Use code blocks](https://github.com/adam-p/markdown-here/wiki/Markdown-Cheatsheet#code); it helps us help you when we can read your code! On that note also refrain from pasting more than 30 lines of code in a post, instead [create a gist](https://gist.github.com/) if you need to share large snippets | ||
|
||
- Use reasonable titles; refrain from using overly long or capitalized titles as they are usually annoying and do little to encourage others to help :smile: | ||
|
||
- Be detailed; refrain from mentioning code problems without sharing your source code and always give information regarding your board and version of the library |
This file was deleted.
Oops, something went wrong.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,182 @@ | ||
# Liquid Crystal Library for Arduino | ||
|
||
## Description | ||
|
||
This library allows an Arduino board to control LiquidCrystal displays (LCDs) based on the Hitachi HD44780 (or a compatible) chipset, which is found on most text-based LCDs. The library works within either 4- or 8-bit mode (i.e. using 4 or 8 data lines in addition to the rs, enable, and, optionally, the rw control lines). | ||
|
||
## Installation | ||
|
||
 | ||
|
||
### First Method | ||
|
||
1. In the Arduino IDE, navigate to Sketch > Include Library > Manage Libraries | ||
1. Then the Library Manager will open and you will find a list of libraries that are already installed or ready for installation. | ||
1. Then search for LiquidCrystal using the search bar. | ||
1. Click on the text area and then select the specific version and install it. | ||
|
||
### Second Method | ||
|
||
1. Navigate to the Releases page. | ||
AghaSaad04 marked this conversation as resolved.
Show resolved
Hide resolved
|
||
1. Download the latest release. | ||
1. Extract the zip file | ||
1. In the Arduino IDE, navigate to Sketch > Include Library > Add .ZIP Library | ||
|
||
## Features | ||
|
||
- ### Easy to use | ||
|
||
It is simple, basic and very easy to understand. The user only needs to import the library in his code and start using its functions. | ||
|
||
- ### Compatible chipset | ||
|
||
 | ||
|
||
Using Liquid Crystal library, Arduino board can control liquid displays based on the Hitachi HD44780 chipset. These chipset LCDs are easily available, come in different shapes and sizes. | ||
|
||
- ### No technical details required | ||
|
||
A key benefit of using this liquid crystal library is that there is no need to care that much about the technical details or timings when using the display. The library happily does all of this. | ||
|
||
- ### Extendable | ||
|
||
The library is extendable, therefore it can grow to support new LCD control devices such as I2C, SPI, Serial, 1wire, RF, CAM, etc. | ||
|
||
- ### Intuitive syntax | ||
|
||
Liquid Crystal has a simple and intuitive syntax to handle variables and functions. The user only needs to import the library and calls its functions | ||
|
||
- ### Give back | ||
|
||
Liquid Crystal is free for everyone. The licensed library can be copied, redistributed and used in the projects, assignments or anywhere. | ||
|
||
## Functions | ||
|
||
- LiquidCrystal() | ||
AghaSaad04 marked this conversation as resolved.
Show resolved
Hide resolved
|
||
- begin() | ||
- clear() | ||
- home() | ||
- setCursor() | ||
- write() | ||
- print() | ||
- cursor() | ||
- noCursor() | ||
- blink() | ||
- noBlink() | ||
- display() | ||
- noDisplay() | ||
- scrollDisplayLeft() | ||
- scrollDisplayRight() | ||
- autoscroll() | ||
- noAutoscroll() | ||
- leftToRight() | ||
- rightToLeft() | ||
- createChar() | ||
|
||
## Example | ||
|
||
There are many examples implemented where this library is used. You can find other examples from [Github-Liquid-Crystal](https://github.com/arduino-libraries/LiquidCrystal/tree/master/examples) and [Arduino-Reference](https://www.arduino.cc/en/Reference/LiquidCrystal). The following are the few examples of this library. | ||
AghaSaad04 marked this conversation as resolved.
Show resolved
Hide resolved
|
||
|
||
### Blink | ||
|
||
This sketch prints "Hello World!" to the LCD and makes the cursor block blink. | ||
AghaSaad04 marked this conversation as resolved.
Show resolved
Hide resolved
|
||
|
||
```C++ | ||
#include <LiquidCrystal.h> | ||
|
||
const int rs = 12, en = 11, d4 = 5, d5 = 4, d6 = 3, d7 = 2; | ||
LiquidCrystal lcd(rs, en, d4, d5, d6, d7); | ||
|
||
void setup() { | ||
lcd.begin(16, 2); | ||
lcd.print("Hello World!"); | ||
} | ||
|
||
void loop() { | ||
lcd.noBlink(); | ||
delay(3000); | ||
lcd.blink(); | ||
delay(3000); | ||
} | ||
``` | ||
|
||
### Display | ||
|
||
This sketch prints "Hello World!" to the LCD and uses the display() and noDisplay() functions to turn on and off the display. | ||
|
||
```C++ | ||
#include <LiquidCrystal.h> | ||
const int rs = 12, en = 11, d4 = 5, d5 = 4, d6 = 3, d7 = 2; | ||
LiquidCrystal lcd(rs, en, d4, d5, d6, d7); | ||
|
||
void setup() { | ||
lcd.begin(16, 2); | ||
lcd.print("Hello World!"); | ||
} | ||
|
||
void loop() { | ||
lcd.noDisplay(); | ||
delay(500); | ||
lcd.display(); | ||
delay(500); | ||
} | ||
``` | ||
|
||
You can find liquid crystal tutorials from [here](https://www.arduino.cc/en/Tutorial/HelloWorld?from=Tutorial.LiquidCrystal) | ||
|
||
## Contributing | ||
|
||
If you want to contribute to this project: | ||
|
||
- Report bugs and errors | ||
- Ask for enhancements | ||
- Create issues and pull requests | ||
- Tell others about this library | ||
- Contribute new protocols | ||
|
||
Please read [CONTRIBUTING.md](https://github.com/arduino-libraries/LiquidCrystal/blob/master/CONTRIBUTING.md) for details on our code of conduct, and the process for submitting pull requests to us. | ||
|
||
## Credits | ||
|
||
The authors of this library are Arduino and Adafruit. This Library is maintained by Arduino <[email protected]>. | ||
AghaSaad04 marked this conversation as resolved.
Show resolved
Hide resolved
|
||
|
||
Based on previous work by: | ||
|
||
- T. Igoe | ||
- D. A. Mellis | ||
- C. Maglie | ||
- M. Faccihin | ||
- M. kooijman | ||
- A. Guadalupi | ||
- F. Vanzati | ||
- Zeveland | ||
- S. Fitzgerald | ||
- J. Nussbaum | ||
- I. Gupta | ||
- C. Park | ||
- A. Daftery | ||
- A. K. Sahoo | ||
- Isaac | ||
|
||
## Current stable version | ||
|
||
**version:** v1.0.7 | ||
AghaSaad04 marked this conversation as resolved.
Show resolved
Hide resolved
|
||
|
||
## License | ||
|
||
Copyright (C) 2006-2008 Hans-Christoph Steiner. All rights reserved. | ||
Copyright (c) 2010 Arduino LLC. All right reserved. | ||
|
||
This library is free software; you can redistribute it and/or | ||
modify it under the terms of the GNU Lesser General Public | ||
License as published by the Free Software Foundation; either | ||
version 2.1 of the License, or (at your option) any later version. | ||
|
||
This library is distributed in the hope that it will be useful, | ||
but WITHOUT ANY WARRANTY; without even the implied warranty of | ||
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU | ||
Lesser General Public License for more details. | ||
|
||
You should have received a copy of the GNU Lesser General Public | ||
License along with this library; if not, write to the Free Software | ||
Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA |
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Uh oh!
There was an error while loading. Please reload this page.