Moddable One Developer Guide
Copyright 2019-2022 Moddable Tech, Inc.
Revised: March 22, 2022
This document provides information about Moddable One, including details about its pins and other components, how to build and deploy apps, and links to other development resources.
Table of Contents
About Moddable One
![](/documentation/assets/devices/moddable-one.png)
Moddable One is a hardware module that makes it easy for developers to experiment with the Moddable SDK on inexpensive hardware. It is available to purchase on the Moddable website.
Components
The two main components of Moddable One are the ESP8266 module and capacitive touch screen. The ESP8266 module includes a Wi-Fi antenna and 4 MB of flash storage memory. The touch screen is a 240 x 320 QVGA IPS display driven by a MIPI Display Serial Interface compatible display controller with an FT6206 capacitive touch controller.
Pinout
![](/documentation/assets/devices/moddable-one-pinout.png)
Touch panel
The touch panel uses pins 4 and 5 to connect to the I2C bus. You cannot use these pins as GPIO if your app uses the touch panel.
You can use other I2C sensors even if your app uses the touch panel as long as they don't use the same address. The touch panel uses address 0x38 (7-bit address).
Display
The display uses pins 13 and 14 to connect to the SPI bus. You cannot use these pins as GPIO if your app uses the display.
You can use other SPI sensors even if your app uses the display.
SDK and Host Environment Setup
To build and run apps on Moddable One, you'll need to:
- Install the Moddable SDK
- Install ESP8266 tools
- Follow the instructions in the Building and Deploying Apps section below.
Building and Deploying Apps
After you've set up your host environment and ESP8266 tools, take the following steps to install an application on your Moddable One.
-
Attach the programmer to your Moddable One.
Make sure you have the programmer oriented correctly. The orientation should match the image below.
Note: The USB port on Moddable One may be used to provide power when operating without the programmer. The USB port is only for powering Moddable One. It cannot be used to program Moddable One.
-
Attach the programmer to your computer with a micro USB cable.
The USB cable must be attached to the programmer, not the power-only USB port on the board. Make sure you're using a data sync–capable cable, not one that is power-only.
-
Build and deploy the app with mcconfig
.
mcconfig
is the command line tool to build and launch Moddable apps on microcontrollers and the simulator. Full documentation of mcconfig
is available here.
Use the platform -p esp/moddable_one
with mcconfig
to build for Moddable One. For example, to build the piu/balls
example:
cd $MODDABLE/examples/piu/balls
mcconfig -d -m -p esp/moddable_one
The examples readme contains additional information about other commonly used mcconfig
arguments for screen rotation, Wi-Fi configuration, and more.
Use the platform -p simulator/moddable_one
with mcconfig
to build for the Moddable One simulator.
Troubleshooting
See the Troubleshooting section of the ESP8266 documentation for a list of common issues and how to resolve them.
Development Resources
Examples
The Moddable SDK has over 150 example apps that demonstrate how to use its many features. The vast majority of these examples run on Moddable One.
That said, not every example is compatible with Moddable One hardware. For example, the ESP8266 does not have BLE capabilities so BLE examples do not build or run. Some examples are designed to test specific display and touch drivers that are not compatible with the Moddable One display and give a build error.
Documentation
All the documentation for the Moddable SDK is in the documentation directory. The documentation, examples, and modules directories share a common structure to make it straightforward to locate information. Some of the highlights include:
- The
commodetto
subdirectory, which contains resources related to Commodetto--a bitmap graphics library that provides a 2D graphics API--and Poco, a lightweight rendering engine.
- The
piu
subdirectory, which contains resources related to Piu, a user interface framework that makes it easier to create complex, responsive layouts.
- The
networking
subdirectory, which contains networking resources related to network sockets and a variety of standard, secure networking protocols built on sockets including HTTP/HTTPS, WebSockets, DNS, SNTP, and telnet
- The
pins
subdirectory, which contains resources related to supported hardware protocols (digital, analog, PWM, I2C, etc.). A number of drivers for common off-the-shelf sensors and corresponding example apps are also available.
Support
If you have questions, we recommend you open an issue. We'll respond as quickly as practical, and other developers can offer help and benefit from the answers to your questions. Many questions have already been answered, so please try searching previous issues before opening a new issue.
Updates
The best way to keep up with what we're doing is to follow us on Twitter (@moddabletech). We post announcements about new posts on our blog there, along with other Moddable news.