• Models
  • Contests
  • Slicer
  • Login
  • Start Here
    thingiverse-iconprintables-iconcults3d-iconmakerworld-iconmyminifactory-icon

    3D GO

    3D ModelsContestsCollectionsSaved ModelsOn a mobile device?

3D GO

Privacy Policy
ESP-DeskDeck 3D Printer File Image 1
ESP-DeskDeck 3D Printer File Thumbnail 1

ESP-DeskDeck

frank_tech avatarfrank_tech

June 16, 2026

makerworld-icon
DescriptionCommentsTags

Description

 

ESP-DeskDeck è un'alternativa compatta e fai-da-te ai tastierini macro commerciali. Basato su un ESP32-C3 Mini, funge sia da display informativo ambientale che da tastierino macro wireless a 4 tasti. Recupera i dati meteo in tempo reale per una città configurata e li visualizza su uno schermo OLED, inviando al contempo comandi tramite la rete Wi-Fi locale a un PC host.

Il dispositivo è completamente configurabile tramite una moderna interfaccia web ospitata direttamente sull'ESP32.

Caratteristiche

  • Visualizzazione delle informazioni ambientali :
    • Recupera e visualizza dati meteorologici in tempo reale (temperatura, condizioni, vento, umidità, visibilità) dall'API gratuita Open-Meteo .
    • Consente di alternare la visualizzazione delle previsioni meteo e dell'ora corrente su uno schermo OLED da 128x32 pixel.
  • Pad macro wireless :
    • Dispone di quattro pulsanti fisici configurabili per eseguire diverse azioni sul PC.
    • Comunica con il computer host tramite Wi-Fi, eliminando la necessità di un cavo USB.
  • Configurazione tramite interfaccia web :
    • Ospita un server web autonomo per la configurazione.
    • Una dashboard meteo reattiva per visualizzare le condizioni attuali, con sfondi animati che si adattano al meteo (sole, pioggia, nuvole, neve, ecc.).
    • Una pagina "Configura Tasti" intuitiva per assegnare azioni diverse a ciascun pulsante.
  • Script di controllo per PC :
    • Uno script Python complementare che rileva automaticamente l'ESP-DeskDeck sulla rete locale.
    • Si mette in ascolto degli eventi di pressione dei pulsanti ed esegue i comandi configurati.
    • Supporta i controlli multimediali, le scorciatoie da tastiera e l'apertura di siti web.

Componenti hardware

  • Scheda ESP32-C3 Mini (o una scheda ESP32 simile, i pin potrebbero richiedere delle regolazioni)
  • Display OLED SSD1306 128x32 I2C
  • 4 pulsanti tattili
  • Breadboard e cavi Dupont

Configurazione e installazione

La procedura di configurazione prevede due fasi principali: il caricamento del firmware sull'ESP32 e l'esecuzione dello script di controllo sul PC.

1. Firmware ESP32

Prerequisiti

  • IDE di Arduino
  • Supporto per la scheda ESP32 nell'IDE di Arduino
  • Le seguenti librerie Arduino sono state installate tramite il Gestore librerie:
    • WebServer
    • HTTPClient
    • ArduinoJson
    • Adafruit GFX Library
    • Adafruit SSD1306

Cablaggio

Collega i componenti alla scheda ESP32 seguendo lo schema riportato di seguito:

ComponentePin ESP32
Display OLED SDAGPIO 8
Display OLED SCLGPIO 9
Pulsante 1GPIO 0
Pulsante 2GPIO 1
Pulsante 3GPIO 2
Pulsante 4GPIO 3

Nota: i pulsanti devono essere cablati in modo da collegare il pin GPIO a GND quando vengono premuti.

Lampeggiante

  1. Apri il ESP32_Meteo_C3_IP_Version9.inofile nell'IDE di Arduino.
  2. Modifica le credenziali Wi-Fi all'inizio del file in modo che corrispondano alla tua rete:

    const char* ssid_casa = "YOUR_WIFI_SSID"; const char* pass_casa = "YOUR_WIFI_PASSWORD";

     

  3. Seleziona la tua scheda ESP32-C3 dal Tools > Boardmenu.
  4. Selezionare la porta COM corretta.
  5. Carica lo sketch sulla tua scheda. Al primo avvio, il dispositivo si connetterà alla tua rete Wi-Fi e visualizzerà il suo indirizzo IP sullo schermo OLED.

2. Script di controllo PC

Lo script Python si mette in ascolto dei comandi provenienti dall'ESP32 e li esegue sul tuo computer.

Prerequisiti

  • Python 3.x
  • I seguenti pacchetti Python:

    pip install requests pyautogui keyboard

     

    Nota: su alcuni sistemi operativi, la keyboardlibreria potrebbe richiedere i privilegi di amministratore/root per funzionare correttamente.

Configurazione

  1. Apri il Esp controll.pyfile.
  2. Regola la IP_PREFIXvariabile in modo che corrisponda alla sottorete della tua rete locale. Ad esempio, se l'indirizzo IP del tuo computer è 192.168.1.50, cambia il prefisso in "192.168.1.".

    # ---------------- CONFIG ---------------- IP_PREFIX = "192.168.1." # ... # ----------------------------------------

     

  3. Esegui lo script dal tuo terminale:

    python "Esp controll.py"

     

    Lo script avvierà la scansione della rete alla ricerca dell'ESP-DeskDeck. Una volta trovato, visualizzerà l'indirizzo IP del dispositivo e inizierà ad ascoltare la pressione dei pulsanti.

Utilizzo

  1. Accensione : una volta acceso l'ESP32 e caricato il firmware, si connetterà alla rete Wi-Fi e visualizzerà il suo indirizzo IP. Se la connessione non riesce, creerà un punto di accesso denominato ESP32-Meteo-Config(password: 12345678) e il suo indirizzo IP sarà 192.168.4.1.
  2. Accesso all'interfaccia web : Aprire un browser web e accedere all'indirizzo IP visualizzato sul display OLED.
  3. Imposta la posizione : nella pagina principale, digita il nome di una città nella barra di ricerca e fai clic su "Cerca". Il dispositivo recupererà e visualizzerà le previsioni meteo per quella località.
  4. Configura i pulsanti : vai alla /tastipagina (ad esempio, http://192.168.1.123/tasti). Qui puoi assegnare un'azione a ciascuno dei quattro pulsanti.
    • Fai clic sulla scheda di configurazione di un pulsante per aprire il selettore delle azioni.
    • Seleziona un'azione e fai clic su "Salva".
    • Se sulla scheda compare un impulso verde quando si preme fisicamente un pulsante, significa che il dispositivo sta registrando correttamente la pressione.

Azioni disponibili

  • display_toggleConsente di alternare la visualizzazione dello schermo OLED tra meteo e ora.
  • media_play: Riproduci/Pausa il contenuto multimediale.
  • media_next: Prossima traccia.
  • media_prev: Traccia precedente.
  • media_vol_up: Alza il volume.
  • media_vol_down: Abbassa il volume.
  • media_mute: Disattiva l'audio.
  • ctrl_c: Copia (Ctrl+C).
  • ctrl_v: Incolla (Ctrl+V).
  • ctrl_zAnnulla (Ctrl+Z).
  • win_d: Mostra il desktop (Win+D).
  • screenshot: Scatta una schermata (Win+Shift+S).
  • open_site: Apre un URL specifico (richiede l'impostazione dell'URL nell'interfaccia web).
  1. Avvia il sistema : con lo Esp controll.pyscript in esecuzione sul tuo PC, ora puoi premere i pulsanti fisici sul DeskDeck per attivare le azioni configurate.

Licenza

Questo progetto è concesso in licenza secondo il Copyright . Per maggiori dettagli, consultare il file LICENSE .

 

 

Parti elettroniche:

  1.  https://www.temu.com/it/1pz-scheda-di--type-c-esp32-c3-scheda-di---esp32-scheda-di--esp32-g-605563341633079.html?_oak_mp_inf=ELfs956b2IkBGiBiOTg3Njc1ODc2M2M0MjZkOGZiODQ3YWE5ODk0MGMzMiDS%2B%2FL%2B7DM%3D&top_gallery_url=https%3A%2F%2Fimg.kwcdn.com%2Fproduct%2Falgo_framework%2FImageCm2InAlgo%2F449c3092-450b-11f1-9ee5-0a580aae0449.jpg&spec_gallery_id=39352329820&refer_page_sn=10009&freesia_scene=2&_oak_freesia_scene=2&_oak_rec_ext_1=MjQ3&_oak_gallery_order=1636351162%2C1469420290%2C1086439333%2C2002275905%2C1236186694&search_key=esp%2032&refer_page_el_sn=200049&ab_scene=1&enable_vqr=0&_x_ns_irclickid=W0j3v51wQxyZWfEUK5WbWVpyUkuTAOVfH26mW80&_x_ads_account=18350&_x_ads_id=1580294&_x_ns_iradname=Online%20Tracking%20Link&_x_ns_iradsize=&_x_ns_prodsku=&_x_ns_irmptype=mediapartner&_x_ns_sharedid=&_x_ns_ts=1781603805554&_x_ns_randint=9723299&_x_ns_adtype=ONLINE_TRACKING_LINK&_x_ns_irmpgroupname=%22lw%22&_x_ads_channel=impact&_x_ns_mp_value2=&_x_ns_mp_value3=&_x_ns_irmpname=WorthEPenny&_x_ns_irpid=5030767&_x_vst_scene=adg&_x_sessn_id=fmzgdmssu4&refer_page_name=search_result&refer_page_id=10009_1781603810912_a5zbsyqyxa (esp32-c3 mini)
  2. https://www.temu.com/it/5-50pcs--interruttore--ttp223--touch-autobloccante-non-bloccante-interruttori-capacitivi-monocanale-per----l8-g-601104901520167.html?_oak_mp_inf=EKf2gqG61ogBGiA2MDBkZjVmYjliOWE0ZDAzYTRkMWVlMjhkZjNkZTM5MiCBq%2Fz%2B7DM%3D&top_gallery_url=https%3A%2F%2Fimg.kwcdn.com%2Fproduct%2Fopen%2F6490c1002a3042ef80bdd7a43b4aa7f8-goods.jpeg&spec_gallery_id=26898004026&refer_page_sn=10009&freesia_scene=2&_oak_freesia_scene=2&_oak_rec_ext_1=MTE4&_oak_gallery_order=1605957270%2C937819776%2C1027753554%2C232500134%2C1234815949&search_key=touch%20sensor%20arduino&refer_page_el_sn=200049&ab_scene=1&enable_vqr=0&refer_page_name=search_result&refer_page_id=10009_1781603910225_8o2sawal7e&_x_sessn_id=fmzgdmssu4 (tasti touch)
  3. https://www.temu.com/it/4-moduli-display-oled-i2c-da-0-91-pollici-con-risoluzione-128x32-compatibili-con---esp32-e--forniti-con-4-spine-da-assemblare-g-601105786535335.html?_oak_mp_inf=EKf7g8e91ogBGiBiM2JiYWNhNjU1MDg0OTdhYmQ3MmMzZDkwZmM5YWU5ZiDNpP%2F%2B7DM%3D&top_gallery_url=https%3A%2F%2Fimg.kwcdn.com%2Fproduct%2Ffancy%2Ff6b3473f-ecee-48f0-9609-cbe89f0819ab.jpg&spec_gallery_id=30682277385&refer_page_sn=10009&freesia_scene=2&_oak_freesia_scene=2&_oak_rec_ext_1=ODc0&_oak_gallery_order=1006529700%2C831254459%2C1004178562%2C572292350%2C1339059715&search_key=schermo%20oled%20esp32&refer_page_el_sn=200049&ab_scene=1&enable_vqr=0&_x_sessn_id=fmzgdmssu4&refer_page_name=search_result&refer_page_id=10009_1781604012406_8tiibamkxs (schermo oled)
  4. saldatrice 
  5. stagno
  6. cavi

    7. https://github.com/Alessiosavi1/ESP-DeskDeck (programma e istruzioni)

     

License:

MakerWorld Exclusive License

Related Models

Self-Watering Planter (Small) preview image

Self-Watering Planter (Small)

parallelgoods profile image

parallelgoods

73,128

Under Desk Drawer preview image

Under Desk Drawer

Paul profile image

Paul

21,217

Sweeping 2-line name plate - customizable preview image

Sweeping 2-line name plate - customizable

Makkuro profile image

Makkuro

9,742

Modular Mounting System preview image

Modular Mounting System

HeyVye profile image

HeyVye

69,117

Catch-All Trays / Desk organizer preview image

Catch-All Trays / Desk organizer

HribaDesign profile image

HribaDesign

16,326

Custom Minecraft Name Plate preview image

Custom Minecraft Name Plate

Capyvara profile image

Capyvara

4,410

Digital Sundial preview image

Digital Sundial

Mojoptix profile image

Mojoptix

67,385

Underware - The Ultimate Cable Management Solution preview image

Underware - The Ultimate Cable Management Solution

Hands on Katie profile image

Hands on Katie

9,398