Nadogradnja firmvera USB uređaja STMicroelectronics Extension
UM0412
Uputstvo za upotrebu

Uvod

Ovaj dokument opisuje demonstracioni korisnički interfejs koji je razvijen da ilustruje upotrebu biblioteke za nadogradnju firmvera STMicroelectronics uređaja. Opis ove biblioteke, uključujući njeno sučelje za programiranje aplikacije, sadržan je u dokumentu “DfuSe aplikacijski programski interfejs” i instaliran sa softverom DfuSe.

Početak

1.1 Sistemski zahtjevi
Da biste koristili demonstraciju DfuSe sa operativnim sistemom Windows, mora biti instalirana najnovija verzija Windowsa, kao što je Windows 98SE, Millennium, 2000, XP ili VISTA.
instaliran na računaru.
Verzija Windows OS instaliranog na vašem računaru može se odrediti desnim klikom na ikonu “Moj računar” na radnoj površini, a zatim klikom na stavku “Svojstva” u prikazanom PopUpMenu-u. Tip OS je prikazan u dijaloškom okviru “Svojstva sistema” ispod oznake “Sistem” na kartici “Općenito” (pogledajte sliku 1).

Slika 1. Dijalog svojstava sistema

1.2 Sadržaj paketa
U ovom paketu se isporučuju sljedeći artikli:
Sadržaj softvera

1. STTube drajver koji se sastoji od dva sljedeća files:
   – STTub30.sys: Učitava se drajver za demo ploču.
   – STFU.inf: Konfiguracija file za vozača.
2. DfuSe_Demo_V3.0_Setup.exe: Instalacija file koji instalira DfuSe aplikacije i izvorni kod na vaš računar.

Hardverski sadržaj
Ovaj alat je dizajniran za rad sa svim STMicroelectronics uređajima koji podržavaju nadogradnju firmvera uređaja putem USB sučelja. Za više detalja, obratite se svom ST
predstavnika ili posjetite ST webstranica (http://www.st.com).

1.3 DfuSe demonstracijska instalacija
1.3.1 Instalacija softvera

Pokrenite DfuSe_Demo_V3.0_Setup.exe file: Čarobnjak InstallShield će vas voditi da instalirate DfuSe aplikacije i izvorni kod na vašem računaru. Kada je softver uspješno instaliran, kliknite na dugme „Završi“. Zatim možete istražiti direktorij drajvera.
Vozač files se nalaze u folderu “Driver” na vašoj instalacijskoj putanji (C:\Program files\STMicroelectronics\DfuSe).
Izvorni kod za Demo aplikaciju i DfuSe biblioteku nalazi se u “C:\Program Files\STMicroelectronics\DfuSe\Sources”.
Dokumentacija se nalazi u “C:\Program Files\STMicroelectronics\DfuSe\Sources\Doc”.

1.3.2 Instalacija hardvera

• Povežite uređaj na rezervni USB port na vašem računaru.
• Zatim se pokreće „Čarobnjak za pronalazak novog hardvera“. Odaberite "Instaliraj sa liste ili određene lokacije" kao što je prikazano u nastavku, a zatim kliknite "Dalje".
• Odaberite „Ne pretražujte. Odabrat ću drajver za instalaciju” kao što je prikazano ispod, a zatim kliknite na “Dalje”.
  
• Ako je upravljački program već instaliran, lista modela će pokazati kompatibilne modele hardvera, u suprotnom kliknite na “Have Disk…” da biste locirali upravljački program files.
  
• U dijaloškom okviru “Install From Disk” kliknite na “Browse…” da navedete upravljački program filena lokaciji, direktorij drajvera se nalazi na vašoj instalacijskoj putanji (C:\Program files\STMicroelectronics\DfuSe\Driver), a zatim kliknite na “OK”.
  Računar automatski bira ispravan INF file, u ovom slučaju, STFU.INF. Kada Windows pronađe potreban drajver.INF file, kompatibilni model hardvera će biti prikazan na listi modela. Kliknite “Dalje” da nastavite.
  
• Kada Windows izvodi instalaciju drajvera, prikazaće se dijalog upozorenja koji pokazuje da drajver nije prošao testiranje Windows logotipa, kliknite na „Ipak nastavi“ da nastavite.
  
• Windows bi tada trebao prikazati poruku koja pokazuje da je instalacija bila uspješna.
  Kliknite na “Finish” da završite instalaciju.

DFU file

Korisnici koji su kupili DFU uređaje zahtijevaju mogućnost nadogradnje firmvera ovih uređaja. Tradicionalno, firmver se pohranjuje u Hex, S19 ili Binarno files, ali ovi formati ne sadrže potrebne informacije za izvođenje operacije nadogradnje, oni sadrže samo stvarne podatke programa za preuzimanje. Međutim, operacija DFU zahtijeva više informacija, kao što su identifikator proizvoda, identifikator dobavljača, verzija firmvera i alternativni broj postavke (ID cilja) cilja koji će se koristiti, te informacije čine nadogradnju ciljanom i sigurnijom. Za dodavanje ove informacije, novi file treba koristiti format koji će se nazvati DFU file formatu. Za više detalja pogledajte “DfuSe File Specifikacija formata” (UM0391).

Opis korisničkog interfejsa

Ovaj odjeljak opisuje različita korisnička sučelja dostupna u paketu DfuSe i objašnjava kako ih koristiti za izvođenje DFU operacija kao što su Upload, Download i
firmware file menadžment.

3.1 DfuSe demonstracija
Nadogradnje firmvera moraju biti u mogućnosti da se izvode bez posebne obuke, čak i za početnike. Stoga je korisnički interfejs dizajniran da bude što je moguće robusniji i jednostavniji za upotrebu (vidi sliku 9). Brojevi na slici 9 odnose se na opis u Tabeli 1 koji navodi dostupne kontrole u DfuSe Demonstration interfejsu.

Tabela 1. koristiti opis dijaloškog okvira demo

Kontrola	Opis
1	Navodi dostupne DFU i kompatibilne HID uređaje, odabrani je onaj koji se trenutno koristi. Kompatibilni HID uređaj je uređaj klase HID koji pruža funkciju odvajanja HID-a (USAGE_PAGE OxFF0O i USAGE_DETACH 0x0055) u svom deskriptoru izvještaja. Example: Oxa1, Ox00, // Kolekcija (fizička) 0x06, Ox00, OxFF, // Stranica upotrebe definirana od strane dobavljača – OxFP00 0x85, 0x80, // REPORT_ID (128) 0x09, 0x55, // KORIŠĆENJE (HID Detach) 0x15, Ox00, // LOGIČKI_MINIMALNI (0) 0x26, OxFF, Ox00, // LOGICAL_MAXIMUM (255) 0x75, 0x08, // REPORT_SIZE (8 bita) 0x95, Ox01, // REPORT_COUNT (1) Ox131, 0x82, // OSOBINE (Podaci,Var,Abs,Vol) OxCO, // END_COLLECTION (definirano dobavljačem)
2	Identifikatori uređaja za DFU način rada; PID, VID i verzija.
3	Identifikatori uređaja za način rada aplikacije; PID, VID i verzija.
4	Pošalji naredbu Enter DFU mode. Target će se prebaciti iz aplikacije u DFU način rada ili će poslati HID Detach ako je uređaj kompatibilan HID uređaj.
5	Pošalji naredbu Napusti DFU način rada. Target će se prebaciti iz DFU u aplikacijski način rada.
6	Mapiranje memorije, dvaput kliknite na svaku stavku za view više detalja o memorijskom dijelu.
7	Odaberite odredišni DFU file, učitani podaci će biti kopirani u ovo file.
8	Pokrenite operaciju učitavanja.
9	Veličina prenesenih podataka tokom tekuće operacije (Upload/Upgrade).
10	Vrijeme trajanja tekuće operacije (Upload/Upgrade).
11	Dostupni ciljevi u učitanom DFU-u file.
12	Odaberite izvorni DFU file, preuzeti podaci će se učitati iz ovoga file.
13	Pokrenite operaciju nadogradnje (Obriši pa preuzmi).
14	Provjerite jesu li podaci uspješno preneseni.
15	Pokažite napredak operacije.
16	Prekini trenutnu operaciju.
17	Izađite iz aplikacije.

Ako se mikrokontroler koristi u STM32F105xx ili STM32F107xx, DfuSe demo prikazuje novu karakteristiku koja se sastoji u čitanju podataka o bajtu opcije preko izvezenog memorijskog dijela “Option byte”. Dvostruki klik na srodnu stavku u memorijskoj mapi (stavka 6 u tabeli 1 /slika 9) otvara novi dijaloški okvir koji prikazuje bajtove opcije čitanja. Možete koristiti ovaj okvir za uređivanje i primjenu vlastite konfiguracije (pogledajte sliku 10).
Alat je u stanju da otkrije mogućnosti odabranog memorijskog dijela (čitanje, pisanje i brisanje). U slučaju nečitljive memorije (aktivirana zaštita čitanja), označava
status čitanja memorije i pita da li da deaktivirate zaštitu od čitanja ili ne.

3.2 DFU file menadžer
3.2.1 Dijalog „Želim da uradim“.
Kada je DFU file manager aplikacija se izvršava, pojavljuje se dijaloški okvir „Želim da uradim“, a korisnik mora da odabere file operaciju koju želi da uradi. Odaberite prvi radio gumb za generiranje DFU file iz S19, Hex ili Bin file, ili drugi za izdvajanje S19, Hex ili Bin file iz DFU file (vidi sliku 11). Odaberite „Želim GENERIRATI DFU file od S19, HEX ili BIN files” radio dugme ako želite da generišete DFU file od S19, Hex ili Binary files.
Odaberite „Želim IZVLAČITI S19, HEX ili BIN files iz radio dugmeta DFU one” ako želite da izdvojite S19, Hex ili Binary file iz DFU file.

3.2.2 File dijaloški okvir za generiranje
Ako je izabran prvi izbor, kliknite na dugme U redu da biste prikazali „File Dijalog za generiranje”. Ovaj interfejs omogućava korisniku da generiše DFU file iz S19, Hex ili Bin file.

Tabela 2. File opis dijaloškog okvira za generiranje

Kontrola	Opis
1	Identifikator dobavljača
2	Identifikator proizvoda
3	Verzija firmvera
4	Dostupne slike za umetanje u DFU file
5	Broj identifikatora cilja
6	Otvorite S19 ili Hex file
7	Otvorite Binary files
8	Ciljno ime
9	Izbrišite odabranu sliku sa liste slika
10	Generiraj DFU file
11	Otkažite i izađite iz aplikacije

Jer S19, Hex i Bin files ne sadrže ciljnu specifikaciju, korisnik mora unijeti svojstva uređaja (VID, PID i verzija), ID cilja i naziv cilja prije generiranja DFU-a file.

Tablica 3. Opis dijaloškog okvira za ubrizgavanje u više kanti

Kontrola	Opis
1	Put zadnje otvorene binarne datoteke file
2	Otvorena binarna datoteka files. Binarno file može biti a file bilo kojeg formata (talas, video, tekst, itd.)
3	Početna adresa učitanog file
4	Dodaj file to the file lista
5	Izbriši file od file lista
6	File lista
7	Potvrdi file izbor
8	Otkažite i izađite iz operacije

3.2.3 File dijaloški okvir za ekstrakciju
Ako je izabran drugi izbor u dijaloškom okviru „Želim da uradim“, kliknite na dugme U redu da biste prikazali „File ekstrakcija” dijalog prozor. Ovaj interfejs vam omogućava da generišete S19, Hex ili Bin file iz DFU file.

Tabela 4. File opis dijaloga za ekstrakciju

Kontrola	Opis
1	Identifikator dobavljača uređaja
2	Identifikator proizvoda uređaja
3	Verzija firmvera
4	Otvorite DFU file
5	Lista slika u učitanom DFU-u file
6	Vrsta file biti generisan
7	Izvucite sliku u S19, Hex ili Bin file
8	Otkažite i izađite iz aplikacije

Procedure korak po korak

4.1 DfuSe demonstracijske procedure
4.1.1 Kako učitati DFU file

1. Pokrenite aplikaciju “DfuSe demonstracija” (Start -> Svi programi -> STMicroelectronics -> DfuSe -> DfuSe Demonstration).
2. Kliknite na dugme “Izaberi” (stavka 7 u tabeli 1 /slika 9) da odaberete DFU file.
3. Odaberite memorijski cilj(e) na listi mapiranja memorije (stavka 6 u tabeli 1 /slika 9).
4. Kliknite na dugme “Učitaj” (stavka 8 u tabeli 1 /slika 9) da započnete učitavanje memorijskog sadržaja u odabrani DFU file.

4.1.2 Kako preuzeti DFU file

1. Pokrenite aplikaciju “DfuSe demonstracija” (Start -> Svi programi -> STMicroelectronics -> DfuSe -> DfuSe Demonstration).
2. Kliknite na dugme “Izaberi” (stavka 12 u tabeli 1 /slika 9) da odaberete DFU file. prikazane informacije kao što su VID, PID, verzija i ciljni broj se čitaju iz DFU-a file.
3. Označite polje za potvrdu „Optimiziraj trajanje nadogradnje“ da zanemarite FF blokove tokom učitavanja.
4. Označite potvrdni okvir „Provjeri nakon preuzimanja“ ako želite pokrenuti proces provjere nakon preuzimanja podataka.
5. Kliknite na dugme „Nadogradi“ (stavka 13 u tabeli 1 /slika 9) da započnete nadogradnju file sadržaja u memoriju.
6. Kliknite na dugme „Verifikuj“ (stavka 14 u tabeli 1 /slika 9) da biste proverili da li su podaci uspešno preuzeti.

4.2 DFU file menadžerske procedure
4.2.1 Kako generirati DFU files od S19/Hex/Bin files

1. Pokrenite “DFU File Manager” aplikacija (Start -> Svi programi -> STMicroelectronics > DfuSe-> DFU File Menadžer).
2. Odaberite „Želim GENERIRATI DFU file od S19, HEX ili BIN files” u dijaloškom okviru „Želim da uradim” (Ta bl e 1 1 ), a zatim kliknite na „OK”.
3. Kreirajte DFU sliku iz S19/Hex ili binarnog file.
   a) Postavite nekorišćeni ID broj mete (stavka 5 u tabeli 2 /slika 12).
   b) Popunite VID, PID, verziju i naziv cilja
   c) Za kreiranje slike iz S19 ili Hex file, kliknite na dugme “S19 ili Hex” (stavka 6 u tabeli 2 /slika 4) i izaberite file, DFU slika će biti kreirana za svaku dodanu sliku file.
   d) Za kreiranje slike iz jedne ili više binarnih datoteka files, kliknite na dugme „Multi Bin“ (stavka 7 u Tabeli 2 /Slika 12) da biste prikazali okvir za dijalog „Multi Bin Injection“ (Slika 13.).
   Kliknite na dugme Pregledaj (stavka 2 u tabeli 3 /slika 13) da odaberete binarni file(*.bin) ili drugi format file (Talas, Video, Tekst,…).
   Postavite početnu adresu u polje za adresu (stavka 3 u tabeli 3 /slika 13).
   Kliknite na dugme “Dodaj na listu” (stavka 4 u tabeli 3 /slika 13) da dodate odabranu binarnu datoteku file sa datom adresom.
   Za brisanje postojećeg file, odaberite ga, a zatim kliknite na dugme “Delete” (stavka 5 u tabeli 3 /slika 13).
   Ponovite istu sekvencu da dodate drugu binarnu files, Kliknite na “OK” za potvrdu.
4. Ponovite korak (3.) da kreirate druge DFU slike.
5. Za kreiranje DFU file, kliknite na “Generiraj”.

4.2.2 Kako izdvojiti S19/Hex/Bin files DFU files

1. Pokrenite “DFU File Manager” aplikacija (Start -> Svi programi -> STMicroelectronics -> DfuSe -> DFU File Upravljaj).
2. Odaberite „Želim IZVLAČITI S19, HEX ili BIN files from a DFU one” radio dugme u dijaloškom okviru „Želim da uradim” (slika 11), a zatim kliknite na „OK”.
3. Izvucite S19/Hex ili binarni file iz DFU file.
   a) Kliknite na dugme Pregledaj (stavka 4 u tabeli 4 /slika 14) da odaberete DFU file. Slike koje se nalaze biće navedene na listi slika (stavka 4 u tabeli 4 /slika 14).
   b) Izaberite sliku sa liste slika.
   c) Odaberite radio dugme Hex, S19 ili Multiple Bin (stavka 6 u tabeli 4 /slika 14).
   d) Kliknite na dugme “Extract” (stavka 7 u tabeli 4 /slika 14) da biste izdvojili odabranu sliku.
4. Ponovite korak (3.) da izdvojite druge DFU slike.

Istorija revizija

Tabela 5. Istorija revizije dokumenta

Datum	Revizija	Promjene
6-jun-07	1	Prvo izdanje.
2-jan-08	2	Dodan odjeljak 4.
24-Sep-08	3	Ažurirana slika 9 do slike 14.
2-Jul-09	4	koristite demo nadograđenu na verziju V3.0. Odjeljak 3.1: Ažurirana demonstracija DfuSe: — Slika 9: DfuSe demo okvir za dijalog je ažuriran — Dodata nova funkcija za STM32F105/107xx uređaje — Slika 10: Dodan dijaloški okvir za uređivanje bajtova opcije Ažurirano u odjeljku 3.2: DFU file menadžer — Slika 11: dijaloški okvir „Želim da uradim“. — Slika 12: dijaloški okvir „Generacija“. — Slika 13: Dijaloški okvir „Multi bin injection“. — Slika 14: Dijaloški okvir „Izdvoji“.

Molimo pažljivo pročitajte:

Informacije u ovom dokumentu date su isključivo u vezi sa ST proizvodima. STMicroelectronics NV i njegove podružnice (“ST”) zadržavaju pravo na izmjene, ispravke, modifikacije ili poboljšanja ovog dokumenta, kao i proizvoda i usluga opisanih u njemu u bilo koje vrijeme, bez prethodne najave.
Svi ST proizvodi se prodaju u skladu sa ST uslovima prodaje.
Kupci su isključivo odgovorni za izbor, odabir i korištenje ST proizvoda i usluga opisanih ovdje, a ST ne preuzima nikakvu odgovornost u vezi s izborom, odabirom ili korištenjem ST proizvoda i usluga opisanih ovdje.
Ovim dokumentom se ne daje nikakva licenca, izričita ili implicirana, putem estoppela ili na drugi način, za bilo koja prava intelektualne svojine. Ako se bilo koji dio ovog dokumenta odnosi na bilo koje proizvode ili usluge treće strane, to se neće smatrati licencom koju je dodijelio ST za korištenje takvih proizvoda ili usluga treće strane, ili bilo koje intelektualno vlasništvo sadržano u njemu ili se smatra garancijom koja pokriva korištenje na bilo koji način od takvih proizvoda ili usluga trećih strana ili bilo koje intelektualne svojine sadržane u njima.
OSIM AKO JE DRUGAČE NIJE NAVEDENO U ST-ovim ODREDBAMA I USLOVIMA PRODAJE ST SE ODRIČE BILO KAKVE IZRIČITE ILI IMPLICIRANE GARANCIJE U ODNOSU NA UPOTREBU I/ILI PRODAJU ST PROIZVODA, UKLJUČUJUĆI BEZ OGRANIČAVANJA IMPLICIRANE GARANCIJE E, I NEZGODNE GARANCIJE. BILO KOJE JURISDIKCIJE), ILI KRŠENJE BILO KOGA PATENTA, AUTORSKOG PRAVA ILI DRUGOG PRAVA INTELEKTUALNE SVOJINE.
OSIM UKOLIKO JE IZRIČITO ODOBREN OD OVLAŠĆENOG PREDSTAVNIKA ST, PROIZVODI ST NISU PREPORUČENI, OVLAŠĆENI NI GARANCIJSKI ZA UPOTREBU U VOJNI, ZRAKOPLOVIMA, SVEMIRSKIM PROIZVODIMA, ILI ZAŠTITU ŽIVOTA MOŽE KVAR ILI KVAR REZULTATI LIČNOM POVREDOM, SMRTOM ILI TEŠKOM IMOVINOM ILI ŠTEотоm po životnu sredinu. ST PROIZVODI KOJI NISU NAVEDENI KAO “AUTOMOTIVNI GRAD” MOGU SE KORISTITI SAMO U AUTOMOBILSKIM APLIKACIJAMA NA VLASTITU ODGOVORNOST KORISNIKA.
Preprodaja ST proizvoda sa odredbama koje se razlikuju od izjava i/ili tehničkih karakteristika navedenih u ovom dokumentu odmah će poništiti svaku garanciju koju je dao ST za ST proizvod ili uslugu opisanu ovde i neće stvoriti ili produžiti na bilo koji način bilo kakvu odgovornost ST.
ST i ST logo su zaštitni znaci ili registrovani zaštitni znaci ST u raznim zemljama.
Informacije u ovom dokumentu zamjenjuju i zamjenjuju sve prethodno dostavljene informacije.
ST logo je registrovani zaštitni znak STMicroelectronics. Sva ostala imena su vlasništvo njihovih vlasnika.

© 2009 STMicroelectronics – Sva prava zadržana
STMicroelectronics grupa kompanija
Australija – Belgija – Brazil – Kanada – Kina – Češka Republika – Finska – Francuska – Njemačka – Hong Kong – Indija – Izrael – Italija – Japan –
Malezija – Malta – Maroko – Filipini – Singapur – Španija – Švedska – Švajcarska – Ujedinjeno Kraljevstvo – Sjedinjene Američke Države
www.st.com
Dokument ID 13379 Rev 4

Dokumenti / Resursi

ST DfuSe Nadogradnja firmvera USB uređaja STMicroelectronics Extension [pdf] Korisnički priručnik DfuSe USB uređaj, Nadogradnja firmvera STMicroelectronics Extension, DfuSe USB Nadogradnja firmvera, STMicroelectronics Extension, DfuSe USB Nadogradnja firmvera STMicroelectronics Extension, UM0412

Reference

• Uputstvo za upotrebu