#6 フォースセンサと超音波センサの使い方【SPIKE-RTでロボコンに出よう!!】

# 目次

https://qiita.com/koushiro/items/482162807339f4d18516

| 章 | タイトル | 内容 |
| :-: | :-: | :-: |
| 1 | [はじめに](#1-はじめに) | 今回やることの説明 |
| 2 | [フォースセンサの使い方](#2-フォースセンサの使い方) | フォースセンサの使用方法について解説 |
| 3 | [超音波センサの使い方](#3-超音波の使い方) | 超音波センサの使用方法について解説 |
| 4 | [まとめ](#4-まとめ) | 今回のまとめ |

# 1. はじめに

前回はカラーセンサの紹介を行いましたが、今回は「フォースセンサ」と「超音波センサ」の解説を行っていきます。

フォースセンサ、超音波センサのAPIの説明は以下のページに書かれています。本記事はそれをかみ砕いて、LEGO EducationのSPIKEソフトでの例も交えながら紹介していきます。

[SPIKE-RT C API Reference [Japanese] / フォースセンサ](https://spike-rt.github.io/spike-rt/ja/html/group__ForceSensor.html)

[SPIKE-RT C API Reference [Japanese] / 超音波センサ](https://spike-rt.github.io/spike-rt/ja/html/group__UltrasonicSensor.html)

## フォースセンサとは

以下に示すのが、「SPIKEプライム フォースセンサー」 です。

![05_01-300x200.jpg](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/183170/d006e905-b81a-0c8d-5d0d-80667354c5bf.jpeg)

「フォースセンサ」はSPIKEプライムで新たに登場したセンサで、感覚的には「無段階のタッチセンサ」といった感じです。
そのイメージ通り、モノが触れているかどうかを確かめるタッチセンサとして扱うことが出来、EV3やNXTなどのタッチセンサとは異なりその「押され具合」まで感知することが出来るのです。

詳しい仕様はこちら👇から

https://afrel.co.jp/product/spike/technology-spike/prime/hardware/forcesensor/45912/

## 超音波センサ

続いて以下に示すのが、「SPIKEプライム 距離センサー」 です。

![03_01-300x200.jpg](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/183170/10b4648c-58f6-8171-316d-02e5f9dbf09a.jpeg)

SPIKE-RTの表記に合わせ、本記事では「超音波センサ」という名前で扱います。

目のようになっているところが超音波の送信部と受信部になっており、対象物に照射した超音波がどれだけの時間で跳ね返ってくるかを計測することで、距離を算出することが出来るセンサです。
目の部分の周りにはLEDが搭載されており、カラーセンサの時と同様にプログラムにより光り方を変えることが出来ます。

詳しい仕様はこちら👇から

https://afrel.co.jp/product/spike/technology-spike/prime/hardware/distancesensor/45916/

これら二つのセンサの使い方を解説していきます。

# 2. フォースセンサの使い方

それではまず、フォースセンサの方から使い方を解説していきます。

## フォースセンサの設定

前回のカラーセンサと同様に、センサを使う前には「ポート」と「フォースセンサ」の結びつけが必要です。

```c
pup_device_t *pup_force_sensor_get_device(pbio_port_id_t port);
```

関数名は`pup_force_sensor_get_device`で、「ポート」の情報により、「フォースセンサ」と「PUPデバイスポインタ」を結びつけます。
引数として、「ポート」を指定すると、戻り値として「PUPデバイスポインタ」が返ってきます。

使い方の例も示しておきます。

*Ex2-1. フォースセンサのセットアップ*

```c:spikert_6.c
#include <stdlib.h>
#include <stdio.h>
#include <kernel.h>

#include <spike/hub/system.h>

#include <spikert_6.h>

#include "spike/pup/motor.h"
#include "spike/pup/colorsensor.h"
#include "spike/pup/forcesensor.h"
#include "spike/pup/ultrasonicsensor.h"

#include "spike/hub/battery.h"
#include "spike/hub/button.h"
#include "spike/hub/display.h"
#include "spike/hub/imu.h"
#include "spike/hub/light.h"
#include "spike/hub/speaker.h"

#include <pbio/color.h>

#include "kernel_cfg.h"
#include "syssvc/serial.h"

pup_device_t *forceD;

void Main(intptr_t exinf)
{
  forceD = pup_force_sensor_get_device(PBIO_PORT_ID_D);
}
```

はじめに`forceD`という名前で「PUPデバイスポインタ」を宣言しています。
`Main`関数に入ったら、`pup_force_sensor_get_device`関数により「ポートD」が「フォースセンサ」であると結び付けて、`forceD`に格納しています。

こちらも#4・#5とお伝えしましたが、ポートの定数`PBIO_PORT_ID_D`などを使うためには、内部のファイルを編集する必要があります。
編集方法については[#4の2章](https://qiita.com/koushiro/items/0471376a9feb9b53b178#2-%E3%83%A2%E3%83%BC%E3%82%BF%E3%81%AE%E8%A8%AD%E5%AE%9A)をご覧ください。

ファイルの編集を避ける場合は、以下のようにポートを指定することも出来ます。

*Ex2-2. カラーセンサのセットアップ (ポート指定方法)*

```c:spikert_6.c
pup_device_t *forceD;

void Main(intptr_t exinf)
{
  forceD = pup_force_sensor_get_device('D');
}
```

## 力の測定

まずは、フォースセンサを使い、ボタンにどれくらいの力が加わっているかを測定してみましょう。

```c
float pup_force_sensor_force(pup_device_t *pdev);
```

関数名は`pup_force_sensor_force`で、ボタンが押された力の大きさを取得します。
引数に「PUPデバイスポインタ」を入力すると、戻り値として「押された力の大きさ」が`float`型(小数値)で返ってきます。
尚、力の単位は`N`(ニュートン)となります。

では、簡単な使い方の例を示しておきます。

*Ex2-3. 押された力の大きさを測定する*

```c:spikert_6.c
pup_device_t *forceD;

void Main(intptr_t exinf)
{
  forceD = pup_force_sensor_get_device(PBIO_PORT_ID_D);
  
  while(1){
    float force =  pup_force_sensor_force(forceD);

    char str[32];
    sprintf(str, "%lf", force);
    hub_display_text_scroll(str, 100);
  }
}
```

フォースセンサとポートの結びつけを行った後、無限ループに入り、ボタンが押された力の大きさを測定します。
測定値は小数値で取得されるので、`sprintf`関数を使用して`char`型配列に格納し、ハブディスプレイに表示しています。

ここで実際に試していただくとわかりますが、データ型は`float`で小数値であるものの、実際に返される値は`0`~`10`の整数値のようです。
よって、以下のようなプログラムでも十分使えるかと思います。

*Ex2-4. 押し込まれた長さを測定する(整数値)*

```c:spikert_6.c
pup_device_t *forceD;

void Main(intptr_t exinf)
{
  forceD = pup_force_sensor_get_device(PBIO_PORT_ID_D);
  
  while(1){
    int force = (int)pup_force_sensor_force(forceD);
    hub_display_number(force);
  }
}
```

ここで、`pup_force_sensor_force`関数の前に`(int)`がついていますが、これは **「キャスト演算子」** と呼ばれるもので、データ型の変換を行います。
この場合、`float`型で得られる「力の大きさ」の値を、`int`型に変換して変数`force`に代入しています。

## ボタンの移動距離の取得

先ほどはボタンの押され具合を「力」で取得しましたが、次は「押し込まれた長さ」で取得したいと思います。

```c
float pup_force_sensor_distance(pup_device_t *pdev);
```

関数名は`pup_force_sensor_distance`で、ボタンが押された時の「押し込まれた長さ」を取得します。
引数に「PUPデバイスポインタ」を入力すると、戻り値として「押し込まれた長さ」が`float`型(小数値)で返ってきます。
長さの単位は`mm`(ミリメートル)となります。

ではこちらも、簡単な使い方の例を示しておきます。

*Ex2-5. 押し込まれた長さを測定する*

```c:spikert_6.c
pup_device_t *forceD;

void Main(intptr_t exinf)
{
  forceD = pup_force_sensor_get_device(PBIO_PORT_ID_D);
  
  while(1){
    float distance =  pup_force_sensor_distance(forceD);

    char str[32];
    sprintf(str, "%lf", distance);
    hub_display_text_scroll(str, 100);
  }
}
```

フォースセンサとポートの結びつけを行った後、無限ループに入り、ボタンが押し込まれた長さを測定します。
こちらも測定値は小数値で取得されるので、`sprintf`関数を使用して`char`型配列に格納し、ハブディスプレイに表示しています。

ここで「力の測定」の時と同様に、データ型は`float`で小数値であるものの、実際にこの関数から返される値は`0`~`7`の整数値のようです。
よって、以下のようなプログラムでも十分使えるかと思います。

*2-6. 押し込まれた長さを測定する(整数値)*

```c:spikert_6.c
pup_device_t *forceD;

void Main(intptr_t exinf)
{
  forceD = pup_force_sensor_get_device(PBIO_PORT_ID_D);
  
  while(1){
    int distance = (int)pup_force_sensor_distance(forceD);
    hub_display_number(distance);
  }
}
```

ここでも「キャスト演算子」を利用しており、この場合、`float`型で得られる「押し込まれた長さ」の値を、`int`型に変換して、変数`force`に代入しています。

## ボタンが押されているかの取得 (閾値指定版)

ここまで「押された力の大きさ」と「押し込まれた長さ」を具体的な値で取得する方法を紹介してきましたが、ここからはEV3の「タッチセンサ」的な使い方、つまり **「押されている」** か **「押されていない」** かを取得する方方法を説明していきたいと思います。

```c
bool pup_force_sensor_pressed(pup_device_t *pdev, float force);
```

関数名は`pup_force_sensor_pressed`で、ボタンが「押されている」か「押されていない」かを取得します。
第一引数に「PUPデバイスポインタ」、第二引数に「押されたと判断する閾値」を指定します。
閾値は「押された力の大きさ」で指定し、指定した値以上となった時に、ボタンが「押された」として`true`を返します。

では、簡単な例を示します。

*Ex2-7. ボタンが押し込まれているか取得*

```c:spikert_6.c

pup_device_t *forceD;

void Main(intptr_t exinf)
{
  forceD = pup_force_sensor_get_device(PBIO_PORT_ID_D);
  
  while(1){
    int force = (int)pup_force_sensor_force(forceD);
    hub_display_number(force);

    int pressed = pup_force_sensor_pressed(forceD, 5);
    if(pressed)
      hub_light_on_color(PBIO_COLOR_GREEN);
    else
      hub_light_on_color(PBIO_COLOR_RED);
  }
}
```

先ほどの *Ex2-4.* に、今回の関数を付け足しました。
`pup_force_sensor_pressed`関数の閾値として`5`を指定しており、「押された力の大きさ」が5以上になった時に、変数`pressed`が`true`になります。
その後、`pressed`が`true`の時にはハブのボタンのLEDを<font color="LimeGreen">緑</font>に、`false`の時は<font color="Red">赤</font>にして、ボタンが「押されているか」を示します。

この関数は自分で閾値を設定することから、使う状況に応じて感度を調整出来るのが特徴です。

## ボタンが触れているかの取得

先ほどはボタンが「押されているか」の閾値を自分で設定するタイプの関数を解説しましたが、同じような関数をもう一つ紹介します。

```c
bool pup_force_sensor_touched(pup_device_t *pdev);
```

関数名は`pup_force_sensor_touched`で、ボタンが「触れている」か「触れていない」かを取得します。
引数には「PUPデバイスポインタ」を指定します。

先ほどの`pup_force_sensor_pressed`関数との違いは、引数に「閾値を指定しない」点です。
この関数は閾値による判定ではなく、ほんの少しでもボタンが押されたら`true`を返します。

先ほどのEx2-7をベースに、この関数を使ってみたいと思います。

*Ex2-8. ボタンが触れているか取得*

```c:spikert_6.c

pup_device_t *forceD;

void Main(intptr_t exinf)
{
  forceD = pup_force_sensor_get_device(PBIO_PORT_ID_D);
  
  while(1){
    int force = (int)pup_force_sensor_force(forceD);
    hub_display_number(force);

    int touched = pup_force_sensor_touched(forceD);
    if(touched)
      hub_light_on_color(PBIO_COLOR_GREEN);
    else
      hub_light_on_color(PBIO_COLOR_RED);
  }
}
```

動きは先ほどのEx2-7と全く同じで、違う点は`pup_force_sensor_pressed`関数を`pup_force_sensor_touched`関数に差し替え、変数名を`touched`に変更したところです。
実際に動かしてみると、`true`となる条件の違いが良くわかるかと思います。

以上で、フォースセンサの使い方は全て紹介いたしました。

# 3. 超音波センサの使い方

続いて、超音波センサの方から使い方を解説していきます。

## 超音波センサの設定

例のように、センサを使う前には「ポート」と「超音波センサ」の結びつけが必要です。

```c
pup_device_t *pup_ultrasonic_sensor_get_device	(pbio_port_id_t port);
```

関数名は`pup_ultrasonic_sensor_get_device	`で、「ポート」の情報により、「超音波センサ」と「PUPデバイスポインタ」を結びつけます。
引数として、「ポート」を指定すると、戻り値として「PUPデバイスポインタ」が返ってきます。

使い方の例も示しておきます。

*Ex3-1. 超音波センサのセットアップ*

```c:spikert_6.c
#include <stdlib.h>
#include <stdio.h>
#include <kernel.h>

#include <spike/hub/system.h>

#include <spikert_6.h>

#include "spike/pup/motor.h"
#include "spike/pup/colorsensor.h"
#include "spike/pup/forcesensor.h"
#include "spike/pup/ultrasonicsensor.h"

#include "spike/hub/battery.h"
#include "spike/hub/button.h"
#include "spike/hub/display.h"
#include "spike/hub/imu.h"
#include "spike/hub/light.h"
#include "spike/hub/speaker.h"

#include <pbio/color.h>

#include "kernel_cfg.h"
#include "syssvc/serial.h"

pup_device_t *ultrasonicE;

void Main(intptr_t exinf)
{
  ultrasonicE = pup_ultrasonic_sensor_get_device(PBIO_PORT_ID_E);
}
```

はじめに`ultrasonicE`という名前で「PUPデバイスポインタ」を宣言しています。
`Main`関数に入ったら、`pup_ultrasonic_sensor_get_device`関数により「ポートE」が「超音波センサ」であると結び付けて、`ultrasonicE`に格納しています。

定数`PBIO_PORT_ID_E`などを使わない場合のポートの指定方法も示しておきます。

*Ex3-2. 超音波センサのセットアップ (ポート指定方法)*

```c:spikert_6.c
pup_device_t *ultrasonicE;

void Main(intptr_t exinf)
{
  ultrasonicE = pup_ultrasonic_sensor_get_device('E');
}
```

## 距離を測定する

まずは、超音波の基本的な使い方である「対象物との距離の測定」を行う関数を紹介します。

```c
int32_t pup_ultrasonic_sensor_distance(pup_device_t *pdev);
```

関数名は`pup_ultrasonic_sensor_distance	`で、超音波センサで対象物との距離を測定します。
引数として、「PUPデバイスポインタ」を指定すると、戻り値として`int型`(整数値)で値を返します。単位はmm(ミリメートル)です。尚、対象物が存在しない場合は`-1`と返されます。

使い方の例も示しておきます。

*Ex3-3. 超音波センサで対象物との距離を測定する*

```c:spikert_6.c
pup_device_t *ultrasonicE;

void Main(intptr_t exinf)
{
  ultrasonicE = pup_ultrasonic_sensor_get_device(PBIO_PORT_ID_E);

  while(1){
    int distance = pup_ultrasonic_sensor_distance(ultrasonicE);
    hub_display_number(distance);
  }
}
```

はじめに`pup_ultrasonic_sensor_get_device`関数により「ポートE」を超音波センサと紐づけ、その後は無限ループに入ります。
無限ループ内では、`pup_ultrasonic_sensor_distance`関数により対象物との距離を測定して、その値をint型変数`distance`に格納しています。
格納された値は`hub_display_number`関数でハブディスプレイ上に表示しています。

ただし、`hub_display_number`関数は2桁までしか値を表示できない為、100mmを超えると`>`と表示され、具体的な値は分からなくなります。
その場合は、以下のようにシリアル通信を用いることで値を確認することが出来ます。
(シリアル通信の使い方はまだ解説していないので、コードの紹介までに留めておきます。)

*Ex3-4. 超音波センサで対象物との距離を測定する(シリアル通信利用)*

```c:spikert_6.c
pup_device_t *ultrasonicE;

void Main(intptr_t exinf)
{
  char msg[32] = "Program Start\n";

  serial_opn_por(SIO_USB_PORTID); // USBシリアル通信の開通
  serial_wri_dat(SIO_USB_PORTID, msg, sizeof(msg)); // "Program Start"を送信

  ultrasonicE = pup_ultrasonic_sensor_get_device(PBIO_PORT_ID_E);

  while(1){
    int distance = pup_ultrasonic_sensor_distance(ultrasonicE);
    hub_display_number(distance);

    sprintf(msg,"distance: %d\n", distance);
    serial_wri_dat(SIO_USB_PORTID, msg, sizeof(msg));
    dly_tsk(500*1000);
  }
}
```

### 超音波センサの検証

さて、返される値についてですが、ある程度計測のテストを行いました。
環境は以下の画像に示すような、一直線上にブロックを置いた状態です。

![IMG_7518.jpg](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/183170/3b7d3583-65a1-d262-74a1-5222795d27b8.jpeg)

又、ブロックについては横幅が6ポッチの「大ブロック」と、横幅4ポッチの「小ブロック」の二種類を用意しました。

![IMG_7522.jpg](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/183170/10775fac-f875-2461-d590-37de5b8e5d2f.jpeg)

(小ブロックはパーツが足りず、黄色いパーツが混じっていますが、測定には赤い面を向けるため問題ありません。)

結果は以下のようになりました。

| **実際の距離 [mm]** | **大ブロック [mm]** | **小ブロック [mm]** |
|:---------:|:---------:|:---------:|
| 10        | 40        | 40        |
| 20        | 40        | 40        |
| 30        | 40        | 40        |
| 40        | 40        | 48        |
| 50        | 51        | -1        |
| 60        | 59        | 85        |
| 70        | 72        | 82        |
| 80        | 88        | 87        |
| 90        | 97        | 96        |
| 100       | 107       | 104       |
| 110       | 117       | 114       |
| 120       | 125       | 122       |
| 130       | 139       | 131       |
| 140       | 148       | 141       |
| 150       | 154       | 151       |
| 160       | 158       | 160       |
| 170       | 165       | 169       |
| 180       | 176       | 177       |
| 190       | 186       | 186       |
| 200       | 196       | 197       |
| 250       | 240       | 246       |
| 300       | 288       | 295       |
| 350       | 339       | 346       |
| 400       | 388       | 397       |
| 450       | 440       | 450       |
| 500       | 489       | 499       |
| 550       | 542       | 549       |
| 600       | 587       | 603       |
| 650       | 647       | 655       |
| 700       | 690       | 707       |
| 750       | 747       | 761       |
| 800       | 796       | 809       |
| 850       | 849       | 883       |
| 900       | 908       | -1        |
| 950       | -1        | -1        |
| 1000      | -1        | -1        |

グラフにすると以下のようになります。

![超音波グラフ.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/183170/b3c52ca4-dfe6-419f-ab3b-64f59756b543.png)

グラフの見方として、青線が実際の距離のため、オレンジや緑の印が青線に近ければ近いほど良い、ということになります。

この結果についてですが、まず大ブロック・小ブロックとも40mm未満では測定不可能です。
ブロックの距離を変化させても、40mmと返されます。

又、40~90mmの範囲では、大ブロックはそこそこの精度が出ているものの、小ブロックはとても正確に測れているとは言えません。
従って、SPIKE Primeの超音波センサは、近距離の測定には不向きだと言えるでしょう。

一方で、100~800mmの範囲では比較的良い精度で測定が出来ています。
この範囲での実際の距離と測定された距離の差の平均は、大ブロックで3.8mm、小ブロックで-2.1mmですので、実用上も問題ない精度でしょう。

最後に900mm以上ですが、このあたりで測定が出来なくなってきます。
たまに900台や1000台の値が表示されますが、9割方は`-1`が返ってくる結果となりました。

これらの結果から、なんとも使いどころが難しいセンサですが、使い方を工夫すれば使えないことは無いのかな…と感じました。

## 超音波信号を検出する

次に紹介する方法は「超音波信号を検出する」というものです。
こちら、最初は自身が反射した超音波も含むのかなと考え、「超音波センサの測定範囲内に、対象物があるかどうか」を判定するものかと思っていましたが、それは間違いでした。

正しくは、文字通り「超音波を検出したとき」に「検出した」と返すものです。
まずは関数を紹介してしまいます。

```c
int32_t pup_ultrasonic_sensor_distance(pup_device_t *pdev);
```

関数名は`pup_ultrasonic_sensor_distance	`で、超音波センサが超音波を検出したかどうかを取得します。
引数として、「PUPデバイスポインタ」を指定すると、戻り値として「検出した」`true`か「検出しなかった」`false`の二通りが返されます。

前述の謎を解明するため、以下のようなコードを作成しました。

*Ex3-5. 超音波センサで超音波を検出*

```c:spikert_6.c
pup_device_t *ultrasonicE;

void Main(intptr_t exinf)
{
  ultrasonicE = pup_ultrasonic_sensor_get_device(PBIO_PORT_ID_E);

  while(1){
    int presence = pup_ultrasonic_sensor_presence(ultrasonicE);
    if(presence)
      hub_light_on_color(PBIO_COLOR_GREEN);
    else
      hub_light_on_color(PBIO_COLOR_RED);
  }
}
```

この関数により、超音波を検出したらボタンのLEDを<font color="LimeGreen">緑</font>に、検出しなかった時は<font color="Red">赤</font>にして、超音波が「検出されているか」を示します。

まず、以下の図のように超音波センサの前にブロックを置いた状態でプログラムを実行しました。

![IMG_7523.jpg](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/183170/3c623e05-f643-b02d-b8fa-f98d9a0aa6ed.jpeg)

このとき、ボタンのLEDは<font color="Red">赤</font>のまま、つまり「検出していない」ということになります。

次に、以下の図のように超音波センサと、別の超音波センサを向かい合わせた状態でプログラムを実行しました。
(手元にSPIKE Primeの超音波センサは1台しかないため、EV3のものを使用しました。EV3の方は電源が付いているだけです。)

![IMG_7524.jpg](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/183170/e5f3c02c-76db-8753-3880-ea37e3105eca.jpeg)

すると、見事にボタンのLEDが<font color="LimeGreen">緑</font>に光りました。

ということで、説明の言葉通り、超音波を検出したら、「検出した」と返す関数でした。
使いどころがなかなか想像つきませんが、ひとまず紹介いたしました。

## ライトの設定

カラーセンサの時にもありましたが、超音波センサにも以下の図のように4個のライトが搭載されています。

![IMG_7525.jpg](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/183170/9da58381-50ca-9cba-d39c-f4782fc6b375.jpeg)

これらのLEDの点灯・消灯・および点灯時の明るさ(パーセント)を個別に指定することが出来ます。

### ライト全消灯

まずは、4つのLEDを全て消す関数です。

```c
pbio_error_t pup_ultrasonic_sensor_light_off(pup_device_t *pdev);
```

関数名は`pup_ultrasonic_sensor_light_off`で、4つのLEDを全て消灯します。
引数には「PUPデバイスポインタ」を入力します。

この関数を実行することで、「PUPデバイスポインタ」により指定したポートの超音波センサのLEDを全消灯します。

### ライト全点灯

続いて、4つのLEDを全て点ける関数です。

```c
pbio_error_t pup_ultrasonic_sensor_light_on(pup_device_t *pdev);
```

関数名は`pup_ultrasonic_sensor_light_on`で、4つのLEDを全て点灯します。
引数には「PUPデバイスポインタ」を入力します。

この関数を実行することで、「PUPデバイスポインタ」により指定したポートの超音波センサのLEDを全点灯します。

### ライトの明るさを個別に指定

最後に、LEDを1個ずつ個別に明るさを変更する関数です。

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

関数名は`pup_ultrasonic_sensor_light_set`で、LEDを1個ずつ個別に明るさを変更します。
第一引数には「PUPデバイスポインタ」を入力します。
第二・三・四・五引数には、それぞれのLEDでの明るさを$0\sim100$の範囲で指定します。

それぞれの引き数と場所の対応は以下の図の通りです。

![IMG_7525 _2.jpg](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/183170/a7a5ebae-1f55-6df2-ee8b-2d576439d3c2.jpeg)

| 引き数番号 | 図の番号 |
|:-:|:-:|
| 2  | ➀ |
| 3  | ➁ |
| 4  | ➂ |
| 5  | ➃ |


これらの関数の使い方についても簡単に例を示しておきます。

*Ex3-6. 超音波センサのライトを設定*

```c:spikert_6.c
pup_device_t *ultrasonicE;

void Main(intptr_t exinf)
{
  ultrasonicE = pup_ultrasonic_sensor_get_device(PBIO_PORT_ID_E);

  pup_ultrasonic_sensor_light_on(ultrasonicE);
  dly_tsk(3*1000*1000);
  pup_ultrasonic_sensor_light_off(ultrasonicE);
  dly_tsk(3*1000*1000);
  pup_ultrasonic_sensor_light_set(ultrasonicE,100,0,0,0);
  dly_tsk(3*1000*1000);
  pup_ultrasonic_sensor_light_set(ultrasonicE,0,100,0,0);
  dly_tsk(3*1000*1000);
  pup_ultrasonic_sensor_light_set(ultrasonicE,0,0,100,0);
  dly_tsk(3*1000*1000);
  pup_ultrasonic_sensor_light_set(ultrasonicE,0,0,0,100);
  dly_tsk(3*1000*1000);
}
```

```
全点灯
↓
全消灯
↓
各部ごとの点灯(1→2→3→4)
```

の順番でLEDを点灯・消灯しています。

SPIKE-RTでは、デフォルトではLEDは点灯していないので、もし必要であれば上記の関数を用いて光りを出すことが出来ます。
ただライトセンサと違い、センサとしては「光」は一切関係ないので、基本的には見た目の問題になるかと思います。

# 4. まとめ

今回は「フォースセンサ」と「超音波センサ」の使い方を紹介しました。
これにて、ハブブロックと接続するモータやセンサ(PUPデバイス)の使い方は全て解説が終了しました。

これである程度ロボットとしては形になってくるかと思いますが、SPIKE Primeの最大の強みである、ある機能の紹介がまだ終わっていません。
それは、「ジャイロセンサ」を内蔵した「ハブブロック」です。
次回はその「ハブブロック」の使い方について、説明していきたいと思います。
かなり機能てんこもりの「ハブブロック」ですので、頑張っていきましょう。

前回: [#5 カラーセンサの使い方](https://qiita.com/koushiro/items/9311142f3e9b0f0cfefb)
次回: 執筆中