Skip to content

Commit fd78a9f

Browse files
authored
Merge pull request solosky#235 from JostenSyon/main-it
added Italian Translation of notes (amiibo_db_link)
2 parents 0863d49 + 04b9f05 commit fd78a9f

22 files changed

+4851
-3486
lines changed

README.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -13,6 +13,7 @@
1313

1414
* [中文文档](docs/zh/README.md)
1515
* [English Documentation](docs/en/README.md)
16+
* [Italian Documentation](docs/it/README.md)
1617

1718
## Credits
1819

docs/it/01-Hardware.md

Lines changed: 33 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,33 @@
1+
# PCB
2+
L'hardware di pixl.js è sviluppato e mantenuto nel repository, puoi accedere alla versione più recente dell'hardware nella [sezione Hardware del repository GitHub.](https://github.com/solosky/pixl.js/tree/main/hw "Sezione Hardware del repository GitHub.")
3+
4+
hw/RevC è la versione più recente del PCB, si consiglia di utilizzarla.
5+
Puoi usare [Kicad 6](https://www.kicad.org/download/) per aprire e modificare i file del PCB e dello schema.
6+
7+
![PCB pixl.js](https://github.com/solosky/pixl.js/blob/main/assets/pixljs-pcb-revc.png)
8+
9+
# BOM
10+
* Il BOM è riassunto nel documento: [Guida all'acquisto dei materiali di RevC](01+1-RevC-bom)
11+
* La lista dei materiali in formato interattivo sono disponibili, puoi scaricarli da: [RevC InteractiveHtmlBom](docs/RevC-ibom.html)
12+
13+
# Immagini
14+
Alcune immagini dei dispositivi attuali sono:
15+
16+
![pixl.js 1](https://github.com/solosky/pixl.js/blob/main/assets/pixljs-3.jpg)
17+
![pixl.js 2](https://github.com/solosky/pixl.js/blob/main/assets/pixljs-4.jpg)
18+
![pixl.js 3](https://github.com/solosky/pixl.js/blob/main/assets/pixljs-5.jpg)
19+
20+
# Demo
21+
22+
[L'ultima versione dell'applicazione Emulatore Amiibo può generare UUID casuali permettendo letture illimitate di amiibo sul gioco! Questo video è un esempio](https://www.bilibili.com/video/BV1TD4y1t76A/)
23+
24+
# Custodia
25+
26+
Una custodia per questo progetto, realizzata dal signor Baicheng, può essere scaricata [qui](https://www.thingiverse.com/thing:5877482)
27+
![CUSTODIA](https://github.com/solosky/pixl.js/blob/main/assets/pixjs-case1.png)
28+
29+
# Versione OLED
30+
31+
La versione OLED è stata contribuita dall'utente @xiaohail. Puoi cliccare [qui](https://gitlab.com/xiaohai/pixl.js) per scaricare il PCB.
32+
33+
![OLED](https://github.com/solosky/pixl.js/blob/main/assets/pixljs-oled1.png)

docs/it/02-Flash-Firmware.md

Lines changed: 77 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,77 @@
1+
Dopo aver costruito o acquistato l'hardware, devi flashare il firmware per la prima volta, che può essere ottenuto solo tramite il metodo cablato.
2+
3+
Il firmware può essere flashato o aggiornato utilizzando uno dei seguenti metodi:
4+
5+
## Metodo 1: Cablato
6+
Questo metodo richiede un flasher compatibile con CMASS-DAP JLink o DAPLink. Raccomandiamo il programmatore STM32 PWLINK2 Lite Emulator, puoi comprarne uno per circa 9.9 yuan su [Taobao](https://item.taobao.com/item.htm?spm=a1z09.2.0.0.4b942e8deXyaQO&id=675067753017&_u=d2p75qfn774a "Taobao")
7+
8+
Scarica l'ultima versione del pacchetto zip del firmware. Dovrebbe contenere i seguenti file:
9+
- fw_update.bat
10+
- bootloader.hex
11+
- pixljs.hex
12+
- pixljs_all.hex
13+
- fw_readme.txt
14+
- pixjs_ota_v237.zip
15+
16+
Devi collegare i cavi da 3.3 Volt, GND, SWDIO e SWDCLK. Puoi utilizzare il file `fw_update.bat` per flashare il firmware `pixjs_all.hex`.
17+
18+
Puoi anche utilizzare OpenOCD per flashare il dispositivo, questo è un esempio del comando da eseguire:
19+
```
20+
openocd -f interface/cmsis-dap.cfg -c "transport select swd" -f target/nrf52.cfg -d2 -c init -c "reset init" -c halt -c "nrf5 mass_erase" -c "program pixjs_all.hex verify" -c "program nrf52832_xxaa.hex verify" -c exit
21+
```
22+
Dopo che il primo flash è completato, gli aggiornamenti del firmware successivi possono essere effettuati tramite OTA.
23+
24+
## Metodo 2: Aggiornamento OTA
25+
Questo metodo è applicabile solo ai dispositivi Pixl.js che sono stati programmati con successo tramite il metodo cablato.
26+
27+
### App nRF Connect
28+
Installa l'applicazione nRF Connect (la puoi trovare sia su iOS che su Android app stores).
29+
30+
Nella lista dei dispositivi, seleziona pixl.js (o pixl dfu) e tocca il pulsante `CONNECT`
31+
32+
Metti il tuo dispositivo pixl.js in modalità "Aggiornamento Firmware", poi il dispositivo entrerà in modalità DFU. Per farlo, seleziona l'app `Settings` e seleziona la voce `Firmware Update`.
33+
34+
Apri l'app "nRF Connect" sul tuo telefono e connettiti al dispositivo chiamato `pixl dfu` per aggiornare il firmware.
35+
36+
Su iOS, il firmware è `pixjs_ota_vxxx.zip`
37+
38+
### Metodo della pagina web
39+
Scarica l'ultima versione del pacchetto zip del firmware corrispondente alla versione del tuo dispositivo ed estrailo in una directory.
40+
41+
Il progetto fornisce due modi per ottenere un aggiornamento DFU:
42+
43+
#### Pagina web di trasferimento file.
44+
Innanzitutto, puoi collegare il dispositivo alla [pagina web ufficiale](https://pixl.amiibo.xyz/ "pagina web ufficiale"), poi sulla pagina web, dopo che il dispositivo è connesso, premi il pulsante grigio `DFU`, il dispositivo entrerà in modalità DFU e la pagina ti chiederà "Vuoi aprire la pagina di aggiornamento DFU?" se accetti, la Pagina di Aggiornamento Firmware sarà aperta.
45+
46+
#### Direttamente alla Pagina di Aggiornamento Firmware.
47+
Puoi anche andare direttamente alla Pagina di Aggiornamento Firmware.
48+
49+
Prima di tutto, devi mettere il tuo dispositivo pixl.js in modalità "Aggiornamento Firmware". Per farlo, seleziona l'app `Impostazioni` e seleziona la voce `Aggiornamento Firmware`.
50+
51+
Apri la [pagina di aggiornamento firmware](https://thegecko.github.io/web-bluetooth-dfu). Trascina e rilascia o seleziona il file `pixljs_ota_xxx.zip` dalla cartella dove hai estratto il pacchetto firmware.
52+
53+
Poi premi il pulsante `SELEZIONA DISPOSITIVO` sulla pagina dovresti vedere un dispositivo chiamato `pixl dfu` connetti per iniziare il processo di aggiornamento del firmware.
54+
55+
56+
# Riparazione versione firmware errata.
57+
58+
Se per errore programmi la versione sbagliata (LCD/OLED) sul tuo dispositivo, il dispositivo funzionerà ma non mostrerà informazioni sullo schermo, la retroilluminazione della versione LCD potrebbe accendersi.
59+
60+
Puoi utilizzare i seguenti metodi per recuperare o flashare la versione firmware corretta.
61+
62+
## Opzione 1: Flasha il firmware tramite connessione cablata
63+
64+
Se hai a disposizione un programmatore JLink o DAPLink compatibile con CMASS-DAP, puoi utilizzare il [Metodo Cablato](Flash-Firmware#Method 1: Wired "Metodo Cablato") per flashare manualmente la versione firmware corretta.
65+
Se per errore programmi la versione sbagliata (LCD/OLED) sul tuo dispositivo, il dispositivo funzionerà ma non mostrerà informazioni sullo schermo, la retroilluminazione della versione LCD potrebbe accendersi.
66+
67+
## Opzione 2: Segui le sequenze di tasti speciali per entrare nuovamente nella modalità DFU e installare la versione corretta del firmware.
68+
69+
Prima assicurati che il tuo dispositivo sia spento, poi premi le seguenti sequenze di tasti per entrare nella `Modalità DFU`
70+
71+
- Un qualsiasi tasto per risvegliare il dispositivo
72+
- SINISTRA
73+
- CENTRO
74+
- SINISTRA X 4
75+
- CENTRO
76+
77+
Ora il tuo dispositivo è in modalità DFU, usa l'app [nRF Connect APP](#nRF-Connect-APP) o [Direttamente dalla pagina di aggiornamento del firmware](#directly-to-the-firmware-update-page) per aggiornare il firmware.

docs/it/03-Build-Firmware.md

Lines changed: 30 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,30 @@
1+
2+
# Compilazione del firmware
3+
4+
## Compilazione con Github Actions
5+
6+
Puoi scaricare l'ultima build di sviluppo da Github Actions
7+
8+
https://github.com/solosky/pixl.js/actions
9+
10+
## Compilazione con immagine Docker personalizzata
11+
12+
Puoi compilare il firmware utilizzando un'immagine Docker personalizzata.
13+
14+
```bash
15+
# creare i contenitori
16+
docker run -it --rm solosky/nrf52-sdk:latest
17+
18+
# inizializzare il repository
19+
root@b10d54636088:/builds# git clone https://github.com/solosky/pixl.js
20+
root@b10d54636088:/builds# cd pixl.js
21+
root@b10d54636088:/builds/pixl.js# git submodule update --init --recursive
22+
23+
# compilare la versione LCD
24+
root@b10d54636088:/builds/pixl.js# cd fw && make all BOARD=LCD RELEASE=1
25+
26+
# compilare la versione OLED
27+
root@b10d54636088:/builds/pixl.js# cd fw && make all BOARD=OLED RELEASE=1
28+
```
29+
30+
Il firmware si trova in fw/_build/pixjs_all.hex, il pacchetto ota si trova in fw/_build/pixjs_ota_vXXXX.zip

0 commit comments

Comments
 (0)