update docs for zephyr

Author: phoddie

documentation/Moddable SDK - Getting Started.md

@@ -463,3 +463,4 @@ The table below links to some of the documents in the `devices` folder to help y
 | QCA4020 | [Using the Moddable SDK with QCA4020](./devices/qca4020/README.md)
 | Raspberry Pi Pico | [Using the Moddable SDK with Pico](./devices/pico.md) |
 | Nordic nRF52 | [Using the Moddable SDK with nRF52](./devices/nrf52.md) |
+| Zephyr | [Using the Moddable SDK with Zephyr](./devices/zephyr.md) |

documentation/devices/zephyr.md

@@ -1,7 +1,7 @@
 # Using the Moddable SDK with Zephyr
 
-Copyright 2025 Moddable Tech, Inc.<BR>
-Updated: October 2, 2025
+Copyright 2026 Moddable Tech, Inc.<BR>
+Updated: January 12, 2026
 
 This document is a guide to building apps with the Zephyr SDK.
 
@@ -162,6 +162,14 @@ The Moddable SDK build uses Zephyr SDK v4.2.0-rc1 (commit `ffb28eed`).
 <a id="mac-troubleshooting"></a>
 ### Troubleshooting
 
+#### Serial / USB Port
+Different silicon families have conenct in different ways. For many ST board, for example, the Moddable SDK build can automatically detect the correct port. For ESP boards, you specify the serial port by setting the `UPLOAD_PORT` environment variable:
+
+```sh
+UPLOAD_PORT=/dev/tty.usbserial-1410 mcconfig -d -m -p zephyr/esp32_ethernet_kit
+```
+
+Other silicon families may have different requirements.
 
 <a id="win"></a>
 ## Windows
@@ -324,22 +332,22 @@ mcconfig -d -m -p zephyr/nucleo_f413zh -t debug
 <a id="new-board"></a>
 ## Adding a new board
 
-Zephyr supports hundreds of development boards.
+Zephyr supports hundreds of development boards. The Moddable SDK includes support for some of them.
 
 To add new board to Moddable:
 
 1. Select a similar board from `$MODDABLE/build/devices/zephyr/targets` and duplicate its directory.
 
 	```sh
 	cd $MODDABLE/build/devices/zephyr/targets
-	cp -r nucleo_f413zh newboard
+	cp -r nucleo_f413zh new_board
 	```
 
-2. Edit the `manifest.json` file and change the `ZEPHYR_BOARD` specifier to match the Zephyr board name (same as "newboard" above).).
+2. Edit the `manifest.json` file and change the `ZEPHYR_BOARD` specifier to match the Zephyr board name (same as "new_board" above). The `ZEPHYR_BOARD` must match the name used in the Zephyr SDK for your board.
 
 3. Use the new target:
 
 	```sh
 	cd $MODDABLE/examples/helloworld
-	mcconfig -d -m -p zephyr/newboard
+	mcconfig -d -m -p zephyr/new_board
 	```

documentation/readme.md

@@ -1,6 +1,6 @@
 # Moddable SDK – Documentation Overview
-Copyright 2019-2023 Moddable Tech, Inc.<BR>
-Revised: April 6, 2023
+Copyright 2019-2026 Moddable Tech, Inc.<BR>
+Revised: January 12, 2026
 
 This directory contains documentation for the Moddable SDK.
 
@@ -16,6 +16,7 @@ Guides for working with specific microcontrollers supported by the Moddable SDK
 - [QCA4020](./devices/qca4020/README.md) by Qualcomm
 - [Pico](./devices/pico.md) by Raspberry Pi
 - [nRF52](./devices/nrf52.md) by Nordic Semiconductor
+- [Zephyr](./devices/zephyr.md) by Zephyr Project
 
 ### API Documentation for Modules
 

readme.md

@@ -1,7 +1,7 @@
 # Moddable SDK
 
-Copyright 2017-2025 Moddable Tech, Inc.<BR>
-Revised: June 11, 2025
+Copyright 2017-2026 Moddable Tech, Inc.<BR>
+Revised: January 12, 2026
 
 ## Modern software development for microcontrollers
 
@@ -105,11 +105,11 @@ The Moddable SDK supports [many devices](./documentation/devices/esp32.md#platfo
 
 | | | |
 | :---: | :---: | :---: |
-| <a href="./documentation/devices/moddable-two.md"><img src="./documentation/assets/devices/moddable-two.png" width=125></a><BR>Moddable Two<sup>[[8](#footnotes3)]</sup> | <a href="./documentation/devices/esp32.md">![ESP32](./documentation/assets/devices/esp32.png)</a><BR>Node MCU ESP32<sup>[[9](#footnotes3)]</sup> | <a href="./documentation/devices/esp32.md#platforms">![M5Stack](./documentation/assets/devices/m5stack.png)</a><BR>M5Stack
+| <a href="./documentation/devices/moddable-six.md"><img src="./documentation/assets/devices/moddable-six.png" width=125></a><BR>Moddable Six<sup>[[8](#footnotes3)]</sup> | <a href="./documentation/devices/esp32.md">![ESP32](./documentation/assets/devices/esp32.png)</a><BR>Node MCU ESP32<sup>[[9](#footnotes3)]</sup> | <a href="./documentation/devices/esp32.md#platforms">![M5Stack](./documentation/assets/devices/m5stack.png)</a><BR>M5Stack
 | <a href="./documentation/devices/esp32.md#platforms">![M5Stack Fire](./documentation/assets/devices/m5stack-fire.png)</a><BR>M5Stack Fire | <a href="./documentation/devices/esp32.md#platforms">![M5Stick C](./documentation/assets/devices/m5stick-c.png)</a><BR>M5Stick C |  <a href="./documentation/devices/esp32.md#platforms">![M5Atom](./documentation/assets/devices/m5atom.png)</a><BR>M5Atom Matrix
 
 <a id="footnotes3"></a>
-> <sup>[8]</sup> *See also: [Moddable Two Developer Guide](./documentation/devices/moddable-two.md), Moddable [product page](https://www.moddable.com/product)*<BR>
+> <sup>[8]</sup> *See also: [Moddable Six Developer Guide](./documentation/devices/moddable-six.md), Moddable [product page](https://www.moddable.com/product)*<BR>
 <sup>[9]</sup> *See also: [Using the Moddable SDK with ESP32](./documentation/devices/esp32.md)*<BR>
 
 ### Pico by Raspberry Pi
@@ -179,6 +179,21 @@ The following developer resources are also available:
 - [QCA4020 Getting Started with the Moddable SDK](https://developer.qualcomm.com/project/qca4020-getting-started-moddable-sdk) blog post on the Qualcomm Developer Network
 - [QCA4020 Modern UI Application Development with the Moddable SDK](https://developer.qualcomm.com/project/qca4020-modern-ui-application-development-moddable-sdk) blog post on the Qualcomm Developer Network
 
+### Zephyr RTOS
+
+To use the Moddable SDK with Zephyr-based devices, you need to:
+
+1. Install the [Moddable SDK](./documentation/Moddable%20SDK%20-%20Getting%20Started.md)
+2. Install [Zephyr tools](./documentation/devices/zephyr.md)
+
+The Moddable SDK supports [many devices](./documentation/devices/zephyr.md#platforms) built on Zephyr RTOS. To see a full list, run:
+
+```sh
+ls $MODDABLE/devices/zephyr/targets
+```
+
+You can also add your own Zephyr devices by following the instructions in the [Zephyr documentation](./documentation/devices/zephyr.md#new-board).
+
 ### WebAssembly (Wasm)
 
 <a href="./documentation/devices/wasm.md">![](./documentation/assets/devices/wasm.gif)</a>
@@ -196,6 +211,8 @@ To use the Moddable SDK with WebAssembly, you need to:
 
 We have tested a variety of SPI displays with the ESP8266 and ESP32. Video demonstrations of these displays are [on our website](http://www.moddable.com/display). Wiring guides are available in the [documentation/displays](./documentation/displays) directory. The source code for the corresponding display and touch drivers is available in the [modules/drivers](./modules/drivers) directory.
 
+On the Zephyr RTOS, there is a single Moddable SDK [display driver](modules/io/display/zephyr/display.c) for all displays supported by Zephyr. The driver has been tested with displays that have 16-bit pixels. It may need to be modified to work with displays that use other pixel formats.
+
 ## Source tree
 
 The Moddable SDK repository contains the following top level directories:
@@ -246,6 +263,6 @@ To learn more about Moddable, see [our website](http://www.moddable.com).
 
 For companies interested in the benefits of using JavaScript and the Moddable SDK to power your products, Moddable provides consulting services to help you get started. We're available to help with design, implementation, training, and support.
 
-You can also reach out to us on Twitter ([@moddabletech](https://twitter.com/moddabletech)). Following us on Twitter is the best way to keep up with what we’re doing—we post announcements about new blog posts there, along with other Moddable news.
+You can also reach out to us on X (aka Twitter) ([@moddabletech](https://twitter.com/moddabletech)). Following us is the best way to keep up with what we’re doing—we post announcements about new blog posts there, along with other Moddable news.
 
 You can contact us directly by e-mail at [info@moddable.com](mailto:info@moddable.com).