Machinekit

Machinekit

hal_param_new

NAME

hal_param_new — Create a HAL parameter

SYNTAX

int hal_param_bit_new ( const char *name, hal_param_dir_t dir, hal_bit_t * data_addr, int comp_id )

int hal_param_float_new ( const char *name, hal_param_dir_t dir, hal_float_t * data_addr, int comp_id )

int hal_param_u32_new ( const char *name, hal_param_dir_t dir, hal_u32_t * data_addr, int comp_id )

int hal_param_s32_new ( const char *name, hal_param_dir_t dir, hal_s32_t * data_addr, int comp_id )

int hal_param_bit_newf ( hal_param_dir_t dir, hal_bit_t * data_addr, int comp_id, const char *fmt, …​ )

int hal_param_float_newf ( hal_param_dir_t dir, hal_float_t * data_addr, int comp_id, const char *fmt, …​ )

int hal_param_u32_newf ( hal_param_dir_t dir, hal_u32_t * data_addr, int comp_id, const char *fmt, …​ )

int hal_param_s32_newf ( hal_param_dir_t dir, hal_s32_t * data_addr, int comp_id, const char *fmt, …​ )

int hal_param_new ( const char name, hal_type_t type, hal_in_dir_t dir, void *data_addr, int* comp_id )

ARGUMENTS

name
The name to give to the created parameter

dir
The direction of the parameter, from the viewpoint of the component. It may be one of HAL_RO, or HAL_RW
A component may assign a value to any parameter, but other programs (such as halcmd) may only assign a value to a parameter that is HAL_RW.

data_addr
The address of the data, which must lie within memory allocated by hal_malloc.

comp_id
A HAL component identifier returned by an earlier call to hal_init.

fmt, …​
A printf-style format string and arguments

type
The type of the parameter, as specified in hal_type_t.

DESCRIPTION

The hal_param_new family of functions create a new param object.

There are functions for each of the data types that the HAL supports.
Pins may only be linked to signals of the same type.

RETURN VALUE

Returns a HAL status code.

SEE ALSO

hal_type_t