Logiciel Arduino LILYGO T-Deck

Informazione di u produttu

Specificazioni:

• Nome di u produttu: T-Deck
• Versione: V1.0
• Data di liberazione: 2024.05
• Hardware: Modulu ESP32
• Software: Arduino

Istruzzioni per l'usu di u produttu

Introduzione

Questa guida hè pensata per aiutà l'utilizatori à stabilisce l'ambiente di sviluppu di software per l'applicazioni chì utilizanu l'hardware T-Deck.

• T-Deck
  U T-Deck hè una piattaforma hardware chì sustene u sviluppu di software per diverse applicazioni.
• Arduino
  Arduino hè u software utilizatu per a prugrammazione di u hardware T-Deck.
• Preparazione
  Prima di inizià, assicuratevi di avè i cumpunenti è l'arnesi necessarii pronti per a stallazione di l'ambiente.

Cuminciate
Segui l'istruzzioni furnite in questa guida per inizià a stallazione di l'ambiente di sviluppu di software.

Configurate
Configurate i paràmetri di u software basatu nantu à i vostri bisogni di u prugettu.

Cunnette
Stabbilisce a cunnessione trà u hardware T-Deck è u vostru sistema di sviluppu.

Pruva Demo
Eseguite una demo di prova per assicurà chì a configurazione di hardware è software funziona bè.

Caricate Sketch

Caricate u vostru sketch Arduino à u modulu ESP32 cù l'istruzzioni furnite.

1. Custruite è Flash
   Cumpilà u vostru codice Arduino è lampà à u modulu ESP32.
2. Monitor
   Monitorate l'output è u cumpurtamentu di u vostru sketch nantu à u hardware T-Deck.

Riferimentu di Command SSC
Riferite à e referenze di cumandamentu per operazioni specifiche relative à u hardware T-Deck.

op
Descrizzione di l'operazione 'op'.

FAQ (Domande Frequenti)

Chì duverebbe fà se u mo upload falla?
Se u vostru upload falla, verificate a cunnessione trà u vostru sistema di sviluppu è u hardware T-Deck. Assicuratevi chì tutti i paràmetri sò curretti è pruvate à carica di novu.

À propositu di Sta Guida

Stu documentu hè destinatu à aiutà l'utilizatori à stabilisce l'ambiente di sviluppu di software di basa per u sviluppu di l'applicazioni chì utilizanu hardware basatu in T-Deck. Attraversu un sèmplice example, stu documentu illustra cumu utilizà Arduino, cumpresu l'assistente di cunfigurazione basatu in menu, cumpilendu l'Arduino è u scaricamentu di u firmware à u modulu ESP32.

Note di rilascio 

Data	Versione	Note di liberazione
2024.05	V1.0	Prima liberazione.

Introduzione

T-Deck

• T-Deck hè un pianu di sviluppu. Pò travaglià indipindente.
• Hè custituitu da ESP32-S3 MCU chì sustene u protocolu di cumunicazione Wi-Fi + BLE è a scheda madre PCB.
• Stu pruduttu hà funzioni LCD è LoRa. LCD mudellu ST7789 LCD cù risoluzione 320 × 240. U chip LoRa hè SX1262.
• Per applicazioni chì varianu da e rete di sensori di bassa putenza à i travaglii più esigenti.
• À u core di stu modulu hè u chip ESP32S3.
• ESP32-S3 integra soluzioni Wi-Fi (banda 2.4 GHz) è Bluetooth 5.0 in un unicu chip, inseme cù core duali d'altu rendiment è assai altri periferiche versatili. ESP32 furnisce una piattaforma robusta è altamente integrata per risponde à e dumande cuntinue per un usu efficiente di l'energia, cuncepimentu compactu è sicurità.
• Xinyuan furnisce e risorse di hardware è software di basa chì permettenu à i sviluppatori di l'applicazioni di custruisce e so idee intornu à u hardware di a serie ESP32-S3. U quadru di sviluppu di software furnitu da Xinyuan hè destinatu à u sviluppu rapidu di l'applicazioni Internet-of-Things (IoT), cù Wi-Fi, Bluetooth, gestione flessibile di l'energia, è altre funzioni avanzate di u sistema.
• U fabricatore hè Shenzhen Xin Yuan Electronic Technology Co., Ltd.

Arduino
Un inseme di applicazioni multipiattaforma scritte in Java. L'IDE di u Software Arduino hè derivatu da a lingua di prugrammazione Processing è l'ambiente di sviluppu integratu di u prugramma Wiring. L'utilizatori ponu sviluppà applicazioni in Windows / Linux / MacOS basati in Arduino. Hè cunsigliatu à aduprà Windows 10. Windows OS hè statu usatu comu un example in stu documentu per scopi illustrativi.

Preparazione
Per sviluppà applicazioni per ESP32-S3 avete bisognu:

• PC carricu cù u sistema operatore Windows, Linux, o Mac
• Toolchain per custruisce l'Applicazione per ESP32-S3
• Arduino cuntene essenzialmente API per ESP32-S3 è scripts per operare Toolchain
• Driver di portu seriale CH9102
• A scheda ESP32-S3 stessu è un cable USB per cunnette à u PC

Cuminciate

Scaricate u software Arduino

U più veloce cumu installà u Software Arduino (IDE) nantu à e macchine Windows

Guida Quick Start
U webU situ furnisce un tutoriale di partenza rapida

• Windows:
  https://www.arduino.cc/en/Guide/Windows
• Linux:
  https://www.arduino.cc/en/Guide/Linux
• Mac OS X:
  https://www.arduino.cc/en/Guide/MacOSX

Passi di installazione per a piattaforma Windows Arduino

Installa u software Arduino

Configurate

Scaricate Git
Scaricate u pacchettu di installazione Git.exe

Cunfigurazione pre-custruita

• Cliccate nantu à l'icona Arduino, dopu cliccate destro è selezziunate "Apri cartulare induve"
• Selezziunà hardware ->
• Mouse ** Click right ** ->
• Cliccate Git Bash quì

Clonà un repository remoto

• mkdir espressif
• cd espressif
• git clone -recursive https://github.com/espressif/arduino-esp32.gitesp32

Cunnette

Ci site quasi. Per pudè cuntinuà più, cunnette a scheda ESP32-S3 à u PC, verificate sottu quale portu seriale hè visibile a scheda è verificate se a cumunicazione seriale funziona.

Pruva Demo

Selezziunà File>> Esample>>WiFi>>WiFiScan

Caricate Sketch

Selezziunà Board
Strumenti <

Caricà
Sketch << Caricate

Monitor seriale
Strumenti << Serial Monitor

Riferimentu di Command SSC

Eccu alcuni cumandamenti Wi-Fi cumuni per voi per pruvà u modulu.

op 

• Descrizzione
  i cumandamenti op sò usati per stabilisce è interrogà u modu Wi-Fi di u sistema.
• Example

  
  

• Parametru
  

  -Q	Interrogate u modu Wi-Fi.
  -S	Stabbilisce u modu Wi-Fi.
  wmode	Ci sò 3 modi Wi-Fi: • modu = 1: modu STA • modu = 2: modu AP • modu = 3: Modu STA + AP

sta

• Descrizzione
  I cumandamenti sta sò usati per scansà l'interfaccia di rete STA, cunnette o disconnect AP, è dumandate u statu di cunnessione di l'interfaccia di rete STA.
• Example

  
  

• Parametru
  

  -ssid	Scansate o cunnette i punti d'accessu cù u ssid.
  -b bssid	Scansate i Punti di Accessu cù u bssid.
  -n canale	Scannà u canali.
  -h	Mostra i risultati di scansione cù punti d'accessu ssid nascosti.
  -Q	Mostra stutus STA connect.
  -D	Disconnected with current Access Points.

ap

• Descrizzione
  I cumandamenti ap sò usati per stabilisce u paràmetru di l'interfaccia di rete AP.
• Example

  
  

• Parametru
  

  -S	Stabbilisce u modu AP.
  -ssid	Set AP ssid.
  -p password	Stabbilisce a password AP.
  -t encrypt	Impostate u modu di criptografia AP.
  -h	Nascondi ssid.
  -m max_sta	Stabilite e cunnessione AP max.
  -Q	Mostra i paràmetri AP.
  -L	Mostra l'indirizzu MAC è l'indirizzu IP di a stazione cunnessa.

mac

• Descrizzione
  i cumandamenti mac sò usati per dumandà l'indirizzu MAC di l'interfaccia di a reta.
• Example

  
  

• Parametru
  

  -Q	Mostra l'indirizzu MAC.
  -o modu	• modu = 1: indirizzu MAC in modu STA. • modu = 2: indirizzu MAC in modu AP.

dhcp

• Descrizzione
  I cumandamenti dhcp sò usati per attivà o disattivà u servitore / cliente dhcp.
• Example

  
  

• Parametru
  

  -S	Start DHCP (Client/Server).
  -E	Fine DHCP (Client/Server).
  -Q	mostra u statu DHCP.
  -o modu	• modu = 1 : cliente DHCP di l'interfaccia STA. • modu = 2 : servitore DHCP di l'interfaccia AP. • modu = 3 : tramindui.

ip

• Descrizzione
  I cumandamenti ip sò usati per stabilisce è dumandà l'indirizzu IP di l'interfaccia di a rete.
• Example

  
  

• Parametru
  

  -Q	Mostra l'indirizzu IP.
  -o modu	• modu = 1 : indirizzu IP di l'interfaccia STA. • modu = 2 : indirizzu IP di l'interfaccia AP. • modu = 3 : tramindui
  -S	Stabbilisce l'indirizzu IP.
  -i ip	indirizzu IP.
  -m maschera	Mascara di indirizzu di subnet.
  -g gateway	Gateway predeterminatu.

riavvia

• Descrizzione
  U cumandamentu di reboot hè utilizatu per reboot u bordu.
• Example

  

ram 
U cumandamentu ram hè utilizatu per dumandà a dimensione di u munzeddu restante in u sistema.
Example

Attenzione FCC

Qualchese Cambiamenti o mudificazioni chì ùn sò micca appruvati espressamente da a parte rispunsevuli di u cumplimentu puderanu annullà l'autorità di l'utilizatore per operà l'equipaggiu.
Stu dispusitivu hè conforme à a parte 15 di e regule FCC. U funziunamentu hè sottumessu à i seguenti dui cundizioni:

1. Stu dispusitivu ùn pò causari interferenza dannusu
2. stu dispusitivu deve accettà ogni interferenza ricevuta, cumpresi interferenza chì pò causà operazione indesiderata.

NOTA IMPORTANTE:
Nota: Stu equipamentu hè statu pruvatu è truvatu cum'è i limiti per un dispositivu digitale di Classe B, sottu a parte 15 di e Regule FCC. Questi limiti sò pensati per furnisce una prutezzione raghjone contr'à l'interferenza dannosa in una stallazione residenziale. Stu equipamentu genera, usa, è pò irradià energia di freccia radio è, se ùn hè micca stallatu è utilizatu da l'istruzzioni, pò causà interferenza dannosa à e cumunicazioni radio. Tuttavia, ùn ci hè micca guarantisci chì l'interferenza ùn accade micca in una stallazione particulare. Se l'apparecchiatura provoca interferenza dannosa à a ricezione di a radio o di a televisione, chì pò esse determinata spegnendu è accendendu l'equipaggiu, l'utilizatore hè incuraghjitu à pruvà à corregge l'interferenza cù una o più di e seguenti misure:

• Riorientate o rilocate l'antenna di ricezione.
• Aumentà a separazione trà l'equipaggiu è u ricevitore.
• Cunnette l'equipaggiu à una presa in un circuitu diversu da quellu à quale hè cunnessu u ricevitore.
• Cunsultate u rivenditore o un tecnicu espertu di radio/TV per aiutu.

Dichjarazione di l'esposizione à a radiazione FCC:
Stu equipamentu hè conforme à i limiti di esposizione à a radiazione FCC stabiliti per un ambiente senza cuntrollu.

Documenti / Risorse

Logiciel Arduino LILYGO T-Deck [pdfGuida di l'utente T-DECK, TDECK, 2ASYE-T-DECK, 2ASYETDECK, T-Deck Software Arduino, Software Arduino, Software

Referenze

• Manuale d'usu