Provided by: linuxcnc-uspace_2.9.1-2ubuntu1_amd64 bug

NAME

       hal_param_new - creates 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_param_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(3hal).

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(3hal)