Copyright 2019-2022 Moddable Tech, Inc.
改訂日： 2022年3月22日
このドキュメントは、Moddable Threeに関する情報を提供します。ピンやその他のコンポーネントの詳細、アプリのビルドとデプロイ方法、その他の開発リソースへのリンクが含まれています。
Moddable Threeは、開発者が安価なハードウェアでModdable SDKを試すのを容易にするハードウェアモジュールです。Moddable のウェブサイトで購入できます。
Moddable Threeの主なコンポーネントは、ESP8266モジュールとePaperスクリーンの2つです。ESP8266モジュールにはWi-Fiアンテナと4 MBのフラッシュストレージメモリが含まれています。ePaperスクリーンは122 x 250の白黒ディスプレイです。
Moddable Threeでアプリをビルドして実行するには、以下の手順が必要です：
- Moddable SDK をインストールする
- ESP8266 ツール をインストールする
- 以下の アプリのビルドとデプロイ セクションの指示に従う
ホスト環境とESP8266ツールをセットアップした後、以下の手順でModdable Threeにアプリケーションをインストールします。
-
Moddable Threeをmicro USBケーブルでコンピュータに接続します。
データ同期が可能なケーブルを使用していることを確認してください。電源供給のみのケーブルは使用しないでください。
-
mcconfigを使ってアプリをビルドしてデプロイする。
mcconfigは、マイクロコントローラおよびシミュレータ上でModdableアプリをビルドおよび起動するためのコマンドラインツールです。mcconfigの完全なドキュメントはこちらにあります。
Moddable Three用にビルドするには、mcconfigでプラットフォーム-p esp/moddable_threeを使用します。例えば、piu/love-e-inkのサンプルをビルドするには：
cd $MODDABLE/examples/piu/love-e-ink
mcconfig -d -m -p esp/moddable_three
examples readmeには、画面の回転、Wi-Fiの設定など、他の一般的に使用されるmcconfig引数に関する追加情報が含まれています。
Moddable Threeシミュレータ用にビルドするには、mcconfigでプラットフォーム-p simulator/moddable_threeを使用します。
一般的な問題とその解決方法については、ESP8266ドキュメントのトラブルシューティングセクションを参照してください。
Moddable SDKには、その多くの機能を示す150以上のサンプルアプリがあります。これらの例のほとんどはModdable Threeで動作します。
とはいえ、CommodettoやPiuを使用する多くのサンプルは、より高速なリフレッシュレートを持つカラースクリーン用に設計されています。さらに、すべてのサンプルがModdable Threeハードウェアと互換性があるわけではありません。例えば、ESP8266にはBLE機能がないため、BLEの例はビルドも実行もできません。一部の例は、Moddable Threeディスプレイと互換性のない特定のディスプレイおよびタッチドライバをテストするために設計されており、ビルドエラーを引き起こします。
Moddable SDKのすべてのドキュメントはdocumentationディレクトリにあります。documentation、examples、およびmodulesディレクトリは共通の構造を持っており、情報を簡単に見つけることができます。いくつかのハイライトは以下の通りです：
commodettoサブディレクトリには、2DグラフィックスAPIを提供するビットマップグラフィックスライブラリであるCommodettoと、軽量なレンダリングエンジンであるPocoに関連するリソースが含まれています。piuサブディレクトリには、複雑でレスポンシブなレイアウトを簡単に作成できるようにするユーザーインターフェースフレームワークであるPiuに関連するリソースが含まれています。networkingサブディレクトリには、ネットワークソケットおよびHTTP/HTTPS、WebSockets、DNS、SNTP、telnetなどのソケット上に構築されたさまざまな標準的で安全なネットワーキングプロトコルに関連するネットワークリソースが含まれています。pinsサブディレクトリには、サポートされているハードウェアプロトコル（デジタル、アナログ、PWM、I2Cなど）に関連するリソースが含まれています。一般的な市販センサーの多くのドライバと対応する例示アプリも利用可能です。
質問がある場合は、issueを開くことをお勧めします。できるだけ早く対応しますし、他の開発者も助けを提供したり、あなたの質問への回答から利益を得ることができます。多くの質問はすでに回答されているので、新しいissueを開く前に以前のissueを検索してみてください。
私たちの活動を追跡する最良の方法は、Twitterで私たちをフォローすることです (@moddabletech)。新しい投稿に関する発表や、その他のModdableニュースを私たちのブログでお知らせしています。