Component: Input Digital (DSP)

Author	Matrix Ltd
Version	1.2
Category	DSP

Input Digital component

Allows the values from a buffer to be assigned. Either a value at a time or from an array. The input signal would usually take the form of an ADC reading or raw data values.

Detailed description

No detailed description exists yet for this component

Examples

Here is a basic example demonstrating how to pass a value into the DSP chain. Delay The input value in the example uses an ADC reading but this can be taken from anything such as a reading from a CSV file on a SD card or a value passed by a sensor on a I2C bus etc.

Downloadable macro reference

	AddByte
Adds a single byte value to the current location in the specified buffer and scales it appropriatley to suit the buffer. Auto increments current location.
- BYTE	Data
- VOID	Return

	AddByteArray
Adds an array of byte values to the specified buffer and scales it appropriatley to suit the buffer. Auto increments current location.
- BYTE	Data
- UINT	Count
- VOID	Return

	AddLong
Adds a single unsigned long value to the current location in the specified buffer and scales it appropriatley to suit the buffer. Auto increments current location.
- ULONG	Data
- VOID	Return

	AddInt
Adds a single unsigned int value to the current location in the specified buffer and scales it appropriatley to suit the buffer. Auto increments current location.
- UINT	Data
- VOID	Return

	AddLongArray
Adds an array of long values to the specified buffer and scales it appropriatley to suit the buffer. Auto increments current location.
- ULONG	Data
- UINT	Count
- VOID	Return

	AddIntArray
Adds an array of integer values to the specified buffer and scales it appropriatley to suit the buffer. Auto increments current location.
- UINT	Data
- UINT	Count
- VOID	Return

	IsPlaying
Checks to see if the last played track is still playing
[[File:]] -	Return

	GetReplyByte
Reads a single byte from the last reply. Each reply contains 4 bytes starting with the command code.
- BYTE	Index
Range: 0-3 / 0=Command, 1=Feedback, 2=Data MSB, 3=Data LSB
- BYTE	Return

	SkipTrack
Jump to the next or previous track
[[File:]] -	Direction
0=Next, 1=Previous
- VOID	Return

	PlayTrack
Plays track from the selected folder. MP3 & Advert folder track numbers should be 4 characters long e.g. 0001 any name.mp3, Other folder track numbers should be 3 characters long e.g. 001 Any name.mp3, Root the Track played in placement order.
- BYTE	Directory
0=Root, 1=Folder "01" - 99=Folder "99", 100=MP3, 101=Advert
- UINT	Track
Track number 1="001*.MP3" / "0001*.MP3", 100="100*.MP3" / "0100*.MP3"
- VOID	Return

	Initialise
Sets up the UART and does some housekeeping. Must be called before calling any of the other component macros.
- VOID	Return

	ReadAnalogAsInt
Reads one of the analogue components as an Integer value
- BYTE	Channel
0 = LDR, 1 = POT
[[File:]] -	Return

	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

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

	SetLEDState
Sets the state of a single LED
- BYTE	Port
0 = PortA, 1 = PortB
- BYTE	LED
0 = LED0, 7 = LED7
- BYTE	State
- VOID	Return

	Initialise
Must be called before any other CAN component macros to enable and initialise the CAN peripheral.
- VOID	Return

Property reference

	Properties
	Buffer Size
Number of individual elements the buffer can store, default 1.
	Buffer Type
Sets the buffer data type, data is automatically scaled to fit and make full use of the data type.
	Connections
	Simulations