HOPE Wiki - User contributions [en]

Getting Started With ESPHome Workshop

2025-08-17T20:29:53Z

Fortuna: Add links

= Getting Started With ESPHome: From Zero to Cool workshop =

⚠️ '''You must bring: a laptop + a USB-C data cable (not just charging).''' ⚠️

📆 '''Date:''' Day 2, Saturday, 16-August-2025 
🕔 '''Time:''' 5:00pm - 6:30pm 
📍 '''Location:''' Tobin 219 (Workshop A) 
[http://Schedulehttps://schedule.hope.net/hope16/talk/T7XAL9/ Schedule]

This hands-on workshop introduces participants to ESPHome, an open-source platform for integrating ESP32 microcontrollers with home automation systems. Participants will learn the fundamentals of configuring ESPHome YAML files to control inputs and outputs, connect to Wi-Fi, enable remote access, perform over-the-air (OTA) updates, integrate with Home Assistant, and add external sensors or components. Attendees will walk away with the knowledge to create their own simple IoT solutions using ESPHome. No programming or soldering skills are required, making this workshop highly accessible to beginners and anyone curious about creating IoT devices and home automation.

By '''Vinicius Fortuna''' — [https://www.viniciusfortuna.com Home] · [https://www.linkedin.com/in/vfortuna/ LinkedIn] · [https://mastodon.social/@vinifortuna Mastodon]

== Materials ==
The workshop is free to attend, but you’ll need an '''ESP32 device''' (ESP32-C3 preferred), plus a '''laptop''' and '''USB-C data cable'''.

'''ESP32 devices:''' I’ll have '''20 ESP32-C3 Super Mini''' boards available for purchase at '''$4''' (cash, crypto, Venmo, PayPal). You can also borrow one if available; priority goes to folks purchasing.

'''Bring last year’s badge:''' You can use the [[HOPE XV Electronic Badge]] (it has an ESP32-C3 inside).

'''USB-C data cables:''' I’ll bring ~20 to loan during the session (please return). If your laptop doesn’t have USB-C, bring your own USB-A↔USB-C cable or adapter. '''Make sure it’s a data-capable cable.'''

No soldering or extra tools needed. No registration; first-come, first-served seating. If you lack materials, you can still sit in if space allows—priority to those ready to flash.

== Preparation ==

This can be problematic and doing it in advance can ensure the workshop can get started without delays.

*[https://esphome.io/guides/installing_esphome.html Install ESPHome]
* Have https://github.com/fortuna/ESPHomeWorkshop open in your laptop to copy the code and follow along.

== Quick links ==

Workshop code: https://github.com/fortuna/ESPHomeWorkshop

ESPHome docs: [https://esphome.io/#getting-started Getting Started] - [https://esphome.io/components/ List of Components]

Home Assistant ESPHome integration:
https://www.home-assistant.io/integrations/esphome/

Community:

* ESPHome: [https://discord.com/invite/KhAMKrd Discord Server], [https://community.home-assistant.io/c/esphome/36 Forum]
* Home Assistant: [https://discord.com/invite/KhAMKrd Discord Server], [https://community.home-assistant.io/ Forum]

Getting Started With ESPHome Workshop

2025-08-16T06:35:19Z

Fortuna: tweaks

= Getting Started With ESPHome: From Zero to Cool workshop =

⚠️ '''You must bring: a laptop + a USB-C data cable (not just charging).''' ⚠️

📆 '''Date:''' Day 2, Saturday, 16-August-2025 
🕔 '''Time:''' 5:00pm - 6:30pm 
📍 '''Location:''' Tobin 219 (Workshop A) 
[http://Schedulehttps://schedule.hope.net/hope16/talk/T7XAL9/ Schedule]

This hands-on workshop introduces participants to ESPHome, an open-source platform for integrating ESP32 microcontrollers with home automation systems. Participants will learn the fundamentals of configuring ESPHome YAML files to control inputs and outputs, connect to Wi-Fi, enable remote access, perform over-the-air (OTA) updates, integrate with Home Assistant, and add external sensors or components. Attendees will walk away with the knowledge to create their own simple IoT solutions using ESPHome. No programming or soldering skills are required, making this workshop highly accessible to beginners and anyone curious about creating IoT devices and home automation.

By '''Vinicius Fortuna''' — [https://www.viniciusfortuna.com Home] · [https://www.linkedin.com/in/vfortuna/ LinkedIn] · [https://mastodon.social/@vinifortuna Mastodon]

== Materials ==
The workshop is free to attend, but you’ll need an '''ESP32 device''' (ESP32-C3 preferred), plus a '''laptop''' and '''USB-C data cable'''.

'''ESP32 devices:''' I’ll have '''20 ESP32-C3 Super Mini''' boards available for purchase at '''$4''' (cash, crypto, Venmo, PayPal). You can also borrow one if available; priority goes to folks purchasing.

'''Bring last year’s badge:''' You can use the [[HOPE XV Electronic Badge]] (it has an ESP32-C3 inside).

'''USB-C data cables:''' I’ll bring ~20 to loan during the session (please return). If your laptop doesn’t have USB-C, bring your own USB-A↔USB-C cable or adapter. '''Make sure it’s a data-capable cable.'''

No soldering or extra tools needed. No registration; first-come, first-served seating. If you lack materials, you can still sit in if space allows—priority to those ready to flash.

== Preparation ==

This can be problematic and doing it in advance can ensure the workshop can get started without delays.

*[https://esphome.io/guides/installing_esphome.html Install ESPHome]
* Have https://github.com/fortuna/ESPHomeWorkshop open in your laptop to copy the code and follow along.

== Quick links ==

Workshop code: https://github.com/fortuna/ESPHomeWorkshop

ESPHome docs: https://esphome.io/

Home Assistant ESPHome integration: https://www.home-assistant.io/integrations/esphome/

Getting Started With ESPHome Workshop

2025-08-16T06:23:48Z

Fortuna: Revamp

= Getting Started With ESPHome: From Zero to Cool workshop =

⚠️ '''You must have a laptop and a USB-C data cable to program the device
''' ⚠️

📆 '''Date:''' Day 2, Saturday, 16-August-2025 
🕔 '''Time:''' 5:00pm - 6:30pm 
📍 '''Location:''' Tobin 219 (Workshop A) 
[http://Schedulehttps://schedule.hope.net/hope16/talk/T7XAL9/ Schedule]

This hands-on workshop introduces participants to ESPHome, an open-source platform for integrating ESP32 microcontrollers with home automation systems. Participants will learn the fundamentals of configuring ESPHome YAML files to control inputs and outputs, connect to Wi-Fi, enable remote access, perform over-the-air (OTA) updates, integrate with Home Assistant, and add external sensors or components. Attendees will walk away with the knowledge to create their own simple IoT solutions using ESPHome. No programming or soldering skills are required, making this workshop highly accessible to beginners and anyone curious about home automation.

By '''Vinicius Fortuna''' 
[https://www.viniciusfortuna.com Home Page] - [https://www.linkedin.com/in/vfortuna/ LinkedIn] - [https://mastodon.social/@vinifortuna Mastodon]

== Materials ==

The workshop is free, but you will need to acquire a '''ESP32 device''', preferably ESP32-C3 (besides brining a '''laptop''' and '''USB-C data cable''').

No soldering or other equipment is needed, and there's no registration.

If you do not have the materials needed, you can still join if there's extra space available. Preference will be given to those with the required materials.

=== ESP32 Devices ===

I'll have 20 [https://www.amazon.com/dp/B0DPSNVWB2/ref=sspa_dk_detail_3 ESP32-C3 Super Mini board] available for purchase at $5 each (cash, crypto, Venmo, Paypal accepted). You can borrow one for free if available, but preference will be given to those acquiring a board.

You can use last year's [[HOPE XV Electronic Badge]], please bring it if you have one (it has a ESP32-C3 inside!).

=== USB-C Data Cables ===

I'll have 20 USB-C to USB-C data cables available to borrow if needed (please return them), but it's best if you bring your own. You must bring your own cable or an adaptor if your laptop USB is not Type C (usually Type A). '''Make sure it's a data cable.''' Your original phone charger cable will probably work.

== Preparation ==

This can be problematic and doing it in advance can ensure the workshop can get started without delays.

*[https://esphome.io/guides/installing_esphome.html Install ESPHome]
* Have https://github.com/fortuna/ESPHomeWorkshop open in your laptop.

HOPE XV Electronic Badge

2025-08-15T19:53:58Z

Fortuna: Add ESPHome

[[File:HOPE_XV_electronic_badge_photo_front.jpg|thumb|500px|The HOPE XV Electronic Badge PCB (front)]] 
[[File:Hopexv-badge-back.jpg|thumb|500px|The HOPE XV Electronic Badge PCB (back)]] 

= Firmware =
<Must-still-be-uploaded> 
hopebadge-0.8.14.bin

Or flash it with ESPHome, which is an easy way to write firmware for your badge:
https://github.com/fortuna/ESPHomeBadge

= Badge Clinic =

Come by the Badge Clinic, and one of our specialized nurse practitioners will help you with all of your HOPE XV Electronic Badge needs. 
Come by for: 
* help with assembly
* to find out more about features
* to hack on the badge
* to volunteer to help others

= Description =

The HOPE XV badge was given to in-person HOPE attendees. Circuit boards are purple (attendee badge) and black (pro version with more components populated). Cases are pink, green, and black (pro version).

 Two 'pro' versions (with additional components) could be purchased at the Badge Clinic for $100 (extra components) and $150 (extra components and accessories).
 

== Features ==
The HOPE XV Electronic Badge has lots of cool features!
* Lots of colored blinky lights (16 WS2812 or similar)!
* ESP32-C3 microcontroller
* MCP73871 LiPo LiPo battery charge controller.
* Feature 2
* Feature 3
* Feature etc

== The Buttons ==
The firmware on the attendee Badge is setup for:
* button 1 - cycle thru light patterns
* button 2, 3 - dim/brighten LEDs
* button 4 - push to send an IR blast to other badges in Range, making their lights flash and motor vibrate

== Open Hardware ==
The HOPE XV Electronic Badge is totally [https://gitlab.com/tidklaas/hip-badge Open Hardware]! Use the vibration branch to pickup the code that runs the small vibration motor.
* The repository linked appears to be correct (REL_0.8.14), but does not specifically mention HOPE, so looking for confirmation.
It is also totally hackable.

=== BOM ===

This bill of materials is based on the KiCAD project. There are a number of components that are not populated on the badges distributed to attendees.

{| class="mw-collapsible mw-collapsed wikitable" ! colspan="6" | HOPE XV Badge Bill of Materials. &nbsp;
! Reference !! Value !! Datasheet !! Footprint !! Qty !! DNP
|-
| AE1 || Antenna_Loop || ~ || Mondev:NFCAntenna_65mm_north || 1 ||
|-
| AE2 || Antenna_Conn || ~ || Mondev:Molex_5051100492-1x04-P0.5mm_Horizontal || 1 ||
|-
| AE4 || Antenna || ~ || Connector_Coaxial:SMA_Samtec_SMA-J-P-X-ST-EM1_EdgeMount || 1 ||
|-
| BT1 || Battery_Cell || ~ || Connector_Molex:Molex_PicoBlade_53261-0371_1x03-1MP_P1.25mm_Horizontal || 1 ||
|-
| C1,C2 || 18pF || ~ || Capacitor_SMD:C_0805_2012Metric || 2 ||
|-
| C3,C31 || 10uF || ~ || Capacitor_SMD:C_0805_2012Metric || 2 ||
|-
| C4,C6,C11,C12,C14,C15,C16,C17,C18,C19,C20,C21,C22,C23,C24,C25,C26,C27,C28,C29,C30,C35,C38,C45,C47,C50,C52,C53,C56,C58,C61,C66 || 0.1uF || ~ || Capacitor_SMD:C_0805_2012Metric || 32 ||
|-
| C5,C7 || 15pF || ~ || Capacitor_SMD:C_0805_2012Metric || 2 ||
|-
| C8,C9,C13,C32,C33,C46,C59,C62 || 1uF || ~ || Capacitor_SMD:C_0805_2012Metric || 8 ||
|-
| C10,C63,C64,C65 || 0.01uF || ~ || Capacitor_SMD:C_0805_2012Metric || 4 ||
|-
| C34,C36,C49 || 4.7uF || ~ || Capacitor_SMD:C_0805_2012Metric || 3 ||
|-
| C37,C48,C51 || 22uF || -- mixed values -- || Capacitor_SMD:C_0805_2012Metric || 3 ||
|-
| C39,C42 || 47pF || ~ || Capacitor_SMD:C_0805_2012Metric || 2 ||
|-
| C40 || NC || ~ || Capacitor_SMD:C_0805_2012Metric || 1 ||
|-
| C41,C43 || 0,1uF || ~ || Capacitor_SMD:C_0805_2012Metric || 2 ||
|-
| C44,C57,C60 || 100pF || ~ || Capacitor_SMD:C_0805_2012Metric || 3 ||
|-
| C54,C55,L3 || TBD || ~ || -- mixed values -- || 3 ||
|-
| D1,D2,D3,D4,D5,D6,D7,D8,D9,D10,D11,D12,D13,D14,D15,D16 || WS2812B || https://cdn-shop.adafruit.com/datasheets/WS2812B.pdf || LED_SMD:LED_WS2812B_PLCC4_5.0x5.0mm_P3.2mm || 16 ||
|-
| D17,D18,D20,D21,D22,D26,D27,D28 || LED || ~ || -- mixed values -- || 8 ||
|-
| D19,D24,D25 || D_Schottky || -- mixed values -- || Diode_SMD:D_SOD-123 || 3 ||
|-
| D23 || IR17-21C || http://www.everlight.com/file/ProductFile/IR26-21C-L110-TR8.pdf || LED_SMD:LED_1206_3216Metric || 1 ||
|-
| FB1,FB2,FB3 || 742792042 || ~ || Inductor_SMD:L_0805_2012Metric || 3 ||
|-
| FID1,FID2,FID3,FID4,FID5,FID6,FID7,FID8 || Fiducial || ~ || Fiducial:Fiducial_1mm_Mask2mm || 8 ||
|-
| H1,H2,H3,H4 || MountingHole || ~ || MountingHole:MountingHole_3.2mm_M3 || 4 ||
|-
| IC1 || IRM-H6xxT || https://datasheet.lcsc.com/szlcsc/2010221806_Everlight-Elec-IRM-H638T-TR2-DX_C390031.pdf || Mondev:IRM-H6XXT || 1 ||
|-
| J1 || Conn_01x02 || ~ || Connector_Molex:Molex_PicoBlade_53261-0271_1x02-1MP_P1.25mm_Horizontal || 1 ||
|-
| J2 || Conn_01x04 || ~ || Connector_JST:JST_SH_SM04B-SRSS-TB_1x04-1MP_P1.00mm_Horizontal || 1 ||
|-
| J3,J4 || Conn_02x03 || ~ || Mondev:Badgelife-SAO-169 || 2 ||
|-
| J5 || Conn_ARM_JTAG_SWD_10 || http://infocenter.arm.com/help/topic/com.arm.doc.ddi0314h/DDI0314H_coresight_components_trm.pdf || Connector:Tag-Connect_TC2050-IDC-NL_2x05_P1.27mm_Vertical || 1 ||
|-
| J6 || USB_C_Receptacle_USB2.0 || https://www.usb.org/sites/default/files/documents/usb_type-c.zip || Connector_USB:USB_C_Receptacle_HRO_TYPE-C-31-M-12 || 1 ||
|-
| J7 || Conn_01x22 || https://www.te.com/deu-de/product-2-1734839-2.html || Connector_FFC-FPC:TE_2-1734839-2_1x22-1MP_P0.5mm_Horizontal || 1 ||
|-
| J8 || Conn_01x39 || ~ || Connector_FFC-FPC:TE_3-1734839-9_1x39-1MP_P0.5mm_Horizontal || 1 ||
|-
| JP3 || SolderJumper || ~ || Jumper:SolderJumper-2_P1.3mm_Bridged_RoundedPad1.0x1.5mm || 1 ||
|-
| L1 || 2nH || ~ || Inductor_SMD:L_0603_1608Metric || 1 ||
|-
| L2 || 22uH || ~ || Inductor_SMD:L_Taiyo-Yuden_MD-4040 || 1 ||
|-
| MK1 || SPH0641LU4H-1 || https://www.knowles.com/docs/default-source/model-downloads/sph0641lu4h-1-revb.pdf || Sensor_Audio:Knowles_LGA-5_3.5x2.65mm || 1 ||
|-
| N1 || Housing || ~ || 1 || ||
|-
| Q1,Q3 || DMP3056L-7 || https://www.taiwansemi.com/products/datasheet/TSM2301A_C15.pdf || Package_TO_SOT_SMD:SOT-23 || 2 ||
|-
| Q2 || BC847 || http://www.infineon.com/dgdl/Infineon-BC847SERIES_BC848SERIES_BC849SERIES_BC850SERIES-DS-v01_01-en.pdf?fileId=db3a304314dca389011541d4630a1657 || Package_TO_SOT_SMD:SOT-23 || 1 ||
|-
| R1,R3,R5,R7,R13,R17,R18,R26,R27,R35 || 10K || ~ || Resistor_SMD:R_0805_2012Metric || 10 ||
|-
| R2,R21,R33 || 100 || ~ || Resistor_SMD:R_0805_2012Metric || 3 ||
|-
| R4,R12,R14,R15 || 4K7 || ~ || Resistor_SMD:R_0805_2012Metric || 4 ||
|-
| R6,R16,R36,R37 || 5K6 || ~ || Resistor_SMD:R_0805_2012Metric || 4 ||
|-
| R8 || 6K8 || ~ || Resistor_SMD:R_0805_2012Metric || 1 ||
|-
| R9 || 4.7 || ~ || Resistor_SMD:R_0805_2012Metric || 1 ||
|-
| R10,R11 || 3K9 || ~ || Resistor_SMD:R_0805_2012Metric || 2 ||
|-
| R19,R20 || 47 || ~ || Resistor_SMD:R_0805_2012Metric || 2 ||
|-
| R22 || 100K || ~ || Resistor_SMD:R_0805_2012Metric || 1 ||
|-
| R23 || 330 || ~ || Resistor_SMD:R_0805_2012Metric || 1 ||
|-
| R24,R25 || 5K1 || ~ || Resistor_SMD:R_0805_2012Metric || 2 ||
|-
| R28 || 2K2 || ~ || Resistor_SMD:R_0805_2012Metric || 1 ||
|-
| R29,R32,R34 || 0 || ~ || Resistor_SMD:R_0805_2012Metric || 3 ||
|-
| R30 || 39K2 || Resistor_SMD:R_0805_2012Metric || 1 || ||
|-
| R31 || 2K || Resistor_SMD:R_0805_2012Metric || 1 || ||
|-
| SF1 || Soldfeld || Mondev:SolderlittleArea_8 || 1 || ||
|-
| SW1 || SPST-Grau || ~ || Button_Switch_SMD:SW_SPST_PTS645 || 1 ||
|-
| SW2 || SPST-Red || ~ || Button_Switch_SMD:SW_SPST_PTS645 || 1 ||
|-
| SW3,SW4 || SPST-Noire || ~ || Button_Switch_SMD:SW_SPST_PTS645 || 2 ||
|-
| SW5 || SPST-Bleu || ~ || Button_Switch_SMD:SW_SPST_PTS810 || 1 ||
|-
| SW6 || SW_SPDT || ~ || Mondev:SW_SPDT_CK-JS102011SCQN || 1 ||
|-
| TP1,TP3,TP4,TP5,TP9,TP10,TP11,TP12,TP13,TP14,TP16,TP17,TP18,TP19,TP20,TP21,TP22,TP23,TP24,TP25 || TestPoint || ~ || -- mixed values -- || 20 ||
|-
| TP6,TP7,TP15 || Test || ~ || -- mixed values -- || 3 ||
|-
| U1 || ESP32-C3 || https://www.espressif.com/sites/default/files/documentation/esp32-c3_datasheet_en.pdf || Package_DFN_QFN:QFN-32-1EP_5x5mm_P0.5mm_EP3.45x3.45mm_ThermalVias || 1 ||
|-
| U2 || AP2112K-3.3 || https://www.diodes.com/assets/Datasheets/AP2112.pdf || Package_TO_SOT_SMD:SOT-23-5 || 1 ||
|-
| U3 || MCP73871 || http://www.mouser.com/ds/2/268/22090a-52174.pdf || Package_DFN_QFN:QFN-20-1EP_4x4mm_P0.5mm_EP2.5x2.5mm || 1 ||
|-
| U4 || MAX17048 || https://datasheets.maximintegrated.com/en/ds/MAX17048-MAX17049.pdf || Package_DFN_QFN:DFN-8-1EP_2x2mm_P0.5mm_EP0.7x1.3mm || 1 ||
|-
| U5 || 74LVC1G17 || https://assets.nexperia.com/documents/data-sheet/74LVC1G17.pdf || Package_TO_SOT_SMD:SOT-23-5 || 1 ||
|-
| U6,U13,U14 || ST25DV04K-JF || https://www.st.com/resource/en/datasheet/st25dv04k.pdf || Package_DFN_QFN:DFN-8-1EP_3x2mm_P0.5mm_EP1.3x1.5mm || 3 ||
|-
| U7 || Sensirion_SGP30 || https://sensirion.com/resource/datasheet/sgp30 || Mondev:Sensirion_SGP30 || 1 ||
|-
| U8 || 93CxxC || http://ww1.microchip.com/downloads/en/DeviceDoc/20001749K.pdf || Package_DFN_QFN:DFN-8-1EP_3x2mm_P0.5mm_EP1.3x1.5mm || 1 ||
|-
| U9 || PCF8574 || http://www.nxp.com/documents/data_sheet/PCF8574_PCF8574A.pdf || Package_DFN_QFN:VQFN-16-1EP_3x3mm_P0.5mm_EP1.6x1.6mm || 1 ||
|-
| U10 || MT3608 || Package_TO_SOT_SMD:SOT-23-6 || 1 || ||
|-
| U11 || ATECC608B || http://ww1.microchip.com/downloads/en/DeviceDoc/ATECC608A-CryptoAuthentication-Device-Summary-Data-Sheet-DS40001977B.pdf || Package_DFN_QFN:DFN-8-1EP_3x2mm_P0.5mm_EP1.3x1.5mm || 1 ||
|-
| U12 || SKYA21024 || https://www.skyworksinc.com/-/media/skyworks/documents/products/2701-2800/skya21024_204618c.pdf || Mondev:QFN-6-1x1mm_P0.5mm || 1 ||
|-
| Y1 || Crystal_GND24 || ~ || Crystal:Crystal_SMD_3225-4Pin_3.2x2.5mm || 1 ||
|-
| Y2 || Crystal || ~ || Crystal:Crystal_SMD_3215-2Pin_3.2x1.5mm || 1 ||
|}

== User Manual ==

The User Manual has a lot of useful information -- you can see the PDF [https://wiki.hope.net/images/6/6b/HOPE_XV_Electronic_Badge_User_Manual.pdf here]: 
[https://wiki.hope.net/images/6/6b/HOPE_XV_Electronic_Badge_User_Manual.pdf HOPE XV Electronic Badge User Manual] 
[[File:UsersManualStandardPage1.jpg|500px|center]] 
 
Here is the User Manual for the Pro model of the [https://wiki.hope.net/images/5/56/HOPE_XV_Electronic_Badge_Pro_User_Manual.pdf HOPE XV electronic badge]: 
[https://wiki.hope.net/images/5/56/HOPE_XV_Electronic_Badge_Pro_User_Manual.pdf HOPE XV Pro Model User Manual]
[[File:UsersManualPage1.jpg|500px|center]] 
 

= MicroPython =

[https://micropython.org/download/ESP32_GENERIC_C3/ MicroPython firmware] can be flashed on the badge to explore its features with an interactive Python console. When finished, you can [https://github.com/dhylands/rshell copy your code] to <code>/boot.py</code> to have it run each time it's powered on.

== Installation ==

'''Note''': this will erase [https://gitlab.com/tidklaas/hip-badge the HOPE firmware], so please obtain a copy if you'd like to flash it back.

# [https://docs.espressif.com/projects/esptool/en/latest/esp32/installation.html Install <code>esptool</code>]
# Download the MicroPython Firmware for ESP32-C3 from [https://micropython.org/download/ESP32_GENERIC_C3/]
# Flash the firmware:
<nowiki>esptool.py erase_flash
esptool.py write_flash --flash_mode=dio 0x0 ~/Downloads/ESP32_GENERIC_C3-20250415-v1.25.0.bin</nowiki>

''If no serial device is found, try holding down Button 4 (<code>SW2</code>) while switching on the badge to put it in "safe mode".''

When finished, make note of the serial port auto-detected by esptool.py (ex. <code>/dev/ttyACM0</code>). You should now be able to get a Python console with:

<nowiki>screen /dev/ttyACM0
>>> print('hello world')
hello world</nowiki>

''If you only see a blank screen, try pressing Enter and/or turning the badge off and back on again.''

For a better experience, and to copy files to the device, install [https://docs.micropython.org/en/latest/reference/mpremote.html mpremote].

To run the REPL:
<nowiki>mpremote</nowiki>

To run a local script:
<nowiki>mpremote run main.py</nowiki>

To make a script to run on restarts:
<nowiki>mpremote fs cp main.py :</nowiki>

== Snippets ==

Please see the [https://docs.micropython.org/en/latest/esp32/quickref.html Quick reference for the ESP32] for helpful snippets.

=== WiFi ===

WiFi works (please see [https://docs.micropython.org/en/latest/esp32/quickref.html#wlan this guide]), with one caveat: maybe my badge is faulty, but I had to reduce the transmit power level slightly to connect to an access point:

<nowiki>import network

wlan = network.WLAN(network.STA_IF)
wlan.active(True)

wlan.config(txpower = 14) # HACK: see note above

wlan.connect('my-ssid', 'my-key')
wlan.isconnected() # wait until True
wlan.ifconfig()
</nowiki>

=== LEDs ===

A NeoPixel library is available to work with the LED strip:

<nowiki>
import neopixel
from machine import Pin

pin = Pin(8, Pin.OUT)
neo = neopixel.NeoPixel(pin, 16)

# Draw a red gradient.
for i in range(16):
neo[i] = (i * 8, 0, 0)

# Update the strip.
neo.write()</nowiki>

=== Buttons ===
Example:

<nowiki>from machine import Pin

sw1_pin = Pin(10, Pin.IN, Pin.PULL_UP)
sw2_pin = Pin(9, Pin.IN, Pin.PULL_UP)

sw1_pin.value()
1
sw1_pin.value() # pressing SW1
0</nowiki>

2/4 buttons work, because buttons 1 (SW3) and 2 (SW4) are assigned to USB D+/D-, and the Micropython firmware for ESP32-C3 doesn't define them ([https://github.com/micropython/micropython/blob/master/ports/esp32/machine_pin.h source code]), resulting on an <code>invalid pin</code> error on usage (see [https://github.com/micropython/micropython/issues/12479]). A custom MicroPython firmware needs to be built to bypass the restriction (TODO, probably just need to define <code>MICROPY_HW_ENABLE_GPIO18</code> and <code>MICROPY_HW_ENABLE_GPIO19</code>).

Getting Started With ESPHome Workshop

2025-08-13T02:25:29Z

Fortuna: /* Day / Time / Location */

= Getting Started With ESPHome: From Zero to Cool workshop =

== Abstract ==

This hands-on workshop introduces participants to ESPHome, an open-source platform for integrating ESP32 microcontrollers with home automation systems. Participants will learn the fundamentals of configuring ESPHome YAML files to control inputs and outputs, connect to Wi-Fi, enable remote access, perform over-the-air (OTA) updates, integrate with Home Assistant, and add external sensors or components. Attendees will walk away with the knowledge to create their own simple IoT solutions using ESPHome. No programming or soldering skills are required, making this workshop highly accessible to beginners and anyone curious about home automation.

== Day / Time / Location ==

'''Date:''' Day 2, Saturday, 16-August-2025 
'''Time:''' 5:00pm - 6:30pm 
'''Location:''' Tobin 219 (Workshop A)

Schedule entry: https://schedule.hope.net/hope16/talk/T7XAL9/

== Full Description ==

== Registration -- NOT required ==

'''NOTE: You do NOT need to register to take this workshop -- please show up early to ensure a seat at Tobin 219 (Workshop A).''' 

== Presenter(s) ==

'''Vinicius Fortuna''' 
[https://www.viniciusfortuna.com Home Page] - [https://www.linkedin.com/in/vfortuna/ LinkedIn] - [https://mastodon.social/@vinifortuna Mastodon]

== Materials ==

You will need:

* A '''ESP32 development board''' that you will program.
* A '''laptop''', to program your board (with power cable as needed)
* A '''USB-C *data* cable''', to connect your laptop to the development board

No soldering or other equipment is needed.

20 [https://www.amazon.com/dp/B0DPSNVWB2/ref=sspa_dk_detail_3 ESP32-C3 Super Mini board] will be available for purchase at $5 each (cash, crypto, Venmo, Paypal accepted). You can borrow one for free if available, but preference will be given to those acquiring a board. You can use last year's [[HOPE XV Electronic Badge]], please bring it if you have one (it has a ESP32-C3 inside!).

I'll have 20 USB-C to USB-C data cables available to borrow if needed (please return them), but it's best if you bring your own. You must bring your own cable or an adaptor if your laptop USB is not Type C (usually Type A). '''Make sure it's a data cable.''' Your original phone charger cable will probably work.

If you do not have the materials needed, you can still spectate if there's extra space available. Preference will be given to those with the required materials.

== Required Software / What to bring ==

laptop with ESPHome and text editor (Visual Code Studio recommended) installed

<pre>
# Create and enter workspace folder
mkdir esphome
cd esphome

# Create and activate Python environment
python3 -m venv venv
source venv/bin/activate

# Install and check ESPHome tool
pip3 install esphome
esphome --version
</pre>

== Links ==

Getting Started With ESPHome Workshop

2025-08-13T02:25:03Z

Fortuna: Add schedule entry

= Getting Started With ESPHome: From Zero to Cool workshop =

== Abstract ==

This hands-on workshop introduces participants to ESPHome, an open-source platform for integrating ESP32 microcontrollers with home automation systems. Participants will learn the fundamentals of configuring ESPHome YAML files to control inputs and outputs, connect to Wi-Fi, enable remote access, perform over-the-air (OTA) updates, integrate with Home Assistant, and add external sensors or components. Attendees will walk away with the knowledge to create their own simple IoT solutions using ESPHome. No programming or soldering skills are required, making this workshop highly accessible to beginners and anyone curious about home automation.

== Day / Time / Location ==

'''Date:''' Day 2, Saturday, 16-August-2025 
'''Time:''' 5:00pm - 6:30pm 
'''Location:''' Tobin 219 (Workshop A)

Schedule entry: Schedule: https://schedule.hope.net/hope16/talk/T7XAL9/

== Full Description ==

== Registration -- NOT required ==

'''NOTE: You do NOT need to register to take this workshop -- please show up early to ensure a seat at Tobin 219 (Workshop A).''' 

== Presenter(s) ==

'''Vinicius Fortuna''' 
[https://www.viniciusfortuna.com Home Page] - [https://www.linkedin.com/in/vfortuna/ LinkedIn] - [https://mastodon.social/@vinifortuna Mastodon]

== Materials ==

You will need:

* A '''ESP32 development board''' that you will program.
* A '''laptop''', to program your board (with power cable as needed)
* A '''USB-C *data* cable''', to connect your laptop to the development board

No soldering or other equipment is needed.

20 [https://www.amazon.com/dp/B0DPSNVWB2/ref=sspa_dk_detail_3 ESP32-C3 Super Mini board] will be available for purchase at $5 each (cash, crypto, Venmo, Paypal accepted). You can borrow one for free if available, but preference will be given to those acquiring a board. You can use last year's [[HOPE XV Electronic Badge]], please bring it if you have one (it has a ESP32-C3 inside!).

I'll have 20 USB-C to USB-C data cables available to borrow if needed (please return them), but it's best if you bring your own. You must bring your own cable or an adaptor if your laptop USB is not Type C (usually Type A). '''Make sure it's a data cable.''' Your original phone charger cable will probably work.

If you do not have the materials needed, you can still spectate if there's extra space available. Preference will be given to those with the required materials.

== Required Software / What to bring ==

laptop with ESPHome and text editor (Visual Code Studio recommended) installed

<pre>
# Create and enter workspace folder
mkdir esphome
cd esphome

# Create and activate Python environment
python3 -m venv venv
source venv/bin/activate

# Install and check ESPHome tool
pip3 install esphome
esphome --version
</pre>

== Links ==

Getting Started With ESPHome Workshop

2025-08-10T19:02:51Z

Fortuna: Add Install instructions

= Getting Started With ESPHome: From Zero to Cool workshop =

== Abstract ==

This hands-on workshop introduces participants to ESPHome, an open-source platform for integrating ESP32 microcontrollers with home automation systems. Participants will learn the fundamentals of configuring ESPHome YAML files to control inputs and outputs, connect to Wi-Fi, enable remote access, perform over-the-air (OTA) updates, integrate with Home Assistant, and add external sensors or components. Attendees will walk away with the knowledge to create their own simple IoT solutions using ESPHome. No programming or soldering skills are required, making this workshop highly accessible to beginners and anyone curious about home automation.

== Day / Time / Location ==
'''Date:''' Day 2, Saturday, 16-August-2025 
'''Time:''' 5:00pm - 6:30pm 
'''Location:''' Tobin 219 (Workshop A)

== Full Description ==

== Registration -- NOT required ==

'''NOTE: You do NOT need to register to take this workshop -- please show up early to ensure a seat at Tobin 219 (Workshop A).''' 

== Presenter(s) ==

'''Vinicius Fortuna''' 
[https://www.viniciusfortuna.com Home Page] - [https://www.linkedin.com/in/vfortuna/ LinkedIn] - [https://mastodon.social/@vinifortuna Mastodon]

== Materials ==

You will need:

* A '''ESP32 development board''' that you will program.
* A '''laptop''', to program your board (with power cable as needed)
* A '''USB-C *data* cable''', to connect your laptop to the development board

No soldering or other equipment is needed.

20 [https://www.amazon.com/dp/B0DPSNVWB2/ref=sspa_dk_detail_3 ESP32-C3 Super Mini board] will be available for purchase at $5 each (cash, crypto, Venmo, Paypal accepted). You can borrow one for free if available, but preference will be given to those acquiring a board. You can use last year's [[HOPE XV Electronic Badge]], please bring it if you have one (it has a ESP32-C3 inside!).

I'll have 20 USB-C to USB-C data cables available to borrow if needed (please return them), but it's best if you bring your own. You must bring your own cable or an adaptor if your laptop USB is not Type C (usually Type A). '''Make sure it's a data cable.''' Your original phone charger cable will probably work.

If you do not have the materials needed, you can still spectate if there's extra space available. Preference will be given to those with the required materials.

== Required Software / What to bring ==

laptop with ESPHome and text editor (Visual Code Studio recommended) installed

<pre>
# Create and enter workspace folder
mkdir esphome
cd esphome

# Create and activate Python environment
python3 -m venv venv
source venv/bin/activate

# Install and check ESPHome tool
pip3 install esphome
esphome --version
</pre>

== Links ==

Getting Started With ESPHome Workshop

2025-08-07T04:52:51Z

Fortuna: /* Materials */

= Getting Started With ESPHome: From Zero to Cool workshop =

== Abstract ==

This hands-on workshop introduces participants to ESPHome, an open-source platform for integrating ESP32 microcontrollers with home automation systems. Participants will learn the fundamentals of configuring ESPHome YAML files to control inputs and outputs, connect to Wi-Fi, enable remote access, perform over-the-air (OTA) updates, integrate with Home Assistant, and add external sensors or components. Attendees will walk away with the knowledge to create their own simple IoT solutions using ESPHome. No programming or soldering skills are required, making this workshop highly accessible to beginners and anyone curious about home automation.

== Day / Time / Location ==
'''Date:''' Day 2, Saturday, 16-August-2025 
'''Time:''' 5:00pm - 6:30pm 
'''Location:''' Tobin 219 (Workshop A)

== Full Description ==

== Registration -- NOT required ==

'''NOTE: You do NOT need to register to take this workshop -- please show up early to ensure a seat at Tobin 219 (Workshop A).''' 

== Presenter(s) ==

'''Vinicius Fortuna''' 
[https://www.viniciusfortuna.com Home Page] - [https://www.linkedin.com/in/vfortuna/ LinkedIn] - [https://mastodon.social/@vinifortuna Mastodon]

== Materials ==

You will need:

* A '''ESP32 development board''' that you will program.
* A '''laptop''', to program your board (with power cable as needed)
* A '''USB-C *data* cable''', to connect your laptop to the development board

No soldering or other equipment is needed.

20 [https://www.amazon.com/dp/B0DPSNVWB2/ref=sspa_dk_detail_3 ESP32-C3 Super Mini board] will be available for purchase at $5 each (cash, crypto, Venmo, Paypal accepted). You can borrow one for free if available, but preference will be given to those acquiring a board. You can use last year's [[HOPE XV Electronic Badge]], please bring it if you have one (it has a ESP32-C3 inside!).

I'll have 20 USB-C to USB-C data cables available to borrow if needed (please return them), but it's best if you bring your own. You must bring your own cable or an adaptor if your laptop USB is not Type C (usually Type A). '''Make sure it's a data cable.''' Your original phone charger cable will probably work.

If you do not have the materials needed, you can still spectate if there's extra space available. Preference will be given to those with the required materials.

== Required Software / What to bring ==

laptop with ESPHome and text editor (Visual Code Studio recommended) installed

== Links ==

Getting Started With ESPHome Workshop

2025-08-07T04:49:49Z

Fortuna: Update Materials

= Getting Started With ESPHome: From Zero to Cool workshop =

== Abstract ==

This hands-on workshop introduces participants to ESPHome, an open-source platform for integrating ESP32 microcontrollers with home automation systems. Participants will learn the fundamentals of configuring ESPHome YAML files to control inputs and outputs, connect to Wi-Fi, enable remote access, perform over-the-air (OTA) updates, integrate with Home Assistant, and add external sensors or components. Attendees will walk away with the knowledge to create their own simple IoT solutions using ESPHome. No programming or soldering skills are required, making this workshop highly accessible to beginners and anyone curious about home automation.

== Day / Time / Location ==
'''Date:''' Day 2, Saturday, 16-August-2025 
'''Time:''' 5:00pm - 6:30pm 
'''Location:''' Tobin 219 (Workshop A)

== Full Description ==

== Registration -- NOT required ==

'''NOTE: You do NOT need to register to take this workshop -- please show up early to ensure a seat at Tobin 219 (Workshop A).''' 

== Presenter(s) ==

'''Vinicius Fortuna''' 
[https://www.viniciusfortuna.com Home Page] - [https://www.linkedin.com/in/vfortuna/ LinkedIn] - [https://mastodon.social/@vinifortuna Mastodon]

== Materials ==

You will need:

* A '''ESP32 development board''' that you will program.
* A '''laptop''', to program your board (with power cable as needed)
* A '''USB-C *data* cable''', to connect your laptop to the development board

No soldering or other equipment is needed.

20 [https://www.amazon.com/dp/B0DPSNVWB2/ref=sspa_dk_detail_3 ESP32-C3 Super Mini board] will be available for purchase at $5 each (cash, crypto, Venmo, Paypal accepted). You can borrow one for free if available, but preference will be given to those acquiring a board. You can use last year's [[HOPE XV Electronic Badge]], please bring it if you have one (it has a ESP32-C3 inside!).

I'll have 20 USB-C to USB-C data cables available to borrow if needed (please return them), but it's best if you bring your own. You must bring your own cable or an adaptor if your laptop USB is not Type C (usually Type A). '''Make sure it's a data cable.''' Your original phone charger cable will probably work.

== Required Software / What to bring ==

laptop with ESPHome and text editor (Visual Code Studio recommended) installed

== Links ==

Badge Village

2025-08-07T02:49:48Z

Fortuna: Add wiki link

= Badge Village =

== Location ==
Marillac Terrace 
 
 
== Description ==
Badge, badge, badge! Bring your badges old and new to the HOPE_16 Badge Village. This mystical space will serve as a gathering spot for folks to work on their [[HOPE_XV_Electronic_Badge|HOPE XV badge]] - or badges from any hacker con. Feel free to showcase the badge hacking you have implemented on your once basic builds and share your expertise with the group. From Human to Eldritch Master, come one, come all! Dust off ye ole badge that’s been waiting patiently to have all systems go since it can’t remember when. 
 
If you are the lucky owner of last year’s HOPE badge and haven’t yet begun the hacking process, the Badge Team has some recommendations to speed your ascension! If you want to develop in the way that the HOPE badge producers do, please install ESP-IDF for the ESP32-C3 and read “Get Started ESP-IDF” beforehand. And don’t forget to bring your computer and a USB-C cable that is capable of data transfer! 
 
Sadly, while there will not be a new production of the improved HOPE badge in time for the con to be shared with HOPE_16 attendees, it is anticipated some folks will be returning with their hackable HOPE XV badges. Much development work has occurred since last summer, and the Badge Team is looking for fresh minds to continue the effort. So bring it and get to hacking - because, as they say, it takes a village!
 
 
 

== Registration -- NOT required ==
'''You do not need to register in advance to visit the Badge Village -- please visit whenever you like.''': 
 
 
== More info: ==

Getting Started With ESPHome Workshop

2025-08-06T02:33:19Z

Fortuna: /* Day / Time / Location */

Getting Started With ESPHome Workshop

2025-08-06T02:30:29Z

Fortuna: Add personal links

HOPE XV Electronic Badge

2025-05-11T01:40:52Z

Fortuna: Clarify button number

[[File:HOPE_XV_electronic_badge_photo_front.jpg|thumb|500px|The HOPE XV Electronic Badge PCB (front)]] 
[[File:Hopexv-badge-back.jpg|thumb|500px|The HOPE XV Electronic Badge PCB (back)]] 

= Firmware =
<Must-still-be-uploaded> 
hopebadge-0.8.14.bin

= Badge Clinic =

Come by the Badge Clinic, and one of our specialized nurse practitioners will help you with all of your HOPE XV Electronic Badge needs. 
Come by for: 
* help with assembly
* to find out more about features
* to hack on the badge
* to volunteer to help others

= Description =

The HOPE XV badge was given to in-person HOPE attendees. Circuit boards are purple (attendee badge) and black (pro version with more components populated). Cases are pink, green, and black (pro version).

 Two 'pro' versions (with additional components) could be purchased at the Badge Clinic for $100 (extra components) and $150 (extra components and accessories).
 

== Features ==
The HOPE XV Electronic Badge has lots of cool features!
* Lots of colored blinky lights (16 WS2812 or similar)!
* ESP32-C3 microcontroller
* MCP73871 LiPo LiPo battery charge controller.
* Feature 2
* Feature 3
* Feature etc

== The Buttons ==
The firmware on the attendee Badge is setup for:
* button 1 - cycle thru light patterns
* button 2, 3 - dim/brighten LEDs
* button 4 - push to send an IR blast to other badges in Range, making their lights flash and motor vibrate

== Open Hardware ==
The HOPE XV Electronic Badge is totally [https://gitlab.com/tidklaas/hip-badge Open Hardware]! Use the vibration branch to pickup the code that runs the small vibration motor.
* The repository linked appears to be correct (REL_0.8.14), but does not specifically mention HOPE, so looking for confirmation.
It is also totally hackable.

=== BOM ===

This bill of materials is based on the KiCAD project. There are a number of components that are not populated on the badges distributed to attendees.

{| class="mw-collapsible mw-collapsed wikitable" ! colspan="6" | HOPE XV Badge Bill of Materials. &nbsp;
! Reference !! Value !! Datasheet !! Footprint !! Qty !! DNP
|-
| AE1 || Antenna_Loop || ~ || Mondev:NFCAntenna_65mm_north || 1 ||
|-
| AE2 || Antenna_Conn || ~ || Mondev:Molex_5051100492-1x04-P0.5mm_Horizontal || 1 ||
|-
| AE4 || Antenna || ~ || Connector_Coaxial:SMA_Samtec_SMA-J-P-X-ST-EM1_EdgeMount || 1 ||
|-
| BT1 || Battery_Cell || ~ || Connector_Molex:Molex_PicoBlade_53261-0371_1x03-1MP_P1.25mm_Horizontal || 1 ||
|-
| C1,C2 || 18pF || ~ || Capacitor_SMD:C_0805_2012Metric || 2 ||
|-
| C3,C31 || 10uF || ~ || Capacitor_SMD:C_0805_2012Metric || 2 ||
|-
| C4,C6,C11,C12,C14,C15,C16,C17,C18,C19,C20,C21,C22,C23,C24,C25,C26,C27,C28,C29,C30,C35,C38,C45,C47,C50,C52,C53,C56,C58,C61,C66 || 0.1uF || ~ || Capacitor_SMD:C_0805_2012Metric || 32 ||
|-
| C5,C7 || 15pF || ~ || Capacitor_SMD:C_0805_2012Metric || 2 ||
|-
| C8,C9,C13,C32,C33,C46,C59,C62 || 1uF || ~ || Capacitor_SMD:C_0805_2012Metric || 8 ||
|-
| C10,C63,C64,C65 || 0.01uF || ~ || Capacitor_SMD:C_0805_2012Metric || 4 ||
|-
| C34,C36,C49 || 4.7uF || ~ || Capacitor_SMD:C_0805_2012Metric || 3 ||
|-
| C37,C48,C51 || 22uF || -- mixed values -- || Capacitor_SMD:C_0805_2012Metric || 3 ||
|-
| C39,C42 || 47pF || ~ || Capacitor_SMD:C_0805_2012Metric || 2 ||
|-
| C40 || NC || ~ || Capacitor_SMD:C_0805_2012Metric || 1 ||
|-
| C41,C43 || 0,1uF || ~ || Capacitor_SMD:C_0805_2012Metric || 2 ||
|-
| C44,C57,C60 || 100pF || ~ || Capacitor_SMD:C_0805_2012Metric || 3 ||
|-
| C54,C55,L3 || TBD || ~ || -- mixed values -- || 3 ||
|-
| D1,D2,D3,D4,D5,D6,D7,D8,D9,D10,D11,D12,D13,D14,D15,D16 || WS2812B || https://cdn-shop.adafruit.com/datasheets/WS2812B.pdf || LED_SMD:LED_WS2812B_PLCC4_5.0x5.0mm_P3.2mm || 16 ||
|-
| D17,D18,D20,D21,D22,D26,D27,D28 || LED || ~ || -- mixed values -- || 8 ||
|-
| D19,D24,D25 || D_Schottky || -- mixed values -- || Diode_SMD:D_SOD-123 || 3 ||
|-
| D23 || IR17-21C || http://www.everlight.com/file/ProductFile/IR26-21C-L110-TR8.pdf || LED_SMD:LED_1206_3216Metric || 1 ||
|-
| FB1,FB2,FB3 || 742792042 || ~ || Inductor_SMD:L_0805_2012Metric || 3 ||
|-
| FID1,FID2,FID3,FID4,FID5,FID6,FID7,FID8 || Fiducial || ~ || Fiducial:Fiducial_1mm_Mask2mm || 8 ||
|-
| H1,H2,H3,H4 || MountingHole || ~ || MountingHole:MountingHole_3.2mm_M3 || 4 ||
|-
| IC1 || IRM-H6xxT || https://datasheet.lcsc.com/szlcsc/2010221806_Everlight-Elec-IRM-H638T-TR2-DX_C390031.pdf || Mondev:IRM-H6XXT || 1 ||
|-
| J1 || Conn_01x02 || ~ || Connector_Molex:Molex_PicoBlade_53261-0271_1x02-1MP_P1.25mm_Horizontal || 1 ||
|-
| J2 || Conn_01x04 || ~ || Connector_JST:JST_SH_SM04B-SRSS-TB_1x04-1MP_P1.00mm_Horizontal || 1 ||
|-
| J3,J4 || Conn_02x03 || ~ || Mondev:Badgelife-SAO-169 || 2 ||
|-
| J5 || Conn_ARM_JTAG_SWD_10 || http://infocenter.arm.com/help/topic/com.arm.doc.ddi0314h/DDI0314H_coresight_components_trm.pdf || Connector:Tag-Connect_TC2050-IDC-NL_2x05_P1.27mm_Vertical || 1 ||
|-
| J6 || USB_C_Receptacle_USB2.0 || https://www.usb.org/sites/default/files/documents/usb_type-c.zip || Connector_USB:USB_C_Receptacle_HRO_TYPE-C-31-M-12 || 1 ||
|-
| J7 || Conn_01x22 || https://www.te.com/deu-de/product-2-1734839-2.html || Connector_FFC-FPC:TE_2-1734839-2_1x22-1MP_P0.5mm_Horizontal || 1 ||
|-
| J8 || Conn_01x39 || ~ || Connector_FFC-FPC:TE_3-1734839-9_1x39-1MP_P0.5mm_Horizontal || 1 ||
|-
| JP3 || SolderJumper || ~ || Jumper:SolderJumper-2_P1.3mm_Bridged_RoundedPad1.0x1.5mm || 1 ||
|-
| L1 || 2nH || ~ || Inductor_SMD:L_0603_1608Metric || 1 ||
|-
| L2 || 22uH || ~ || Inductor_SMD:L_Taiyo-Yuden_MD-4040 || 1 ||
|-
| MK1 || SPH0641LU4H-1 || https://www.knowles.com/docs/default-source/model-downloads/sph0641lu4h-1-revb.pdf || Sensor_Audio:Knowles_LGA-5_3.5x2.65mm || 1 ||
|-
| N1 || Housing || ~ || 1 || ||
|-
| Q1,Q3 || DMP3056L-7 || https://www.taiwansemi.com/products/datasheet/TSM2301A_C15.pdf || Package_TO_SOT_SMD:SOT-23 || 2 ||
|-
| Q2 || BC847 || http://www.infineon.com/dgdl/Infineon-BC847SERIES_BC848SERIES_BC849SERIES_BC850SERIES-DS-v01_01-en.pdf?fileId=db3a304314dca389011541d4630a1657 || Package_TO_SOT_SMD:SOT-23 || 1 ||
|-
| R1,R3,R5,R7,R13,R17,R18,R26,R27,R35 || 10K || ~ || Resistor_SMD:R_0805_2012Metric || 10 ||
|-
| R2,R21,R33 || 100 || ~ || Resistor_SMD:R_0805_2012Metric || 3 ||
|-
| R4,R12,R14,R15 || 4K7 || ~ || Resistor_SMD:R_0805_2012Metric || 4 ||
|-
| R6,R16,R36,R37 || 5K6 || ~ || Resistor_SMD:R_0805_2012Metric || 4 ||
|-
| R8 || 6K8 || ~ || Resistor_SMD:R_0805_2012Metric || 1 ||
|-
| R9 || 4.7 || ~ || Resistor_SMD:R_0805_2012Metric || 1 ||
|-
| R10,R11 || 3K9 || ~ || Resistor_SMD:R_0805_2012Metric || 2 ||
|-
| R19,R20 || 47 || ~ || Resistor_SMD:R_0805_2012Metric || 2 ||
|-
| R22 || 100K || ~ || Resistor_SMD:R_0805_2012Metric || 1 ||
|-
| R23 || 330 || ~ || Resistor_SMD:R_0805_2012Metric || 1 ||
|-
| R24,R25 || 5K1 || ~ || Resistor_SMD:R_0805_2012Metric || 2 ||
|-
| R28 || 2K2 || ~ || Resistor_SMD:R_0805_2012Metric || 1 ||
|-
| R29,R32,R34 || 0 || ~ || Resistor_SMD:R_0805_2012Metric || 3 ||
|-
| R30 || 39K2 || Resistor_SMD:R_0805_2012Metric || 1 || ||
|-
| R31 || 2K || Resistor_SMD:R_0805_2012Metric || 1 || ||
|-
| SF1 || Soldfeld || Mondev:SolderlittleArea_8 || 1 || ||
|-
| SW1 || SPST-Grau || ~ || Button_Switch_SMD:SW_SPST_PTS645 || 1 ||
|-
| SW2 || SPST-Red || ~ || Button_Switch_SMD:SW_SPST_PTS645 || 1 ||
|-
| SW3,SW4 || SPST-Noire || ~ || Button_Switch_SMD:SW_SPST_PTS645 || 2 ||
|-
| SW5 || SPST-Bleu || ~ || Button_Switch_SMD:SW_SPST_PTS810 || 1 ||
|-
| SW6 || SW_SPDT || ~ || Mondev:SW_SPDT_CK-JS102011SCQN || 1 ||
|-
| TP1,TP3,TP4,TP5,TP9,TP10,TP11,TP12,TP13,TP14,TP16,TP17,TP18,TP19,TP20,TP21,TP22,TP23,TP24,TP25 || TestPoint || ~ || -- mixed values -- || 20 ||
|-
| TP6,TP7,TP15 || Test || ~ || -- mixed values -- || 3 ||
|-
| U1 || ESP32-C3 || https://www.espressif.com/sites/default/files/documentation/esp32-c3_datasheet_en.pdf || Package_DFN_QFN:QFN-32-1EP_5x5mm_P0.5mm_EP3.45x3.45mm_ThermalVias || 1 ||
|-
| U2 || AP2112K-3.3 || https://www.diodes.com/assets/Datasheets/AP2112.pdf || Package_TO_SOT_SMD:SOT-23-5 || 1 ||
|-
| U3 || MCP73871 || http://www.mouser.com/ds/2/268/22090a-52174.pdf || Package_DFN_QFN:QFN-20-1EP_4x4mm_P0.5mm_EP2.5x2.5mm || 1 ||
|-
| U4 || MAX17048 || https://datasheets.maximintegrated.com/en/ds/MAX17048-MAX17049.pdf || Package_DFN_QFN:DFN-8-1EP_2x2mm_P0.5mm_EP0.7x1.3mm || 1 ||
|-
| U5 || 74LVC1G17 || https://assets.nexperia.com/documents/data-sheet/74LVC1G17.pdf || Package_TO_SOT_SMD:SOT-23-5 || 1 ||
|-
| U6,U13,U14 || ST25DV04K-JF || https://www.st.com/resource/en/datasheet/st25dv04k.pdf || Package_DFN_QFN:DFN-8-1EP_3x2mm_P0.5mm_EP1.3x1.5mm || 3 ||
|-
| U7 || Sensirion_SGP30 || https://sensirion.com/resource/datasheet/sgp30 || Mondev:Sensirion_SGP30 || 1 ||
|-
| U8 || 93CxxC || http://ww1.microchip.com/downloads/en/DeviceDoc/20001749K.pdf || Package_DFN_QFN:DFN-8-1EP_3x2mm_P0.5mm_EP1.3x1.5mm || 1 ||
|-
| U9 || PCF8574 || http://www.nxp.com/documents/data_sheet/PCF8574_PCF8574A.pdf || Package_DFN_QFN:VQFN-16-1EP_3x3mm_P0.5mm_EP1.6x1.6mm || 1 ||
|-
| U10 || MT3608 || Package_TO_SOT_SMD:SOT-23-6 || 1 || ||
|-
| U11 || ATECC608B || http://ww1.microchip.com/downloads/en/DeviceDoc/ATECC608A-CryptoAuthentication-Device-Summary-Data-Sheet-DS40001977B.pdf || Package_DFN_QFN:DFN-8-1EP_3x2mm_P0.5mm_EP1.3x1.5mm || 1 ||
|-
| U12 || SKYA21024 || https://www.skyworksinc.com/-/media/skyworks/documents/products/2701-2800/skya21024_204618c.pdf || Mondev:QFN-6-1x1mm_P0.5mm || 1 ||
|-
| Y1 || Crystal_GND24 || ~ || Crystal:Crystal_SMD_3225-4Pin_3.2x2.5mm || 1 ||
|-
| Y2 || Crystal || ~ || Crystal:Crystal_SMD_3215-2Pin_3.2x1.5mm || 1 ||
|}

== User Manual ==

The User Manual has a lot of useful information -- you can see the PDF [https://wiki.hope.net/images/6/6b/HOPE_XV_Electronic_Badge_User_Manual.pdf here]: 
[https://wiki.hope.net/images/6/6b/HOPE_XV_Electronic_Badge_User_Manual.pdf HOPE XV Electronic Badge User Manual] 
[[File:UsersManualStandardPage1.jpg|500px|center]] 
 
Here is the User Manual for the Pro model of the [https://wiki.hope.net/images/5/56/HOPE_XV_Electronic_Badge_Pro_User_Manual.pdf HOPE XV electronic badge]: 
[https://wiki.hope.net/images/5/56/HOPE_XV_Electronic_Badge_Pro_User_Manual.pdf HOPE XV Pro Model User Manual]
[[File:UsersManualPage1.jpg|500px|center]] 
 

= MicroPython =

[https://micropython.org/download/ESP32_GENERIC_C3/ MicroPython firmware] can be flashed on the badge to explore its features with an interactive Python console. When finished, you can [https://github.com/dhylands/rshell copy your code] to <code>/boot.py</code> to have it run each time it's powered on.

== Installation ==

'''Note''': this will erase [https://gitlab.com/tidklaas/hip-badge the HOPE firmware], so please obtain a copy if you'd like to flash it back.

# [https://docs.espressif.com/projects/esptool/en/latest/esp32/installation.html Install <code>esptool</code>]
# Download the MicroPython Firmware for ESP32-C3 from [https://micropython.org/download/ESP32_GENERIC_C3/]
# Flash the firmware:
<nowiki>esptool.py erase_flash
esptool.py write_flash --flash_mode=dio 0x0 ~/Downloads/ESP32_GENERIC_C3-20250415-v1.25.0.bin</nowiki>

''If no serial device is found, try holding down Button 4 (<code>SW2</code>) while switching on the badge to put it in "safe mode".''

When finished, make note of the serial port auto-detected by esptool.py (ex. <code>/dev/ttyACM0</code>). You should now be able to get a Python console with:

<nowiki>screen /dev/ttyACM0
>>> print('hello world')
hello world</nowiki>

''If you only see a blank screen, try pressing Enter and/or turning the badge off and back on again.''

For a better experience, and to copy files to the device, install [https://docs.micropython.org/en/latest/reference/mpremote.html mpremote].

To run the REPL:
<nowiki>mpremote</nowiki>

To run a local script:
<nowiki>mpremote run main.py</nowiki>

To make a script to run on restarts:
<nowiki>mpremote fs cp main.py :</nowiki>

== Snippets ==

Please see the [https://docs.micropython.org/en/latest/esp32/quickref.html Quick reference for the ESP32] for helpful snippets.

=== WiFi ===

WiFi works (please see [https://docs.micropython.org/en/latest/esp32/quickref.html#wlan this guide]), with one caveat: maybe my badge is faulty, but I had to reduce the transmit power level slightly to connect to an access point:

<nowiki>import network

wlan = network.WLAN(network.STA_IF)
wlan.active(True)

wlan.config(txpower = 14) # HACK: see note above

wlan.connect('my-ssid', 'my-key')
wlan.isconnected() # wait until True
wlan.ifconfig()
</nowiki>

=== LEDs ===

A NeoPixel library is available to work with the LED strip:

<nowiki>
import neopixel
from machine import Pin

pin = Pin(8, Pin.OUT)
neo = neopixel.NeoPixel(pin, 16)

# Draw a red gradient.
for i in range(16):
neo[i] = (i * 8, 0, 0)

# Update the strip.
neo.write()</nowiki>

=== Buttons ===
Example:

<nowiki>from machine import Pin

sw1_pin = Pin(10, Pin.IN, Pin.PULL_UP)
sw2_pin = Pin(9, Pin.IN, Pin.PULL_UP)

sw1_pin.value()
1
sw1_pin.value() # pressing SW1
0</nowiki>

2/4 buttons work, because buttons 1 (SW3) and 2 (SW4) are assigned to USB D+/D-, and the Micropython firmware for ESP32-C3 doesn't define them ([https://github.com/micropython/micropython/blob/master/ports/esp32/machine_pin.h source code]), resulting on an <code>invalid pin</code> error on usage (see [https://github.com/micropython/micropython/issues/12479]). A custom MicroPython firmware needs to be built to bypass the restriction (TODO, probably just need to define <code>MICROPY_HW_ENABLE_GPIO18</code> and <code>MICROPY_HW_ENABLE_GPIO19</code>).

HOPE XV Electronic Badge

2025-04-22T03:37:07Z

Fortuna: Update MicroPython information with pin information and mpremote

[[File:HOPE_XV_electronic_badge_photo_front.jpg|thumb|500px|The HOPE XV Electronic Badge PCB (front)]] 
[[File:Hopexv-badge-back.jpg|thumb|500px|The HOPE XV Electronic Badge PCB (back)]] 

= Firmware =
<Must-still-be-uploaded> 
hopebadge-0.8.14.bin

= Badge Clinic =

Come by the Badge Clinic, and one of our specialized nurse practitioners will help you with all of your HOPE XV Electronic Badge needs. 
Come by for: 
* help with assembly
* to find out more about features
* to hack on the badge
* to volunteer to help others

= Description =

The HOPE XV badge was given to in-person HOPE attendees. Circuit boards are purple (attendee badge) and black (pro version with more components populated). Cases are pink, green, and black (pro version).

 Two 'pro' versions (with additional components) could be purchased at the Badge Clinic for $100 (extra components) and $150 (extra components and accessories).
 

== Features ==
The HOPE XV Electronic Badge has lots of cool features!
* Lots of colored blinky lights (16 WS2812 or similar)!
* ESP32-C3 microcontroller
* MCP73871 LiPo LiPo battery charge controller.
* Feature 2
* Feature 3
* Feature etc

== The Buttons ==
The firmware on the attendee Badge is setup for:
* button 1 - cycle thru light patterns
* button 2, 3 - dim/brighten LEDs
* button 4 - push to send an IR blast to other badges in Range, making their lights flash and motor vibrate

== Open Hardware ==
The HOPE XV Electronic Badge is totally [https://gitlab.com/tidklaas/hip-badge Open Hardware]! Use the vibration branch to pickup the code that runs the small vibration motor.
* The repository linked appears to be correct (REL_0.8.14), but does not specifically mention HOPE, so looking for confirmation.
It is also totally hackable.

=== BOM ===

This bill of materials is based on the KiCAD project. There are a number of components that are not populated on the badges distributed to attendees.

{| class="mw-collapsible mw-collapsed wikitable" ! colspan="6" | HOPE XV Badge Bill of Materials. &nbsp;
! Reference !! Value !! Datasheet !! Footprint !! Qty !! DNP
|-
| AE1 || Antenna_Loop || ~ || Mondev:NFCAntenna_65mm_north || 1 ||
|-
| AE2 || Antenna_Conn || ~ || Mondev:Molex_5051100492-1x04-P0.5mm_Horizontal || 1 ||
|-
| AE4 || Antenna || ~ || Connector_Coaxial:SMA_Samtec_SMA-J-P-X-ST-EM1_EdgeMount || 1 ||
|-
| BT1 || Battery_Cell || ~ || Connector_Molex:Molex_PicoBlade_53261-0371_1x03-1MP_P1.25mm_Horizontal || 1 ||
|-
| C1,C2 || 18pF || ~ || Capacitor_SMD:C_0805_2012Metric || 2 ||
|-
| C3,C31 || 10uF || ~ || Capacitor_SMD:C_0805_2012Metric || 2 ||
|-
| C4,C6,C11,C12,C14,C15,C16,C17,C18,C19,C20,C21,C22,C23,C24,C25,C26,C27,C28,C29,C30,C35,C38,C45,C47,C50,C52,C53,C56,C58,C61,C66 || 0.1uF || ~ || Capacitor_SMD:C_0805_2012Metric || 32 ||
|-
| C5,C7 || 15pF || ~ || Capacitor_SMD:C_0805_2012Metric || 2 ||
|-
| C8,C9,C13,C32,C33,C46,C59,C62 || 1uF || ~ || Capacitor_SMD:C_0805_2012Metric || 8 ||
|-
| C10,C63,C64,C65 || 0.01uF || ~ || Capacitor_SMD:C_0805_2012Metric || 4 ||
|-
| C34,C36,C49 || 4.7uF || ~ || Capacitor_SMD:C_0805_2012Metric || 3 ||
|-
| C37,C48,C51 || 22uF || -- mixed values -- || Capacitor_SMD:C_0805_2012Metric || 3 ||
|-
| C39,C42 || 47pF || ~ || Capacitor_SMD:C_0805_2012Metric || 2 ||
|-
| C40 || NC || ~ || Capacitor_SMD:C_0805_2012Metric || 1 ||
|-
| C41,C43 || 0,1uF || ~ || Capacitor_SMD:C_0805_2012Metric || 2 ||
|-
| C44,C57,C60 || 100pF || ~ || Capacitor_SMD:C_0805_2012Metric || 3 ||
|-
| C54,C55,L3 || TBD || ~ || -- mixed values -- || 3 ||
|-
| D1,D2,D3,D4,D5,D6,D7,D8,D9,D10,D11,D12,D13,D14,D15,D16 || WS2812B || https://cdn-shop.adafruit.com/datasheets/WS2812B.pdf || LED_SMD:LED_WS2812B_PLCC4_5.0x5.0mm_P3.2mm || 16 ||
|-
| D17,D18,D20,D21,D22,D26,D27,D28 || LED || ~ || -- mixed values -- || 8 ||
|-
| D19,D24,D25 || D_Schottky || -- mixed values -- || Diode_SMD:D_SOD-123 || 3 ||
|-
| D23 || IR17-21C || http://www.everlight.com/file/ProductFile/IR26-21C-L110-TR8.pdf || LED_SMD:LED_1206_3216Metric || 1 ||
|-
| FB1,FB2,FB3 || 742792042 || ~ || Inductor_SMD:L_0805_2012Metric || 3 ||
|-
| FID1,FID2,FID3,FID4,FID5,FID6,FID7,FID8 || Fiducial || ~ || Fiducial:Fiducial_1mm_Mask2mm || 8 ||
|-
| H1,H2,H3,H4 || MountingHole || ~ || MountingHole:MountingHole_3.2mm_M3 || 4 ||
|-
| IC1 || IRM-H6xxT || https://datasheet.lcsc.com/szlcsc/2010221806_Everlight-Elec-IRM-H638T-TR2-DX_C390031.pdf || Mondev:IRM-H6XXT || 1 ||
|-
| J1 || Conn_01x02 || ~ || Connector_Molex:Molex_PicoBlade_53261-0271_1x02-1MP_P1.25mm_Horizontal || 1 ||
|-
| J2 || Conn_01x04 || ~ || Connector_JST:JST_SH_SM04B-SRSS-TB_1x04-1MP_P1.00mm_Horizontal || 1 ||
|-
| J3,J4 || Conn_02x03 || ~ || Mondev:Badgelife-SAO-169 || 2 ||
|-
| J5 || Conn_ARM_JTAG_SWD_10 || http://infocenter.arm.com/help/topic/com.arm.doc.ddi0314h/DDI0314H_coresight_components_trm.pdf || Connector:Tag-Connect_TC2050-IDC-NL_2x05_P1.27mm_Vertical || 1 ||
|-
| J6 || USB_C_Receptacle_USB2.0 || https://www.usb.org/sites/default/files/documents/usb_type-c.zip || Connector_USB:USB_C_Receptacle_HRO_TYPE-C-31-M-12 || 1 ||
|-
| J7 || Conn_01x22 || https://www.te.com/deu-de/product-2-1734839-2.html || Connector_FFC-FPC:TE_2-1734839-2_1x22-1MP_P0.5mm_Horizontal || 1 ||
|-
| J8 || Conn_01x39 || ~ || Connector_FFC-FPC:TE_3-1734839-9_1x39-1MP_P0.5mm_Horizontal || 1 ||
|-
| JP3 || SolderJumper || ~ || Jumper:SolderJumper-2_P1.3mm_Bridged_RoundedPad1.0x1.5mm || 1 ||
|-
| L1 || 2nH || ~ || Inductor_SMD:L_0603_1608Metric || 1 ||
|-
| L2 || 22uH || ~ || Inductor_SMD:L_Taiyo-Yuden_MD-4040 || 1 ||
|-
| MK1 || SPH0641LU4H-1 || https://www.knowles.com/docs/default-source/model-downloads/sph0641lu4h-1-revb.pdf || Sensor_Audio:Knowles_LGA-5_3.5x2.65mm || 1 ||
|-
| N1 || Housing || ~ || 1 || ||
|-
| Q1,Q3 || DMP3056L-7 || https://www.taiwansemi.com/products/datasheet/TSM2301A_C15.pdf || Package_TO_SOT_SMD:SOT-23 || 2 ||
|-
| Q2 || BC847 || http://www.infineon.com/dgdl/Infineon-BC847SERIES_BC848SERIES_BC849SERIES_BC850SERIES-DS-v01_01-en.pdf?fileId=db3a304314dca389011541d4630a1657 || Package_TO_SOT_SMD:SOT-23 || 1 ||
|-
| R1,R3,R5,R7,R13,R17,R18,R26,R27,R35 || 10K || ~ || Resistor_SMD:R_0805_2012Metric || 10 ||
|-
| R2,R21,R33 || 100 || ~ || Resistor_SMD:R_0805_2012Metric || 3 ||
|-
| R4,R12,R14,R15 || 4K7 || ~ || Resistor_SMD:R_0805_2012Metric || 4 ||
|-
| R6,R16,R36,R37 || 5K6 || ~ || Resistor_SMD:R_0805_2012Metric || 4 ||
|-
| R8 || 6K8 || ~ || Resistor_SMD:R_0805_2012Metric || 1 ||
|-
| R9 || 4.7 || ~ || Resistor_SMD:R_0805_2012Metric || 1 ||
|-
| R10,R11 || 3K9 || ~ || Resistor_SMD:R_0805_2012Metric || 2 ||
|-
| R19,R20 || 47 || ~ || Resistor_SMD:R_0805_2012Metric || 2 ||
|-
| R22 || 100K || ~ || Resistor_SMD:R_0805_2012Metric || 1 ||
|-
| R23 || 330 || ~ || Resistor_SMD:R_0805_2012Metric || 1 ||
|-
| R24,R25 || 5K1 || ~ || Resistor_SMD:R_0805_2012Metric || 2 ||
|-
| R28 || 2K2 || ~ || Resistor_SMD:R_0805_2012Metric || 1 ||
|-
| R29,R32,R34 || 0 || ~ || Resistor_SMD:R_0805_2012Metric || 3 ||
|-
| R30 || 39K2 || Resistor_SMD:R_0805_2012Metric || 1 || ||
|-
| R31 || 2K || Resistor_SMD:R_0805_2012Metric || 1 || ||
|-
| SF1 || Soldfeld || Mondev:SolderlittleArea_8 || 1 || ||
|-
| SW1 || SPST-Grau || ~ || Button_Switch_SMD:SW_SPST_PTS645 || 1 ||
|-
| SW2 || SPST-Red || ~ || Button_Switch_SMD:SW_SPST_PTS645 || 1 ||
|-
| SW3,SW4 || SPST-Noire || ~ || Button_Switch_SMD:SW_SPST_PTS645 || 2 ||
|-
| SW5 || SPST-Bleu || ~ || Button_Switch_SMD:SW_SPST_PTS810 || 1 ||
|-
| SW6 || SW_SPDT || ~ || Mondev:SW_SPDT_CK-JS102011SCQN || 1 ||
|-
| TP1,TP3,TP4,TP5,TP9,TP10,TP11,TP12,TP13,TP14,TP16,TP17,TP18,TP19,TP20,TP21,TP22,TP23,TP24,TP25 || TestPoint || ~ || -- mixed values -- || 20 ||
|-
| TP6,TP7,TP15 || Test || ~ || -- mixed values -- || 3 ||
|-
| U1 || ESP32-C3 || https://www.espressif.com/sites/default/files/documentation/esp32-c3_datasheet_en.pdf || Package_DFN_QFN:QFN-32-1EP_5x5mm_P0.5mm_EP3.45x3.45mm_ThermalVias || 1 ||
|-
| U2 || AP2112K-3.3 || https://www.diodes.com/assets/Datasheets/AP2112.pdf || Package_TO_SOT_SMD:SOT-23-5 || 1 ||
|-
| U3 || MCP73871 || http://www.mouser.com/ds/2/268/22090a-52174.pdf || Package_DFN_QFN:QFN-20-1EP_4x4mm_P0.5mm_EP2.5x2.5mm || 1 ||
|-
| U4 || MAX17048 || https://datasheets.maximintegrated.com/en/ds/MAX17048-MAX17049.pdf || Package_DFN_QFN:DFN-8-1EP_2x2mm_P0.5mm_EP0.7x1.3mm || 1 ||
|-
| U5 || 74LVC1G17 || https://assets.nexperia.com/documents/data-sheet/74LVC1G17.pdf || Package_TO_SOT_SMD:SOT-23-5 || 1 ||
|-
| U6,U13,U14 || ST25DV04K-JF || https://www.st.com/resource/en/datasheet/st25dv04k.pdf || Package_DFN_QFN:DFN-8-1EP_3x2mm_P0.5mm_EP1.3x1.5mm || 3 ||
|-
| U7 || Sensirion_SGP30 || https://sensirion.com/resource/datasheet/sgp30 || Mondev:Sensirion_SGP30 || 1 ||
|-
| U8 || 93CxxC || http://ww1.microchip.com/downloads/en/DeviceDoc/20001749K.pdf || Package_DFN_QFN:DFN-8-1EP_3x2mm_P0.5mm_EP1.3x1.5mm || 1 ||
|-
| U9 || PCF8574 || http://www.nxp.com/documents/data_sheet/PCF8574_PCF8574A.pdf || Package_DFN_QFN:VQFN-16-1EP_3x3mm_P0.5mm_EP1.6x1.6mm || 1 ||
|-
| U10 || MT3608 || Package_TO_SOT_SMD:SOT-23-6 || 1 || ||
|-
| U11 || ATECC608B || http://ww1.microchip.com/downloads/en/DeviceDoc/ATECC608A-CryptoAuthentication-Device-Summary-Data-Sheet-DS40001977B.pdf || Package_DFN_QFN:DFN-8-1EP_3x2mm_P0.5mm_EP1.3x1.5mm || 1 ||
|-
| U12 || SKYA21024 || https://www.skyworksinc.com/-/media/skyworks/documents/products/2701-2800/skya21024_204618c.pdf || Mondev:QFN-6-1x1mm_P0.5mm || 1 ||
|-
| Y1 || Crystal_GND24 || ~ || Crystal:Crystal_SMD_3225-4Pin_3.2x2.5mm || 1 ||
|-
| Y2 || Crystal || ~ || Crystal:Crystal_SMD_3215-2Pin_3.2x1.5mm || 1 ||
|}

== User Manual ==

The User Manual has a lot of useful information -- you can see the PDF [https://wiki.hope.net/images/6/6b/HOPE_XV_Electronic_Badge_User_Manual.pdf here]: 
[https://wiki.hope.net/images/6/6b/HOPE_XV_Electronic_Badge_User_Manual.pdf HOPE XV Electronic Badge User Manual] 
[[File:UsersManualStandardPage1.jpg|500px|center]] 
 
Here is the User Manual for the Pro model of the [https://wiki.hope.net/images/5/56/HOPE_XV_Electronic_Badge_Pro_User_Manual.pdf HOPE XV electronic badge]: 
[https://wiki.hope.net/images/5/56/HOPE_XV_Electronic_Badge_Pro_User_Manual.pdf HOPE XV Pro Model User Manual]
[[File:UsersManualPage1.jpg|500px|center]] 
 

= MicroPython =

[https://micropython.org/download/ESP32_GENERIC_C3/ MicroPython firmware] can be flashed on the badge to explore its features with an interactive Python console. When finished, you can [https://github.com/dhylands/rshell copy your code] to <code>/boot.py</code> to have it run each time it's powered on.

== Installation ==

'''Note''': this will erase [https://gitlab.com/tidklaas/hip-badge the HOPE firmware], so please obtain a copy if you'd like to flash it back.

# [https://docs.espressif.com/projects/esptool/en/latest/esp32/installation.html Install <code>esptool</code>]
# Download the MicroPython Firmware for ESP32-C3 from [https://micropython.org/download/ESP32_GENERIC_C3/]
# Flash the firmware:
<nowiki>esptool.py erase_flash
esptool.py write_flash --flash_mode=dio 0x0 ~/Downloads/ESP32_GENERIC_C3-20250415-v1.25.0.bin</nowiki>

''If no serial device is found, try holding down the <code>SW2</code> button while switching on the badge to put it in "safe mode".''

When finished, make note of the serial port auto-detected by esptool.py (ex. <code>/dev/ttyACM0</code>). You should now be able to get a Python console with:

<nowiki>screen /dev/ttyACM0
>>> print('hello world')
hello world</nowiki>

''If you only see a blank screen, try pressing Enter and/or turning the badge off and back on again.''

For a better experience, and to copy files to the device, install [https://docs.micropython.org/en/latest/reference/mpremote.html mpremote].

To run the REPL:
<nowiki>mpremote</nowiki>

To run a local script:
<nowiki>mpremote run main.py</nowiki>

To make a script to run on restarts:
<nowiki>mpremote fs cp main.py :</nowiki>

== Snippets ==

Please see the [https://docs.micropython.org/en/latest/esp32/quickref.html Quick reference for the ESP32] for helpful snippets.

=== WiFi ===

WiFi works (please see [https://docs.micropython.org/en/latest/esp32/quickref.html#wlan this guide]), with one caveat: maybe my badge is faulty, but I had to reduce the transmit power level slightly to connect to an access point:

<nowiki>import network

wlan = network.WLAN(network.STA_IF)
wlan.active(True)

wlan.config(txpower = 14) # HACK: see note above

wlan.connect('my-ssid', 'my-key')
wlan.isconnected() # wait until True
wlan.ifconfig()
</nowiki>

=== LEDs ===

A NeoPixel library is available to work with the LED strip:

<nowiki>
import neopixel
from machine import Pin

pin = Pin(8, Pin.OUT)
neo = neopixel.NeoPixel(pin, 16)

# Draw a red gradient.
for i in range(16):
neo[i] = (i * 8, 0, 0)

# Update the strip.
neo.write()</nowiki>

=== Buttons ===
Example:

<nowiki>from machine import Pin

sw1_pin = Pin(10, Pin.IN, Pin.PULL_UP)
sw2_pin = Pin(9, Pin.IN, Pin.PULL_UP)

sw1_pin.value()
1
sw1_pin.value() # pressing SW1
0</nowiki>

2/4 buttons work, because buttons 1 (SW3) and 2 (SW4) are assigned to USB D+/D-, and the Micropython firmware for ESP32-C3 doesn't define them ([https://github.com/micropython/micropython/blob/master/ports/esp32/machine_pin.h source code]), resulting on an <code>invalid pin</code> error on usage (see [https://github.com/micropython/micropython/issues/12479]). A custom MicroPython firmware needs to be built to bypass the restriction (TODO, probably just need to define <code>MICROPY_HW_ENABLE_GPIO18</code> and <code>MICROPY_HW_ENABLE_GPIO19</code>).

HOPE XV Electronic Badge

2025-04-22T02:41:12Z

Fortuna: Clarify installation steps for MicroPython

[[File:HOPE_XV_electronic_badge_photo_front.jpg|thumb|500px|The HOPE XV Electronic Badge PCB (front)]] 
[[File:Hopexv-badge-back.jpg|thumb|500px|The HOPE XV Electronic Badge PCB (back)]] 

= Firmware =
<Must-still-be-uploaded> 
hopebadge-0.8.14.bin

= Badge Clinic =

Come by the Badge Clinic, and one of our specialized nurse practitioners will help you with all of your HOPE XV Electronic Badge needs. 
Come by for: 
* help with assembly
* to find out more about features
* to hack on the badge
* to volunteer to help others

= Description =

The HOPE XV badge was given to in-person HOPE attendees. Circuit boards are purple (attendee badge) and black (pro version with more components populated). Cases are pink, green, and black (pro version).

 Two 'pro' versions (with additional components) could be purchased at the Badge Clinic for $100 (extra components) and $150 (extra components and accessories).
 

== Features ==
The HOPE XV Electronic Badge has lots of cool features!
* Lots of colored blinky lights (16 WS2812 or similar)!
* ESP32-C3 microcontroller
* MCP73871 LiPo LiPo battery charge controller.
* Feature 2
* Feature 3
* Feature etc

== The Buttons ==
The firmware on the attendee Badge is setup for:
* button 1 - cycle thru light patterns
* button 2, 3 - dim/brighten LEDs
* button 4 - push to send an IR blast to other badges in Range, making their lights flash and motor vibrate

== Open Hardware ==
The HOPE XV Electronic Badge is totally [https://gitlab.com/tidklaas/hip-badge Open Hardware]! Use the vibration branch to pickup the code that runs the small vibration motor.
* The repository linked appears to be correct (REL_0.8.14), but does not specifically mention HOPE, so looking for confirmation.
It is also totally hackable.

=== BOM ===

This bill of materials is based on the KiCAD project. There are a number of components that are not populated on the badges distributed to attendees.

{| class="mw-collapsible mw-collapsed wikitable" ! colspan="6" | HOPE XV Badge Bill of Materials. &nbsp;
! Reference !! Value !! Datasheet !! Footprint !! Qty !! DNP
|-
| AE1 || Antenna_Loop || ~ || Mondev:NFCAntenna_65mm_north || 1 ||
|-
| AE2 || Antenna_Conn || ~ || Mondev:Molex_5051100492-1x04-P0.5mm_Horizontal || 1 ||
|-
| AE4 || Antenna || ~ || Connector_Coaxial:SMA_Samtec_SMA-J-P-X-ST-EM1_EdgeMount || 1 ||
|-
| BT1 || Battery_Cell || ~ || Connector_Molex:Molex_PicoBlade_53261-0371_1x03-1MP_P1.25mm_Horizontal || 1 ||
|-
| C1,C2 || 18pF || ~ || Capacitor_SMD:C_0805_2012Metric || 2 ||
|-
| C3,C31 || 10uF || ~ || Capacitor_SMD:C_0805_2012Metric || 2 ||
|-
| C4,C6,C11,C12,C14,C15,C16,C17,C18,C19,C20,C21,C22,C23,C24,C25,C26,C27,C28,C29,C30,C35,C38,C45,C47,C50,C52,C53,C56,C58,C61,C66 || 0.1uF || ~ || Capacitor_SMD:C_0805_2012Metric || 32 ||
|-
| C5,C7 || 15pF || ~ || Capacitor_SMD:C_0805_2012Metric || 2 ||
|-
| C8,C9,C13,C32,C33,C46,C59,C62 || 1uF || ~ || Capacitor_SMD:C_0805_2012Metric || 8 ||
|-
| C10,C63,C64,C65 || 0.01uF || ~ || Capacitor_SMD:C_0805_2012Metric || 4 ||
|-
| C34,C36,C49 || 4.7uF || ~ || Capacitor_SMD:C_0805_2012Metric || 3 ||
|-
| C37,C48,C51 || 22uF || -- mixed values -- || Capacitor_SMD:C_0805_2012Metric || 3 ||
|-
| C39,C42 || 47pF || ~ || Capacitor_SMD:C_0805_2012Metric || 2 ||
|-
| C40 || NC || ~ || Capacitor_SMD:C_0805_2012Metric || 1 ||
|-
| C41,C43 || 0,1uF || ~ || Capacitor_SMD:C_0805_2012Metric || 2 ||
|-
| C44,C57,C60 || 100pF || ~ || Capacitor_SMD:C_0805_2012Metric || 3 ||
|-
| C54,C55,L3 || TBD || ~ || -- mixed values -- || 3 ||
|-
| D1,D2,D3,D4,D5,D6,D7,D8,D9,D10,D11,D12,D13,D14,D15,D16 || WS2812B || https://cdn-shop.adafruit.com/datasheets/WS2812B.pdf || LED_SMD:LED_WS2812B_PLCC4_5.0x5.0mm_P3.2mm || 16 ||
|-
| D17,D18,D20,D21,D22,D26,D27,D28 || LED || ~ || -- mixed values -- || 8 ||
|-
| D19,D24,D25 || D_Schottky || -- mixed values -- || Diode_SMD:D_SOD-123 || 3 ||
|-
| D23 || IR17-21C || http://www.everlight.com/file/ProductFile/IR26-21C-L110-TR8.pdf || LED_SMD:LED_1206_3216Metric || 1 ||
|-
| FB1,FB2,FB3 || 742792042 || ~ || Inductor_SMD:L_0805_2012Metric || 3 ||
|-
| FID1,FID2,FID3,FID4,FID5,FID6,FID7,FID8 || Fiducial || ~ || Fiducial:Fiducial_1mm_Mask2mm || 8 ||
|-
| H1,H2,H3,H4 || MountingHole || ~ || MountingHole:MountingHole_3.2mm_M3 || 4 ||
|-
| IC1 || IRM-H6xxT || https://datasheet.lcsc.com/szlcsc/2010221806_Everlight-Elec-IRM-H638T-TR2-DX_C390031.pdf || Mondev:IRM-H6XXT || 1 ||
|-
| J1 || Conn_01x02 || ~ || Connector_Molex:Molex_PicoBlade_53261-0271_1x02-1MP_P1.25mm_Horizontal || 1 ||
|-
| J2 || Conn_01x04 || ~ || Connector_JST:JST_SH_SM04B-SRSS-TB_1x04-1MP_P1.00mm_Horizontal || 1 ||
|-
| J3,J4 || Conn_02x03 || ~ || Mondev:Badgelife-SAO-169 || 2 ||
|-
| J5 || Conn_ARM_JTAG_SWD_10 || http://infocenter.arm.com/help/topic/com.arm.doc.ddi0314h/DDI0314H_coresight_components_trm.pdf || Connector:Tag-Connect_TC2050-IDC-NL_2x05_P1.27mm_Vertical || 1 ||
|-
| J6 || USB_C_Receptacle_USB2.0 || https://www.usb.org/sites/default/files/documents/usb_type-c.zip || Connector_USB:USB_C_Receptacle_HRO_TYPE-C-31-M-12 || 1 ||
|-
| J7 || Conn_01x22 || https://www.te.com/deu-de/product-2-1734839-2.html || Connector_FFC-FPC:TE_2-1734839-2_1x22-1MP_P0.5mm_Horizontal || 1 ||
|-
| J8 || Conn_01x39 || ~ || Connector_FFC-FPC:TE_3-1734839-9_1x39-1MP_P0.5mm_Horizontal || 1 ||
|-
| JP3 || SolderJumper || ~ || Jumper:SolderJumper-2_P1.3mm_Bridged_RoundedPad1.0x1.5mm || 1 ||
|-
| L1 || 2nH || ~ || Inductor_SMD:L_0603_1608Metric || 1 ||
|-
| L2 || 22uH || ~ || Inductor_SMD:L_Taiyo-Yuden_MD-4040 || 1 ||
|-
| MK1 || SPH0641LU4H-1 || https://www.knowles.com/docs/default-source/model-downloads/sph0641lu4h-1-revb.pdf || Sensor_Audio:Knowles_LGA-5_3.5x2.65mm || 1 ||
|-
| N1 || Housing || ~ || 1 || ||
|-
| Q1,Q3 || DMP3056L-7 || https://www.taiwansemi.com/products/datasheet/TSM2301A_C15.pdf || Package_TO_SOT_SMD:SOT-23 || 2 ||
|-
| Q2 || BC847 || http://www.infineon.com/dgdl/Infineon-BC847SERIES_BC848SERIES_BC849SERIES_BC850SERIES-DS-v01_01-en.pdf?fileId=db3a304314dca389011541d4630a1657 || Package_TO_SOT_SMD:SOT-23 || 1 ||
|-
| R1,R3,R5,R7,R13,R17,R18,R26,R27,R35 || 10K || ~ || Resistor_SMD:R_0805_2012Metric || 10 ||
|-
| R2,R21,R33 || 100 || ~ || Resistor_SMD:R_0805_2012Metric || 3 ||
|-
| R4,R12,R14,R15 || 4K7 || ~ || Resistor_SMD:R_0805_2012Metric || 4 ||
|-
| R6,R16,R36,R37 || 5K6 || ~ || Resistor_SMD:R_0805_2012Metric || 4 ||
|-
| R8 || 6K8 || ~ || Resistor_SMD:R_0805_2012Metric || 1 ||
|-
| R9 || 4.7 || ~ || Resistor_SMD:R_0805_2012Metric || 1 ||
|-
| R10,R11 || 3K9 || ~ || Resistor_SMD:R_0805_2012Metric || 2 ||
|-
| R19,R20 || 47 || ~ || Resistor_SMD:R_0805_2012Metric || 2 ||
|-
| R22 || 100K || ~ || Resistor_SMD:R_0805_2012Metric || 1 ||
|-
| R23 || 330 || ~ || Resistor_SMD:R_0805_2012Metric || 1 ||
|-
| R24,R25 || 5K1 || ~ || Resistor_SMD:R_0805_2012Metric || 2 ||
|-
| R28 || 2K2 || ~ || Resistor_SMD:R_0805_2012Metric || 1 ||
|-
| R29,R32,R34 || 0 || ~ || Resistor_SMD:R_0805_2012Metric || 3 ||
|-
| R30 || 39K2 || Resistor_SMD:R_0805_2012Metric || 1 || ||
|-
| R31 || 2K || Resistor_SMD:R_0805_2012Metric || 1 || ||
|-
| SF1 || Soldfeld || Mondev:SolderlittleArea_8 || 1 || ||
|-
| SW1 || SPST-Grau || ~ || Button_Switch_SMD:SW_SPST_PTS645 || 1 ||
|-
| SW2 || SPST-Red || ~ || Button_Switch_SMD:SW_SPST_PTS645 || 1 ||
|-
| SW3,SW4 || SPST-Noire || ~ || Button_Switch_SMD:SW_SPST_PTS645 || 2 ||
|-
| SW5 || SPST-Bleu || ~ || Button_Switch_SMD:SW_SPST_PTS810 || 1 ||
|-
| SW6 || SW_SPDT || ~ || Mondev:SW_SPDT_CK-JS102011SCQN || 1 ||
|-
| TP1,TP3,TP4,TP5,TP9,TP10,TP11,TP12,TP13,TP14,TP16,TP17,TP18,TP19,TP20,TP21,TP22,TP23,TP24,TP25 || TestPoint || ~ || -- mixed values -- || 20 ||
|-
| TP6,TP7,TP15 || Test || ~ || -- mixed values -- || 3 ||
|-
| U1 || ESP32-C3 || https://www.espressif.com/sites/default/files/documentation/esp32-c3_datasheet_en.pdf || Package_DFN_QFN:QFN-32-1EP_5x5mm_P0.5mm_EP3.45x3.45mm_ThermalVias || 1 ||
|-
| U2 || AP2112K-3.3 || https://www.diodes.com/assets/Datasheets/AP2112.pdf || Package_TO_SOT_SMD:SOT-23-5 || 1 ||
|-
| U3 || MCP73871 || http://www.mouser.com/ds/2/268/22090a-52174.pdf || Package_DFN_QFN:QFN-20-1EP_4x4mm_P0.5mm_EP2.5x2.5mm || 1 ||
|-
| U4 || MAX17048 || https://datasheets.maximintegrated.com/en/ds/MAX17048-MAX17049.pdf || Package_DFN_QFN:DFN-8-1EP_2x2mm_P0.5mm_EP0.7x1.3mm || 1 ||
|-
| U5 || 74LVC1G17 || https://assets.nexperia.com/documents/data-sheet/74LVC1G17.pdf || Package_TO_SOT_SMD:SOT-23-5 || 1 ||
|-
| U6,U13,U14 || ST25DV04K-JF || https://www.st.com/resource/en/datasheet/st25dv04k.pdf || Package_DFN_QFN:DFN-8-1EP_3x2mm_P0.5mm_EP1.3x1.5mm || 3 ||
|-
| U7 || Sensirion_SGP30 || https://sensirion.com/resource/datasheet/sgp30 || Mondev:Sensirion_SGP30 || 1 ||
|-
| U8 || 93CxxC || http://ww1.microchip.com/downloads/en/DeviceDoc/20001749K.pdf || Package_DFN_QFN:DFN-8-1EP_3x2mm_P0.5mm_EP1.3x1.5mm || 1 ||
|-
| U9 || PCF8574 || http://www.nxp.com/documents/data_sheet/PCF8574_PCF8574A.pdf || Package_DFN_QFN:VQFN-16-1EP_3x3mm_P0.5mm_EP1.6x1.6mm || 1 ||
|-
| U10 || MT3608 || Package_TO_SOT_SMD:SOT-23-6 || 1 || ||
|-
| U11 || ATECC608B || http://ww1.microchip.com/downloads/en/DeviceDoc/ATECC608A-CryptoAuthentication-Device-Summary-Data-Sheet-DS40001977B.pdf || Package_DFN_QFN:DFN-8-1EP_3x2mm_P0.5mm_EP1.3x1.5mm || 1 ||
|-
| U12 || SKYA21024 || https://www.skyworksinc.com/-/media/skyworks/documents/products/2701-2800/skya21024_204618c.pdf || Mondev:QFN-6-1x1mm_P0.5mm || 1 ||
|-
| Y1 || Crystal_GND24 || ~ || Crystal:Crystal_SMD_3225-4Pin_3.2x2.5mm || 1 ||
|-
| Y2 || Crystal || ~ || Crystal:Crystal_SMD_3215-2Pin_3.2x1.5mm || 1 ||
|}

== User Manual ==

The User Manual has a lot of useful information -- you can see the PDF [https://wiki.hope.net/images/6/6b/HOPE_XV_Electronic_Badge_User_Manual.pdf here]: 
[https://wiki.hope.net/images/6/6b/HOPE_XV_Electronic_Badge_User_Manual.pdf HOPE XV Electronic Badge User Manual] 
[[File:UsersManualStandardPage1.jpg|500px|center]] 
 
Here is the User Manual for the Pro model of the [https://wiki.hope.net/images/5/56/HOPE_XV_Electronic_Badge_Pro_User_Manual.pdf HOPE XV electronic badge]: 
[https://wiki.hope.net/images/5/56/HOPE_XV_Electronic_Badge_Pro_User_Manual.pdf HOPE XV Pro Model User Manual]
[[File:UsersManualPage1.jpg|500px|center]] 
 

= MicroPython =

[https://micropython.org/download/ESP32_GENERIC_C3/ MicroPython firmware] can be flashed on the badge to explore its features with an interactive Python console. When finished, you can [https://github.com/dhylands/rshell copy your code] to <code>/boot.py</code> to have it run each time it's powered on.

== Installation ==

'''Note''': this will erase [https://gitlab.com/tidklaas/hip-badge the HOPE firmware], so please obtain a copy if you'd like to flash it back.

# [https://docs.espressif.com/projects/esptool/en/latest/esp32/installation.html Install <code>esptool</code>]
# Download the MicroPython Firmware for ESP32-C3 from [https://micropython.org/download/ESP32_GENERIC_C3/]
# Flash the firmware:
<nowiki>esptool.py erase_flash
esptool.py write_flash --flash_mode=dio 0x0 ~/Downloads/ESP32_GENERIC_C3-20250415-v1.25.0.bin</nowiki>

''If no serial device is found, try holding down the <code>SW2</code> button while switching on the badge to put it in "safe mode".''

When finished, make note of the serial port auto-detected by esptool.py (ex. <code>/dev/ttyACM0</code>). You should now be able to get a Python console with:

<nowiki>screen /dev/ttyACM0
>>> print('hello world')
hello world</nowiki>

''If you only see a blank screen, try pressing Enter and/or turning the badge off and back on again.''

== Snippets ==

Please see the [https://docs.micropython.org/en/latest/esp32/quickref.html Quick reference for the ESP32] for helpful snippets.

=== WiFi ===

WiFi works (please see [https://docs.micropython.org/en/latest/esp32/quickref.html#wlan this guide]), with one caveat: maybe my badge is faulty, but I had to reduce the transmit power level slightly to connect to an access point:

<nowiki>import network

wlan = network.WLAN(network.STA_IF)
wlan.active(True)

wlan.config(txpower = 14) # HACK: see note above

wlan.connect('my-ssid', 'my-key')
wlan.isconnected() # wait until True
wlan.ifconfig()
</nowiki>

=== LEDs ===

A NeoPixel library is available to work with the LED strip:

<nowiki>
import neopixel
from machine import Pin

pin = Pin(8, Pin.OUT)
neo = neopixel.NeoPixel(pin, 16)

# Draw a red gradient.
for i in range(16):
neo[i] = (i * 8, 0, 0)

# Update the strip.
neo.write()</nowiki>

=== Buttons ===

2/4 buttons work, perhaps [https://github.com/micropython/micropython/issues/12479 because of this]? Please update this if you discover a solution!

<nowiki>from machine import Pin

sw1_pin = Pin(10, Pin.IN, Pin.PULL_UP)
sw2_pin = Pin(9, Pin.IN, Pin.PULL_UP)

sw1_pin.value()
1
sw1_pin.value() # pressing SW1
0</nowiki>

HOPE XV Electronic Badge

2025-04-22T01:55:24Z

Fortuna: Add `--flash_mode=dio` to ensure it doesn't use qio flash mode.

[[File:HOPE_XV_electronic_badge_photo_front.jpg|thumb|500px|The HOPE XV Electronic Badge PCB (front)]] 
[[File:Hopexv-badge-back.jpg|thumb|500px|The HOPE XV Electronic Badge PCB (back)]] 

= Firmware =
<Must-still-be-uploaded> 
hopebadge-0.8.14.bin

= Badge Clinic =

Come by the Badge Clinic, and one of our specialized nurse practitioners will help you with all of your HOPE XV Electronic Badge needs. 
Come by for: 
* help with assembly
* to find out more about features
* to hack on the badge
* to volunteer to help others

= Description =

The HOPE XV badge was given to in-person HOPE attendees. Circuit boards are purple (attendee badge) and black (pro version with more components populated). Cases are pink, green, and black (pro version).

 Two 'pro' versions (with additional components) could be purchased at the Badge Clinic for $100 (extra components) and $150 (extra components and accessories).
 

== Features ==
The HOPE XV Electronic Badge has lots of cool features!
* Lots of colored blinky lights (16 WS2812 or similar)!
* ESP32-C3 microcontroller
* MCP73871 LiPo LiPo battery charge controller.
* Feature 2
* Feature 3
* Feature etc

== The Buttons ==
The firmware on the attendee Badge is setup for:
* button 1 - cycle thru light patterns
* button 2, 3 - dim/brighten LEDs
* button 4 - push to send an IR blast to other badges in Range, making their lights flash and motor vibrate

== Open Hardware ==
The HOPE XV Electronic Badge is totally [https://gitlab.com/tidklaas/hip-badge Open Hardware]! Use the vibration branch to pickup the code that runs the small vibration motor.
* The repository linked appears to be correct (REL_0.8.14), but does not specifically mention HOPE, so looking for confirmation.
It is also totally hackable.

=== BOM ===

This bill of materials is based on the KiCAD project. There are a number of components that are not populated on the badges distributed to attendees.

{| class="mw-collapsible mw-collapsed wikitable" ! colspan="6" | HOPE XV Badge Bill of Materials. &nbsp;
! Reference !! Value !! Datasheet !! Footprint !! Qty !! DNP
|-
| AE1 || Antenna_Loop || ~ || Mondev:NFCAntenna_65mm_north || 1 ||
|-
| AE2 || Antenna_Conn || ~ || Mondev:Molex_5051100492-1x04-P0.5mm_Horizontal || 1 ||
|-
| AE4 || Antenna || ~ || Connector_Coaxial:SMA_Samtec_SMA-J-P-X-ST-EM1_EdgeMount || 1 ||
|-
| BT1 || Battery_Cell || ~ || Connector_Molex:Molex_PicoBlade_53261-0371_1x03-1MP_P1.25mm_Horizontal || 1 ||
|-
| C1,C2 || 18pF || ~ || Capacitor_SMD:C_0805_2012Metric || 2 ||
|-
| C3,C31 || 10uF || ~ || Capacitor_SMD:C_0805_2012Metric || 2 ||
|-
| C4,C6,C11,C12,C14,C15,C16,C17,C18,C19,C20,C21,C22,C23,C24,C25,C26,C27,C28,C29,C30,C35,C38,C45,C47,C50,C52,C53,C56,C58,C61,C66 || 0.1uF || ~ || Capacitor_SMD:C_0805_2012Metric || 32 ||
|-
| C5,C7 || 15pF || ~ || Capacitor_SMD:C_0805_2012Metric || 2 ||
|-
| C8,C9,C13,C32,C33,C46,C59,C62 || 1uF || ~ || Capacitor_SMD:C_0805_2012Metric || 8 ||
|-
| C10,C63,C64,C65 || 0.01uF || ~ || Capacitor_SMD:C_0805_2012Metric || 4 ||
|-
| C34,C36,C49 || 4.7uF || ~ || Capacitor_SMD:C_0805_2012Metric || 3 ||
|-
| C37,C48,C51 || 22uF || -- mixed values -- || Capacitor_SMD:C_0805_2012Metric || 3 ||
|-
| C39,C42 || 47pF || ~ || Capacitor_SMD:C_0805_2012Metric || 2 ||
|-
| C40 || NC || ~ || Capacitor_SMD:C_0805_2012Metric || 1 ||
|-
| C41,C43 || 0,1uF || ~ || Capacitor_SMD:C_0805_2012Metric || 2 ||
|-
| C44,C57,C60 || 100pF || ~ || Capacitor_SMD:C_0805_2012Metric || 3 ||
|-
| C54,C55,L3 || TBD || ~ || -- mixed values -- || 3 ||
|-
| D1,D2,D3,D4,D5,D6,D7,D8,D9,D10,D11,D12,D13,D14,D15,D16 || WS2812B || https://cdn-shop.adafruit.com/datasheets/WS2812B.pdf || LED_SMD:LED_WS2812B_PLCC4_5.0x5.0mm_P3.2mm || 16 ||
|-
| D17,D18,D20,D21,D22,D26,D27,D28 || LED || ~ || -- mixed values -- || 8 ||
|-
| D19,D24,D25 || D_Schottky || -- mixed values -- || Diode_SMD:D_SOD-123 || 3 ||
|-
| D23 || IR17-21C || http://www.everlight.com/file/ProductFile/IR26-21C-L110-TR8.pdf || LED_SMD:LED_1206_3216Metric || 1 ||
|-
| FB1,FB2,FB3 || 742792042 || ~ || Inductor_SMD:L_0805_2012Metric || 3 ||
|-
| FID1,FID2,FID3,FID4,FID5,FID6,FID7,FID8 || Fiducial || ~ || Fiducial:Fiducial_1mm_Mask2mm || 8 ||
|-
| H1,H2,H3,H4 || MountingHole || ~ || MountingHole:MountingHole_3.2mm_M3 || 4 ||
|-
| IC1 || IRM-H6xxT || https://datasheet.lcsc.com/szlcsc/2010221806_Everlight-Elec-IRM-H638T-TR2-DX_C390031.pdf || Mondev:IRM-H6XXT || 1 ||
|-
| J1 || Conn_01x02 || ~ || Connector_Molex:Molex_PicoBlade_53261-0271_1x02-1MP_P1.25mm_Horizontal || 1 ||
|-
| J2 || Conn_01x04 || ~ || Connector_JST:JST_SH_SM04B-SRSS-TB_1x04-1MP_P1.00mm_Horizontal || 1 ||
|-
| J3,J4 || Conn_02x03 || ~ || Mondev:Badgelife-SAO-169 || 2 ||
|-
| J5 || Conn_ARM_JTAG_SWD_10 || http://infocenter.arm.com/help/topic/com.arm.doc.ddi0314h/DDI0314H_coresight_components_trm.pdf || Connector:Tag-Connect_TC2050-IDC-NL_2x05_P1.27mm_Vertical || 1 ||
|-
| J6 || USB_C_Receptacle_USB2.0 || https://www.usb.org/sites/default/files/documents/usb_type-c.zip || Connector_USB:USB_C_Receptacle_HRO_TYPE-C-31-M-12 || 1 ||
|-
| J7 || Conn_01x22 || https://www.te.com/deu-de/product-2-1734839-2.html || Connector_FFC-FPC:TE_2-1734839-2_1x22-1MP_P0.5mm_Horizontal || 1 ||
|-
| J8 || Conn_01x39 || ~ || Connector_FFC-FPC:TE_3-1734839-9_1x39-1MP_P0.5mm_Horizontal || 1 ||
|-
| JP3 || SolderJumper || ~ || Jumper:SolderJumper-2_P1.3mm_Bridged_RoundedPad1.0x1.5mm || 1 ||
|-
| L1 || 2nH || ~ || Inductor_SMD:L_0603_1608Metric || 1 ||
|-
| L2 || 22uH || ~ || Inductor_SMD:L_Taiyo-Yuden_MD-4040 || 1 ||
|-
| MK1 || SPH0641LU4H-1 || https://www.knowles.com/docs/default-source/model-downloads/sph0641lu4h-1-revb.pdf || Sensor_Audio:Knowles_LGA-5_3.5x2.65mm || 1 ||
|-
| N1 || Housing || ~ || 1 || ||
|-
| Q1,Q3 || DMP3056L-7 || https://www.taiwansemi.com/products/datasheet/TSM2301A_C15.pdf || Package_TO_SOT_SMD:SOT-23 || 2 ||
|-
| Q2 || BC847 || http://www.infineon.com/dgdl/Infineon-BC847SERIES_BC848SERIES_BC849SERIES_BC850SERIES-DS-v01_01-en.pdf?fileId=db3a304314dca389011541d4630a1657 || Package_TO_SOT_SMD:SOT-23 || 1 ||
|-
| R1,R3,R5,R7,R13,R17,R18,R26,R27,R35 || 10K || ~ || Resistor_SMD:R_0805_2012Metric || 10 ||
|-
| R2,R21,R33 || 100 || ~ || Resistor_SMD:R_0805_2012Metric || 3 ||
|-
| R4,R12,R14,R15 || 4K7 || ~ || Resistor_SMD:R_0805_2012Metric || 4 ||
|-
| R6,R16,R36,R37 || 5K6 || ~ || Resistor_SMD:R_0805_2012Metric || 4 ||
|-
| R8 || 6K8 || ~ || Resistor_SMD:R_0805_2012Metric || 1 ||
|-
| R9 || 4.7 || ~ || Resistor_SMD:R_0805_2012Metric || 1 ||
|-
| R10,R11 || 3K9 || ~ || Resistor_SMD:R_0805_2012Metric || 2 ||
|-
| R19,R20 || 47 || ~ || Resistor_SMD:R_0805_2012Metric || 2 ||
|-
| R22 || 100K || ~ || Resistor_SMD:R_0805_2012Metric || 1 ||
|-
| R23 || 330 || ~ || Resistor_SMD:R_0805_2012Metric || 1 ||
|-
| R24,R25 || 5K1 || ~ || Resistor_SMD:R_0805_2012Metric || 2 ||
|-
| R28 || 2K2 || ~ || Resistor_SMD:R_0805_2012Metric || 1 ||
|-
| R29,R32,R34 || 0 || ~ || Resistor_SMD:R_0805_2012Metric || 3 ||
|-
| R30 || 39K2 || Resistor_SMD:R_0805_2012Metric || 1 || ||
|-
| R31 || 2K || Resistor_SMD:R_0805_2012Metric || 1 || ||
|-
| SF1 || Soldfeld || Mondev:SolderlittleArea_8 || 1 || ||
|-
| SW1 || SPST-Grau || ~ || Button_Switch_SMD:SW_SPST_PTS645 || 1 ||
|-
| SW2 || SPST-Red || ~ || Button_Switch_SMD:SW_SPST_PTS645 || 1 ||
|-
| SW3,SW4 || SPST-Noire || ~ || Button_Switch_SMD:SW_SPST_PTS645 || 2 ||
|-
| SW5 || SPST-Bleu || ~ || Button_Switch_SMD:SW_SPST_PTS810 || 1 ||
|-
| SW6 || SW_SPDT || ~ || Mondev:SW_SPDT_CK-JS102011SCQN || 1 ||
|-
| TP1,TP3,TP4,TP5,TP9,TP10,TP11,TP12,TP13,TP14,TP16,TP17,TP18,TP19,TP20,TP21,TP22,TP23,TP24,TP25 || TestPoint || ~ || -- mixed values -- || 20 ||
|-
| TP6,TP7,TP15 || Test || ~ || -- mixed values -- || 3 ||
|-
| U1 || ESP32-C3 || https://www.espressif.com/sites/default/files/documentation/esp32-c3_datasheet_en.pdf || Package_DFN_QFN:QFN-32-1EP_5x5mm_P0.5mm_EP3.45x3.45mm_ThermalVias || 1 ||
|-
| U2 || AP2112K-3.3 || https://www.diodes.com/assets/Datasheets/AP2112.pdf || Package_TO_SOT_SMD:SOT-23-5 || 1 ||
|-
| U3 || MCP73871 || http://www.mouser.com/ds/2/268/22090a-52174.pdf || Package_DFN_QFN:QFN-20-1EP_4x4mm_P0.5mm_EP2.5x2.5mm || 1 ||
|-
| U4 || MAX17048 || https://datasheets.maximintegrated.com/en/ds/MAX17048-MAX17049.pdf || Package_DFN_QFN:DFN-8-1EP_2x2mm_P0.5mm_EP0.7x1.3mm || 1 ||
|-
| U5 || 74LVC1G17 || https://assets.nexperia.com/documents/data-sheet/74LVC1G17.pdf || Package_TO_SOT_SMD:SOT-23-5 || 1 ||
|-
| U6,U13,U14 || ST25DV04K-JF || https://www.st.com/resource/en/datasheet/st25dv04k.pdf || Package_DFN_QFN:DFN-8-1EP_3x2mm_P0.5mm_EP1.3x1.5mm || 3 ||
|-
| U7 || Sensirion_SGP30 || https://sensirion.com/resource/datasheet/sgp30 || Mondev:Sensirion_SGP30 || 1 ||
|-
| U8 || 93CxxC || http://ww1.microchip.com/downloads/en/DeviceDoc/20001749K.pdf || Package_DFN_QFN:DFN-8-1EP_3x2mm_P0.5mm_EP1.3x1.5mm || 1 ||
|-
| U9 || PCF8574 || http://www.nxp.com/documents/data_sheet/PCF8574_PCF8574A.pdf || Package_DFN_QFN:VQFN-16-1EP_3x3mm_P0.5mm_EP1.6x1.6mm || 1 ||
|-
| U10 || MT3608 || Package_TO_SOT_SMD:SOT-23-6 || 1 || ||
|-
| U11 || ATECC608B || http://ww1.microchip.com/downloads/en/DeviceDoc/ATECC608A-CryptoAuthentication-Device-Summary-Data-Sheet-DS40001977B.pdf || Package_DFN_QFN:DFN-8-1EP_3x2mm_P0.5mm_EP1.3x1.5mm || 1 ||
|-
| U12 || SKYA21024 || https://www.skyworksinc.com/-/media/skyworks/documents/products/2701-2800/skya21024_204618c.pdf || Mondev:QFN-6-1x1mm_P0.5mm || 1 ||
|-
| Y1 || Crystal_GND24 || ~ || Crystal:Crystal_SMD_3225-4Pin_3.2x2.5mm || 1 ||
|-
| Y2 || Crystal || ~ || Crystal:Crystal_SMD_3215-2Pin_3.2x1.5mm || 1 ||
|}

== User Manual ==

The User Manual has a lot of useful information -- you can see the PDF [https://wiki.hope.net/images/6/6b/HOPE_XV_Electronic_Badge_User_Manual.pdf here]: 
[https://wiki.hope.net/images/6/6b/HOPE_XV_Electronic_Badge_User_Manual.pdf HOPE XV Electronic Badge User Manual] 
[[File:UsersManualStandardPage1.jpg|500px|center]] 
 
Here is the User Manual for the Pro model of the [https://wiki.hope.net/images/5/56/HOPE_XV_Electronic_Badge_Pro_User_Manual.pdf HOPE XV electronic badge]: 
[https://wiki.hope.net/images/5/56/HOPE_XV_Electronic_Badge_Pro_User_Manual.pdf HOPE XV Pro Model User Manual]
[[File:UsersManualPage1.jpg|500px|center]] 
 

= MicroPython =

[https://micropython.org/download/ESP32_GENERIC_C3/ MicroPython firmware] can be flashed on the badge to explore its features with an interactive Python console. When finished, you can [https://github.com/dhylands/rshell copy your code] to <code>/boot.py</code> to have it run each time it's powered on.

== Installation ==

'''Note''': this will erase [https://gitlab.com/tidklaas/hip-badge the HOPE firmware], so please obtain a copy if you'd like to flash it back.

Using the [https://docs.espressif.com/projects/esptool/en/latest/esp32/installation.html esptool.py flasher utility]:

<nowiki>esptool.py erase_flash
esptool.py write_flash --flash_mode=dio 0x0 ~/Downloads/ESP32_GENERIC_C3-20240602-v1.23.0.bin</nowiki>

''If no serial device is found, try holding down the <code>SW2</code> button while switching on the badge to put it in "safe mode".''

When finished, make note of the serial port auto-detected by esptool.py (ex. <code>/dev/ttyACM0</code>). You should now be able to get a Python console with:

<nowiki>screen /dev/ttyACM0
>>> print('hello world')
hello world</nowiki>

''If you only see a blank screen, try pressing Enter and/or turning the badge off and back on again.''

== Snippets ==

Please see the [https://docs.micropython.org/en/latest/esp32/quickref.html Quick reference for the ESP32] for helpful snippets.

=== WiFi ===

WiFi works (please see [https://docs.micropython.org/en/latest/esp32/quickref.html#wlan this guide]), with one caveat: maybe my badge is faulty, but I had to reduce the transmit power level slightly to connect to an access point:

<nowiki>import network

wlan = network.WLAN(network.STA_IF)
wlan.active(True)

wlan.config(txpower = 14) # HACK: see note above

wlan.connect('my-ssid', 'my-key')
wlan.isconnected() # wait until True
wlan.ifconfig()
</nowiki>

=== LEDs ===

A NeoPixel library is available to work with the LED strip:

<nowiki>
import neopixel
from machine import Pin

pin = Pin(8, Pin.OUT)
neo = neopixel.NeoPixel(pin, 16)

# Draw a red gradient.
for i in range(16):
neo[i] = (i * 8, 0, 0)

# Update the strip.
neo.write()</nowiki>

=== Buttons ===

2/4 buttons work, perhaps [https://github.com/micropython/micropython/issues/12479 because of this]? Please update this if you discover a solution!

<nowiki>from machine import Pin

sw1_pin = Pin(10, Pin.IN, Pin.PULL_UP)
sw2_pin = Pin(9, Pin.IN, Pin.PULL_UP)

sw1_pin.value()
1
sw1_pin.value() # pressing SW1
0</nowiki>