M128_HMI_Form_put

呼叫介面

char M128_HMI_Form_put(char *FormatString, int Bytes, void *Data_p)

簡介

呼叫函式可以將存放於指標*Data_p所指記憶體內、以”FormatString”指定不同形態及筆數組 成之資料結構內容送向人機。

輸入參數

FormatString：由資料代碼及筆數所組成之字串，其中每一欄位，代表依總資料型態， 由 Type資料型態代碼對應表 中的代碼表示，後接英文字母”x”及一個數字指其筆數。形態文字代碼 。各欄間以”,”隔開。

Bytes：欲接收資料bytes數大小，最大值為65535。

Data_p：欲存放接收結構資料之變數指標位址。

回傳

0：成功

1：錯誤

Type資料型態代碼對應表

代碼	使用資料型態	說明	avr-gcc中的變數型態
i8	int8	8 bit 整數型態	char, int8_t
i16	int16	16 bit 整數型態	int, int16_t
i32	int32	32 bit 整數型態	long int, int32_t
i64	int64	64 bit 整數型態	int64_t
ui8	uint8	8 bit正整數型態	unsigned char, uint8_t
ui16	uint16	16 bit正整數型態	unsigned int, uint16_t
ui32	uint32	32 bit 正整數型態	unsigned long int, uint32_t
ui64	uint64	64 bit 正整數型態	uint64_t
f32	float32	32 bit 浮點數型態	float, double
f64	float64	64 bit 浮點數型態

範例

struct Ball {
    char color[10];
    float radius;
}

struct Ball ball1 = {"red", 5.0};

M128_HMI_Form_put("i8x10,f32x1", &ball1); //10筆char,1筆float