You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/arduino_example.md
+1-1Lines changed: 1 addition & 1 deletion
Original file line number
Diff line number
Diff line change
@@ -6,7 +6,7 @@ Now that we've installed the espressif boards package in Arduino, it's time to u
6
6
7
7
## Blink RGB Example
8
8
9
-
The ESP32 core includes an example for cycling an RGB LED like the one found on this Thing Plus so long as the board variant defines it as `RGB_BUILTIN` (which ours does). Navigate to the example by going to **File** > **Examples** > **ESP32** > **GPIO** > **BlinkRGB** like the screenshot below shows:
9
+
The ESP32 core includes integrated code support for easily controlling a WS2812 LED and an example demonstrating how to cycle an RGB LED like the one found on this Thing Plus so long as the board variant defines it as `RGB_BUILTIN`. The Thing Plus ESP32-C6 does define IO23 as `RBG_BUILTIN` so this example and all other code calling for the built-in RGB LED works for this board. Open the example by navigating to **File** > **Examples** > **ESP32** > **GPIO** > **BlinkRGB** like the screenshot below shows:
10
10
11
11
<figuremarkdown>
12
12
[{ width="600"}](./assets/img/BlinkRGB_example.jpg"Click to enlarge.")
Copy file name to clipboardExpand all lines: docs/hardware_assembly.md
+18-2Lines changed: 18 additions & 2 deletions
Original file line number
Diff line number
Diff line change
@@ -6,7 +6,7 @@ Now that we're familiar with the hardware on this Thing Plus board, it's time to
6
6
7
7
## Basic USB Assembly
8
8
9
-
Basic assembly of the Thing Plus ESP32-C only requires a USB-C cable connecting the board to a computer. Just plug the cable into the USB-C connector like the photo below shows and you should see the RGB LED cycling through rainbow colors. From here, we can move on to installing the espressif boards package in Arduino and uploading code.
9
+
Basic assembly of the Thing Plus ESP32-C only requires a USB-C cable connecting the board to a computer. Just plug the cable into the USB-C connector like the photo below shows and you should see the RGB LED cycling through rainbow colors with the pre-loaded test code. From here, we can move on to installing the espressif boards package in Arduino and uploading code.
10
10
11
11
<figuremarkdown>
12
12
[{ width="600"}](./assets/img/Thing_Plus_C6-USB_Assembly.jpg"Click to enlarge")
@@ -23,4 +23,20 @@ If you prefer a battery-powered application, plug a single-cell LiPo battery int
23
23
[{ width="600"}](./assets/img/Thing_Plus_C6-Battery_Assembly.jpg"Click to enlarge")
24
24
</figure>
25
25
26
-
For tips on the proper use of a LiPo battery and the 2-pin JST connector, please read through our [Single Cell LiPo Battery Care](https://learn.sparkfun.com/tutorials/single-cell-lipo-battery-care) tutorial.
26
+
For tips on the proper use of a LiPo battery and the 2-pin JST connector, please read through our [Single Cell LiPo Battery Care](https://learn.sparkfun.com/tutorials/single-cell-lipo-battery-care) tutorial.
27
+
28
+
## Soldered Assembly
29
+
30
+
Those who prefer a traditional soldered assembly should solder wires or header pins to the PTH header on the side of the board. If you're not familiar with through-hole soldering or would like a refresher, take a look at our Through-Hole Soldering Tutorial:
Copy file name to clipboardExpand all lines: docs/hardware_overview.md
+10-5Lines changed: 10 additions & 5 deletions
Original file line number
Diff line number
Diff line change
@@ -12,7 +12,7 @@ The ESP32-C6 WROOM1 module from espressif combines a powerful RISC-5 processor w
12
12
[{ width="600"}](./assets/img/Thing_Plus_C6-Module.jpg"Click to enlarge")
13
13
</figure>
14
14
15
-
This development board uses the WROOM1 version of the C6 module which has slightly more computing power in exchange for lesser power efficiency. The ESP32-C6 features a 32-bit RISC-V single-core processor with an integrated wireless stack. The wireless stack is compatible with 2.4 GHz WiFi 6, Bluetooth<sup>®</sup> 5.3, Zigbee and Thread (802.15.4) and uses an on-board PCB antenna.
15
+
This development board uses the WROOM1 version of the C6 module which has slightly more computing power in exchange for lesser power efficiency. The ESP32-C6 is built around a 32-bit RISC-V single-core processor with an integrated wireless stack. The wireless stack is compatible with 2.4 GHz WiFi 6, Bluetooth<sup>®</sup> 5.3, Zigbee and Thread (802.15.4) and uses an on-board PCB antenna.
16
16
17
17
The module features a wide range of peripheral options including SPI, UART, LPUART, I<sup>2</sup>C, I<sup>2</sup>S, LED PWM, USB Serial/JTAG controller, ADC and more. Many of these peripherals can be mapped to any GPIO pin though some are tied to specific pins. This Thing Plus breaks out 21 pins from the module to a pair of 0.1"-spaced PTH headers.
18
18
@@ -41,6 +41,8 @@ The board has a 2-pin JST connector to connect a single-cell Lithium Ion (LiPo)
41
41
42
42
## Pinout & Qwiic Connector
43
43
44
+
Next up let's take a look at the Thing Plus pinout and Qwiic connector on this board.
45
+
44
46
<figuremarkdown>
45
47
[{ width="600"}](./assets/img/Thing_Plus_C6-PTHs.jpg"Click to enlarge")
46
48
</figure>
@@ -69,7 +71,7 @@ There are two buttons on the board labeled <b>RESET</b> and <b>BOOT</b>. The RES
69
71
70
72
## µSD Card Slot
71
73
72
-
This board also has a friction-fit µSD card slot for users who need some more programming space on the Thing Plus - ESP32-C6.
74
+
This board also has a friction-fit µSD card slot for users who need more storage space on the Thing Plus - ESP32-C6.
73
75
74
76
<figuremarkdown>
75
77
[{ width="600"}](./assets/img/Thing_Plus_C6-SD.jpg"Click to enlarge")
@@ -91,6 +93,9 @@ This Thing Plus has three LEDs labeled <b>PWR</b>, <b>CHG</b>, and <b>STAT</b>.
91
93
[{ width="600"}](./assets/img/Thing_Plus_C6-LEDs.jpg"Click to enlarge")
92
94
</figure>
93
95
96
+
!!! note "RGB LED"
97
+
The board definition for the Thing Plus - ESP32-C6 sets IO23 to use espressif's `RGB_BUILTIN` code support. This automatically includes the necessary code to control an RGB LED easily when calling `RGB_BUILTIN`. Unfortunately, this means the RGB PTH pin (IO23) can run into code conflicts when users attempt to use it for another purpose. If you *really* need IO23 for something other than the RGB LED, you may need to modify the board definition files in the ESP32 Arduino boards package. Modifying these files is beyond the scope of this tutorial and is not supported by SparkFun.
98
+
94
99
## Solder Jumpers
95
100
96
101
There are nine solder jumpers on the Thing Plus - ESP32-C6 labeled <b>I<sup>2</sup>C</b>, <b>ALRT</b>, <b>SD_DET</b>, <b>MEAS</b>, <b>LP</b>, <b>SHLD</b>, <b>RGB</b>, <b>CHG</b>, and <b>PWR</b>. The table below outlines the jumpers' labels, default state, function, and any notes regarding their use:
@@ -116,12 +121,12 @@ There are nine solder jumpers on the Thing Plus - ESP32-C6 labeled <b>I<sup>2</s
116
121
<td>ALRT</td>
117
122
<td>CLOSED</td>
118
123
<td>Ties the MAX17048's alert pin to IO11 for battery voltage monitoring</td>
119
-
<td>Open to isolate IO11 from the MAX17048's alert pin</td>
124
+
<td>Open to isolate IO11 from the MAX17048's alert pin if IO11 is needed for other uses</td>
120
125
<tr>
121
126
<td>SD_DET</td>
122
127
<td>CLOSED</td>
123
128
<td>Connects the µSD card's card detection pin to IO19</td>
124
-
<td></td>
129
+
<td>Open to disable µSD card detection or if IO19 is needed for other uses</td>
125
130
</tr>
126
131
<tr>
127
132
<td>MEAS</td>
@@ -163,7 +168,7 @@ There are nine solder jumpers on the Thing Plus - ESP32-C6 labeled <b>I<sup>2</s
163
168
164
169
## Board Dimensions
165
170
166
-
This board matches the Thing Plus footprint and measures 2.30" x 0.90" (58.42mm x 22.86mm) with four mounting holes that fit a [4-40 screw](https://www.sparkfun.com/products/10453).
171
+
This board matches the Thing Plus footprint and measures 2.30" x 0.90" (58.42mm x 22.86mm) with four mounting holes that fit a [4-40 screw](https://www.sparkfun.com/products/10453) though the top two mounting holes are obstructed by the ESP32-C6 module.
167
172
168
173
<figuremarkdown>
169
174
[{ width="600"}](./assets/board_files/Thing_Plus_ESP32_C6-Dimensions.png"Click to enlarge")
- The SparkFun Thing Plus - ESP32-C6 adds a powerful wireless development option to SparkFun's popular Thing Plus footprint. This Thing Plus board features the ESP32-C6 WROOM-1-N16 module from espressif<sup>™</sup>. It includes a LiPo battery charger and fuel gauge, µSD card slot, an addressable LED and more. The Thing Plus footprint is Feather-compatible and breaks out all of the ESP32-C6's 23 GPIO pins to 0.1"-spaced PTH headers. The board also has a USB-C connector for primary power and programming, 2-pin JST connector for a LiPo battery, and a Qwiic connector to integrate it into SparkFun's [Qwiic ecosystem](https://www.sparkfun.com/qwiic).
19
+
- The SparkFun Thing Plus - ESP32-C6 adds a powerful wireless development option to SparkFun's popular Thing Plus footprint. This Thing Plus board features the ESP32-C6 WROOM-1-N16 module from espressif<sup>™</sup>. It includes a LiPo battery charger and fuel gauge to charge and monitor a battery connected to the on-bard 2-pin JST connector, µSD card slot, an addressable LED and more. The board breaks out all of the ESP32-C6's 23 GPIO pins to a pair of 0.1"-spaced PTH headers on either side of the board. The board also has a USB-C connector for primary power and programming and a Qwiic connector to integrate it into SparkFun's [Qwiic ecosystem](https://www.sparkfun.com/qwiic).
20
20
21
21
The ESP32-C6 SoC is built around a RISC-V single-core processor with 16 MB flash memory with an integrated wireless stack. The wireless stack supports 2.4 GHz WiFi 6, Bluetooth<sup>®</sup> 5.3, Zigbee and Thread (802.15.4) and uses an on-board PCB antenna. The ESP32-C6 includes a wide range of peripheral options including SPI, UART, LPUART, I<sup>2</sup>C, I<sup>2</sup>S, LED PWM, USB Serial/JTAG controller, ADC and more. Many of these peripherals can be mapped to any GPIO pin though some are tied to specific pins.
The Thing Plus - ESP32-C6 includes a 2-pin JST connector and integrated charging circuit for an attached single-cell LiPo battery. Below are a few options for batteries we recommend for battery-powered applications:
115
+
The Thing Plus - ESP32-C6 includes a 2-pin JST connector and integrated charging circuit for an attached single-cell LiPo battery. Below are a few options we recommend for battery-powered applications:
115
116
116
117
<divclass="grid cards"markdownalign="center">
117
118
@@ -171,25 +172,25 @@ If you prefer a soldered connection or want to modify the solder jumpers on this
292
+
</figure>
293
+
</a>
294
+
<ahref="https://learn.sparkfun.com/tutorials/1107">**SparkFun Qwiic Shield for Thing Plus Hookup Guide**
Copy file name to clipboardExpand all lines: docs/software_setup.md
+3-1Lines changed: 3 additions & 1 deletion
Original file line number
Diff line number
Diff line change
@@ -15,7 +15,9 @@ With the ESP32-C6 Thing Plus connected to our computer, it's time to set up the
15
15
16
16
To install the ESP32 boards package, open the Preferences menu by navigating to <b>File</b> > <b>Preferences</b>. Look at the bottom of the Preferences menu for "Additional boards manager URLS" and then copy this JSON link into that field:
Click "Ok" and then open the *Boards Manager* tool, search for "espressif ESP32" and install the latest alpha release (3.0.0-alpha2 or later). This install process may take some time so feel free to step away while it downloads and installs.
Copy file name to clipboardExpand all lines: docs/troubleshooting.md
+4Lines changed: 4 additions & 0 deletions
Original file line number
Diff line number
Diff line change
@@ -4,6 +4,10 @@ Take note of the option labeled "USB CDC on Boot" when selecting the Board from
4
4
5
5
With either setting, <code>Serial1</code> is available and refers to the UART1 bus (default pins are 4 and 5).
6
6
7
+
## RGB LED Pin
8
+
9
+
The board definition for the Thing Plus - ESP32-C6 sets IO23 to use espressif's `RGB_BUILTIN` code support. This automatically includes the necessary code to control an RGB LED easily when calling `RGB_BUILTIN`. Unfortunately, this means the RGB PTH pin (IO23) can run into code conflicts when users attempt to use it for another purpose. If you *really* need IO23 for something other than the RGB LED, you may need to modify the board definition files in the ESP32 Arduino boards package. Modifying these files is beyond the scope of this tutorial and is not supported by SparkFun.
0 commit comments