Repository files navigation

Just another library to communicate with the SHA5461AS 4 Digit Segment Display.

This library has been written in order to help a pupil of mine with his Arduino project.

• Installation
• Importing/Including
• Example
• Flags
• Library Overview
  • class Display
    • Constructor
    • Members
    • Member Functions
      • void print(const char[])
        • Example
      • void toggle()
      • void toggle(bool arg_state)
      • void fill(bool all = true)
      • void empty()
  • class Digit
    • Members
    • Member Functions
      • void toggle()
      • void toggle(bool arg_state)
  • class Segment
    • Members
    • Member Functions
      • void toggle()
      • void toggle(bool arg_state)
• License

Download the repository as a zip

After obtaining a local copy, import the library in theArduino IDE:

Add the following to the top of your source file in order to include this library:

#include"Segment.h"#include"Digit.h"#include"Display.h"

The following example prints1.234 to the display

#include<Arduino.h>/* Include this library*/#include"Segment.h"#include"Digit.h"#include"Display.h"const byte digit_pins[4] {6,9,10,12};// From com1 - com4const byte segment_pins[7] {7,11,2,4,5,8,13};// From a - g (abc...g)const byte dp_pin =3;Displayd(digit_pins, segment_pins, dp_pin);voidsetup() {for (int i =0; i <= A5; i++) {pinMode(i, OUTPUT);  }}voidloop() {  d.print("1.234");// Must be looped!}

Result:

The following preprocessor directives may be used to optimize the library:

Preprocessors must be setBEFORE the library is included:

#defineDISABLE_DP#include"Segment.h"#include"Digit.h"#include"Display.h"

The library provides a total of three classes:

The Display class acts as a display controller and should be sufficient for most applications. It provides aprint function that displays the provided number on the display. Seeclass Display for more.

A display controller class

The constructor is provided with the necessary pin information in order to successfully communicate with the display.

#ifdef DISABLE_DPDisplay(byte digit_pins[4], byte segment_pins[7])#elseDisplay(byte digit_pins[4], byte segment_pins[7], byte dp_pin)#endif

Access: Public

Prints a string of numbers onto the display. The string may only include characters\0,0-9 and. (unless#DISABLE_DP has been defined).The print function requires to be constantly refreshed!

If\0 has been provided, no number is displayed (Ex:print("1\0\01") will display 1 on the first and last digit only).

Because speed is crucial, this function provides no error-checking. As a result, if too many, or invalid characters have been specified, the display will return unpredictable/wrong results.

Access: Public

Togglesall digits on or off, depending on it's previous state.

Access: Public

Setsall digits to the provided state.

Access: Public

Turns all segments and decimal points (unless#DISABLE_DP has been defined) to 'ON'. Ifbool all has been set tofalse, only digits that are 'ON' will be filled.

Access: Public

Turns all segments and decimal points (unless#DISABLE_DP has been defined) to 'OFF'.

A hardware abstraction for COM pins

The constructor is provided with the necessary pin information in order to successfully communicate with the display.

Digit(byte pin);

Access: Public

Toggles digit on or off, depending on it's previous state.

Access: Public

Sets digit to the provided state.

A hardware abstraction for segments

The constructor is provided with the necessary pin information in order to successfully communicate with the display.

Segment(byte pin);

Access: Public

Toggles segment on or off, depending on it's previous state.

Access: Public

Sets segment to the provided state.

The MIT License (MIT)Copyright (c) 2018 Patrick PedersenPermission is hereby granted, free of charge, to any person obtaining a copyof this software and associated documentation files (the "Software"), to dealin the Software without restriction, including without limitation the rightsto use, copy, modify, merge, publish, distribute, sublicense, and/or sellcopies of the Software, and to permit persons to whom the Software isfurnished to do so, subject to the following conditions:The above copyright notice and this permission notice shall be included inall copies or substantial portions of the Software.THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS ORIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THEAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHERLIABILITY, 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 INTHE SOFTWARE.