この記事はHRBrain Advent Calendar 2023 9日目の記事です。
はじめに
初めまして。11月からHRBrainで業務委託として関わっている yakiniku0220です。
12月になり、いよいよ年末感が少しずつ出てきましたね。
年末といえば大掃除ですが、一気にやるのは億劫なので私は週末に細かくやっています。
そこで久々にあるものを発見しました。
そうですAWS IoT Enterprise Buttonです。
HRBrainでは各々がtimesのチャンネルを作っており、そこで作業の開始と終了を投稿しているのですが、毎回打ち込むのは面倒くさいのでアドベントカレンダーのネタとして面白いと思ったのと、実用的にも使えそうだなと思ったので今回記事として作りました。
AWS IoT Enterprise Buttonとは
AWS IoT Enterprise Button ボタンは、Amazon Dash Button ハードウェアをベースにしたプログラミング可能なボタン。Wi-Fi デバイスは設定が簡単で、特定のデバイス向けのコードを記述することなく、AWS IoT Core、AWS Lambda、Amazon DynamoDB、Amazon SNSなどに連携できるボタンです。
今回はこのAmazon Iot Enterprise Buttonを使って勤怠ボタンを作ります。
全体の構成
構成はかなりシンプルです。
処理の流れとしては以下のようになってます。
- AWS IoT Enterprise Buttonをクリック
- Lambdaに紐づいたAWS IoT Enterprise Buttonのトリガーが発火。
- Slackに通知。
- シングルクリックした場合
-
仕事始めます
とSlackに通知。
-
- ダブルクリックした場合
-
仕事終了します
とSlackに通知。
-
- シングルクリックした場合
Lambdaの設定
関数を作成します。
右上にある 関数の作成
をクリックします。
関数を作成します。
今回は一から作成を選択します。
関数名は任意で、ランタイムは Node.js
の最新版を選択しました。
アーキテクチャは最初から設定されている x86_64
を選択。
最後に右下にある関数の作成をクリックします。
AWS IoT 1-Clickの設定
プロジェクトの作成
まずはプロジェクトを作成します。
AWS IoT 1-ClickのTopにある プロジェクト作成
をクリックします。
プロジェクト情報の指定をします。
今回は Attendance_to_slack
というプロジェクト名にします。
説明部分は省いても問題ありません。
プロジェクトのプレイスメントのテンプレート作成。
今回はLambdaを使ってSlackに通知するので、アクションは Lambda 関数の選択
を指定して、リージョンは 東京
、 Lambda関数は
Lambda側に作った関数を指定します。
これでAWS IoT 1-Clickのプロジェクトの作成は完了です。
AWS IoT Enterprise Buttonの登録
AWS IoT Enterprise Buttonを使用するにはAWS IoT 1-Clickでデバイスを登録させる必要があるので登録します。
ブラウザでもできますがアプリで登録するのが楽なので、今回はアプリで登録していきます。
AWS IoT 1-ClickアプリをダウンロードしたらAWSアカウントでログインします。
![IMG_A20BB05EA9E9-1.jpeg](https://qiita-user-contents.imgix.net/https%3A%2F%2Fqiita-image-store.s3.ap-northeast-1.amazonaws.com%2F0%2F271450%2Fa887aa3e-fb72-cedd-c3c3-da06e61214ed.jpeg?ixlib=rb-4.0.0&auto=format&gif-q=60&q=75&s=865b279293769d1b6f067b202c845994)
デバイスを登録します。(リージョンはLambdaなどで設定しているリージョンに変えてください。)
登録パターンは2つあります。
-
デバイスIDで登録
- カメラを起動してAWS IoT Enterprise Buttonの裏面にあるQRコードを読み取る。
-
登録コードで登録
- AWS IoT Enterprise Buttonの登録コードを入力する。
デバイスを登録します。
今回はデバイスをスキャンで登録するのでデバイスIDで登録
を選択してスキャン
のボタンをクリックします。
![IMG_0361.PNG](https://qiita-user-contents.imgix.net/https%3A%2F%2Fqiita-image-store.s3.ap-northeast-1.amazonaws.com%2F0%2F271450%2Fc545de59-d801-22c0-ae5b-2ea1c9f614ca.png?ixlib=rb-4.0.0&auto=format&gif-q=60&q=75&s=2496d43fc0ffc4e541972f35a3516411)
デバイスが読み込まれると1個のデバイスが追加されました
と表示されるので、スキャンの停止
をクリックします。
追加されると以下の画面のようにデバイス情報が表示されるので、登録
のボタンをクリックします。
![IMG_9458CE2C991D-1.jpeg](https://qiita-user-contents.imgix.net/https%3A%2F%2Fqiita-image-store.s3.ap-northeast-1.amazonaws.com%2F0%2F271450%2F39e31b19-f4c3-a2db-18cf-97360e2796f2.jpeg?ixlib=rb-4.0.0&auto=format&gif-q=60&q=75&s=dc71ad260f1cdf5147033809fdf91c30)
するとWi-Fiの設定をする画面が表示されるので登録をします。
今回は登録の流れは省きます。
![IMG_0363.PNG](https://qiita-user-contents.imgix.net/https%3A%2F%2Fqiita-image-store.s3.ap-northeast-1.amazonaws.com%2F0%2F271450%2F8dc6e484-8a7b-0246-147d-ef821d6d6276.png?ixlib=rb-4.0.0&auto=format&gif-q=60&q=75&s=e35106a359dce9195395f0f913294fc9)
登録が完了すると設定部分が成功と表示されるようになるので、次へ
をクリックします。
![IMG_860833C0E8A0-1.jpeg](https://qiita-user-contents.imgix.net/https%3A%2F%2Fqiita-image-store.s3.ap-northeast-1.amazonaws.com%2F0%2F271450%2F7c7f670b-e411-0027-10fb-3a93ec794e14.jpeg?ixlib=rb-4.0.0&auto=format&gif-q=60&q=75&s=a0e7f4a83a5d6bd9a3b705247df8c778)
最後にAWS IoT Enterprise Buttonをクリックすると登録が完了します。
![IMG_0367.PNG](https://qiita-user-contents.imgix.net/https%3A%2F%2Fqiita-image-store.s3.ap-northeast-1.amazonaws.com%2F0%2F271450%2F297816b1-7025-b734-71f7-b6680037fd20.png?ixlib=rb-4.0.0&auto=format&gif-q=60&q=75&s=3505fb8fa04d502d4c3baac7d46b1849)
登録が成功するとAWS IoT 1-Clickのデバイス一覧に登録したデバイスが表示されます。
![スクリーンショット 2023-12-05 5.50.15.png](https://qiita-user-contents.imgix.net/https%3A%2F%2Fqiita-image-store.s3.ap-northeast-1.amazonaws.com%2F0%2F271450%2Fc1c85b30-832f-0772-2658-209bfdd5a542.png?ixlib=rb-4.0.0&auto=format&gif-q=60&q=75&s=b670e6dd646ddeee88e56794813c1831)
この段階だとまだデバイスが無効になっているので有効にする必要があります。
右側の・・・
をクリックしてデバイスを有効化します。
![スクリーンショット 2023-12-04 1.59.31.png](https://qiita-user-contents.imgix.net/https%3A%2F%2Fqiita-image-store.s3.ap-northeast-1.amazonaws.com%2F0%2F271450%2F396967a1-4886-4f2c-ebce-c8f057276579.png?ixlib=rb-4.0.0&auto=format&gif-q=60&q=75&s=d895b414321f39cdaaad26c2adbad98f)
プレイスメントの作成
AWS IoT 1-Clickで作ったプロジェクトに登録したデバイスを紐づける必要があるため、プレイスメントを作成します。
プロジェクト一覧に移動して、作成したプロジェクト名をクリックします。
![スクリーンショット 2023-12-05 6.03.36.png](https://qiita-user-contents.imgix.net/https%3A%2F%2Fqiita-image-store.s3.ap-northeast-1.amazonaws.com%2F0%2F271450%2F61945cc2-7c9f-a4a0-5bbb-38afc6af1b25.png?ixlib=rb-4.0.0&auto=format&gif-q=60&q=75&s=83a6c948c8f12f28b05bdefcef1474b8)
プロジェクト詳細画面に遷移したらプレイスメント
をクリックして、右上にあるプレイスメントの作成
をクリックします。
![スクリーンショット 2023-12-05 5.55.34.png](https://qiita-user-contents.imgix.net/https%3A%2F%2Fqiita-image-store.s3.ap-northeast-1.amazonaws.com%2F0%2F271450%2F57152179-3449-3737-0eb6-86844cbab5f0.png?ixlib=rb-4.0.0&auto=format&gif-q=60&q=75&s=8abe3bd5e02c55fe581d2ddf1902b6cd)
プレイスメントを作成します。
プレイスメント名は今回はAttendance
とします。
デバイスの選択で
先ほど登録したデバイスが表示されるので選択して右下のプレイスメントの作成
ボタンをクリックして作成が完了します。
![スクリーンショット 2023-12-05 6.07.29.png](https://qiita-user-contents.imgix.net/https%3A%2F%2Fqiita-image-store.s3.ap-northeast-1.amazonaws.com%2F0%2F271450%2F1be744ae-bed8-8728-5497-1c0b5458b0a9.png?ixlib=rb-4.0.0&auto=format&gif-q=60&q=75&s=8a525c9e87210166b42288218cf726dc)
Slackに送信するコード作成
今回はNode.jsで書きました。
export const handler = async (event) => {
// AWS IoT Enterprise Buttonのクリックイベントを取得。
const clickType = event.deviceEvent.buttonClicked.clickType;
let text;
if (clickType === 'SINGLE') {
text = "仕事始めます。";
} else if (clickType === 'DOUBLE') {
text = "仕事終了します。";
} else {
text = '??';
}
const data = {
body: JSON.stringify({ text })
};
const headers = {
'Content-Type': 'application/json; charset=utf-8',
};
try {
const response = await fetch(process.env.WEBHOOK_URL, { method: 'POST', headers, body: data.body });
console.log(`Message posted to ${text}`);
return response;
} catch (error) {
console.error("Error:", error.message);
return { statusCode: 500, body: 'Internal Server Error' };
}
};
処理内容はとてもシンプルで、AWS IoT Enterprise Buttonでクリックされたイベントを取得してきて、クリックとダブルクリックでSlackに送信するテキストを変えています。
process.env.WEBHOOK_URL
は送りたいSlackのチャンネルのWebhook URLを環境変数にセットします。
トリガーの追加
AWS IoT 1-Clickで登録した端末をトリガーにLambdaの処理を走るようにしたいのでトリガーを追加します。
トリガーを追加
のボタンをクリックします。
![スクリーンショット 2023-12-04 0.16.44.png](https://qiita-user-contents.imgix.net/https%3A%2F%2Fqiita-image-store.s3.ap-northeast-1.amazonaws.com%2F0%2F271450%2Fca6982fe-c90f-2bf9-d52d-3bf3365e27f2.png?ixlib=rb-4.0.0&auto=format&gif-q=60&q=75&s=419abdb3c56da0e833746ee690971f31)
ソースの選択ではAWS Iot
を選択します。
![スクリーンショット 2023-12-05 6.11.53.png](https://qiita-user-contents.imgix.net/https%3A%2F%2Fqiita-image-store.s3.ap-northeast-1.amazonaws.com%2F0%2F271450%2Fef2991ab-a55d-86ef-c67d-26ed05530ef5.png?ixlib=rb-4.0.0&auto=format&gif-q=60&q=75&s=c13f7d5875f86daa5a8a601e7b432d7e)
IoT Button
を選択してDevice Serial Number
には登録したAWS IoT Enterprise Buttonの番号を入力して追加
を押すとトリガーの設定が完了します。
![スクリーンショット 2023-12-05 6.15.44.png](https://qiita-user-contents.imgix.net/https%3A%2F%2Fqiita-image-store.s3.ap-northeast-1.amazonaws.com%2F0%2F271450%2F6df25ae3-9c41-8782-8c15-b92759f44455.png?ixlib=rb-4.0.0&auto=format&gif-q=60&q=75&s=a42d67f04ee405c038c576c7403e1597)
実演
ちゃんと動作してることが確認できました。
まとめ
昔試しに買ったAWS IoT Enterprise Buttonがこういうところで役に立つとは思わなかったです。
今回はシンプルなテキストにしましたが、タップした時間帯などを送ったりも出来たりするので色々とカスタマイズすれば実用的なものになると思いました。
最後に
株式会社HRBrainでは新しいメンバーを募集中です。
興味がある方は下記のリンクから宜しくお願い致します。