Difference between revisions of "CZ19"
| Line 1: | Line 1: | ||
=Intro= | =Intro= | ||
| + | Welcome, and congratulations with your brand new CampZone 2019 "I-Pane" event badge! This year's badge features an eye-killing RGB LED matrix, an extended 8MB flash ESP32 WiFi/BL microcontroller, and the wonderful multi-badge firmware platform by badge.team. | ||
| + | |||
| + | You can install apps from the (of course fully free) app store, and even write your own apps easily in Python that others can then install too! | ||
=Getting started= | =Getting started= | ||
| − | Plug in your battery. | + | Plug in your battery. The + and - are indicated on the circuit board. The positive terminal should point towards the USB connector. The badge has a protection circuit against reversing the battery, but it's best not to need it. |
| + | |||
| + | When you power the badge for the first time, it will first show a one-time intro screen. Afterwards, it will try to connect to WiFi. If connecting is successful, it will force a day-0 OTA update to get you the latest firmware. Otherwise, it will boot into a minimal firmware that allows you to setup WiFi and force OTA manually (and play snake!). | ||
=Launcher= | =Launcher= | ||
| + | The badge boots into a launcher application, from which you can run all the apps you've installed. | ||
| + | |||
==Brightness control== | ==Brightness control== | ||
| − | + | The left and right buttons in the launcher app control the badge's system brightness, which is persistent across reboots. You can save your eyes and also improve your charging time by lowering the brightness. | |
| + | |||
| + | =UART menu and python shell= | ||
| + | You can play with your badge's internals by connecting it to your computer with a micro-USB cable. This is currently supported for Linux and Mac systems (please let us know if you're interested in adding Windows). For Mac, first install the CH340 driver mentioned [https://github.com/badgeteam/new-esp32-firmware/tree/91fb211f46e71a5508d0c0d994054dac5a3005a8#build-instructions here]. Instructions for opening a UART connection can be found [https://github.com/badgeteam/new-esp32-firmware/tree/91fb211f46e71a5508d0c0d994054dac5a3005a8#interacting-via-serial here]. | ||
| − | == | + | ==WiFi Settings== |
| − | The badge is preconfigured for the Campzone | + | The badge is preconfigured for the Campzone WiFi, SSID 'CampZone-IoT' Pass 'CampZone-IoT'. If you want to use the badge at home, do the OverTheAir Update on the campsite so the WiFi settings app works without bugs ;) |
To configure from the terminal, open a Serial terminal (115200) and choose 'python shell'. | To configure from the terminal, open a Serial terminal (115200) and choose 'python shell'. | ||
| Line 26: | Line 36: | ||
=Hardware mods= | =Hardware mods= | ||
==Capacitor for operation without battery== | ==Capacitor for operation without battery== | ||
| − | + | In order to use the I-Pane badge at high brightness without the battery on just USB, you can solder in the capacitor that is included in your bag. Please note the capacitor is polarized, the negative terminal (short wire, white marking on capacitor) should point towards the Campzone/Deloitte logo. | |
*Before you begin, unplug USB cable and remove battery. | *Before you begin, unplug USB cable and remove battery. | ||
Revision as of 23:54, 20 July 2019
Contents
Intro
Welcome, and congratulations with your brand new CampZone 2019 "I-Pane" event badge! This year's badge features an eye-killing RGB LED matrix, an extended 8MB flash ESP32 WiFi/BL microcontroller, and the wonderful multi-badge firmware platform by badge.team.
You can install apps from the (of course fully free) app store, and even write your own apps easily in Python that others can then install too!
Getting started
Plug in your battery. The + and - are indicated on the circuit board. The positive terminal should point towards the USB connector. The badge has a protection circuit against reversing the battery, but it's best not to need it.
When you power the badge for the first time, it will first show a one-time intro screen. Afterwards, it will try to connect to WiFi. If connecting is successful, it will force a day-0 OTA update to get you the latest firmware. Otherwise, it will boot into a minimal firmware that allows you to setup WiFi and force OTA manually (and play snake!).
Launcher
The badge boots into a launcher application, from which you can run all the apps you've installed.
Brightness control
The left and right buttons in the launcher app control the badge's system brightness, which is persistent across reboots. You can save your eyes and also improve your charging time by lowering the brightness.
You can play with your badge's internals by connecting it to your computer with a micro-USB cable. This is currently supported for Linux and Mac systems (please let us know if you're interested in adding Windows). For Mac, first install the CH340 driver mentioned here. Instructions for opening a UART connection can be found here.
WiFi Settings
The badge is preconfigured for the Campzone WiFi, SSID 'CampZone-IoT' Pass 'CampZone-IoT'. If you want to use the badge at home, do the OverTheAir Update on the campsite so the WiFi settings app works without bugs ;)
To configure from the terminal, open a Serial terminal (115200) and choose 'python shell'.
import machine
machine.nvs_setstr("system", "wifi.ssid", "YOUR SSID HERE")
machine.nvs_setstr("system", "wifi.password", "YOUR PASSWORD HERE")
If you use a SSID without a password, then erase the wifi password setting:
import machine
machine.nvs_erase("system", "wifi.password")
Reboot and it should 'just work' (if you have done the OTA). Else make an accesspoint with the CampZone-IoT as SSID and Password, do the OTA and THEN use your badge properly.
Hardware mods
Capacitor for operation without battery
In order to use the I-Pane badge at high brightness without the battery on just USB, you can solder in the capacitor that is included in your bag. Please note the capacitor is polarized, the negative terminal (short wire, white marking on capacitor) should point towards the Campzone/Deloitte logo.
- Before you begin, unplug USB cable and remove battery.
- Bend and cut the leads and solder in place.
Ultra bright LEDs
Replace 6 resistors and burn your eyes even further. More details soon!
