|
EV3RT C API Reference
V1.0
An RTOS-based development platform for LEGO Mindstorms EV3.
|
|
|
EV3RT C API Reference
V1.0
An RTOS-based development platform for LEGO Mindstorms EV3.
|
|
各種センサに関するAPI． [詳解]
データ構造 | |
| struct | rgb_raw_t |
| RGB Raw値を格納する構造体 [詳解] | |
| struct | ir_seek_t |
| IRビーコンの方位と距離を格納する構造体 [詳解] | |
| struct | ir_remote_t |
マクロ定義 | |
| #define | IR_RED_UP_BUTTON 1 |
| #define | IR_RED_DOWN_BUTTON 2 |
| #define | IR_BLUE_UP_BUTTON 4 |
| #define | IR_BLUE_DOWN_BUTTON 8 |
| #define | IR_BEACON_BUTTON 16 |
列挙型 | |
| enum | sensor_port_t { EV3_PORT_1 = 0, EV3_PORT_2 = 1, EV3_PORT_3 = 2, EV3_PORT_4 = 3, TNUM_SENSOR_PORT = 4 } |
| センサポートを表す番号 [詳解] | |
| enum | sensor_type_t { NONE_SENSOR = 0, ULTRASONIC_SENSOR, GYRO_SENSOR, TOUCH_SENSOR, COLOR_SENSOR, INFRARED_SENSOR, HT_NXT_ACCEL_SENSOR, HT_NXT_COLOR_SENSOR, NXT_TEMP_SENSOR, TNUM_SENSOR_TYPE } |
| サポートするセンサタイプ [詳解] | |
| enum | colorid_t { COLOR_NONE = 0, COLOR_BLACK = 1, COLOR_BLUE = 2, COLOR_GREEN = 3, COLOR_YELLOW = 4, COLOR_RED = 5, COLOR_WHITE = 6, COLOR_BROWN = 7, TNUM_COLOR } |
| カラーセンサで識別できるカラーの番号 [詳解] | |
各種センサに関するAPI．
| enum colorid_t |
| enum sensor_port_t |
| enum sensor_type_t |
| uint8_t ev3_color_sensor_get_ambient | ( | sensor_port_t | port | ) |
カラーセンサで環境光の強さを測定する．
不正のセンサポート番号を指定した場合，常に0を返す（エラーログが出力される）．
| port | センサポート番号 |
| colorid_t ev3_color_sensor_get_color | ( | sensor_port_t | port | ) |
カラーセンサでカラーを識別する．
不正のセンサポート番号を指定した場合，常にCOLOR_NONEを返す（エラーログが出力される）．
| port | センサポート番号 |
| uint8_t ev3_color_sensor_get_reflect | ( | sensor_port_t | port | ) |
カラーセンサで反射光の強さを測定する．
不正のセンサポート番号を指定した場合，常に0を返す（エラーログが出力される）．
| port | センサポート番号 |
| void ev3_color_sensor_get_rgb_raw | ( | sensor_port_t | port, |
| rgb_raw_t * | val | ||
| ) |
カラーセンサでRGB Raw値を測定する．
不正のセンサポート番号を指定した場合，valは更新しない（エラーログが出力される）．
| port | センサポート番号 |
| val | 取得した値を格納する変数のポインタ |
| int16_t ev3_gyro_sensor_get_angle | ( | sensor_port_t | port | ) |
ジャイロセンサで角位置を測定する．
不正のセンサポート番号を指定した場合，常に0を返す（エラーログが出力される）．
| port | センサポート番号 |
| int16_t ev3_gyro_sensor_get_rate | ( | sensor_port_t | port | ) |
ジャイロセンサで角速度を測定する
不正のセンサポート番号を指定した場合，常に0を返す（エラーログが出力される）．
| port | センサポート番号 |
| ER ev3_gyro_sensor_reset | ( | sensor_port_t | port | ) |
ジャイロセンサの角位置をゼロにリセットする．
| port | センサポート番号 |
| E_OK | 正常終了 |
| E_ID | 不正のセンサポート番号 |
| int8_t ev3_infrared_sensor_get_distance | ( | sensor_port_t | port | ) |
IRセンサで距離を測定する．
不正のセンサポート番号を指定した場合，常に0を返す（エラーログが出力される）．
| port | センサポート番号 |
| ir_remote_t ev3_infrared_sensor_get_remote | ( | sensor_port_t | port | ) |
IRセンサでIRビーコンのボタン入力を検出する．
不正のセンサポート番号を指定した場合，常に0のパタンを返す（エラーログが出力される）．
| port | センサポート番号 |
| ir_seek_t ev3_infrared_sensor_seek | ( | sensor_port_t | port | ) |
IRセンサでIRビーコンの方位と距離を測定する．
不正のセンサポート番号を指定した場合，常に0の方位と-128の距離を返す（エラーログが出力される）．
| port | センサポート番号 |
| ER ev3_sensor_config | ( | sensor_port_t | port, |
| sensor_type_t | type | ||
| ) |
センサポートを設定する．
センサポートに接続しているセンサのタイプを設定する．既に設定した場合も新しいセンサタイプを指定できる．
| port | センサポート番号 |
| type | センサタイプ |
| E_OK | 正常終了 |
| E_ID | 不正のセンサポート番号 |
| E_PAR | 不正のセンサタイプ |
| ER_UINT ev3_sensor_get_type | ( | sensor_port_t | port | ) |
センサポートのセンサタイプを取得する．
| port | センサポート番号 |
| >=0 | 指定したセンサポートのセンサタイプ |
| E_ID | 不正のセンサポート番号 |
| bool_t ev3_touch_sensor_is_pressed | ( | sensor_port_t | port | ) |
タッチセンサの状態を検出する．
不正のセンサポート番号を指定した場合，常に false を返す（エラーログが出力される）．
| port | センサポート番号 |
| true | 押されている状態 |
| false | 押されていない状態 |
| int16_t ev3_ultrasonic_sensor_get_distance | ( | sensor_port_t | port | ) |
超音波センサで距離を測定する．
不正のセンサポート番号を指定した場合，常に0を返す（エラーログが出力される）．
| port | センサポート番号 |
| bool_t ev3_ultrasonic_sensor_listen | ( | sensor_port_t | port | ) |
超音波センサで超音波信号を検出する．
不正のセンサポート番号を指定した場合，常に false を返す（エラーログが出力される）．
| port | センサポート番号 |
| true | 超音波信号を検出した |
| false | 超音波信号を検出しなかった |
| bool_t ht_nxt_accel_sensor_measure | ( | sensor_port_t | port, |
| int16_t | axes[3] | ||
| ) |
加速度センサ（HiTechnic社製）で加速度を測定する．
不正のセンサポート番号を指定した場合，常に false を返す（エラーログが出力される）．
| port | センサポート番号 |
| axes | x軸、y軸、z軸の3方向の加速度を格納するための配列 |
| true | axes[]は更新された |
| false | axes[]は変更されなかった（前回のI2C操作が完成していない） |
| bool_t ht_nxt_color_sensor_measure_color | ( | sensor_port_t | port, |
| uint8_t * | color | ||
| ) |
カラーセンサ（HiTechnic社製）でカラーを測定する．
不正のセンサポート番号を指定した場合，常に false を返す（エラーログが出力される）．
| port | センサポート番号 |
| color | カラーの番号（0-17）を格納するためのポインタ |
| true | colorは更新された |
| false | colorは変更されなかった（前回のI2C操作が完成していない） |
| bool_t ht_nxt_color_sensor_measure_rgb | ( | sensor_port_t | port, |
| rgb_raw_t * | val | ||
| ) |
カラーセンサ（HiTechnic社製）でRGB Raw値を測定する．
不正のセンサポート番号を指定した場合，常に false を返す（エラーログが出力される）．
| port | センサポート番号 |
| val | RGB Raw値を格納するためのポインタ |
| true | valは更新された |
| false | valは変更されなかった（前回のI2C操作が完成していない） |
| bool_t nxt_temp_sensor_measure | ( | sensor_port_t | port, |
| float * | temp | ||
| ) |
NXT温度センサ（9749）で温度を測定する．
不正のセンサポート番号を指定した場合，常に false を返す（エラーログが出力される）．
| port | センサポート番号 |
| temp | 温度データ（°C）を格納するための変数へのポインタ |
| true | tempは更新された |
| false | tempは変更されなかった（前回のI2C操作が完成していない） |
1.8.13