SYNTAX
int hal_pin_bit_new(const char* name, hal_pin_dir_t dir, hal_bit_t** data_ptr_addr, int comp_id)
int hal_pin_float_new(const char* name, hal_pin_dir_t dir, hal_float_t** data_ptr_addr, int comp_id)
int hal_pin_u32_new(const char* name, hal_pin_dir_t dir, hal_u32_t** data_ptr_addr, int comp_id)
int hal_pin_s32_new(const char* name, hal_pin_dir_t dir, hal_s32_t** data_ptr_addr, int comp_id)
int hal_pin_port_new(const char* name, hal_pin_dir_t dir, hal_port_t** data_ptr_addr, int comp_id)
int hal_pin_bit_newf(hal_pin_dir_t dir, hal_bit_t** data_ptr_addr, int comp_id, const char* fmt, …)
int hal_pin_float_newf(hal_pin_dir_t dir, hal_float_t** data_ptr_addr, int comp_id, const char* fmt, …)
int hal_pin_u32_newf(hal_pin_dir_t dir, hal_u32_t** data_ptr_addr, int comp_id, const char* fmt, …)
int hal_pin_s32_newf(hal_pin_dir_t dir, hal_s32_t** data_ptr_addr, int comp_id, const char* fmt, …)
int hal_pin_port_newf(hal_pin_dir_t dir, hal_port_t** data_ptr_addr, int comp_id, const char* fmt, …)
int hal_pin_new(const char* name, hal_type_t type, hal_pin_dir_t dir, void** data_ptr_addr, int comp_id)
ARGUMENTE
- name
-
Name des Pins.
- dir
-
Die Richtung des Pins aus der Sicht der Komponente. Es kann einer von HAL_IN>, HAL_OUT oder HAL_IO sein. Eine beliebige Anzahl von HAL_IN- oder HAL_IO-Pins kann mit demselben Signal verbunden werden, es ist jedoch höchstens ein HAL_OUT-Pin zulässig. Eine Komponente kann einem Pin, der HAL_OUT oder HAL_IO ist, einen Wert zuweisen, aber nicht einem Pin, der HAL_IN ist.
- data_ptr_addr
-
Die Adresse des Zeigers auf Daten, die im von hal_malloc zugewiesenen Speicher liegen muss.
- comp_id
-
Eine HAL-Komponenten-Kennung, die durch einen früheren Aufruf von hal_init zurückgegeben wurde.
- fmt,
-
Formatzeichenfolge und Argumente im Stil von printf
- type
-
Der Typ des Parameters, wie in hal_type_t(3) angegeben.
BESCHREIBUNG
Die Funktionen der Familie hal_pin_new erzeugen ein neues pin Objekt. Sobald ein Pin erstellt wurde, kann er mit Hilfe von hal_link mit einem Signalobjekt verknüpft werden. Ein Pin enthält einen Zeiger, und die Komponente, die den Pin besitzt, kann den Zeiger derefenzieren, um auf das Signal zuzugreifen, das mit dem Pin verknüpft ist. (Wenn kein Signal verknüpft ist, zeigt er auf ein Dummy-Signal.)
Für jeden Datentyp, den der HAL unterstützt, gibt es Funktionen. Pins dürfen nur mit Signalen desselben Typs verknüpft werden.
RETURN VALUE
Gibt bei Erfolg 0 oder bei einem Fehler einen negativen errno-Wert zurück.
SIEHE AUCH
hal_type_t(3), hal_link(3)