Skip to content

Commit

Permalink
Merge pull request #36 from niwciu/feature/ReadMe_file_update
Browse files Browse the repository at this point in the history
Feature/read me file update
  • Loading branch information
niwciu authored Mar 10, 2024
2 parents 61a7336 + 1258c15 commit e1f9f8b
Show file tree
Hide file tree
Showing 2 changed files with 28 additions and 16 deletions.
44 changes: 28 additions & 16 deletions ReadMe.md
Original file line number Diff line number Diff line change
Expand Up @@ -75,7 +75,15 @@
<br><br>
<img src="https://raw.githubusercontent.com/niwciu/LCD_HD44780/main/doc/HW%20connection%20no%20RW.png" height="400"><br> <br><b>
ATTENTION!<br>
When using controller that do not tolerant 5V on their pins, appropriate voltage levels converter should be used for signals: LCD_DB4, LCD_DB5, LCD_DB6, LCD_DB7, LCD_RS, LCD_E, LCD_RW </b>
When using controller that is not 5V pin tolerant, appropriate voltage levels converter should be used for signals:
- LCD_DB4,
- LCD_DB5,
- LCD_DB6,
- LCD_DB7,
- LCD_RS,
- LCD_E,
- LCD_RW,
- LCD_BCKL </b>
## LCD_HD44780 library src folders file structure and description
```bash
LCD_HD44780
Expand Down Expand Up @@ -424,7 +432,7 @@ Library main header file with available library functions.
2. LCD Keypad Shield for Arduino<br>
<img src="https://raw.githubusercontent.com/niwciu/LCD_HD44780/main/examples/doc/lcd_keypad_shield.png" width="400"><br> <br>
3. Pin connection between LCD Keypad Shield and ESP8266 NoneMCU board<br>
<img src="https://raw.githubusercontent.com/niwciu/LCD_HD44780/main/examples/doc/ESP8266_NodeMCU_V3_lcd_keypad shield_HW_connection.png" width="800"><br> <br>
<img src="https://raw.githubusercontent.com/niwciu/LCD_HD44780/feature/ReadMe_file_update/examples/doc/ESP8266_NodeMCU_V3_lcd_keypad%20shield_HW_connection.png" width="800"><br> <br>
#### LCD_HD44780 library configuration - lcd_hd44780_config.h
```C
/************************************ LCD HARDWARE SETTINGS *******************************
Expand Down Expand Up @@ -470,21 +478,21 @@ Library main header file with available library functions.
##### Windows
1. Open the location you want to clone the repository to in your terminal
2. Clone the repository to your preferred location
```bash
git clone https://github.com/niwciu/LCD_HD44780.git
```
```bash
git clone https://github.com/niwciu/LCD_HD44780.git
```
3. Enter to LCD_HD44780/examples/ESP8266_NONOS_SDK/LCD_HD44780_TEST folder
```bash
cd ./LCD_HD44780/examples/ESP8266_NONOS_SDK/LCD_HD44780_TEST
```
```bash
cd ./LCD_HD44780/examples/ESP8266_NONOS_SDK/LCD_HD44780_TEST
```
4. Clean the project by running clean.bat script
```bash
./clean.bat
```
```bash
./clean.bat
```
5. Build the project by running build.bat script
```bash
./build.bat
```
```bash
./build.bat
```
6. Run flash_download_tool_3.8.5
7. Select "Developer Mode" and "ESP8266 DownloadTool"
8. Set all fields as it is shown on picture bellow<br>
Expand Down Expand Up @@ -632,7 +640,8 @@ static const uint8_t leter_b[8] = {16, 16, 22, 25, 17, 17, 30, 0};
HD44780 allows the user to define a maximum of 8 user characters. Therefore on character bank can contain only up to 8 characters. Nevertheless, it's possible to define a couple of special character banks with different combinations of special characters. Depending on needs one of the banks can be loaded to the CGRAM and switched to another if the information presented on the LCD requires different special characters

Below you can find a simple example of two special characters bank definitions:
1. Definition of special characters in lcd_hd44780_def_char.h:
1. Definition of special characters in lcd_hd44780_def_char.h:

```C
static const uint8_t Pol_e[8] = {0, 0, 14, 17, 31, 16, 14, 3};
static const uint8_t Pol_o[8] = {2, 4, 14, 17, 17, 17, 14, 0};
Expand Down Expand Up @@ -731,7 +740,7 @@ LCD_HD44780
└───unity
```
Folder description:
- .github -> Folder with githubactions .yml scripts
- .github -> folder with githubactions .yml scripts for tunning Github Actions
- doc -> folder for any documentation needed or created in the project
- examples -> folder with example hardware implementations contain ready to compile examples for different uC and templates of lcd_driver_interface implementations.
- ATMEGA328P_ARDUINO_UNO_R3 -> example project
Expand All @@ -741,6 +750,9 @@ Folder description:
- lcd_driver_intrface_example_implementations -> as named
- STM32G071RB_NUCLEO_BARE_METAL -> example project
- STM32G474RE_NUCLEO_CUBE_IDE_LL -> example project
- reports -> folder with generated reports from cmake ccmr target and cmake ccr target are stored.
- CCR -> GCOVR output report
- CCMR -> Lizard Code Complexity Metrix output report.
- src -> library source files
- test -> folder where all tests are written. The folder contains following subfolders:
- hw_test -> folder with configurations/setups for specific ucontrollers to make integration tests
Expand Down
Binary file modified doc/LCD_HD44780_doc.chm
Binary file not shown.

0 comments on commit e1f9f8b

Please sign in to comment.