Extern Function

Target Category: Arduino, C2407, Cortex M3, Delfino, F280x, F281X, Generic MCU, Linux AMD64 and Raspberry Pi, MSP430, Piccolo, STM32

Target Sub-Category: Extern

Description: The Extern Function block lets you call an external function.

The Extern Function block only allows built-in C data types. This means, for example, that you would specify the unsigned short data type in the Extern Function block to match a uint16 user-defined data type.

Do Not Declare Function: Prevents the code generator from creating a declaration for the function. This is useful if the function is already declared in the header file.

Function Name: Specifies the function call. To specify function calls on new lines, press CTRL+ENTER.

You can specify arguments to a function that reference the input pins using $ notation. For example, Foo($1,$2).

Input Pins: Specifies the number of input pins.

Return Value Type

Data Type: Specifies the data type of the variable. If you choose hardware register, Embed will only create a reference in the code and not an external declaration.

char: Smallest addressable unit. On the MSP430, it is 8 bits; on the C2000, it is 16 bits.
char*: Pointer to a character.
double: 64-bit floating point number.
float: 32-bit floating point number.
int: The natural word length for a given architecture.
long: 32 bits.
MATRIX: Pointer to Embed MATRIX data type. The MATRIX structure is defined in VSUSER.H.
SCALED_INT: 16- or 32-bit depending on word size, which is specified separately.
short: 16 bits.
unsigned char: Smallest addressable unsigned unit. On the MSP430, it is 8 bits; on the C2000, it is 16 bits.
unsigned long: Non-negative 32 bits.
unsigned short: Non-negative 16 bits.

Has Return Value: Lets you return a value. If you have a return value, there will be an output pin to reference it.

Radix Point: Sets the binary point.

Word Size: Specifies the word size in bits.