Skip to the content
2 layers18.2 × 24.2 mmThunberg, the printed circuit board in 3D

An infrared controller for Fuji and Mitsubishi climate control units. Visit thunberg.lumi.guide and select the room of the climate control unit you want to control under 'Room:'.

Size
18.2 × 24.2 mm
Copper layers
2
Thickness
1.6 mm
Parts
7
Nets
28
Pads
53
Tracks, vias
63, 3
Pours
1
Routed
Yes
KiCad
KiCad 6 (file 20211014)
Created
10 Nov 2022
Updated
21 Dec 2023

Overview

Thunberg is an open-source printed circuit board by LumiGuide, from the LumiGuide/Thunberg repository on GitHub. It is a 2-layer board of 18.2 × 24.2 mm with 7 parts on 28 nets, routed with 63 tracks and 3 vias.

It is built around the BSS214NW-TP. Its parts include 2 resistors, 2 connectors, 1 IC, 1 diode and 1 transistor.

Main components

1

README

README.md

THUNBERG CLIMATE CONTROL

An infrared controller for Fuji and Mitsubishi climate control units. Visit thunberg.lumi.guide and select the room of the climate control unit you want to control under 'Room:'. It will load the last settings that were sent to this unit using the website. Set the preferred temperature, mode, strenth and extra options under 'toppings'. Click 'Send' to send a signal with these settings to the climate control unit, or click 'Turn off' to turn the unit off. At the bottom of the page, you can click 'KILL ALL' to turn off all units in the rooms listed under 'Room:'. Every day between 19:00 and 19:15, all units will be turned off automatically.

Troubleshooting

  • No response from the climate control unit The Thunberg device works with an IR-LED, make sure there is nothing blocking the IR signal from the Thunberg device to the climate control unit. Make sure the IR-LED is pointing directly at the climate control unit.

If the LED on the back of the device is green, the device is connected to the internet. If this is not the case, unplug the device and plug it in again to reboot. It should automatically connect to the internet. If the wifi name and/or password has changed, you need to change this in the menuconfig and flash the device. (Open the menuconfig by navigating to the Thunberg folder and using the command idf.py menuconfig in your terminal. ESP-IDF should be installed and running for this.)

  • The webpage keeps loading If there's no room selected, the page will remain on the loading screen. As soon as you select a room, it will load the last settings that were sent to the climate control unit in this room. If there's a room selected, but the page keeps showing the loading screen, the website doesn't get a response from the device you selected. Check the internet connection of the device.

  • The webpage is offline The Master Device is offline. Unplug the device and plug it in again to reboot. It should automatically reconnect to the internet.

  • It's still not working Connect the device to your computer using the USB programmer and plug in the charger. With ESP-IDF running, type idf.py -p USB-PORT monitor in your terminal to see the data log.

HOW TO BUILD

Parts

Soldering

Shorten the legs of the IR LED to about 4mm. Solder the components on the PCB, using the thunberg.kicad_sch file for component names and thunberg.kicad_pcb for placement details. Take the plastic casing of the M5Stamp Pico and solder the PCB on top of the M5Stamp Pico.

Flash the device

Enter the WiFi settings in the menuconfig by navigating to the Thunberg folder and using the command idf.py menuconfig in your terminal (ESP-IDF should be installed and running for this) and go to Thunberg Climate Control. Set the WiFi name under WiFi SSID and the corresponding password under WiFi password.

You'll need as much static IP-addresses as devices. In spiffs_data/index.html, change the IP-addresses and corresponding room names if needed.

Connect the M5Stamp Pico to your laptop using the USB programmer and plug in the charger. Flash one device using the host-settings. You can open the menuconfig by using the command idf.py menuconfig in your terminal (ESP-IDF should be installed and running for this). Go to Thunberg Climate Control > Host website on this device and select Yes, host website. This one will be the Master Device. Select the right climate control brand under Select airco brand. Save and close the menuconfig and flash the device by using the command idf.py -p USB-PORT flash in your terminal.

Flash the other devices without hosting a website on them. You can change this setting by opening the menuconfig by using the command idf.py menuconfig in your terminal and change the setting Host website on this device to No, receive signals only and make sure to select the right climate control brand.

Run the program on every single device while monitoring it using idf.py -p USB-PORT monitor. In the terminal, you will be able to fetch its MAC-address in the line: wifi:mode : sta (MAC). In your router settings, link the MAC addresses of all devices to a static IP-address, and match these with the IP-addresses used in spiffs_data/index.html. Optional: Create a convenient URL for the IP-address of the Master Device.

How to use

Place the PCBs inside the cases and secure the lid with a screw. Mount the devices on the wall with the IR LED facing the climate control unit. The casing has some room for the IR LED to be adjusted. Power the devices with an USB-C charger. When the LED on the back of the device turns green, it is connected to the internet. Visit the IP-address of the Master Device. Here you can select the room of the climate control unit you want to control and the settings. 'Send' will send a signal to the selected climate control unit, ' Turn off' will turn this unit off. 'Kill all' will turn of all units in the rooms that are listed in the 'Room:' list on top of the page. At the bottom of the page you see the date & time of the GET request and the last NTP synchronisation. This data can be used to see if the time and date are up to date. This is important for the next feature: From monday to Friday, between 19:00 and 19:15, all units will be turned off automatically by sending a turn-off signal to every device.

OTA

/ota/new: To update the software, host a server with the compiled software in a .bin file. Place a POST request to the /ota/new URI of the IP-address of the device you want to update with the URL to the .bin file in the body. (You can use a program like Postman for this request.) The device will download the file and update the software. It will then restart and run the updated software. The old software is stored in another OTA slot in the Flash memory.

/ota/commit: After running and testing the new software, you either have to commit this version or go back to the old version. Without committing, the version will remain in status ESP_OTA_IMG_PENDING_VERIFY and it will not be possible to update the software to a newer version. Also, in case of a restart, it will automatically change the status of this version to ESP_OTA_IMG_ABORTED and therefor it will not run. To commit, place a POST request to the /ota/commit URI of the IP-address of the device you are updating.

/ota/rollback: If you wish to go back to the old software version, it is possible to change the status of this version to ESP_OTA_IMG_ABORTED and restart the device. This version will not run due to its status and the old version will be selected with the reboot. To roll back to the old version, place a POST request to the /ota/rollback URI of the device you were updating.

TO DO

It's not possible to update the HTML-file using OTA updates. A software update should be written to provide this function.

Parts

7
QtyValueFootprintReferences
1100 ohmResistor_SMD:R_0603_1608MetricR1
133.2 ohmResistor_SMD:R_0603_1608MetricR2
1BSS214NWPackage_TO_SOT_SMD:SOT-323_SC-70Q1
1Conn_02x03_Odd_Even_MountingPinConnector_PinHeader_1.00mm:PinHeader_2x03_P1.00mm_VerticalJ2
1LD271LED_THT:LED_D5.0mm_IRGreyD1
1Stamp_Picofa603e63f9aa0e06760f68fa7b63b726-43bf3e6480359f64eb3430bd220fdd2fb23b2790:StampPico_templateU1
1USB4110-GF-A_REVBUSB4110-GF-A_REVB:GCT_USB4110-GF-A_REVBJ1

Similar boards

  • 4 layers42.3 × 60.2 mmMicroSD Switch Reader, the printed circuit board in 3D

    MicroSD Switch Reader

    will127534/microSD-Switcher-Reader

    A simple USB3.0 uSD card reader with a SD card switch for SBCs

    81 parts25MIT
  • 4 layers150 × 50 mmQI Charger, the printed circuit board in 3D

    QI Charger

    drewsum/QI_Charger

    A DIY QI Wireless Phone Charger

    322 parts20
  • 8 layers100 × 100 mmThermal Camera, the printed circuit board in 3D

    Thermal Camera

    drewsum/Thermal_Camera

    DIY Thermal Camera

    559 parts19
  • 2 layers19.4 × 20.9 mmESC f051, the printed circuit board in 3D

    ESC f051

    fademike/Fly_ESC_with_stm32F051

    ESC for brushless motors.

    53 parts6
  • 2 layers54.3 × 59 mmNet bms GSMM, the printed circuit board in 3D

    Net bms GSMM

    Millisman/Quectel-BG95-LPWA-Module

    Quectel BG95 LPWA Module board with integrated GPS & GSM

    148 parts6Apache-2.0
  • 2 layers106.7 × 156.6 mmEnviro node, the printed circuit board in 3D

    Enviro node

    DPIclimate/enviro-node

    Agriculture node for SDI-12 (and other) sensors.

    190 parts4MIT
  • 2 layers111.2 × 122.7 mmUniversalNode, the printed circuit board in 3D

    UniversalNode

    DPIclimate/ag-node

    Automatic multi-weigh-station for measuring the live-weight of sheep in remote locations.

    83 parts2MIT

Questions

How big is the Thunberg PCB?

It measures 18.2 × 24.2 mm and has 2 copper layers, 1.6 mm thick.

What parts does the Thunberg use?

7 parts, built around the BSS214NW-TP. The full list of its parts is on this page, with links to each part's symbol and footprint where PCBKit's library has them.

Where can I download the Thunberg KiCad files?

From the LumiGuide/Thunberg repository on GitHub, at the commit this page was made from: the board is thunberg.kicad_pcb and its schematic thunberg.kicad_sch. PCBKit opens the board in the browser, with nothing to install.

Can I use the Thunberg design in my own project?

Its repository states no licence, so its author keeps all rights: ask LumiGuide before reusing the design.