Skip to content

Commit

Permalink
Merge pull request #40 from yetanothercarbot/0.7.0
Browse files Browse the repository at this point in the history 
Update documentation for ESP32-S3-BOX-3
  • Loading branch information
@fvanroie
fvanroie authored Jul 30, 2024
2 parents b7c02bc + f4b25ae commit 426e8c6
Showing 1 changed file with 15 additions and 8 deletions.
23 changes: 15 additions & 8 deletions docs/hardware/espressif/esp-s3-box.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -2,14 +2,16 @@

## Features

The ESP-BOX is a development kit by Espressif that features an ESP32-S3 with 8MB of PSRAM, a 320x240 2.4" LCD and a TT21100 capacitive touchscreen controller. It also includes two microphones and a speaker, though these are not used by OpenHASP. A number of GPIOs are on the rear (or on the stand, if equipped).
The ESP-BOX is a series of development kits by Espressif. A handful of variations exist, but all feature an ESP32-S3 with PSRAM, a 320x240 2.4" LCD and a capacitive touchscreen controller. They also include two microphones and a speaker, though these are not used by OpenHASP. A number of GPIOs are also available, depending on variation and stand.

This devkit comes with a stand, which can be detached to hang the devkit on a wall instead. Power is supplied via USB-C, either plugged into the devkit or into its stand.

If considering purchasing, see [Variants](#variants)

| Pros | Cons
|:----- |:----
| With stand | Poor viewing angles
| 8MB PSRAM | Small display
| 8MB/16 PSRAM | Small display
| Capacitive touchscreen |

## Gallery
Expand All @@ -23,13 +25,18 @@ This devkit comes with a stand, which can be detached to hang the devkit on a wa
## Flashing
This devkit uses the native USB peripheral on the ESP32-S3. To put the devkit into flashing mode, hold the boot button (top button on the left edge) while clicking the reset button (bottom button on the left edge). After this, it can be flashed as usual.

After flashing, click the reset button. You will need to open the serial port after flashing for the firmware to boot - in the UI, disable serial logging to fix this.
After flashing, click the reset button. You might need to open the serial port after flashing for the firmware to boot - in the UI, disable serial logging to fix this. <!-- Revisit after 0.7 is released. It seems to not be necessary on newer RC builds but I'd like someone else to verify if possible. -->

## Variations
## Variants

### ESP-S3-BOX-3
This is not to be confused with the newer ESP-S3-BOX-3. The ESP-S3-BOX-3 uses the same display driver and may be compatible, but has not been tested yet. This variant also has 16MB of PSRAM.
| | **ESP32-S3-BOX** | **ESP32-S3-BOX-Lite** | **ESP32-S3-BOX-3** | **ESP32-S3-BOX-3B** |
|------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------|
| **Description** | Original release. Case is 3D-printed, and includes a stand that exposes the GPIO pins and a USB-C port. If the stand is removed, the display can be wall-mounted. This variant has 8MB of PSRAM. | This is similar to the ESP32-S3-BOX, but does not have touch input; instead it has three buttons below the display. Stand is not included. Has 8MB of PSRAM. | Second generation device. Comes with a variety of stands, with various accessories integrated, but very few are supported. This version is no longer wall-mountable. Has 16MB of PSRAM. | The same as ESP32-S3-BOX-3, but has only a regular dock. |
| **Supported** | Yes. Touch and display work. | Untested. Display should work. Buttons not implemented. | Yes. Touch and display work. | Yes. Touch and display work. |
| **Recommended** | No; deprecated and superseded - buy a ESP32-S3-BOX-3B instead. | No. Does not support touch and has been superseded since. | Yes, but consider the ESP32-SE-BOX-3B instead if only purchasing for OpenHASP - the additional accessories included in this variant are not supported by OpenHASP. | **Yes** |
| **Build Target** | `esp32-s3-box` | `esp32-s3-box` | `esp32-s3-box-3` | `esp32-s3-box-3` |

### ESP-S3-BOX-LITE
For more information about the hardware, see [Espressif's documentation](https://github.com/espressif/esp-box).

A -LITE version also exists, which does not have a touch layer. The display controller is the same and should work for purely informational displays, though untested.
## Other notes
- The mute button (on top) is on GPIO1 on all variants, and can be added as a switch (not button) input.

0 comments on commit 426e8c6

Please sign in to comment.