サンプルの動かし方

サンプルは、リーフの構成と開発ツールを合わせ、ビルド → 書き込み → 実行結果の順に確認すると、途中で止まった原因を探しやすくなります。サンプル一覧で目的やCPUを選び、各記事の準備物を確認してください。

1. 手元の構成と合わせる

• CPUの型番を確認します。同じ温湿度センサの例でも、AVR・STM32・ESP32ではボードの選択や書き込み方法が異なります。
• 使用するリーフと追加部品を揃えます。必要キット名だけでなく、各記事の型番・電源・アンテナ・SIMなども確認します。組み立てや着脱は電源を切ってから行います。
• 開発ツールを選びます。Arduino IDEのスケッチ、PlatformIOのプロジェクト、STM32CubeIDEのプロジェクトは、それぞれ対応する手順で開きます。開発環境設定から使用するCPUの説明へ進んでください。

2. ソースとライブラリを揃える

記事のソースリンクから、サンプルに必要なファイル一式を取得します。複数ファイルのサンプルは、主な.inoやmain.cppだけでなく、同じフォルダのヘッダや設定ファイルも必要です。

開発ツール	開くもの・確認するもの
Arduino IDE	スケッチのフォルダと.ino。記事指定のライブラリとボードパッケージを導入する
PlatformIO	platformio.iniを含むプロジェクトフォルダ。board・lib_deps・書き込み先を確認する
STM32CubeIDE	.project・.cprojectを含むプロジェクトフォルダ。Core・Driversなども一緒に取得する

GitHubのmainやmasterへのリンクは、配布内容が更新されます。新旧のファイルを混ぜず、同じ版の一式を使ってください。以前動いたプロジェクトを更新する場合は、元のフォルダを残してから変更すると比較できます。

ライブラリは機能名が似ていても別の実装の場合があります。記事が指定する配布元を使い、CPUやArduino Coreとの対応条件も確認してください。たとえばSTM32ではRTC・低消費電力ライブラリとCoreの対応があります。

3. 三つの段階で確認する

段階	成功の確認	止まった場合
ビルド	コンパイルがエラーなく完了する	最初のエラーを確認し、ボード・CPU・必要ライブラリを見直す
書き込み	開発ツールが書き込みの成功を表示する	USBケーブル・ポート・電源・プログラムスイッチを確認する
実行	記事のLED点滅、シリアル表示、受信データなどが得られる	実行への切り替えとリセット、配線、通信先の設定を確認する

ビルドや書き込みの成功と、サンプルの動作成功は別の確認です。 通信サンプルでは、送信ログに加えて受信側の表示や保存先のデータまで確かめます。センサの値は周囲の環境で変わるため、画面例と同じ数値になることではなく、取得できること・変化が反映されることを確認します。

4. うまく動かない場合

まず各記事の「うまく動かないとき」とよくある質問を確認します。問い合わせる際は、使用リーフ、開発ツール、実行したサンプルのURL、どの段階まで進んだか、最初のエラーを添えると状況を伝えやすくなります。パスワード・トークン・SIMの識別情報は送らないでください。

一覧の準備中は未公開、過去版・参考は現在の手順と条件が異なる可能性がある記事です。外部サービスの終了などが書かれている場合は、その案内を確認してから利用してください。