ESP32 を MicroPython (軽量版 Python) で制御し、なおかつそのプログラムを Wi-Fi 経由で更新できる。
IoT づくりで、自由度の高いプログラミングをする際の個人的最適解だと思っている。

自由度が低くて簡単なら HomeAssistant + ESPHome？

設定方法

開発環境 Thonny の「実行」→「インタプリタの設定」→「Install or update MicroPython」で、使っている ESP32 を指定し、MicroPython をインストール。

シェルが開くので、

import webrepl_setup

を実行し、ウィザードに従って Repl をインストール。

ESP32 の boot に以下のようなコードを書き込む。
固定 IP にしておくと多分大抵の環境で便利。

# This file is executed on every boot (including wake-boot from deepsleep)
#import esp
#esp.osdebug(None)
import webrepl
import network
import time
import machine

# Wi-Fi設定
SSID = '**'
PASSWORD = '**'
IP_ADDRESS = '**'
SUBNET_MASK = '**'
GATEWAY = '**'
DNS_SERVER = '**'

# Wi-Fiに接続
sta_if = network.WLAN(network.STA_IF)
if not sta_if.isconnected():
    print('Connecting to network', end='')
    sta_if.active(True)
    sta_if.ifconfig((IP_ADDRESS, SUBNET_MASK, GATEWAY, DNS_SERVER))
    sta_if.connect(SSID, PASSWORD)
    
    # 接続待ち
    while not sta_if.isconnected():
        print('.', end='')
        time.sleep(1)
        
print('Network config:', sta_if.ifconfig())

# WebREPLを開始
webrepl.start()

ESP32 側に忘れず保存しておく。

接続方法

Thonny の「実行」→「インタプリタの設定」→「ポートまたは WebRepl」で、さっき設定した IP とパスワードを入れる。

注意点

main.py としてプログラムを ESP32 に書き込むと、boot.py 終了後に実行される。
Repl 接続中は Thonny から実行することになる。

torchrun --standalone --nnodes=1 --nproc_per_node=2 train_ms_jp_extra.py -c Data/<model_name>/config.json -m Data/<model_name>

Pythonのインストール後、Python3 -m ensurepip を実行してpipのインストールを試みたが、
Bus error:10 と表示され、プログラムが終了する。

エラー原因の調査

エラーがどこで起きたのかがわからないと原因の究明に至れないので、faulthandler を使ってエラー発生箇所を特定する。faulthandleはtracebackを明示的にダンプしてくれる関数である。

python3 -X faulthandler -m ensurepip --upgrade

これを実行すると、エラー内容が次のように表示された

Current thread 0x0000000104c1f880 (most recent call first):
  File "/usr/local/lib/python3.7/ctypes/__init__.py", line 273 in _reset_cache
  File "/usr/local/lib/python3.7/ctypes/__init__.py", line 543 in <module>

...省略

  File "/usr/local/lib/python3.7/ensurepip/__init__.py", line 27 in _run_pip
  File "/usr/local/lib/python3.7/ensurepip/__init__.py", line 117 in _bootstrap
  File "/usr/local/lib/python3.7/ensurepip/__init__.py", line 204 in _main
  File "/usr/local/lib/python3.7/ensurepip/__main__.py", line 5 in <module>
  File "/usr/local/lib/python3.7/runpy.py", line 85 in _run_code
  File "/usr/local/lib/python3.7/runpy.py", line 193 in _run_module_as_main
Bus error: 10

どうやらctypesをimport した時にエラーを吐くっぽい。実際に対話モードでimport ctypes と明示的にctypes を入れてやると、Bus error と表示されて異常終了した。

うーん

エラーの再現には成功した。しかし同様の事例があまりネットに転がっておらず、似たような事例の解決案を試してみてもbus error は消えない。。。bus error の原因がctypes だけとも限らないし、Python のバージョンを変更したら解決できるのだろうか。
明日(土曜)に色々試したい、って明日は休日出勤だった。。。(~_~);

DockerfileにRUN pip install --no-cache-dir -r requirements.txt と記述し、buildした際、txtファイル内に記述したnumpy などのパッケージがNo matching distribution found for というエラーを吐いて失敗する。しかしながら、pip install を記述せずに先にビルドしてコンテナ起動後に、コンテナ内でpip install すると成功してしまう。

ビルド時に追加のオプションを指定

このエラーはDNS失敗に起因するものである。docker build --network=host -t <コンテナ名> のように--network=host という引数を追加することで、DNS問題を回避できる。

docker-compose.yml の場合

docker-compose.ymlにnetwork_modeをhostに指定する。ホストと同じ DNS / proxy を使えるのでDNS失敗を回避できる。

version: "3.9"

services:
  app:
    build:
      context: .
      network: host         # ←★ここ
    network_mode: host      # ←★ここ

onnxruntime-inference-examples/mobile/examples/object_detection/ios at main · microsoft/onnxruntime-inference-examples

Examples for using ONNX Runtime for machine learning inferencing. - microsoft/onnxruntime-inference-examples

github.com

rubyのバージョンが古い

onnx runtime を使うためのツールとしてcocoapodsをインストールしようとすると、rubyのバージョンが古いと怒られた。mac にはruby がデフォルトで入っているものの、そのバージョンが古いため、アップデートする必要がある。

tensorflowがインストールできない。pythonのパッケージが合わない

仮想環境を作成する際、誤ってPython3.13 で作成していた。tensorflowはpython3.13向けに公開されていない（2025/04/09現在）。python3.11で環境を作り直すと正常に動作した。パッケージのインストールでトラブルがあった際はpythonのバージョンを確認してみるのが大事だ。

xcodeでチームを設定するとFailed to register bundle identifier と表示される。

bundle identifier が同じだと上記のエラーを吐く。bundle identifierが同じにならないように末尾に適当な数字（日付など）の追記などの対策をする必要がある。

すべての手順を実施してもビルドに失敗する

onnxruntime.h not found というエラーが出た。ccoapodで正しくライブラリが構築できていないことが疑われたので、ライブラリの再構築をしてみた。pod deintegrate でプロジェクトからライブラリ を切り離して、もう一度pod install で構築したが、それでも治らない。

しかし、xcode を再起動するとなぜかビルドに成功した。

コードブロックでコピーができるようにEnlighterを導入したのだが、見えちゃいけないはずのHTMLコードが表示され、うまくレンダリングされなかった。
↓見た目だけ再現

<span class="hljs-function"><span class="hljs-keyword">function</span> <span class="hljs-title">custom_category_card_widget</span><span class="hljs-params">()</span> </span>{
    $args = <span class="hljs-keyword">array</span>(
        <span class="hljs-string">'post_type'</span>      => <span class="hljs-string">'post'</span>,
        <span class="hljs-string">'posts_per_page'</span> => <span class="hljs-number">10</span>,
        <span class="hljs-string">'category_name'</span>  => <span class="hljs-string">'seikabutsu'</span>,
    );
    $query = <span class="hljs-keyword">new</span> WP_Query($args);
    <span class="hljs-comment">// ラッパー div を追加</span>
    $html = <span class="hljs-string">'<div class="custom-widget"><div class="custom-post-cards">'</span>;
    <span class="hljs-keyword">if</span> ($query->have_posts()) {
        <span class="hljs-keyword">while</span> ($query->have_posts()) {
            $query->the_post();
            $link    = get_permalink();
            $title   = get_the_title();
            $date    = get_the_date(<span class="hljs-string">'Y.n.j'</span>);
            $excerpt = get_the_excerpt();
            $excerpt = str_replace(<span class="hljs-string">'[...]'</span>, <span class="hljs-string">' ...'</span>, $excerpt);
            $thumb   = has_post_thumbnail()

原因

cocoon設定の方の「ソースコードをハイライト表示する」がONになっていると、ソースコードのレンダリングで競合するらしい。

ついでに

フォントをVScodeで見慣れた consoles + MS ゴシック にした。

/* 2025.3.27 Enlighter フォント*/
.enlighter-code {
    font-family: Consolas, "MS Gothic", "Courier New", monospace;
	font-size: 1.3em
}

↓作ったトップページ

成果物ウィジェット

「成果物」カテゴリがついた記事を、新しい順に10件表示する。
外観 > テーマファイルエディタ > functions.phpに記載

function custom_category_card_widget() {
    $args = array(
        'post_type'      => 'post',
        'posts_per_page' => 10,
        'category_name'  => 'seikabutsu',
    );
    $query = new WP_Query($args);
    // ラッパー div を追加
    $html = '<div class="custom-widget"><div class="custom-post-cards">';
    if ($query->have_posts()) {
        while ($query->have_posts()) {
            $query->the_post();
            $link    = get_permalink();
            $title   = get_the_title();
            $date    = get_the_date('Y.n.j');
            $excerpt = get_the_excerpt();
            $excerpt = str_replace('[...]', ' ...', $excerpt);
            $thumb   = has_post_thumbnail()
                ? get_the_post_thumbnail(get_the_ID(), 'medium')
                : '<img src="https://via.placeholder.com/180x180?text=No+Image" alt="No Image">';
            // カテゴリをバッジ風に出力
            $categories = get_the_category();
            $cat_labels = '';
            if (!empty($categories)) {
                foreach ($categories as $category) {
                    $cat_labels .= '<span class="card-category">' . esc_html($category->name) . '</span>';
                }
            }
            $html .= '<a class="custom-post-card" href="' . esc_url($link) . '">';
            $html .= '  <div class="card-thumb">' . $thumb . '</div>';
            $html .= '  <div class="card-meta">';
            $html .= '    <div class="card-header">';
            $html .= '      <div class="card-title">' . esc_html($title) . '</div>';
            $html .= '      <div class="card-date">';
            $html .= '        <span class="date-text">' . esc_html($date) . '</span>' . $cat_labels;
            $html .= '      </div>';
            $html .= '    </div>';
            $html .= '    <div class="card-excerpt">' . esc_html($excerpt) . '</div>';
            $html .= '  </div>';
            $html .= '</a>';
        }
    } else {
        $html .= '<p>該当する記事がありません</p>';
    }
    $html .= '</div></div>'; // custom-post-cards と custom-widget の終了タグ
    wp_reset_postdata();
    return $html;
}
add_shortcode('seikabutsu_widget', 'custom_category_card_widget');

すべての新着記事ウィジェット

function custom_category_card_widget() {
    $args = array(
        'post_type'      => 'post',
        'posts_per_page' => 10,
        'category_name'  => 'seikabutsu',
    );
    $query = new WP_Query($args);
    // ラッパー div を追加
    $html = '<div class="custom-widget"><div class="custom-post-cards">';
    if ($query->have_posts()) {
        while ($query->have_posts()) {
            $query->the_post();
            $link    = get_permalink();
            $title   = get_the_title();
            $date    = get_the_date('Y.n.j');
            $excerpt = get_the_excerpt();
            $excerpt = str_replace('[...]', ' ...', $excerpt);
            $thumb   = has_post_thumbnail()
                ? get_the_post_thumbnail(get_the_ID(), 'medium')
                : '<img src="https://via.placeholder.com/180x180?text=No+Image" alt="No Image">';
            // カテゴリをバッジ風に出力
            $categories = get_the_category();
            $cat_labels = '';
            if (!empty($categories)) {
                foreach ($categories as $category) {
                    $cat_labels .= '<span class="card-category">' . esc_html($category->name) . '</span>';
                }
            }
            $html .= '<a class="custom-post-card" href="' . esc_url($link) . '">';
            $html .= '  <div class="card-thumb">' . $thumb . '</div>';
            $html .= '  <div class="card-meta">';
            $html .= '    <div class="card-header">';
            $html .= '      <div class="card-title">' . esc_html($title) . '</div>';
            $html .= '      <div class="card-date">';
            $html .= '        <span class="date-text">' . esc_html($date) . '</span>' . $cat_labels;
            $html .= '      </div>';
            $html .= '    </div>';
            $html .= '    <div class="card-excerpt">' . esc_html($excerpt) . '</div>';
            $html .= '  </div>';
            $html .= '</a>';
        }
    } else {
        $html .= '<p>該当する記事がありません</p>';
    }
    $html .= '</div></div>'; // custom-post-cards と custom-widget の終了タグ
    wp_reset_postdata();
    return $html;
}
add_shortcode('seikabutsu_widget', 'custom_category_card_widget');

CSS

/* ■ ウィジェット全体のラッパ */
.custom-widget .custom-post-cards {
  display: flex;
  flex-direction: column;
  gap: 0px; /* 成果物ウィジェット：カード間のスペースを小さく */
}
/* 新着記事ウィジェット専用：カード間の余白を完全になくす */
.custom-widget .custom-post-cards.new-posts {
  gap: 0 !important;
}
/* ■ 個別カードのベース（共通） */
.custom-widget .custom-post-card {
  display: flex;
  border: 1px solid #ddd;
  border-radius: 8px;
  background-color: #fff;
  text-decoration: none;
  color: inherit;
  overflow: hidden;
  padding: 12px;
}
/* 成果物ウィジェット専用（画像あり）の場合：外枠を削除し、左側の余白をなくす */
.custom-widget .custom-post-cards:not(.new-posts) .custom-post-card {
  border: none !important;
  padding-left: 0;
}
/* 成果物ウィジェット専用：画像とテキスト情報の間に余白を追加 */
.custom-widget .custom-post-card:not(.new-posts) .card-meta {
  margin-left: 20px;
}
/* ※ スマホ版ではこの余白を少し縮める */
@media (max-width: 768px) {
  .custom-widget .custom-post-card:not(.new-posts) .card-meta {
    margin-left: 10px;
  }
}
/* ■ サムネイル領域（成果物ウィジェット用） */
.custom-widget .card-thumb {
  width: 180px;
  height: 180px;
  flex-shrink: 0;
}
.custom-widget .card-thumb img {
  width: 100%;
  height: 100%;
  object-fit: cover;
}
/* ■ テキスト情報領域 */
.custom-widget .card-meta {
  flex: 1;
  display: flex;
  flex-direction: column;
}
/* ■ ヘッダー：タイトルと日付＋カテゴリを縦に配置 */
.custom-widget .card-header {
  display: flex;
  flex-direction: column;
  margin-bottom: 8px;
}
/* タイトル（1行目） */
.custom-widget .card-title {
  font-size: 18px;
  font-weight: bold;
  margin: 0;
}
/* 日付＋カテゴリ（2行目）、右揃え */
.custom-widget .card-date {
  display: flex;
  justify-content: flex-end;
  align-items: center;
  margin-top: 4px;
}
.custom-widget .date-text {
  font-size: 14px;
  color: #999;
  margin-right: 12px;
}
/* ■ カテゴリバッジ */
.custom-widget .card-category {
  display: inline-block;
  font-size: 11px;
  color: #999;
  border: 1px solid #ddd;
  border-radius: 2px;
  padding: 0 10px;
  margin-left: 8px;
  background-color: transparent;
}
/* ■ 抜粋（成果物ウィジェット用）：文字サイズを少し小さくし、通常配置に */
.custom-widget .card-excerpt {
  font-size: 13px;
  color: #555;
  /* margin-top: auto; を削除して、通常の流れで配置 */
}
/* ■ スマホ版 */
@media (max-width: 768px) {
  .custom-widget .card-title {
    font-size: 16px;
  }
  .custom-widget .date-text {
    font-size: 13px;
  }
  .custom-widget .card-category {
    font-size: 10px;
    padding: 0 8px;
  }
  /* スマホではサムネイル画像を小さめに */
  .custom-widget .card-thumb {
    width: 100px;
    height: 100px;
  }
  /* スマホでは抜粋部分を非表示 */
  .custom-widget .card-excerpt {
    display: none;
  }
}
/* ■ 新着記事ウィジェット専用の調整 */
/* 個別カード（新着記事）の枠を削除し、カード内の余白も小さく */
.custom-widget .custom-post-card.new-posts {
  border: none;
  padding: 0px;
}

1. https://aistudio.google.com/app/apikey からAPIキーを取得する
2. 以下のテストコードを動かしてみる

API_KEY = ＜さっき取得したAPIキー＞
model = genai.GenerativeModel(
    model_name="gemini-1.5-flash", 
    system_instruction=＜システム指示＞
)
self.chat = model.start_chat(history=[])
response = self.chat.send_message(＜メッセージ＞)
print(response.txt)

トークンについて

• 日本語は大体 1文字/token っぽい（実測）
• アルファベットは 4文字/token らしい（ドキュメントより）
• システム指示とhistoryは、メッセージのたびに送信され、ちゃんとトークンが消費される
• 32,768token以上のトークンは、コンテキストキャッシュを利用するとトークンを節約出来るらしい
• 関数を用意して渡しておけば、必要に応じてGeminiAPIが利用してくれるらしい

参考文献

• https://ai.google.dev/gemini-api/docs?hl=ja