Nadgradnja vdelane programske opreme naprave USB STMicroelectronics Extension
UM0412
Uporabniški priročnik

Uvod

Ta dokument opisuje predstavitveni uporabniški vmesnik, ki je bil razvit za ponazoritev uporabe knjižnice za nadgradnjo vdelane programske opreme naprave STMicroelectronics. Opis te knjižnice, vključno z vmesnikom za programiranje aplikacij, je v dokumentu »Vmesnik za programiranje aplikacij DfuSe« in je nameščen s programsko opremo DfuSe.

Začetek

1.1 Sistemske zahteve
Če želite uporabiti predstavitev DfuSe z operacijskim sistemom Windows, morate imeti najnovejšo različico sistema Windows, kot je Windows 98SE, Millennium, 2000, XP ali VISTA.
nameščen na osebnem računalniku.
Različico operacijskega sistema Windows, ki je nameščen na vašem računalniku, lahko ugotovite tako, da z desno miškino tipko kliknete ikono »Moj računalnik« na namizju in nato v prikazanem pojavnem meniju kliknete element »Lastnosti«. Vrsta OS je prikazana v pogovornem oknu »Sistemske lastnosti« pod oznako »Sistem« na zavihku »Splošno« (glejte sliko 1).

Slika 1. Pogovorno okno Lastnosti sistema

1.2 Vsebina paketa
V tem paketu so na voljo naslednji predmeti:
Vsebina programske opreme

1. Gonilnik STTube, sestavljen iz naslednjih dveh files:
   – STTub30.sys: gonilnik, ki se naloži za demo ploščo.
   – STFU.inf: Konfiguracija file za voznika.
2. DfuSe_Demo_V3.0_Setup.exe: Namestitev file ki na vaš računalnik namesti aplikacije in izvorno kodo DfuSe.

Vsebina strojne opreme
To orodje je zasnovano za delo z vsemi napravami STMicroelectronics, ki podpirajo nadgradnjo vdelane programske opreme naprave prek vmesnika USB. Za več podrobnosti se obrnite na svojega ST
predstavnika ali obiščite ST webspletno mesto (http://www.st.com).

1.3 Predstavitvena namestitev DfuSe
1.3.1 Namestitev programske opreme

Zaženite DfuSe_Demo_V3.0_Setup.exe file: čarovnik InstallShield vas bo vodil pri namestitvi aplikacij DfuSe in izvorne kode na vaš računalnik. Ko je programska oprema uspešno nameščena, kliknite gumb »Dokončaj«. Nato lahko raziščete imenik gonilnikov.
Voznik filese nahajajo v mapi »Gonilnik« na vaši namestitveni poti (C:\Program files\STMicroelectronics\DfuSe).
Izvorna koda za Demo aplikacijo in knjižnico DfuSe se nahaja v »C:\Program Files\STMicroelectronics\DfuSe\Sources«.
Dokumentacija se nahaja v "C:\Program Files\STMicroelectronics\DfuSe\Sources\Doc«.

1.3.2 Namestitev strojne opreme

• Priključite napravo na rezervna vrata USB na vašem računalniku.
• Nato se zažene »Čarovnik za najdeno novo strojno opremo«. Izberite »Namesti s seznama ali določene lokacije«, kot je prikazano spodaj, in kliknite »Naprej«.
• Izberite »Ne išči. Izbral bom gonilnik za namestitev«, kot je prikazano spodaj, in nato kliknite »Naprej«.
  
• Če je gonilnik že nameščen, bodo na seznamu modelov prikazani združljivi modeli strojne opreme, sicer kliknite »Imam disk ...«, da poiščete gonilnik. files.
  
• V pogovornem oknu »Namesti z diska« kliknite »Prebrskaj ...«, da določite gonilnik files lokacijo, se imenik gonilnika nahaja na vaši namestitveni poti (C:\Program files\STMicroelectronics\DfuSe\Driver), nato kliknite »V redu«.
  Računalnik samodejno izbere pravilen INF file, v tem primeru STFU.INF. Ko Windows najde zahtevani gonilnik.INF file, bo združljiv model strojne opreme prikazan na seznamu modelov. Za nadaljevanje kliknite »Naprej«.
  
• Ko Windows izvaja namestitev gonilnika, se prikaže opozorilno pogovorno okno, ki nakazuje, da gonilnik ni opravil testiranja logotipa Windows; za nadaljevanje kliknite »Vseeno nadaljuj«.
  
• Windows bi moral nato prikazati sporočilo, ki nakazuje, da je bila namestitev uspešna.
  Za dokončanje namestitve kliknite »Dokončaj«.

DFU file

Uporabniki, ki so kupili naprave DFU, potrebujejo možnost nadgradnje vdelane programske opreme teh naprav. Tradicionalno je vdelana programska oprema shranjena v Hex, S19 ali Binary files, vendar ti formati ne vsebujejo potrebnih informacij za izvedbo operacije nadgradnje, vsebujejo le dejanske podatke programa, ki ga je treba prenesti. Vendar operacija DFU zahteva več informacij, kot so identifikator izdelka, identifikator prodajalca, različica vdelane programske opreme in številka nadomestne nastavitve (ciljni ID) cilja, ki bo uporabljen, te informacije naredijo nadgradnjo ciljno usmerjeno in varnejšo. Če želite dodati te informacije, novo file uporabiti je treba format, imenovan DFU file format. Za več podrobnosti glejte »DfuSe File Specifikacija formata« (UM0391).

Opis uporabniškega vmesnika

Ta razdelek opisuje različne uporabniške vmesnike, ki so na voljo v paketu DfuSe, in pojasnjuje, kako jih uporabiti za izvajanje operacij DFU, kot so nalaganje, prenos in
vdelana programska oprema file upravljanje.

3.1 Predstavitev DfuSe
Nadgradnje vdelane programske opreme morajo imeti možnost izvajati brez posebnega usposabljanja, tudi začetniki. Zato je bil uporabniški vmesnik zasnovan tako, da je čim bolj robusten in preprost za uporabo (glej sliko 9). Številke na sliki 9 se nanašajo na opis v tabeli 1, ki navaja razpoložljive kontrole v demonstracijskem vmesniku DfuSe.

Tabela 1. Opis pogovornega okna za uporabo demo

Nadzor	Opis
1	Navede razpoložljive naprave DFU in združljive naprave HID, izbrana je tista, ki se trenutno uporablja. Združljiva naprava HID je naprava razreda HID, ki v svojem deskriptorju poročila nudi funkcijo odklopa HID (USAGE_PAGE OxFF0O in USAGE_DETACH 0x0055). Example: Oxa1, Ox00, // Zbirka (fizično) 0x06, Ox00, OxFF, // Stran za uporabo, ki jo je določil prodajalec – OxFP00 0x85, 0x80, // REPORT_ID (128) 0x09, 0x55, // UPORABA (odklop HID) 0x15, Ox00, // LOGIČNI_MINIMUM (0) 0x26, OxFF, Ox00, // LOGIČNI_MAKSIMUM (255) 0x75, 0x08, // REPORT_SIZE (8 bitov) 0x95, Ox01, // REPORT_COUNT (1) Ox131, 0x82, // ZNAČILNOST (Podatki, Var, Abs, Vol) OxCO, // END_COLLECTION (Določeno od prodajalca)
2	Identifikatorji naprav za način DFU; PID, VID in različica.
3	Identifikatorji naprav za način aplikacije; PID, VID in različica.
4	Pošlji Vnesite ukaz za način DFU. Target bo preklopil iz aplikacije v način DFU ali poslal sporočilo HID Detach, če je naprava združljiva naprava HID.
5	Pošlji ukaz Zapusti način DFU. Target bo preklopil iz načina DFU v način aplikacije.
6	Preslikava pomnilnika, dvokliknite vsak element za view več podrobnosti o pomnilniškem delu.
7	Izberite ciljni DFU file, bodo naloženi podatki kopirani v to file.
8	Začnite operacijo nalaganja.
9	Velikost prenesenih podatkov med trenutno operacijo (Nalaganje/Nadgradnja).
10	Čas trajanja trenutne operacije (nalaganje/nadgradnja).
11	Razpoložljivi cilji v naloženem DFU file.
12	Izberite izvor DFU file, bodo preneseni podatki naloženi iz tega file.
13	Začnite postopek nadgradnje (izbriši in nato prenesi).
14	Preverite, ali so bili podatki uspešno naloženi.
15	Pokaži napredek operacije.
16	Prekini trenutno operacijo.
17	Izhod iz aplikacije.

Če je mikrokrmilnik v uporabi v STM32F105xx ali STM32F107xx, predstavitev DfuSe prikazuje novo funkcijo, ki vključuje branje opcijskih bajtnih podatkov prek izvoženega pomnilniškega dela »Option byte«. Dvojni klik na povezani element v pomnilniški karti (element 6 v tabeli 1 /slika 9) odpre novo pogovorno okno, ki prikaže bajte možnosti branja. To polje lahko uporabite za urejanje in uporabo lastne konfiguracije (glejte sliko 10).
Orodje je sposobno zaznati zmožnosti izbranega dela pomnilnika (branje, pisanje in brisanje). V primeru neberljivega pomnilnika (aktivirana zaščita pred branjem) označuje
stanje branja pomnilnika in poziv, ali naj deaktivira zaščito branja ali ne.

3.2 DFU file vodja
3.2.1 Pogovorno okno »Želim narediti«.
Ko je DFU file se izvede aplikacija upravitelja, prikaže se pogovorno okno »Želim narediti« in uporabnik mora izbrati file operacijo, ki jo želi opraviti. Izberite prvi izbirni gumb za ustvarjanje DFU file iz S19, Hex ali Bin file, ali drugo, da izvlečete S19, Hex ali Bin file iz DFU file (glej sliko 11). Izberite »Želim ustvariti DFU file iz S19, HEX ali BIN files« izbirni gumb, če želite ustvariti DFU file iz S19, Hex ali Binary files.
Izberite »I want to EXTRACT S19, HEX, ali BIN files iz izbirnega gumba DFU one«, če želite izvleči S19, Hex ali Binary file iz DFU file.

3.2.2 File pogovorno okno za generiranje
Če je bila izbrana prva izbira, kliknite gumb V redu, da se prikaže "File Pogovorno okno za generiranje«. Ta vmesnik omogoča uporabniku ustvarjanje DFU file iz S19, Hex ali Bin file.

Tabela 2. File opis pogovornega okna za ustvarjanje

Nadzor	Opis
1	Identifikator prodajalca
2	Identifikator izdelka
3	Različica vdelane programske opreme
4	Razpoložljive slike, ki jih je treba vstaviti v DFU file
5	Ciljna identifikacijska številka
6	Odprite S19 ali Hex file
7	Odprite Binary files
8	Ciljno ime
9	Izbrišite izbrano sliko s seznama slik
10	Ustvari DFU file
11	Prekliči in zapusti aplikacijo

Ker S19, Hex in Bin filene vsebujejo ciljne specifikacije, mora uporabnik pred generiranjem DFU vnesti lastnosti naprave (VID, PID in različica), ciljni ID in ciljno ime. file.

Tabela 3. Opis pogovornega okna za vbrizgavanje v več pladnjev

Nadzor	Opis
1	Pot zadnje odprte dvojiške datoteke file
2	Odprta dvojiška datoteka files. Binarno file bi lahko bil a file katere koli oblike (Wave, video, besedilo itd.)
3	Začetni naslov naloženega file
4	Dodaj file do file seznam
5	Izbriši file od file seznam
6	File seznam
7	Potrdi file izbor
8	Prekliči in zapusti operacijo

3.2.3 File pogovorno okno za ekstrakcijo
Če je bila izbrana druga možnost v pogovornem oknu »Želim narediti«, kliknite gumb V redu, da prikažete »File ekstrakcija«. Ta vmesnik vam omogoča ustvarjanje S19, Hex ali Bin file iz DFU file.

Tabela 4. File opis pogovornega okna za ekstrakcijo

Nadzor	Opis
1	Identifikator prodajalca naprave
2	Identifikator izdelka naprave
3	Različica vdelane programske opreme
4	Odprite DFU file
5	Seznam slik v naloženem DFU file
6	Vrsta file ki jih je treba ustvariti
7	Ekstrahirajte sliko v S19, Hex ali Bin file
8	Prekliči in zapusti aplikacijo

Postopki po korakih

4.1 Predstavitveni postopki DfuSe
4.1.1 Kako naložiti DFU file

1. Zaženite aplikacijo “DfuSe demonstration” (Start -> Vsi programi -> STMicroelectronics -> DfuSe -> DfuSe Demonstration).
2. Kliknite gumb »Izberi« (točka 7 v tabeli 1 /slika 9), da izberete DFU file.
3. Na seznamu preslikav pomnilnika izberite pomnilniški cilj (element 6 v tabeli 1 /slika 9).
4. Kliknite gumb »Naloži« (element 8 v tabeli 1 /slika 9), da začnete nalagati vsebino pomnilnika v izbrani DFU file.

4.1.2 Kako prenesti DFU file

1. Zaženite aplikacijo “DfuSe demonstration” (Start -> Vsi programi -> STMicroelectronics -> DfuSe -> DfuSe Demonstration).
2. Kliknite gumb »Izberi« (točka 12 v tabeli 1 /slika 9), da izberete DFU file. prikazane informacije, kot so VID, PID, različica in ciljna številka, se preberejo iz DFU file.
3. Označite potrditveno polje »Optimiziraj trajanje nadgradnje«, da prezrete bloke FF med nalaganjem.
4. Označite potrditveno polje »Preveri po prenosu«, če želite zagnati postopek preverjanja po prenosu podatkov.
5. Za začetek nadgradnje kliknite gumb »Nadgradi« (točka 13 v tabeli 1 /slika 9). file vsebino v spomin.
6. Kliknite gumb »Preveri« (točka 14 v tabeli 1 /slika 9), da preverite, ali so bili podatki uspešno preneseni.

4.2 DFU file upravni postopki
4.2.1 Kako ustvariti DFU files iz S19/Hex/Bin files

1. Zaženite »DFU File Manager” (Start -> Vsi programi -> STMicroelectronics > DfuSe-> DFU File Upravitelj).
2. Izberite »Želim ustvariti DFU file iz S19, HEX ali BIN files« v pogovornem oknu »Želim narediti« (tabela 1 1 ), nato kliknite »V redu«.
3. Ustvarite sliko DFU iz S19/Hex ali dvojiške file.
   a) Nastavite neuporabljeno ciljno ID številko (točka 5 v tabeli 2 /slika 12).
   b) Izpolnite VID, PID, različico in ciljno ime
   c) Za ustvarjanje slike iz S19 ali Hex file, kliknite gumb »S19 ali Hex« (element 6 v tabeli 2 /slika 4) in izberite svoj file, bo za vsakega dodanega ustvarjena slika DFU file.
   d) Za ustvarjanje slike iz ene ali več dvojiških datotek files, kliknite gumb »Multi Bin« (Postavka 7 v tabeli 2 /Slika 12), da prikažete pogovorno okno »Multi Bin Injection« (Slika 13.).
   Kliknite gumb Prebrskaj (element 2 v tabeli 3 /slika 13), da izberete dvojiško file(*.bin) ali drug format file (Wave, Video, Besedilo,…).
   V naslovnem polju nastavite začetni naslov (točka 3 v tabeli 3 /slika 13).
   Kliknite gumb »Dodaj na seznam« (točka 4 v tabeli 3 /slika 13), da dodate izbrano dvojiško datoteko. file z navedenim naslovom.
   Za brisanje obstoječega file, ga izberite in nato kliknite gumb »Izbriši« (točka 5 v tabeli 3 /slika 13).
   Ponovite isto zaporedje, da dodate drugo dvojiško datoteko files, kliknite »V redu« za potrditev.
4. Ponovite korak (3.), da ustvarite druge slike DFU.
5. Če želite ustvariti DFU file, kliknite »Ustvari«.

4.2.2 Kako ekstrahirati S19/Hex/Bin files iz DFU files

1. Zaženite »DFU File Manager” (Start -> Vsi programi -> STMicroelectronics -> DfuSe -> DFU File Upravljanje).
2. Izberite »I want to EXTRACT S19, HEX or BIN files iz DFU one« izbirni gumb v pogovornem oknu »Želim narediti« (slika 11), nato kliknite »V redu«.
3. Izvlecite S19/Hex ali binarno file iz DFU file.
   a) Kliknite gumb Prebrskaj (4. element v tabeli 4/slika 14), da izberete DFU. file. Vsebovane slike bodo navedene na seznamu slik (točka 4 v tabeli 4 /slika 14).
   b) Izberite sliko s seznama slik.
   c) Izberite izbirni gumb Hex, S19 ali Multiple Bin (element 6 v tabeli 4/slika 14).
   d) Kliknite gumb »Izvleči« (točka 7 v tabeli 4 /slika 14), da izvlečete izbrano sliko.
4. Ponovite korak (3.), da izvlečete druge slike DFU.

Zgodovina revizij

Tabela 5. Zgodovina revizij dokumenta

Datum	Revizija	Spremembe
6. junij 07	1	Začetna izdaja.
2. januarja 08	2	Dodan razdelek 4.
24. september 08	3	Slika 9 posodobljena na sliko 14.
2. julij 09	4	uporabite predstavitev, nadgrajeno na različico V3.0. Razdelek 3.1: posodobljena predstavitev DfuSe: — Slika 9: Posodobljeno predstavitveno pogovorno okno DfuSe — Dodana nova funkcija za naprave STM32F105/107xx — Slika 10: Dodano pogovorno okno za urejanje bajtov možnosti Posodobljeno v razdelku 3.2: DFU file vodja — Slika 11: pogovorno okno »Želim narediti«. — Slika 12: Pogovorno okno »Generacija«. — Slika 13: pogovorno okno »Multi bin injection«. — Slika 14: pogovorno okno »Extract«.

Prosimo, da pozorno preberete:

Informacije v tem dokumentu so podane izključno v povezavi z izdelki ST. STMicroelectronics NV in njegove podružnice (»ST«) si pridržujejo pravico do sprememb, popravkov, modifikacij ali izboljšav tega dokumenta ter izdelkov in storitev, opisanih v njem, kadar koli in brez predhodnega obvestila.
Vsi izdelki ST se prodajajo v skladu s prodajnimi pogoji ST.
Kupci so izključno odgovorni za izbiro, izbiro in uporabo tukaj opisanih izdelkov in storitev ST, ST pa ne prevzema nobene odgovornosti v zvezi z izbiro, izbiro ali uporabo izdelkov in storitev ST, opisanih tukaj.
V tem dokumentu ni podeljena nobena licenca, izrecna ali implicitna, z ustavitvijo ali kako drugače, za kakršne koli pravice intelektualne lastnine. Če se kateri koli del tega dokumenta nanaša na izdelke ali storitve tretjih oseb, se to ne šteje za licenco, ki jo je podelil ST za uporabo takih izdelkov ali storitev tretjih oseb ali katere koli intelektualne lastnine, ki jo vsebuje, ali se šteje za garancijo, ki pokriva uporabo na kakršen koli način takih izdelkov ali storitev tretjih oseb ali katere koli intelektualne lastnine, ki jo vsebujejo.
ČE NI DRUGAČE DOLOČENO V PRODAJNIH POGOJIH ST, ST ZAVRAČA KAKRŠNO KOLI IZRECNO ALI NAZNAČENO JAMSTVO V ZVEZI Z UPORABO IN/ALI PRODAJO IZDELKOV ST, VKLJUČNO BREZ OMEJITEV NAZNAČENO JAMSTVO ZA PRODAJO, PRIMERNOST ZA DOLOČEN NAMEN ( IN NJIHOVIH ENAKOVREDNIH V SKLADU Z ZAKONI KAKRŠNE KOLI PRISTOJNOSTI) ALI KRŠITEV KAKRŠNEGA KOLI PATENTA, AVTORSKE PRAVICE ALI DRUGE PRAVICE INTELEKTUALNE LASTNINE.
RAZEN ČE GA POOBLAŠČENI ZASTOPNIK ST IZRECNO PISNO ODOBRI, IZDELKI ST NISO PRIPOROČENI, ODOBRENI ALI GARANCIJSKI ZA UPORABO V VOJAŠKIH, LETALSKIH, VESOLJSKIH APLIKACIJAH, ZA REŠEVANJE ALI VZDRŽEVANJE ŽIVLJENJ, NITI V IZDELKIH ALI SISTEMIH, KJER LAHKO OKVARA ALI OKVARA POSLEDICA TELESNE POŠKODBE, SMRT ALI HUDE PREMOŽENJSKE ALI OKOLJSKE ŠKODE. IZDELKI ST, KI NISO NAVEDENI KOT »AVTOMOBILSKI RAZRED«, SE LAHKO UPORABLJAJO SAMO V AVTOMOBILSKIH APLIKACIJAH NA LASTNO ODGOVORNOST UPORABNIKA.
Nadaljnja prodaja izdelkov ST z določbami, ki se razlikujejo od izjav in/ali tehničnih lastnosti, navedenih v tem dokumentu, takoj razveljavi vsako garancijo, ki jo je podelila ST za izdelek ali storitev ST, opisano tukaj, in ne ustvarja ali na kakršen koli način širi nobene odgovornosti ST.
ST in logotip ST sta blagovni znamki ali registrirani blagovni znamki ST v različnih državah.
Informacije v tem dokumentu nadomeščajo in nadomeščajo vse predhodno posredovane informacije.
Logotip ST je registrirana blagovna znamka STMicroelectronics. Vsa druga imena so last njihovih lastnikov.

© 2009 STMicroelectronics – Vse pravice pridržane
Skupina podjetij STMicroelectronics
Avstralija – Belgija – Brazilija – Kanada – Kitajska – Češka – Finska – Francija – Nemčija – Hong Kong – Indija – Izrael – Italija – Japonska –
Malezija – Malta – Maroko – Filipini – Singapur – Španija – Švedska – Švica – Združeno kraljestvo – Združene države Amerike
www.st.com
Dokument ID 13379 Rev 4

Dokumenti / Viri

ST DfuSe Nadgradnja vdelane programske opreme naprave USB STMicroelectronics Extension [pdfUporabniški priročnik Naprava USB DfuSe, nadgradnja vdelane programske opreme STMicroelectronics Extension, nadgradnja vdelane programske opreme naprave DfuSe USB, razširitev STMicroelectronics, nadgradnja vdelane programske opreme DfuSe naprave USB STMicroelectronics Extension, UM0412

Reference

• Uporabniški priročnik