超音波センサのAPI． [詳解]

関数
pup_device_t *	pup_ultrasonic_sensor_get_device (pbio_port_id_t port)
	ポート ID で指定された超音波センサへの PUP デバイスポインタを取得する．

int32_t	pup_ultrasonic_sensor_distance (pup_device_t *pdev)
	超音波センサで距離を測定する．

bool	pup_ultrasonic_sensor_presence (pup_device_t *pdev)
	超音波センサで超音波信号を検出する．

pbio_error_t	pup_ultrasonic_sensor_light_set (pup_device_t *pdev, int32_t bv1, int32_t bv2, int32_t bv3, int32_t bv4)
	超音波センサ内臓の4つのライトの輝度をセットする．

pbio_error_t	pup_ultrasonic_sensor_light_on (pup_device_t *pdev)
	超音波センサのライトを点灯させる．

pbio_error_t	pup_ultrasonic_sensor_light_off (pup_device_t *pdev)
	超音波センサのライトを消灯させる．

詳解

超音波センサのAPI．

関数詳解

◆ pup_ultrasonic_sensor_distance()

int32_t pup_ultrasonic_sensor_distance ( pup_device_t * pdev )

超音波センサで距離を測定する．

失敗した場合，エラーログを出力し，負の値を返す．

引数

pdev	PUP デバイスポインタ．

戻り値: 距離（単位：mm ）

◆ pup_ultrasonic_sensor_get_device()

pup_device_t * pup_ultrasonic_sensor_get_device ( pbio_port_id_t port )

ポート ID で指定された超音波センサへの PUP デバイスポインタを取得する．

失敗した場合，エラーログを出力し，NULL を返す．

引数

port	PUP ポート ID．

戻り値: PUP デバイスポインタ．

◆ pup_ultrasonic_sensor_light_off()

pbio_error_t pup_ultrasonic_sensor_light_off ( pup_device_t * pdev )

超音波センサのライトを消灯させる．

pup_ultrasonic_sensor_light_set(pdev, 0, 0, 0, 0) と同じ．

引数

pdev	PUP デバイスポインタ．

戻り値

err エラー番号．

◆ pup_ultrasonic_sensor_light_on()

pbio_error_t pup_ultrasonic_sensor_light_on ( pup_device_t * pdev )

超音波センサのライトを点灯させる．

pup_ultrasonic_sensor_light_set(pdev, 100, 100, 100, 100) と同じ．

引数

pdev	PUP デバイスポインタ．

戻り値

err エラー番号．

◆ pup_ultrasonic_sensor_light_set()

pbio_error_t pup_ultrasonic_sensor_light_set	(	pup_device_t *	pdev,
		int32_t	bv1,
		int32_t	bv2,
		int32_t	bv3,
		int32_t	bv4 )

超音波センサ内臓の4つのライトの輝度をセットする．

引数

pdev	PUP デバイスポインタ．
bv1	輝度.

戻り値

err エラー番号．

◆ pup_ultrasonic_sensor_presence()

bool pup_ultrasonic_sensor_presence ( pup_device_t * pdev )

超音波センサで超音波信号を検出する．

失敗した場合，false を返す．

引数

pdev	PUP デバイスポインタ．

戻り値

true	超音波を検出した．
false	超音波を検出しなかった．