TLS)¶

2.0 で追加。CRuby と同じ書き方 — Net::HTTP、WebSocket、その下の TLS — でアプリからインターネットにつながります。

両機種で使えます。Modern は ESP32-C6 経由、Retro は ESP32-S3 自身の無線を使います。 Linux のシミュレータでも、ホストのネットワークと OpenSSL を使って動きます。

使う前に¶

実機の /etc/wifi.toml に接続先を書いておく必要があります。書き方は WiFi につなぐを参照してください。

Retro は無線を 1 つずつしか使えません

ESP32-S3 の無線は 1 系統なので、WiFi と BLE は同時に使えません。BLE の web コンソールが動いていると WiFi は起動しません。Config で ble_auto_start を off にして再起動してください。Modern は ESP32-C6 が両方を受け持つので、この制約はありません。

つながっているか調べる¶

if FmrbApp.wifi_connected?
  info = FmrbApp.wifi_info
  # => { connected: true, ip: "192.168.10.16", ssid: "my-ap", hostname: "fmruby" }
  Log.info("address: #{info[:ip]}")
end

メソッド	戻り値
`FmrbApp.wifi_connected?`	`true` / `false`。メモリを確保しないので、繰り返し呼んでも安全です
`FmrbApp.wifi_info`	`:connected` / `:ip` / `:ssid` / `:hostname` を持つ Hash。WiFi の無い機種では `nil`

WiFi はデスクトップより後に立ち上がるので、ネットワークを使うアプリは「つながっている前提」ではなく待つように書きます。

def on_create
  @ready = false
end

def on_update
  unless @ready
    return unless FmrbApp.wifi_connected?
    @ready = true
    fetch_data
  end
end

HTTP¶

require 'net/http'
require 'json'

# 単発の GET
body = Net::HTTP.get(URI.parse("http://example.com/api/status"))

# 応答オブジェクトで受ける
res = Net::HTTP.get_response(URI.parse("https://example.com/data.json"))
if res.code == "200"
  data = ::JSON.parse(res.body)
end

# フォームの POST
res = Net::HTTP.post_form(URI.parse("https://example.com/post"), { "key" => "value" })

# 接続を使い回す
http = Net::HTTP.new("example.com", 443)
http.use_ssl = true
http.start do |h|
  res = h.get("/index.html")
  res = h.post("/api", '{"a":1}', { "Content-Type" => "application/json" })
end

HTTPS はそのまま使えます。同梱の CA で証明書を検証するので、https:// の URL を渡すだけで追加の設定は要りません。

JSON ではなく ::JSON と書いてください

クラスの中で JSON と書くと YourClass::JSON として探されて失敗します。頭に :: をつけてください。

止まらずに取ってくる (`FmrbNet.request`)¶

2.1 からの機能です。Net::HTTP はサーバの返事を待ちます。実機の上でしか動かさない道具ならそれでかまいませんが、ブラウザでも動かすアプリはこちらを使います。要求は一度出すだけで、状態は on_update から見ます。

def on_create
  @req = FmrbNet.request("https://example.org/thing.json")
end

def on_update
  if @req && @req.done?
    @req.ok? ? use(@req.body) : Log.warn(@req.error)
    @req = nil
  end
  50
end


`FmrbNet.request(url)`	取得を 1 つ始めて、要求オブジェクトを返す
`done?`	返事が届いたか。`on_update` から見ます。ここで回して待たないこと
`ok?`	届いていて、状態コードも問題ないなら true
`status` / `body` / `error`	HTTP の状態コード、本文、失敗した理由

コールバックにしていないのは意図的です。今しまって後で呼ぶブロックは、外側のローカル変数を捕まえると Spinel で壊れる形だからです。

環境によって違うのは待つ場所であって、アプリの書き方ではありません。実機では request の中で取得が終わるので、そのアプリのタスクだけがそこで待ち、done? はすぐ true になります (タスクは横取りされるので、システムの他の部分は動き続けます)。ブラウザでは誰も待ちません。ページが取ってくる間も画面は描き続けます。ブラウザで「待つアプリ」が書けないのはこのためです。

ブラウザではページの制約がそのまま効きます

取得はブラウザが行うので、別のサイトからの取得を許していないサーバは Studio からは読めません。Net::HTTP や WebSocket (ソケットの側) はそもそもありません。アプリの店がこの書き方で、だから実機でもブラウザでも動きます。

WebSocket¶

require 'net/websocket'

Net::WebSocket::Client.connect("wss://echo.example.com/ws") do |ws|
  ws.send_text("hello")
  msg = ws.receive(timeout: 5)
  ws.close
end

receive は待ち続けるのではなく定期的に確認する作りなので、待ち時間の間ずっと VM が止まることはありません。

CRuby との違い¶

書き方は CRuby に似せてありますが、動くのはマイコンです。実際に効いてくる制約は次のとおりです。


TLS の版	TLS 1.2 のみ。TLS 1.3 には対応していません
待ち時間	呼び出しは同期です。通信中はそのアプリのイベント処理が止まり、窓は再描画されず入力は溜まります。要求は短く、時間切れを設定してください
応答の大きさ	本文はまるごとアプリのメモリ領域 (割り当てにより 512KB か 1MB) に載ります。大きなものを落とすと足りなくなります
HTTP の機能	分割転送・リダイレクト追跡・接続の使い回しは、picoruby の `net/http` が実装している範囲までです。CRuby と同じではありません
証明書	独自の CA やクライアント証明書は、ファイルの場所ではなく PEM の文字列で渡します

通信中はそのアプリが止まるので、起動時か一定間隔で 1 回取得して結果を保持し、描画はその控えから行う、という形が基本になります。

実例¶

同梱の Weather (/app/demo/weather.app.rb) は Open-Meteo から HTTPS で天気を取得し、 JSON を解析して描画します。ネットワークを待ち、最初に成功するまで再試行する作りなので、写して始めるのに向いています。

Net Test (/app/test/net_test.app.rb) は API を一つずつ試すもので、うまく動かないときの切り分けに使えます。/app/test の他のものと同じくランチャーには出ないので、エディタかシェルから起動してください。