Component: Combo Board (EB083) (E-blocks 1)

Author	Matrix TSL
Version	1.0
Category	E-blocks 1

Combo Board component

A component to drive the EB083 Combo board including LEDs, Switches, LCD, 7-Segs and analogue inputs.

Component Source Code

Please click here to download the component source project: FC_Comp_Source_EB086_DEMO.fcfx

Please click here to view the component source code (Beta): FC_Comp_Source_EB086_DEMO.fcfx

Detailed description

No detailed description exists yet for this component

Examples

The following files provide examples of how to use this component:

Arduino Mega 2560 & Combo Board

This blank project consists of the Matrix EB083 Combo Board connected to an Arduino Mega 2560.

Arduino Uno R3 & Combo Board

This blank project consists of the Matrix EB093 Combo Board connected to an Arduino Uno R3.

Note; Due to a limitation in the Arduino Uno hardware, portA6 & PortA7 are replicated from PortA5 in this template.

Macro reference

Clear

	Clear
Clears the entire contents of the display.
- VOID	Return

ClearLine

	ClearLine
Clears a single line on the display and then moves the cursor to the start of the line to allow you to start populating the line with data.
- BYTE	Line
The line to clear, zero being the first (top) line of the display
- VOID	Return

Command

	Command
Use this method/macro to send a specific command to the LCD. Refer to the Matrix Multimedia EB006 datasheet for a list of supported instructions. For Non-Matrix LCD's refer to the manufacturers datasheet.
- BYTE	instruction
Send a defined command to the LCD Screen. See datasheet for supported commands.
- VOID	Return

Cursor

	Cursor
Moves the cursor on the LCD Display
- BYTE	x
Set the cursor position in the X plane, 0 is the left most cell
- BYTE	y
Set the cursor position in the Y plane, 0 is the top most cell
- VOID	Return

GetPort

	GetPort
Reads the state of a single port
- BYTE	Bank
0 = Top Bank of Switches, 1 = Bottom Bank of Switches
- BYTE	Return

GetSwitchState

	GetSwitchState
Reads the state of a single switch Returns: 0 = Switch not pressed, 1 = Switch pressed
- BYTE	Bank
0 = Top Bank of Switches, 1 = Bottom Bank of Switches
- BYTE	Switch
0 = SW0, 7 = SW7
- BYTE	Return

PrintAscii

	PrintAscii
Takes the ascii value for a character and prints the character
- BYTE	character
Holds an ascii value.
- VOID	Return

PrintFloat

	PrintFloat
Print a Float number rounded up to a specified amount of decimal places.
- FLOAT	Number
Enter the number or variable to print to the LCD
- BYTE	DecimalPlaces
Enter how many decimal places to round up to (1 - 6)
- VOID	Return

PrintFormattedNumber

	PrintFormattedNumber
Will allow you to print a number up to 32-bits with signed or unsigned formatting. Signed = -2147483648 to 2147483647 Unsigned = 0 to 4294967295
- ULONG	Number
Enter the number or variable to print to the LCD
- BOOL	Format
0=Signed, 1=Unsigned
- VOID	Return

PrintNumber

	PrintNumber
Based on v5 macro, will allow you to print a number. This is limited to a signed-INT, -32768 to 32767
- INT	Number
Enter the number or variable to print to the LCD
- VOID	Return

PrintString

	PrintString
Breaks down a string of text and sends it to the LCD via the private RawSend(byte, mask) macro
- STRING	Text
Enter the text or variable to print to the LCD
- VOID	Return

RAMWrite

	RAMWrite
Modifies the internal memory of the LCD to allow for up to 8 customised characters to be created and stored in the device memory
- BYTE	Index
Values 0 to 7
- BYTE	d0
- BYTE	d1
- BYTE	d2
- BYTE	d3
- BYTE	d4
- BYTE	d5
- BYTE	d6
- BYTE	d7
- VOID	Return

RawSend

	RawSend
Sends data to the LCD display
- BYTE	data
The data byte to send to the LCD
- BOOL	type
A boolean to indicate command type: true to write data, false to write a command
- VOID	Return

ReadAnalogAsByte

	ReadAnalogAsByte
Reads one of the analogue components as an byte value
- BYTE	Channel
0 = Light Sensor, 1 = Potentiometer
- BYTE	Return

ReadAnalogAsInt

	ReadAnalogAsInt
Reads one of the analogue components as an Integer value
- BYTE	Channel
0 = Light Sensor, 1 = Potentiometer
- INT	Return

RemapCharacter

	RemapCharacter
Assigns a remap character allowing the PrintString function to automatically swap between pre-defined characters. The characters can be custom (in the range 0-9) or can point to an existing character in the LCD character map.
- BYTE	RemapIdx
Remap Index, Range: 0 to (Remap Characters - 1)
- BYTE	SearchCharacter
Character to look for a replace
- BYTE	ReplacementCharacter
New character value to use in place of the search character.
- VOID	Return

ScrollDisplay

	ScrollDisplay
Scrolls the display left or right by a number of given positions.
- BYTE	Position
Holds the number of positions to shift the display
- BYTE	Direction
0 = left, 1 = right
- VOID	Return

SegShowDigit

	SegShowDigit
Displays a digit on the 7-seg display
- BYTE	Digit
Which of the digits to change (0 - 3)
- BYTE	Value
The value to display (0 - 9)
- BYTE	DecimalPoint
Decides if the decimal point is lit
- VOID	Return

SegShowSegments

	SegShowSegments
Allows the individual segments of the display to be controlled.
- BYTE	Digit
Which of the digits to change (0 - 3)
- BYTE	Segments
8-bit Binary value to set the segments, bit0 = segA, bit1 = segB...
- VOID	Return

SetLEDState

	SetLEDState
Sets the state of a single LED
- BYTE	Bank
0 = Top Bank of LEDs, 1 = Bottom Bank of LEDs
- BYTE	LED
0 = LED0, 7 = LED7
- BYTE	State
0 = Off, 1 = On
- VOID	Return

SetPort

	SetPort
Sets the state of a single port
- BYTE	Bank
0 = Top Bank of LEDs, 1 = Bottom Bank of LEDs
- BYTE	Value
- VOID	Return

Start

	Start
Startup routine required by the hardware device. Automatically clears the display after initialising.
- VOID	Return

Property reference

	Properties
	Connection Type
	Bank 0 Connections
	Bank 0
	Bank 1 Connections
	Bank 1
	Analog Connections
	Light Sensor
Light Sensor ADC channel Connected to Bank 0 pin 0 which is usually analog pin AN0.
	Potentiometer
Potentiometer ADC channel Connected to Bank 0 pin 1 which is usually analog pin AN1.
	Simulation
	Analog Scope Traces
Controls if traces are automatically added to the data recorder window for the analogue signals on the combo board.