segmentlcd.c File Reference

EFM32 Segment LCD Display driver.

Version
5.4.0

License

Copyright 2017 Silicon Labs, Inc. www.silabs.com

This file is licensed under the Silabs License Agreement. See the file "Silabs_License_Agreement.txt" for details. Before using this software for any purpose, you must agree to the terms of that agreement.

Definition in file segmentlcd.c.

#include <stdio.h>
#include <string.h>
#include <stdlib.h>
#include <stdbool.h>
#include "em_device.h"
#include "em_cmu.h"
#include "em_gpio.h"
#include "segmentlcd.h"

Data Structures

struct  ARING_TypeDef
 Defines segment COM and BIT fields for A-wheel (suited for Anim)
 
struct  ARRAY_TypeDef
 Defines segment COM and BIT fields for array.
 
struct  BATTERY_TypeDef
 Defines segment COM and BIT fields for Battery (suited for Anim)
 
struct  Block_TypeDef
 Defines segment COM and BIT fields for top and bottom row blocks. The bit pattern shown above for characters can be split into upper and lower portions for animation purposes. There are separate COM and BIT numbers which together represent a set of stacked blocks which can be shown on two rows in the segmented LCD screen.
 
struct  CHAR_TypeDef
 Defines each text symbol's segment in terms of COM and BIT numbers, in a way that we can enumerate each bit for each text segment in the following bit pattern:
 
struct  EM_TypeDef
 Defines segment COM and BIT fields for Energy Modes on display.
 
struct  MCU_DISPLAY
 Defines prototype for all segments in display.
 
struct  NUMBER_TypeDef
 Defines segment COM and BIT fields numeric display.
 

Macros

#define ALPHA_DIGITS   7
 
#define ALPHA_VAL_MAX   9999999
 
#define ALPHA_VAL_MIN   -9999999
 
#define NUM_DIGITS   4
 
#define NUM_VAL_MAX   9999
 
#define NUM_VAL_MAX_HEX   0xFFFF
 
#define NUM_VAL_MIN   -999
 

Functions

static void displayBlock (SegmentLCD_BlockMode_TypeDef topMode[SEGMENT_LCD_NUM_BLOCK_COLUMNS], SegmentLCD_BlockMode_TypeDef botMode[SEGMENT_LCD_NUM_BLOCK_COLUMNS])
 Working instance of LCD display.
 
void SegmentLCD_AllOff (void)
 Disable all segments.
 
void SegmentLCD_AllOn (void)
 Enable all segments.
 
void SegmentLCD_AlphaNumberOff (void)
 Turn all segments on alpha characters in display off.
 
void SegmentLCD_ARing (int anum, int on)
 Light up or shut off Ring of Indicators.
 
void SegmentLCD_Battery (int batteryLevel)
 Light up or shut off Battery Indicator.
 
void SegmentLCD_Block (SegmentLCD_BlockMode_TypeDef topMode[SEGMENT_LCD_NUM_BLOCK_COLUMNS], SegmentLCD_BlockMode_TypeDef botMode[SEGMENT_LCD_NUM_BLOCK_COLUMNS])
 
void SegmentLCD_Disable (void)
 Disables LCD controller.
 
void SegmentLCD_EnergyMode (int em, int on)
 Light up or shut off Energy Mode indicator.
 
void SegmentLCD_Init (bool useBoost)
 Segment LCD Initialization routine for EFM32 STK display.
 
void SegmentLCD_LowerHex (uint32_t num)
 Write a hexadecimal number on lower alphanumeric part of Segment LCD display.
 
void SegmentLCD_LowerNumber (int num)
 Write number on lower alphanumeric part of Segment LCD display.
 
void SegmentLCD_Number (int value)
 Write number on numeric part on Segment LCD display.
 
void SegmentLCD_NumberOff (void)
 Turn all segments on numeric digits in display off.
 
unsigned int SegmentLCD_segCnt (unsigned int segdl, unsigned int segdh)
 Counting the number of active segments in a single common line.
 
void SegmentLCD_Symbol (lcdSymbol s, int on)
 Light up or shut off various symbols on Segment LCD.
 
void SegmentLCD_UnsignedHex (uint32_t value)
 Write hexadecimal number on numeric part on Segment LCD display.
 
void SegmentLCD_Write (const char *string)
 Write text on LCD display.
 

Variables

static const uint16_t Blocks []
 Defines highlighted segments for the block display.
 
static const MCU_DISPLAY EFM_Display = EFM_DISPLAY_DEF
 Working instance of LCD display.
 
static const uint16_t Segment_Alphabet []
 Defines higlighted segments for the alphabet, starting from "blank" (SPACE) Uses bit pattern as defined for text segments above. E.g. a capital O, would have bits 0 1 2 3 4 5 => 0x003f defined.
 
static const uint16_t Segment_Numbers []
 Defines higlighted segments for the numeric display.
 

Function Documentation

static void displayBlock ( SegmentLCD_BlockMode_TypeDef  topMode[SEGMENT_LCD_NUM_BLOCK_COLUMNS],
SegmentLCD_BlockMode_TypeDef  botMode[SEGMENT_LCD_NUM_BLOCK_COLUMNS] 
)
static

Working instance of LCD display.

Enabling/disabling dynamic charge redistribution.

Parameters
true==> enable, false ==> disable

Dynamically switching charge redistribution ON/OFF based on display contents

Parameters
None

Definition at line 1293 of file segmentlcd.c.

References Block_TypeDef::bit, Blocks, MCU_DISPLAY::BotBlocks, Block_TypeDef::com, and MCU_DISPLAY::TopBlocks.

unsigned int SegmentLCD_segCnt ( unsigned int  segdl,
unsigned int  segdh 
)

Counting the number of active segments in a single common line.

Parameters
valuein registers LCD_SEGDnL and LCD_SEGDnH (n = common line number)

Definition at line 1120 of file segmentlcd.c.

Variable Documentation

const uint16_t Blocks[]
static
Initial value:
= {
0x0000,
0x00E0,
0x001F,
0x00FF
}

Defines highlighted segments for the block display.

Definition at line 328 of file segmentlcd.c.

Referenced by displayBlock().

const uint16_t Segment_Numbers[]
static
Initial value:
= {
0x003f,
0x0006,
0x005b,
0x004f,
0x0066,
0x006d,
0x007d,
0x0007,
0x007f,
0x006f,
0x0077,
0x007c,
0x0039,
0x005e,
0x0079,
0x0071,
0x0040
}

Defines higlighted segments for the numeric display.

Definition at line 304 of file segmentlcd.c.

Referenced by SegmentLCD_Number(), and SegmentLCD_UnsignedHex().