Skip to content

Commit

Permalink
update boards (c3fh4-rgb)
Browse files Browse the repository at this point in the history
  • Loading branch information
mmoskal committed Sep 12, 2023
1 parent cca3c5c commit 47e9b87
Show file tree
Hide file tree
Showing 4 changed files with 193 additions and 0 deletions.
39 changes: 39 additions & 0 deletions compiler/src/boards.json
Expand Up @@ -249,6 +249,45 @@
"productId": "0x3ff6ffeb",
"url": "https://www.espressif.com/en/products/socs/esp32"
},
"esp32_c3fh4_rgb": {
"$description": "A tiny ESP32-C3 board with 5x5 LED array.",
"$fwUrl": "https://github.com/microsoft/devicescript-esp32/releases/latest/download/devicescript-esp32c3-esp32_c3fh4_rgb-0x0.bin",
"$schema": "https://raw.githubusercontent.com/microsoft/devicescript-esp32/main/boards/esp32deviceconfig.schema.json",
"$services": [
{
"name": "buttonBOOT",
"pin": 9,
"service": "button"
}
],
"archId": "esp32c3",
"devName": "ESP32-C3FH4-RGB",
"i2c": {
"$connector": "Qwiic",
"pinSCL": 1,
"pinSDA": 0
},
"id": "esp32_c3fh4_rgb",
"led": {
"isMono": true,
"pin": 10
},
"log": {
"pinTX": 21
},
"pins": {
"LEDS": 8,
"P2": 2,
"P20": 20,
"P3": 3,
"P4": 4,
"P5": 5,
"P6": 6,
"P7": 7
},
"productId": "0x3a90885c",
"url": "https://github.com/01Space/ESP32-C3FH4-RGB"
},
"esp32_devkit_c": {
"$description": "There are currently issues with serial chip on these, best avoid. ESP32-DevKitC development board. This will also work with DOIT DevkitV1, NodeMCU ESP32, ... (search for 'esp32 devkit'). Some of these boards do not have the LED.",
"$fwUrl": "https://github.com/microsoft/devicescript-esp32/releases/latest/download/devicescript-esp32-esp32_devkit_c-0x1000.bin",
Expand Down
40 changes: 40 additions & 0 deletions website/docs/devices/boards.json
Expand Up @@ -121,6 +121,46 @@
"productId": "0x3ff6ffeb",
"url": "https://www.espressif.com/en/products/socs/esp32"
},
"esp32_c3fh4_rgb": {
"$description": "A tiny ESP32-C3 board with 5x5 LED array.",
"$fwUrl": "https://github.com/microsoft/devicescript-esp32/releases/latest/download/devicescript-esp32c3-esp32_c3fh4_rgb-0x0.bin",
"$schema": "https://raw.githubusercontent.com/microsoft/devicescript-esp32/main/boards/esp32deviceconfig.schema.json",
"$services": [
{
"name": "buttonBOOT",
"pin": 9,
"service": "button"
}
],
"archId": "esp32c3",
"devName": "ESP32-C3FH4-RGB",
"i2c": {
"$connector": "Qwiic",
"pinSCL": 1,
"pinSDA": 0
},
"id": "esp32_c3fh4_rgb",
"led": {
"isMono": true,
"pin": 10
},
"log": {
"pinTX": 21
},
"pins": {
"LEDS": 8,
"P2": 2,
"P20": 20,
"P3": 3,
"P4": 4,
"P5": 5,
"P6": 6,
"P7": 7
},
"productId": "0x3a90885c",
"url": "https://github.com/01Space/ESP32-C3FH4-RGB",
"img": "https://microsoft.github.io/jacdac-docs/images/devices/01space/esp32c3fh4rgbv10.catalog.jpg"
},
"esp32_devkit_c": {
"$description": "There are currently issues with serial chip on these, best avoid. ESP32-DevKitC development board. This will also work with DOIT DevkitV1, NodeMCU ESP32, ... (search for 'esp32 devkit'). Some of these boards do not have the LED.",
"$fwUrl": "https://github.com/microsoft/devicescript-esp32/releases/latest/download/devicescript-esp32-esp32_devkit_c-0x1000.bin",
Expand Down
1 change: 1 addition & 0 deletions website/docs/devices/esp32/boards.mdp
@@ -1,5 +1,6 @@

- [![photograph of Adafruit QT Py ESP32-C3 WiFi](https://microsoft.github.io/jacdac-docs/images/devices/adafruit/qtpyesp32c3wifidevboardv10.avatar.jpg) Adafruit QT Py ESP32-C3 WiFi](/devices/esp32/adafruit-qt-py-c3)
- [![photograph of ESP32-C3FH4-RGB](https://microsoft.github.io/jacdac-docs/images/devices/01space/esp32c3fh4rgbv10.avatar.jpg) ESP32-C3FH4-RGB](/devices/esp32/esp32-c3fh4-rgb)
- [![photograph of Espressif ESP32-DevKitC](https://microsoft.github.io/jacdac-docs/images/devices/espressif/esp32devkitcdevicescriptv40.avatar.jpg) Espressif ESP32-DevKitC](/devices/esp32/esp32-devkit-c)
- [![photograph of Espressif ESP32-C3-RUST-DevKit](https://microsoft.github.io/jacdac-docs/images/devices/espressif/esp32c3rustdevkitv12a.avatar.jpg) Espressif ESP32-C3-RUST-DevKit](/devices/esp32/esp32c3-rust-devkit)
- [![photograph of Espressif ESP32-S3 DevKitM](https://microsoft.github.io/jacdac-docs/images/devices/espressif/esp32s3devkitmv10.avatar.jpg) Espressif ESP32-S3 DevKitM](/devices/esp32/esp32s3-devkit-m)
Expand Down
113 changes: 113 additions & 0 deletions website/docs/devices/esp32/esp32-c3fh4-rgb.mdx
@@ -0,0 +1,113 @@
---
description: ESP32-C3FH4-RGB
---
# ESP32-C3FH4-RGB


A tiny ESP32-C3 board with 5x5 LED array.


![ESP32-C3FH4-RGB picture](https://microsoft.github.io/jacdac-docs/images/devices/01space/esp32c3fh4rgbv10.catalog.jpg)

## Features

- I2C on 0/1 using Qwiic connector
- LED on pin 10 (use [setStatusLight](/developer/status-light) to control)
- Serial logging on pin 21 at 115200 8N1
- Service: buttonBOOT (button)

## Stores

- [https://github.com/01Space/ESP32-C3FH4-RGB](https://github.com/01Space/ESP32-C3FH4-RGB)
- [https://usa.banggood.com/ESP32-C3-Development-Board-RISC-V-WiFi-Bluetooth-IoT-Development-Board-Compatible-with-Python-p-1914005.html?imageAb=2&akmClientCountry=America&a=1694552315.7453&akmClientCountry=America&cur_warehouse=CN](https://usa.banggood.com/ESP32-C3-Development-Board-RISC-V-WiFi-Bluetooth-IoT-Development-Board-Compatible-with-Python-p-1914005.html?imageAb=2&akmClientCountry=America&a=1694552315.7453&akmClientCountry=America&cur_warehouse=CN)

## Pins

| pin name | hardware id | features |
|:---------|:------------|---------:|
| **LEDS** | GPIO8 | boot, io |
| **P2** | GPIO2 | analogIn, boot, io |
| **P20** | GPIO20 | bootUart, io |
| **P3** | GPIO3 | analogIn, io |
| **P4** | GPIO4 | analogIn, debug, io |
| **P5** | GPIO5 | debug, io |
| **P6** | GPIO6 | debug, io |
| **P7** | GPIO7 | debug, io |
| **$services.buttonBOOT[0].pin** | GPIO9 | $services.buttonBOOT[0].pin, boot, io |
| **i2c.pinSCL** | GPIO1 | i2c.pinSCL, analogIn, io |
| **i2c.pinSDA** | GPIO0 | i2c.pinSDA, analogIn, io |
| **led.pin** | GPIO10 | led.pin, io |
| **log.pinTX** | GPIO21 | log.pinTX, bootUart, io |



## DeviceScript import


You must add this import statement to load
the pinout configuration for this device.

In [Visual Studio Code](/getting-started/vscode),
click the **wand** icon on the file menu and
select "ESP32-C3FH4-RGB".

```ts
import { pins, board } from "@dsboard/esp32_c3fh4_rgb"
```

## Firmware update

In Visual Studio Code,
select **DeviceScript: Flash Firmware...** from the command palette.

Run this [command line](/api/cli) command and follow the instructions.

```bash
devicescript flash --board esp32_c3fh4_rgb
```


- [Firmware](https://github.com/microsoft/devicescript-esp32/releases/latest/download/devicescript-esp32c3-esp32_c3fh4_rgb-0x0.bin)

## Configuration

```json title="esp32_c3fh4_rgb.json"
{
"$schema": "https://raw.githubusercontent.com/microsoft/devicescript-esp32/main/boards/esp32deviceconfig.schema.json",
"id": "esp32_c3fh4_rgb",
"devName": "ESP32-C3FH4-RGB",
"productId": "0x3a90885c",
"$description": "A tiny ESP32-C3 board with 5x5 LED array.",
"archId": "esp32c3",
"url": "https://github.com/01Space/ESP32-C3FH4-RGB",
"$services": [
{
"name": "buttonBOOT",
"pin": 9,
"service": "button"
}
],
"i2c": {
"$connector": "Qwiic",
"pinSCL": 1,
"pinSDA": 0
},
"led": {
"isMono": true,
"pin": 10
},
"log": {
"pinTX": 21
},
"pins": {
"LEDS": 8,
"P2": 2,
"P20": 20,
"P3": 3,
"P4": 4,
"P5": 5,
"P6": 6,
"P7": 7
}
}
```

0 comments on commit 47e9b87

Please sign in to comment.