ESP32でメール送信
2023.09.16
ESP32とセンサーを組み合わせると
情報を何かしらの手段で報告させたいという考えに結びつきます。
だってWiFi機能があるんですから(;'∀')
一番簡単にできるのはメール送信かと思うわけですが、
以下はその方法と苦労の備忘録となります。
まず、メール送信させるとしてもレンタルサーバーを持ってる人なら
メールアカウントを自分で作って活用すればいいですが、
無い人はGoogleのGMailを使うのが手っ取り早いでしょう。
ESP32でメール送信するためには、ESP_Mail_Client.hを使います。
このライブラリも登録に罠があって、Arduino IDEの「ライブラリを管理」で
「ESP32 Mail Client」で検索すると、
ESP32 Mail Client by Mobizt 最新ver 2.1.6
ESP Mail Client by Mobizt 最新ver 3.4.14
の２つがあり、とても紛らわしいです。
どちらでも動くと思って上のほうを入れてみたら
あらゆることでどうにもうまくいかないので
下のを使ってみたら試行錯誤はありましたが、ソースの構築に成功しました。
WiFi.h
ESP_Mail_Client.h
あとこの2つのライブラリを使用すると
高確率で「***.hに対して複数のライブラリが見つかりました。」
というエラーがでます。***の部分はWifi.hやSD.hだったりします。
ArduinoIDEにはArduino用としてすでにこの2つのライブラリが存在していて、
ESP32用のライブラリをインストールしたら同じ名前のライブラリが追加登録されてしまうものだから
重複してますよと言ってくるわけですね。
ArduinoIDEが吐き出すエラーは「使用済み」と「未使用」にわけて、
しかも保存されているパスまで教えてくれますから、
未使用のライブラリを直接削除して対応しました。これでコンパイルは通ります。
このメールライブラリはコンパイルが非常に遅いです。
Core i9でもかなり待たされます。
私が使っているノート、Core i5-3320Mだと3分くらいも待たされます。
一見ハングアップしたように見えますが、正常に動いていますので気長に待ちましょう。
コンパイルが完成すると、スケッチの空きが極端に少なくなっているので、
追加の機能を持たせるなら要注意です。
Googleのメールですが、ESP32がGmailアカウントを使ってメールを送信できるように、
アプリパスワードを作成する必要があります。
アプリパスワードは16桁のパスコードで、
安全性の低いアプリやデバイスにGoogleアカウントへのアクセス許可を与えるものです。
アプリパスワードによるサインインについては、
https://support.google.com/accounts/answer/185833
こちらをご覧ください。
アプリ パスワードは、2段階認証が有効になっているアカウントでのみ使用できます。
まずは2段階認証を有効にする手順を書きます。
１．「Googleアカウントを管理」を開きます。
２．ナビゲーション パネルで、[セキュリティ] を選択します。
３．Googleへのログイン」で、「2段階認証」＞「開始」を選択します。
４．画面に表示される手順に従います。携帯の電話番号が必要になります。
５．２段階認証を有効にすると、アプリのパスワードを作成できる権利を得ます。
アプリパスワードは以下の手順で取得します。
１．「Googleアカウントを管理」を開きます。
２．ナビゲーションパネルで「セキュリティ」を選択します。
３．「Googleにログインする方法」の「2 段階認証プロセス」を開きます。
４．一番したまでスクロールさせて、「アプリパスワード」を選択します。
５．ここのアプリから「メール」、デバイスを選択で「その他」を選び「ESP32」を登録
６．「生成」を選択。これでアプリパスワードが取得できます。
メールサーバーのログインにはこのアプリパスワードを使うことになります。
メール送信に成功したソースコードを貼っておきます。
画像だけでなく、一応ダウンロードできるようにファイルも置いておきます。
testmail.ino
情報を何かしらの手段で報告させたいという考えに結びつきます。
だってWiFi機能があるんですから(;'∀')
一番簡単にできるのはメール送信かと思うわけですが、
以下はその方法と苦労の備忘録となります。
まず、メール送信させるとしてもレンタルサーバーを持ってる人なら
メールアカウントを自分で作って活用すればいいですが、
無い人はGoogleのGMailを使うのが手っ取り早いでしょう。
ESP32でメール送信するためには、ESP_Mail_Client.hを使います。
このライブラリも登録に罠があって、Arduino IDEの「ライブラリを管理」で
「ESP32 Mail Client」で検索すると、
ESP32 Mail Client by Mobizt 最新ver 2.1.6
ESP Mail Client by Mobizt 最新ver 3.4.14
の２つがあり、とても紛らわしいです。
どちらでも動くと思って上のほうを入れてみたら
あらゆることでどうにもうまくいかないので
下のを使ってみたら試行錯誤はありましたが、ソースの構築に成功しました。
WiFi.h
ESP_Mail_Client.h
あとこの2つのライブラリを使用すると
高確率で「***.hに対して複数のライブラリが見つかりました。」
というエラーがでます。***の部分はWifi.hやSD.hだったりします。
ArduinoIDEにはArduino用としてすでにこの2つのライブラリが存在していて、
ESP32用のライブラリをインストールしたら同じ名前のライブラリが追加登録されてしまうものだから
重複してますよと言ってくるわけですね。
ArduinoIDEが吐き出すエラーは「使用済み」と「未使用」にわけて、
しかも保存されているパスまで教えてくれますから、
未使用のライブラリを直接削除して対応しました。これでコンパイルは通ります。
このメールライブラリはコンパイルが非常に遅いです。
Core i9でもかなり待たされます。
私が使っているノート、Core i5-3320Mだと3分くらいも待たされます。
一見ハングアップしたように見えますが、正常に動いていますので気長に待ちましょう。
コンパイルが完成すると、スケッチの空きが極端に少なくなっているので、
追加の機能を持たせるなら要注意です。
Googleのメールですが、ESP32がGmailアカウントを使ってメールを送信できるように、
アプリパスワードを作成する必要があります。
アプリパスワードは16桁のパスコードで、
安全性の低いアプリやデバイスにGoogleアカウントへのアクセス許可を与えるものです。
アプリパスワードによるサインインについては、
https://support.google.com/accounts/answer/185833
こちらをご覧ください。
アプリ パスワードは、2段階認証が有効になっているアカウントでのみ使用できます。
まずは2段階認証を有効にする手順を書きます。
１．「Googleアカウントを管理」を開きます。
２．ナビゲーション パネルで、[セキュリティ] を選択します。
３．Googleへのログイン」で、「2段階認証」＞「開始」を選択します。
４．画面に表示される手順に従います。携帯の電話番号が必要になります。
５．２段階認証を有効にすると、アプリのパスワードを作成できる権利を得ます。
アプリパスワードは以下の手順で取得します。
１．「Googleアカウントを管理」を開きます。
２．ナビゲーションパネルで「セキュリティ」を選択します。
３．「Googleにログインする方法」の「2 段階認証プロセス」を開きます。
４．一番したまでスクロールさせて、「アプリパスワード」を選択します。
５．ここのアプリから「メール」、デバイスを選択で「その他」を選び「ESP32」を登録
６．「生成」を選択。これでアプリパスワードが取得できます。
メールサーバーのログインにはこのアプリパスワードを使うことになります。
メール送信に成功したソースコードを貼っておきます。
画像だけでなく、一応ダウンロードできるようにファイルも置いておきます。
testmail.ino
2023.09.16 23:18
| 
SSD1306 OLEDディスプレイを使ってみる
2023.09.16
ESP32を使うようになって、SSD1306のOLEDモジュールを使う機会がありました。
ピン数が多いと扱いにくいのでI2Cモデルを買ってみたのですが、
意外と躓くところがあったので、備忘録的に残しておきます。
まずSSD1306はこれは0.96インチのモノクロモジュールです。
買うとケースに入って送られてきた・・
送料込み270円程度なのになかなかやるじゃん(;´Д｀)
カラーモジュールはSSD1331らしく型番が違う。
カラーの影響なのか4本I2Cでの接続はできないらしい。
あと1.3インチのモノクロモジュールはSSH1106となっていて全部型番がちがう。
これに気が付かないで買ってしまうといろいろと後悔するかもしれない。
今回は白文字で表示できればよかったので、0.96インチのSSD1306で
この事実に気が付かずもトラブル回避できていた。
今回勝ったSSD1306は4pinのI2C接続なので、
VCC(5V or 3.3V)
GND
SCL
SDA
の4か所を接続するだけでOK! とても簡単。
ただし、ESP32側のプログラムではちょっとてこずった。
ネットで検索するとAdafruit社のライブラリを使ったソースコードが多々見つかる。
ChatGPTに聞いてもAdafruitを使ったコードを出してくる。
きっと書籍とかでもよく紹介している方法なんだと思うが、
私の環境ではライブラリの導入でトラブルが続出した。
Arduino IDEのライブラリマネージャーから
Adafruit SSD1306というライブラリをインストールするだけのはずが、
どうもコンパイルするとエラーが出る。何かが足りないといったメッセージだ。
結局ネットで検索し、Adafruitのサイトからダウンロードして組み込んだら動くようになった。
今この問題を解決できたとしても、ソースファイルをほかのPCに移したりPCを買い替えたりしたとき
また同じ問題に直面するとすれば時間的ロスが半端ないので、
今回はSSD1306.hを利用する方式を採用した。
このssd1306.hもArduino IDEのライブラリマネージャーから「ESP32 SSD1306」で検索し、
「ESP8266 and ESP32 OLED driver for SSD1306 displays」
をインストールするだけ。バージョンはとりあえず最新を選んだ。
ESP32のSDAは21ピン、SCLは22ピンと決まっているので
#define OLED_SDA 21 //I2C接続のSDAを21番に接続
#define OLED_SCL 22 //I2C接続のSCLを22番に接続
SSD1306 display(0x3c, OLED_SDA, OLED_SCL); //SSD1306インスタンスの作成（I2Cアドレス,SDA,SCL）
と定義してあげれば管理しやすい。
0x3cはI2Cのポートを意味する。売られている物のほとんどは0x3cになっているようだ。
実際私が購入したのは0x3Cで動いた。
ところがモジュールの背面を見ればわかるのだが、
ポートは背面をみて判断するのがお決まりらしい。
稀に0x78や0x7Aと書かれているものは抵抗がどちらに張り付いているかでわかる。
私のOLEDも裏には0x78と示している。（8がBのようにもみえるがおそらくはプリントミスだと思われる）
これはどういうことなのだろうか？
調べたところによると、I2Cのアドレスは7ビットで使われており、
8ビット目は使用されない。つまり0x78と指定しても0x3Cとして使われ、
0x7Aと指定しても0x3Dとして使われるという話。
だから最初から0x3Cと指定しているということらしい。
ここら辺も知っておかないとハマる原因になりかねない。
ちなみに1.3インチの裏面も同じようになっています。
さて上の3行が定義できれば後はもう自由に表示させることが可能。
命令の種類はネットで調べたところ
display.setPixel(x,y)で点を打つ
display.drawRect(x1,y1,x2,y2)で四角形を描く
display.fillRect(x1,y1,x2,y2)で四角形を描き中を塗る
display.drawHorizontalLine(x,y,ドット幅)でラインを引く
display.drawCircle(x,y,半径)で四角形を描く
display.fillCircle(x,y,半径)で四角形を描き中を塗る
display.setTextAlignment(TEXT_ALIGN_LEFT) 文字表示座標の起点を指示。他にTEXT_ALIGN_CENTER、TEXT_ALIGN_RIGHTがある
display.drawString(x,y,"半角文字") //文字の表示
display.setFont //フォントと文字サイズを指定
display.drawVerticalLine
display.drawProgressBar(X, Y, 幅, 高さ, 少数第2位の実数);
display.setColor(WHITE) //色を指定WHITE or BLACK
display.clear() 画面の初期化
display.display() //指定された描画命令を反映
これらが見つかった。もしかしたらもっとあるかもしれない。
これだけあれば特に困ることはないが、
Adafruitのライブラリのように改行があれば便利だったかなと思う。
フォントのサイズは3種類。実行すればそれ以降のdisplay.drawStringが対象となる。
display.setFont(ArialMT_Plain_10); //約17文字×6行 Yに対して10の倍数
display.setFont(ArialMT_Plain_16); //約10.5文字×3行 Yに対して16の倍数
display.setFont(ArialMT_Plain_24); //約7文字×2.5行 Yに対して24の倍数
フォントの種類は1種類しか見つけ出せてない。
このフォントはプロポーショナルフォントで、横幅が狭いアルファベットは詰められるので
表示できる文字数は書く文字によって変化することに注意。Iなんて文字は横幅が無いので一気に詰められる。
漢字を試しに打ち込んでみたら何も表示されず暗黒のままだった(;'∀')
display.setColorカラー指定ができるが、1306のモジュールは白と黒だけ選択できる。
他のモジュールなら細かく設定できるのかもしれない。
どの描画命令もdisplay.display()を実行しないと反映されない。
LOOP内で頻繁にdisplay.display() を繰り返すとOLEDがチカチカするので
LOOP内の最後らへんに1つだけ置いておくといいかもしれない。
画像を黒に消し去りたいときはdisplay.clear()を使う。
以下は使ってみた感想。
0.96インチは思っていた以上に小さい。
フォントサイズ10で文字を表示したら老眼の人にはかなり厳しいだろうと思う。
1.3インチを使ったほうが段違いに見やすい。コストダウンを考えて選択したのが裏目に出た(;'∀')
余分な部分が少ないので取り回しは楽。
LCDモジュールをよく使っていたけど、OLEDは画像が鮮明で見やすい。
LCDのように角度によっては見えにくいなんてことはないと思う。
基板に固定穴がついているのがいい。液晶は基板ではなくフタにつけることが多いので非常に助かる。
今のところはっきりわかるほどの熱はでてない。
これが1か月も1年もロングランさせるのであればどうなのかは今後の検証次第というとこ。
ESP32-WROVER-IEを買う。
2023.08.09
ArduinoでWiFi接続しデータをサーバーに転送、
メールで情報を送信したいという話がでてきました。
でも私は扱ったことが無いので、いろいろ躓きまくりです(;´Д｀)
一番悩ませられたのが、技適の問題。
Arduinoで一般的に使われているモジュールはESP8266や
MKR WiFi 1010を使ったものが多いですが、
これらは技術基準適合証明、いわゆる技適が取得されてないので
国内で使用することはできません。
いきなり躓いたわけですが、ちょっと調べていくうちに、
Arduinoではなく、ESP32シリーズならWiFiを搭載しており、
技適も取れているということを知りました。
Arduinoではないけど、使い方やプログラム、ライブラリ等、
ほぼ一緒なので問題ないでしょう。
で、選んだESP32はコレ
ESP32-WROVER-IE 8MB FLASH【ESP32-DEVKITC-VIE】
互換製品がたくさんありますが、なぜ正規品を選んだかというと
互換品はWiFiがまともに動くものは少ない（特に感度問題）、
書き込みエラーが起きることがある。
USB変換チップにCP2102ではなくCH340を使っているものがある。
なにかしら正規の方法とは違う手段でないと機能しない部分がある。
などで
値段も数百円しか違わないなら
正規品を買っといたほうが安心。
あと技適を本当にとっているか互換品は怪しいというのもあります。
ESP32-WROVER-IEは令和3年4月28日に取得しています（211-200403）
あとWROOMではなく、WROVERを選んだのはメモリの問題。
WROVERには32mbit spi psramが追加装備されているのです。
これだけならなんのこっちゃという感じですが、
仕様で搭載メモリのところに8MB FLASHと書かれていても実際に使えるのは4MB程度らしいので、
重いデータを扱うとなるとパワー不足。それを補うための拡張メモリとして
psramが8MB（実際は4MB？）付いていると考えればまぁ大きく外れてはいないでしょう。
将来カメラを接続して画像を送信なんてことを始めるならメモリは多いに越したことはないですからね(;'∀')
ではIEを選んだ理由はなにか？
それは電波状況が悪い場合、外付けアンテナを接続できるので保険として重要だと思ったから。
基板のアンテナ部分だけだとどうも頼りないですからね。
さて次に考えるはセキュリティのこと。
WiFi接続に必要なSSIDや暗号キー、
メール送信に必要なアドレスとSMTPのサーバーアドレスとパスワード、
これらをソースに入れ込むのは安全なのだろうかと・・
さらに設置場所を変えるたびに、ソースを書き換えコンパイルするのかと・・
それはちょっと勘弁してほしいところ。
なので、WPS接続で何とかできないかと思案する・・(;'∀')
どうやらライブラリはあるっぽい。
なんか救われた気がする。
ESP32からのメール送信はどうしようか。
接続するWiFi先でいちいちプロバイダメールを確認するわけにもいかないので、
フリーで取得できるなかから最も信頼できるものを選ぶしかないか・・・
Microsoft、Google、Yahooあたりか。
どれもすぐ仕様変更したり、突然本人確認ができるまで停止とかやりかねないので
信頼は薄いんだけど、やむを得ないか。
メールのパスワードをソースに入れ込むのはやむを得ない(;´Д｀)
そして、どうせならってことで1分ごとに情報をレンタルWebサーバーに送って
スマホかPCで情報のログも閲覧できればなんて要望もでたり・・
そうなると、サーバー側でもある程度処理するプログラムを
用意しておかないといけないな・・ウホ
ちなみにESP32のデータシートはこちら
https://www.espressif.com/sites/default/files/documentation/esp32-wrover-e_esp32-wrover-ie_datasheet_en.pdf
Amazonでは売ってませんね。今のところマルツで買うのが良さそうです。
ジョイスティック KY-023の制御
2022.10.24
前回はロータリーエンコーダを調査しましたが、
今回はジョイスティックです。
良く使われるパーツはKY-023とよばれるもの。
2次元の座標を読み取れるだけでなく、
スティックを押し込むとスイッチとしての機能もあります。
とても安いので扱いやすいパーツです。
接続するにあたって、デュポンコネクタのケーブルを作成しました。
5V、GND、VRx、VRy、SW
の5本。
VRxとVRyは倒している量を計測したいのでアナログピンに接続。
SWはスイッチなのでデジタルピンに接続します。
ただし、SWのデジタルピンはインプットプルアップにします。
テストプログラムはこんな感じ。
世に出回っている一般的なソースを少し改造したものです。
このジョイスティックという部品は、
X方向とY方向の可変抵抗の値を読み取って傾斜量と向きを判別しています。
X軸、Y軸それぞれで0～1023までの値を読み取ることができ、
ニュートラル状態ではその中央値である512を返します。
512より小さければ左か上方向、大きければ右か下方向を示すわけですね。
ところが、そうはうまくいかないのが世の常で、
個体差が必ずありニュートラル位置でキレイに512を返すことは稀です。
道具として組み込むならその誤差を修正する機能が必要になるので、
その部分だけ付け足しています。
実行してみました。
成功のようです。
シリアルモニタで状況を見ていると、
±1は頻繁にブレることがわかります。
逆にスティックを少々傾けても値は大きく変化しないことがわかりました。
検知に遊びがあるんですね、触った感じゆっくり倒しても100刻みくらい？
丁寧に倒せば50刻みくらいできる？ そんな感じです。
プレステとかSwitchのコントローラーはどれくらいの感度なんでしょうかねぇ・・
ロータリーエンコーダ（ホイールエンコーダ）の使い方。
2022.10.14
マウスに良く使われているロータリーエンコーダ（ホイールエンコーダ）。
これの使い方を調べてみたいと思います。
↑ロータリーエンコーダというとこれが一番有名ですが、
捻るタイプのエンコーダなので今考えている用途には使えません、
今回はもっと小型でマウスのホイールと同じものを使います。
最近のマウスは、このようなパーツでホイールを検知しているようですね。
一昔前は回転する網が何回光を遮ったかを検知する構造で
センサーが露出しているタイプだったのに、
今はこれらの機能が内包し小型化がすすんでいるという。
進化が早いです(;´Д｀)
さて、このロータリーエンコーダーは3ピンです。
1本が電源線、2本が信号線。
先人の知恵を借りるためにネットで使用例を検索してみると、
電源線をGNDにつなげている人が多く見えます。
しかもそのようなソースに限って、
pinMode(1, INPUT);
となっています。
中学レベルの電気しか学んでいない私は「え？インプット？入力？なのにGND？」
とちょっと疑問に思ってしまうのですが、
GNDのマイナス電圧を利用するん？とか考えてしまいますよね？
これが
pinMode(1, INPUT_PULLUP);
だったなら理解はできますが・・・。
しばし悩んだら、
pinMode(1, INPUT);
digitalWrite(1, HIGH);
と2行がセットになっていることに気が付きました。
INPUTなのに、HIGHを出してる。
このパターンでも、INPUT_PULLUPと同様に内部抵抗（最小20KΩ～最大50KΩ）
がオンになるという話。
Arduinoではあまり推奨していない方法だけど、
こういった使い方もできるんだねと。
話はそれましたが、電源線はGNDに繋いで問題ないようです。
そうそう、Arduinoはモデルによって割り込みが使えるピンが違います。
私が良く使うモデルだけ載せておきます。
UNOとMEGAとMicroとLeonardoの4つがわかればok
今回のテストで使うUNOは2ピンと３ピンね。
動作の検証なので、とりあえずシンプルに接続。
2本の信号を組み合わせて回転の方向と量を検知する仕組み。
ソースはとりあえずこんなところかな。
ロータリーエンコーダーの回転量（位置）を導き出す関数だけど、
今回はどの程度の速さで処理できるのか見たかったので、
シリアルモニターに表示させてみました。
1ノッチ動かすだけでも数回割り込みしているのがわかる。
結構デリケートなのね。
カチッって言うノッチの振動で判定がぶれるのかな。
これは割り込み処理内で位置情報だけ確保しておいて、
LOOP内で適切なタイミングで移動量を計算させて使用したほうが安定しそうだ。
これの使い方を調べてみたいと思います。
↑ロータリーエンコーダというとこれが一番有名ですが、
捻るタイプのエンコーダなので今考えている用途には使えません、
今回はもっと小型でマウスのホイールと同じものを使います。
最近のマウスは、このようなパーツでホイールを検知しているようですね。
一昔前は回転する網が何回光を遮ったかを検知する構造で
センサーが露出しているタイプだったのに、
今はこれらの機能が内包し小型化がすすんでいるという。
進化が早いです(;´Д｀)
さて、このロータリーエンコーダーは3ピンです。
1本が電源線、2本が信号線。
先人の知恵を借りるためにネットで使用例を検索してみると、
電源線をGNDにつなげている人が多く見えます。
しかもそのようなソースに限って、
pinMode(1, INPUT);
となっています。
中学レベルの電気しか学んでいない私は「え？インプット？入力？なのにGND？」
とちょっと疑問に思ってしまうのですが、
GNDのマイナス電圧を利用するん？とか考えてしまいますよね？
これが
pinMode(1, INPUT_PULLUP);
だったなら理解はできますが・・・。
しばし悩んだら、
pinMode(1, INPUT);
digitalWrite(1, HIGH);
と2行がセットになっていることに気が付きました。
INPUTなのに、HIGHを出してる。
このパターンでも、INPUT_PULLUPと同様に内部抵抗（最小20KΩ～最大50KΩ）
がオンになるという話。
Arduinoではあまり推奨していない方法だけど、
こういった使い方もできるんだねと。
話はそれましたが、電源線はGNDに繋いで問題ないようです。
そうそう、Arduinoはモデルによって割り込みが使えるピンが違います。
私が良く使うモデルだけ載せておきます。
UNOとMEGAとMicroとLeonardoの4つがわかればok
今回のテストで使うUNOは2ピンと３ピンね。
動作の検証なので、とりあえずシンプルに接続。
2本の信号を組み合わせて回転の方向と量を検知する仕組み。
ソースはとりあえずこんなところかな。
ロータリーエンコーダーの回転量（位置）を導き出す関数だけど、
今回はどの程度の速さで処理できるのか見たかったので、
シリアルモニターに表示させてみました。
1ノッチ動かすだけでも数回割り込みしているのがわかる。
結構デリケートなのね。
カチッって言うノッチの振動で判定がぶれるのかな。
これは割り込み処理内で位置情報だけ確保しておいて、
LOOP内で適切なタイミングで移動量を計算させて使用したほうが安定しそうだ。
