Skip to content

Latest commit

 

History

History
125 lines (78 loc) · 8.38 KB

File metadata and controls

125 lines (78 loc) · 8.38 KB

Moddable One 開発者ガイド

Copyright 2019-2022 Moddable Tech, Inc.
改訂日: 2022年3月22日

このドキュメントは、Moddable Oneに関する情報を提供します。ピンやその他のコンポーネントの詳細、アプリのビルドとデプロイ方法、その他の開発リソースへのリンクが含まれています。

目次

Moddable Oneについて

Moddable Oneは、開発者が安価なハードウェアでModdable SDKを試すのを容易にするハードウェアモジュールです。Moddableのウェブサイトで購入できます。

コンポーネント

Moddable Oneの主なコンポーネントは、ESP8266モジュールと静電容量式タッチスクリーンの2つです。ESP8266モジュールにはWi-Fiアンテナと4 MBのフラッシュストレージメモリが含まれています。タッチスクリーンは、FT6206静電容量式タッチコントローラを備えたMIPIディスプレイシリアルインターフェース互換のディスプレイコントローラによって駆動される240 x 320 QVGA IPSディスプレイです。

ピン配置

タッチパネル

タッチパネルはピン4と5を使用してI2Cバスに接続します。アプリがタッチパネルを使用する場合、これらのピンをGPIOとして使用することはできません。

アプリがタッチパネルを使用していても、同じアドレスを使用しない限り、他のI2Cセンサーを使用することができます。タッチパネルはアドレス0x38(7ビットアドレス)を使用します。

ディスプレイ

ディスプレイはピン13と14を使用してSPIバスに接続します。アプリがディスプレイを使用する場合、これらのピンをGPIOとして使用することはできません。

アプリがディスプレイを使用していても、他のSPIセンサーを使用することができます。

SDKとホスト環境のセットアップ

Moddable Oneでアプリをビルドして実行するには、以下の手順が必要です。

  1. Moddable SDKをインストールする
  2. ESP8266ツールをインストールする
  3. 以下のアプリのビルドとデプロイセクションの指示に従う

アプリのビルドとデプロイ

ホスト環境とESP8266ツールをセットアップした後、以下の手順でModdable Oneにアプリケーションをインストールします。

  1. プログラマーをModdable Oneに接続する。

    プログラマーの向きが正しいことを確認してください。向きは以下の画像と一致する必要があります。

    注意: Moddable OneのUSBポートは、プログラマーなしで動作する場合に電源を供給するために使用できます。USBポートはModdable Oneのプログラムには使用できません。電源供給のみです。

  2. プログラマーをマイクロUSBケーブルでコンピューターに接続する。

    USBケーブルはプログラマーに接続する必要があります。ボード上の電源専用USBポートには接続しないでください。データ同期が可能なケーブルを使用していることを確認してください。電源専用のケーブルではありません。

  3. mcconfigを使用してアプリをビルドおよびデプロイする。

mcconfigは、マイクロコントローラおよびシミュレータ上でModdableアプリをビルドおよび起動するためのコマンドラインツールです。mcconfigの完全なドキュメントはこちらにあります。

Moddable One用にビルドするには、mcconfigでプラットフォーム -p esp/moddable_one を使用します。例えば、piu/ballsの例をビルドするには:

cd $MODDABLE/examples/piu/balls
mcconfig -d -m -p esp/moddable_one

サンプルのreadmeには、画面の回転、Wi-Fi設定など、他の一般的に使用されるmcconfig引数に関する追加情報が含まれています。

Moddable Oneシミュレータ用にビルドするには、mcconfigでプラットフォーム -p simulator/moddable_one を使用します。

トラブルシューティング

一般的な問題とその解決方法については、ESP8266ドキュメントのトラブルシューティングセクションを参照してください。

開発リソース

サンプル

Moddable SDKには、その多くの機能を使用する方法を示す150以上のサンプルアプリがあります。これらの例の大部分はModdable Oneで実行されます。

とはいえ、すべてのサンプルがModdable Oneハードウェアと互換性があるわけではありません。たとえば、ESP8266にはBLE機能がないため、BLEの例はビルドも実行もできません。一部のサンプルは、Moddable Oneディスプレイと互換性のない特定のディスプレイおよびタッチドライバをテストするために設計されており、ビルドエラーが発生します。

ドキュメント

Moddable SDKのすべてのドキュメントはdocumentationディレクトリにあります。documentationexamples、およびmodulesディレクトリは、情報を簡単に見つけられるように共通の構造を共有しています。いくつかのハイライトを以下に示します:

  • commodettoサブディレクトリには、2DグラフィックスAPIを提供するビットマップグラフィックスライブラリであるCommodettoと、軽量レンダリングエンジンであるPocoに関連するリソースが含まれています。
  • piuサブディレクトリには、複雑で応答性の高いレイアウトを簡単に作成できるユーザーインターフェースフレームワークであるPiuに関連するリソースが含まれています。
  • networkingサブディレクトリには、ネットワークソケットおよびHTTP/HTTPS、WebSockets、DNS、SNTP、telnetなどのソケット上に構築されたさまざまな標準の安全なネットワーキングプロトコルに関連するネットワークリソースが含まれています。
  • pinsサブディレクトリには、サポートされているハードウェアプロトコル(デジタル、アナログ、PWM、I2Cなど)に関連するリソースが含まれています。一般的な市販センサー用の多くのドライバと対応する例示アプリも利用可能です。

サポート

質問がある場合は、issueを開くことをお勧めします。できるだけ早く対応しますし、他の開発者も助けを提供したり、あなたの質問への回答から利益を得ることができます。多くの質問はすでに回答されているので、新しいissueを開く前に以前のissueを検索してみてください。

更新情報

私たちの活動を追跡する最良の方法は、Twitter (@moddabletech) でフォローすることです。新しい投稿に関するお知らせや、その他のModdableニュースを私たちのブログで投稿しています。