LCDBigNumbers

KO | EN

gitlite — search

#typescript #ai-agents #ai #dsh-plugin #deepseek-harness #open-source #claude-code #codex #cli #developer-tools #react #windows

★ 36 Open GitHub ↗

Arduino library to write big numbers on a 1602 or 2004 LCD.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# LCDBigNumbers
Arduino library to write big numbers on a 1602 or 2004 LCD.

[![Badge License: GPL v3](https://img.shields.io/badge/License-GPLv3-blue.svg)](https://www.gnu.org/licenses/gpl-3.0)
 &nbsp; &nbsp; 
[![Badge Version](https://img.shields.io/github/v/release/ArminJo/LCDBigNumbers?color=yellow&logo=DocuSign&logoColor=white)](https://github.com/ArminJo/LCDBigNumbers/releases/latest)
 &nbsp; &nbsp; 
[![Badge Commits since latest](https://img.shields.io/github/commits-since/ArminJo/LCDBigNumbers/latest?color=yellow)](https://github.com/ArminJo/LCDBigNumbers/commits/master)
 &nbsp; &nbsp; 
[![Badge Build Status](https://github.com/ArminJo/LCDBigNumbers/workflows/LibraryBuild/badge.svg)](https://github.com/ArminJo/LCDBigNumbers/actions)
 &nbsp; &nbsp; 
![Badge Hit Counter](https://visitor-badge.laobi.icu/badge?page_id=ArminJo_LCDBigNumbers)
 
 
[![Stand With Ukraine](https://raw.githubusercontent.com/vshymanskyy/StandWithUkraine/main/badges/StandWithUkraine.svg)](https://stand-with-ukraine.pp.ua)

Available as [Arduino library "LCDBigNumbers"](https://www.arduinolibraries.info/libraries/lcd-big-numbers).

</div>

#### If you find this library useful, please give it a star.

&#x1F30E; [Google Translate](https://translate.google.com/translate?sl=en&u=https://github.com/ArminJo/LCDBigNumbers)

# Features
- **10 different fonts available. From 1x2 up to 3x4.**.
- Support for special big characters `-`, `.` and `:`.
- Fonts which require no gap between numbers (1x2 and 3x2, variant 2 and 3) are printed by default without this gap.
- Support for **parallel and serial** LCD connections.
- For all architectures.

# Usage

```c++
// Choose your display
//#define USE_PARALLEL_2004_LCD // Is default
//#define USE_PARALLEL_1602_LCD
//#define USE_SERIAL_2004_LCD
//#define USE_SERIAL_1602_LCD
#include "LCDBigNumbers.hpp" // Include sources for LCD big number generation

LiquidCrystal myLCD(2, 3, 4, 5, 6, 7); // Depends on your actual connections
LCDBigNumbers bigNumberLCD(&myLCD, BIG_NUMBERS_FONT_3_COLUMN_4_ROWS_VARIANT_1); // Use 3x4 numbers, 1. variant

void setup() {
 myLCD.begin(LCD_COLUMNS, LCD_ROWS); // LCD_COLUMNS and LCD_ROWS are set by LCDBigNumbers.hpp depending on the defined display
 bigNumberLCD.begin(); // Creates custom character used for generating big numbers
 
 bigNumberLCD.setBigNumberCursor(0);
 bigNumberLCD.print(-47.11, 2); // use the standard print function
 delay(2000);
 bigNumberLCD.setBigNumberCursor(0, 0); // row specification is redundant here for a 4 row font :-)
 bigNumberLCD.print(F(ONE_COLUMN_HYPHEN_STRING ONE_COLUMN_SPACE_STRING "47.11:")); // print a number string
}
```
A **space character** is always rendered as an empty space with the size and the gap of a number. To have an one column space with the height of a number, you must use `ONE_COLUMN_SPACE_STRING` like above or `ONE_COLUMN_SPACE_CHARACTER` like in `bigNumberLCD.print(ONE_COLUMN_SPACE_CHARACTER)`. 
The `ONE_COLUMN_SPACE_CHARACTER` it is by default a bar `|`.

A **hyphen / minus character** is always rendered with the gap of a number. To have an one column hyphen, you must use `ONE_COLUMN_HYPHEN_STRING` like above or `ONE_COLUMN_HYPHEN_CHARACTER` like in `bigNumberLCD.print(ONE_COLUMN_HYPHEN_CHARACTER)`. 
The `ONE_COLUMN_HYPHEN_CHARACTER` it is by default a underscore `_`.

# API
**Only print functions with base <= 10 like print(1234, 8) are available because Hex characters are NOT supported!**

```c++
void init(const uint8_t aBigNumberFontIdentifier); // Reconfigure existing object to hold (another) font
void begin(); // Generate font symbols in LCD controller
void write();
void writeAt(uint8_t aNumber, uint8_t aUpperLeftColumnIndex, uint8_t aUpperLeftRowIndex = 0);
void setBigNumberCursor(uint8_t aUpperLeftColumnIndex, uint8_t aUpperLeftRowIndex = 0);
void enableGapBetweenNumbers();
void disableGapBetweenNumbers();

// LCD convenience functions
void clearLine(LiquidCrystal *aLCD, uint_fast8_t aLineNumber);
void printSpaces(LiquidCrystal *aLCD, uint_fast8_t aNumberOfSpacesToPrint);
size_t printHex(LiquidCrystal *aLCD, uint16_t aHexByteValue);
void testBigNumbers(LiquidCrystal *aLCD); // Print all fonts, used in screenshots below, using one object
```

# Examples on Wokwi
- [Wokwi BigNumbersDemo example](https://wokwi.com/projects/346534078384702034).
- [Wokwi SimpleClock example](https://wokwi.com/projects/346661429974139474).

# Screenshots
Screenshots of [BigNumbersDemo example](https://github.com/ArminJo/LCDBigNumbers/tree/master/examples/BigNumbersDemo).

| Size | Variant Number | | | |
|-|-|-|-|-|
| 1x2 | 1 | ![](https://raw.githubusercontent.com/ArminJo/LCDBigNumbers/master/pictures/1x2_1.png) | | |
| 2x2 | 1 | ![](https://raw.githubusercontent.com/ArminJo/LCDBigNumbers/master/pictures/2x2_1.png) | | ![](https://raw.githubusercontent.com/ArminJo/LCDBigNumbers/master/pictures/2x2_1x.png) |
| 3x2 | 1 | ![](https://raw.githubusercontent.com/ArminJo/LCDBigNumbers/master/pictures/3x2_1.png) | | ![](https://raw.githubusercontent.com/ArminJo/LCDBigNumbers/master/pictures/3x2_1x.png) |
| 3x2 | 2 | ![](https://raw.githubusercontent.com/ArminJo/LCDBigNumbers/master/pictures/3x2_2.png) | | ![](https://raw.githubusercontent.com/ArminJo/LCDBigNumbers/master/pictures/3x2_2x.png) |
| 3x2 | 3 | ![](https://raw.githubusercontent.com/ArminJo/LCDBigNumbers/master/pictures/3x2_3.png) | | ![](https://raw.githubusercontent.com/ArminJo/LCDBigNumbers/master/pictures/3x2_3x.png) |
| 2x3 | 1 | ![](https://raw.githubusercontent.com/ArminJo/LCDBigNumbers/master/pictures/2x3_1a.png) | ![](https://raw.githubusercontent.com/ArminJo/LCDBigNumbers/master/pictures/2x3_1b.png) | ![](https://raw.githubusercontent.com/ArminJo/LCDBigNumbers/master/pictures/2x3_1x.png) |
| 2x3 | 2 | ![](https://raw.githubusercontent.com/ArminJo/LCDBigNumbers/master/pictures/2x3_2a.png) | ![](https://raw.githubusercontent.com/ArminJo/LCDBigNumbers/master/pictures/2x3_2b.png) | ![](https://raw.githubusercontent.com/ArminJo/LCDBigNumbers/master/pictures/2x3_2x.png) |
| 3x3 | 1 | ![](https://raw.githubusercontent.com/ArminJo/LCDBigNumbers/master/pictures/3x3_1a.png) | ![](https://raw.githubusercontent.com/ArminJo/LCDBigNumbers/master/pictures/3x3_1b.png) | ![](https://raw.githubusercontent.com/ArminJo/LCDBigNumbers/master/pictures/3x3_1x.png) |
| 3x4 | 1 | ![](https://raw.githubusercontent.com/ArminJo/LCDBigNumbers/master/pictures/3x4_1a.png) | ![](https://raw.githubusercontent.com/ArminJo/LCDBigNumbers/master/pictures/3x4_1b.png) | ![](https://raw.githubusercontent.com/ArminJo/LCDBigNumbers/master/pictures/3x4_1x.png) |
| 3x4 | 2 | ![](https://raw.githubusercontent.com/ArminJo/LCDBigNumbers/master/pictures/3x4_2a.png) | ![](https://raw.githubusercontent.com/ArminJo/LCDBigNumbers/master/pictures/3x4_2b.png) | ![](https://raw.githubusercontent.com/ArminJo/LCDBigNumbers/master/pictures/3x4_2x.png) |

# Compile options / macros for this library
To customize the library to different requirements, there are some compile options / macros available. 
These macros must be defined in your program **before** the line `#include <LCDBigNumbers.hpp>` to take effect. 
Modify them by enabling / disabling them, or change the values if applicable.

# Why *.hpp instead of *.cpp?
**Every \*.cpp file is compiled separately** by a call of the compiler exclusively for this cpp file. These calls are managed by the IDE / make system.
In the Arduino IDE the calls are executed when you click on *Verify* or *Upload*.

And now **our problem with Arduino** is: 
**How to set [compile options](#compile-options--macros-for-this-library) for all *.cpp files, especially for libraries used?** 
IDE's like [Sloeber](https://github.com/Arduino-IRremote/Arduino-IRremote?tab=readme-ov-file#modifying-compile-options--macros-with-sloeber-ide) or
[PlatformIO](https://github.com/Arduino-IRremote/Arduino-IRremote?tab=readme-ov-file#modifying-compile-options--macros-with-platformio) support this by allowing to specify a set of options per project.
They add these options at each compiler call e.g. `-DTRACE`.

But Arduino lacks this feature. So the **workaround** is not to compile all sources separately, but to concatenate them to one huge source file by including them in your source.
This is done by e.g. `#include "LCDBigNumbers.hpp"`.
 
But why not `#include "LCDBigNumbers.cpp"`? 
Try it and you will see tons of errors, because each function of the *.cpp file is now compiled twice,
first by compiling the huge file and second by compiling the *.cpp file separately, like described above.
So using the extension *cpp* is not longer possible, and one solution is to use *hpp* as extension, to show that it is an included *.cpp file.
Every other extension e.g. *cinclude* would do, but *hpp* seems to be common sense.

# Revision History
### Version 1.2.3
- Fixed bug in clearing the gap between numbers.

### Version 1.2.2
- Improved _createChar().
- Added `VERSION_LCD_BIG_NUMBERS`.

### Version 1.2.1
- Fixed bug of not working forceGapBetweenNumbers for BIG_NUMBERS_FONT_1_COLUMN_2_ROWS_VARIANT_1.

### Version 1.2.0
- Support for floating point numbers.

### Version 1.1.1
- Removed compiler warning.

### Version 1.1.0
- Changed handling of space and therefore introduced `ONE_COLUMN_SPACE_STRING` and `ONE_COLUMN_SPACE_CHARACTER`.
### Version 1.0.0
 Initial Arduino library version.

LCDBigNumbers

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README