Firmware-upgrade voor USB-apparaat STMicroelectronics-extensie
UM0412
Gebruiksaanwijzing
Invoering
Dit document beschrijft de demonstratiegebruikersinterface die is ontwikkeld om het gebruik van de STMicroelectronics-apparaatfirmware-upgradebibliotheek te illustreren. Een beschrijving van deze bibliotheek, inclusief de applicatie-programmeerinterface, is opgenomen in het document “DfuSe-applicatieprogrammeerinterface” en geïnstalleerd met de DfuSe-software.
Aan de slag
1.1 Systeemvereisten
Om de DfuSe-demonstratie te gebruiken met het Windows-besturingssysteem, moet een recente versie van Windows, zoals Windows 98SE, Millennium, 2000, XP of VISTA, zijn
geïnstalleerd op de pc.
De versie van het Windows-besturingssysteem dat op uw pc is geïnstalleerd, kan worden bepaald door met de rechtermuisknop op het pictogram "Deze computer" op het bureaublad te klikken en vervolgens op het item "Eigenschappen" in het weergegeven PopUpMenu te klikken. Het type besturingssysteem wordt weergegeven in het dialoogvenster "Systeemeigenschappen" onder het label "Systeem" op het tabblad "Algemeen" (zie Afbeelding 1).
Afbeelding 1. Dialoogvenster Systeemeigenschappen
1.2 Inhoud van het pakket
In dit pakket worden de volgende artikelen geleverd:
Software-inhoud
- STTube-stuurprogramma bestaande uit de volgende twee: files:
– STTub30.sys: stuurprogramma dat moet worden geladen voor demobord.
– STFU.inf: Configuratie file voor de bestuurder. - DfuSe_Demo_V3.0_Setup.exe: Installatie file die de DfuSe-toepassingen en broncode op uw computer installeert.
Hardware-inhoud
Deze tool is ontworpen om te werken met alle STMicroelectronics-apparaten die de Device Firmware Upgrade via een USB-interface ondersteunen. Neem voor meer informatie contact op met uw ST
vertegenwoordiger of bezoek de ST website (http://www.st.com).
1.3 DfuSe demonstratie-installatie
1.3.1 Software-installatie
Voer de DfuSe_Demo_V3.0_Setup.exe uit file: de InstallShield Wizard begeleidt u bij het installeren van DfuSe-toepassingen en broncode op uw computer. Wanneer de software met succes is geïnstalleerd, klikt u op de knop "Voltooien". U kunt dan de map met stuurprogramma's verkennen.
De bestuurder files bevinden zich in de map "Driver" in uw installatiepad (C:\Program files\STMicroelectronics\DfuSe).
De broncode voor de Demo-applicatie en DfuSe-bibliotheek bevindt zich in de "C:\Program" Files\STMicroelectronics\DfuSe\Bronnen” map.
Documentatie bevindt zich in de "C:\Program" Files\STMicroelectronics\DfuSe\Sources\Doc” map.
1.3.2 Hardware-installatie
- Sluit het apparaat aan op een vrije USB-poort op uw pc.
- De “Wizard Nieuwe hardware gevonden” start dan. Selecteer de "Installeer vanaf een lijst of specifieke locatie" zoals hieronder weergegeven en klik vervolgens op "Volgende".
- Selecteer 'Niet zoeken. Ik zal het stuurprogramma kiezen om te installeren” zoals hieronder weergegeven en klik vervolgens op “Volgende”.
- Als er al een stuurprogramma is geïnstalleerd, toont de lijst met modellen de compatibele hardwaremodellen, anders klikt u op "Have Disk..." om het stuurprogramma te vinden files.
- Klik in het dialoogvenster "Installeren vanaf schijf" op "Bladeren..." om het stuurprogramma op te geven files locatie, bevindt de drivermap zich in uw installatiepad (C:\Program files\STMicroelectronics\DfuSe\Driver) en klik vervolgens op "OK".
De pc selecteert automatisch de juiste INF file, in dit geval STFU.INF. Zodra Windows het vereiste stuurprogramma heeft gevonden.INF file, wordt het compatibele hardwaremodel weergegeven in de modellenlijst. Klik op "Volgende" om verder te gaan.
- Wanneer Windows de installatie van het stuurprogramma uitvoert, wordt een waarschuwingsvenster weergegeven dat aangeeft dat het stuurprogramma de Windows-logotest niet heeft doorstaan. Klik op "Toch doorgaan" om door te gaan.
- Windows zou dan een bericht moeten weergeven dat aangeeft dat de installatie is geslaagd.
Klik op "Voltooien" om de installatie te voltooien.
DFU file
Gebruikers die DFU-apparaten hebben gekocht, moeten de mogelijkheid hebben om de firmware van deze apparaten te upgraden. Traditioneel wordt firmware opgeslagen in Hex, S19 of Binary files, maar deze formaten bevatten niet de benodigde informatie om de upgradebewerking uit te voeren, ze bevatten alleen de daadwerkelijke gegevens van het te downloaden programma. De DFU-bewerking vereist echter meer informatie, zoals de product-ID, leverancier-ID, firmwareversie en het alternatieve instellingsnummer (doel-ID) van het te gebruiken doel, deze informatie maakt de upgrade gericht en veiliger. Om deze informatie toe te voegen, een nieuwe file formaat moet worden gebruikt, genaamd de DFU file formaat. Raadpleeg voor meer details de "DfuSe" File Formaatspecificatie” document (UM0391).
Beschrijving gebruikersinterface
In dit gedeelte worden de verschillende gebruikersinterfaces beschreven die beschikbaar zijn in het DfuSe-pakket en wordt uitgelegd hoe u deze kunt gebruiken om DFU-bewerkingen uit te voeren, zoals uploaden, downloaden en
firmware file beheer.
3.1 DfuSe-demonstratie
Firmware-upgrades moeten kunnen worden uitgevoerd zonder speciale training, zelfs door beginnende gebruikers. Daarom is de gebruikersinterface ontworpen om zo robuust en gebruiksvriendelijk mogelijk te zijn (zie afbeelding 9). De nummers in Afbeelding 9 verwijzen naar de beschrijving in Tabel 1 met de beschikbare bedieningselementen in de DfuSe-demonstratie-interface.
Tabel 1. gebruik demo-dialoogvensterbeschrijving
| Controle | Beschrijving |
| 1 | Geeft een overzicht van de beschikbare DFU en compatibele HID-apparaten, de geselecteerde is degene die momenteel wordt gebruikt. Een compatibel HID-apparaat is een apparaat van de HID-klasse dat de HID-detach-functie (USAGE_PAGE OxFF0O en USAGE_DETACH 0x0055) in zijn rapportdescriptor biedt. Exampon: Oxa1, Ox00, // Verzameling (fysiek) 0x06, Ox00, OxFF, // Door de leverancier gedefinieerde gebruikspagina - OxFP00 0x85, 0x80, // REPORT_ID (128) 0x09, 0x55, // GEBRUIK (HID losmaken) 0x15, Ox00, // LOGISCH_MINIMUM (0) 0x26, OxFF, Ox00, // LOGISCH_MAXIMUM (255) 0x75, 0x08, // REPORT_SIZE (8 bits) 0x95, Ox01, // REPORT_COUNT (1) Ox131, 0x82, // FUNCTIE (Data,Var,Abs,Vol) OxCO, // END_COLLECTION (leverancier gedefinieerd) |
| 2 | Apparaat-ID's voor DFU-modus; PID, VID en versie. |
| 3 | Apparaat-ID's voor toepassingsmodus; PID, VID en versie. |
| 4 | Verzenden Voer de opdracht DFU-modus in. Target schakelt over van applicatie- naar DFU-modus of stuurt een HID Detach als het apparaat een compatibel HID-apparaat is. |
| 5 | Stuur de opdracht Verlaat de DFU-modus. Doel zal overschakelen van DFU naar toepassingsmodus. |
| 6 | Geheugentoewijzing, dubbelklik op elk item om view meer details over het geheugengedeelte. |
| 7 | Kies de bestemming DFU file, de geüploade gegevens worden hierin gekopieerd file. |
| 8 | Start de uploadbewerking. |
| 9 | Grootte van de overgedragen gegevens tijdens de huidige bewerking (Upload/Upgrade). |
| 10 | Duur van de huidige bewerking (Upload/Upgrade). |
| 11 | Beschikbare doelen in de geladen DFU file. |
| 12 | Kies de bron DFU file, de gedownloade gegevens worden hieruit geladen file. |
| 13 | Start de upgrade-bewerking (wissen en vervolgens downloaden). |
| 14 | Controleer of de gegevens zijn geüpload. |
| 15 | Laat de voortgang van de operatie zien. |
| 16 | Huidige bewerking afbreken. |
| 17 | Sluit applicatie. |
Als de microcontroller in gebruik is in een STM32F105xx of een STM32F107xx, toont de DfuSe-demo een nieuwe functie die bestaat uit het lezen van de optiebytegegevens over het geëxporteerde "Option byte" -geheugengedeelte. Een dubbelklik op het gerelateerde item in de geheugenmap (item 6 in tabel 1 / figuur 9) opent een nieuw dialoogvenster waarin de gelezen optiebytes worden weergegeven. U kunt dit vak gebruiken om uw eigen configuratie te bewerken en toe te passen (zie afbeelding 10).
De tool kan de mogelijkheden van het geselecteerde geheugengedeelte detecteren (lezen, schrijven en wissen). In het geval van een onleesbaar geheugen (uitleesbeveiliging geactiveerd), geeft het de
geheugenleesstatus en prompts om te vragen of de leesbeveiliging moet worden gedeactiveerd of niet.
3.2 DFU file manager
3.2.1 "Wil ik doen" dialoogvenster
Wanneer de DFU file manager-toepassing wordt uitgevoerd, het dialoogvenster "Wil je doen" verschijnt en de gebruiker moet de file operatie die hij wil doen. Selecteer het eerste keuzerondje om een DFU te genereren file van een S19, Hex of Bin file, of de tweede om een S19, Hex of Bin . te extraheren file van een DFU file (zie figuur 11).
Selecteer de "Ik wil een DFU GENEREREN" file van S19, HEX of BIN files" keuzerondje als u een DFU wilt genereren file van S19, Hex of Binair files.
Selecteer de "Ik wil S19, HEX of BIN EXTRACTEREN" files van een DFU één” keuzerondje als u een S19, Hex of Binary wilt extraheren file van een DFU file.
3.2.2 File generatie dialoogvenster
Als de eerste keuze is geselecteerd, klikt u op de knop OK om de "File dialoogvenster Generatie". Met deze interface kan de gebruiker een DFU . genereren file van een S19, Hex of Bin file.
Tabel 2. File beschrijving dialoogvenster generatie
| Controle | Beschrijving |
| 1 | Leveranciers-ID |
| 2 | Productidentificatie |
| 3 | Firmware-versie |
| 4 | Beschikbare afbeeldingen die moeten worden ingevoegd in de DFU file |
| 5 | Doelidentificatienummer |
| 6 | Open S19 of Hex file |
| 7 | Binair openen files |
| 8 | Doelnaam |
| 9 | Geselecteerde afbeelding verwijderen uit de lijst met afbeeldingen |
| 10 | Genereer DFU file |
| 11 | Annuleer en sluit de applicatie |
Omdat S19, Hex en Bin files de doelspecificatie niet bevatten, moet de gebruiker de apparaateigenschappen (VID, PID en versie), de doel-ID en de doelnaam invoeren voordat de DFU wordt gegenereerd file.
Tabel 3. Beschrijving van het dialoogvenster Multi-bin injectie
| Controle | Beschrijving |
| 1 | Pad van het laatst geopende binaire bestand file |
| 2 | Open binair files. een binair file zou een kunnen zijn file van elk formaat (golf, video, tekst, enz.) |
| 3 | Startadres van de geladen file |
| 4 | Toevoegen file naar de file lijst |
| 5 | Verwijderen file van de file lijst |
| 6 | File lijst |
| 7 | Bevestigen file selectie |
| 8 | Bewerking annuleren en afsluiten |
3.2.3 File dialoogvenster voor extractie
Als de tweede keuze in het dialoogvenster "Wil ik doen" is geselecteerd, klikt u op de knop OK om de "File extractie” dialoogvenster. Met deze interface kunt u een S19, Hex of Bin file van een DFU file.
Tabel 4. File beschrijving dialoogvenster extractie
| Controle | Beschrijving |
| 1 | Apparaatverkoper-ID |
| 2 | Product-ID apparaat |
| 3 | Firmware-versie |
| 4 | DFU openen file |
| 5 | Afbeeldingslijst in de geladen DFU file |
| 6 | Type van de file gegenereerd worden |
| 7 | Pak de afbeelding uit naar S19, Hex of Bin file |
| 8 | Annuleer en sluit de applicatie |
Stapsgewijze procedures
4.1 DfuSe-demonstratieprocedures
4.1.1 Een DFU uploaden file
- Voer de toepassing "DfuSe-demonstratie" uit (Start -> Alle programma's -> STMicroelectronics -> DfuSe -> DfuSe-demonstratie).
- Klik op de knop "Kiezen" (item 7 in tabel 1 / figuur 9) om een DFU te selecteren file.
- Selecteer de geheugendoel(en) in de geheugentoewijzingslijst (item 6 in tabel 1 / afbeelding 9).
- Klik op de knop "Uploaden" (item 8 in tabel 1 / afbeelding 9) om geheugeninhoud naar de geselecteerde DFU te uploaden file.
4.1.2 Een DFU downloaden file
- Voer de toepassing "DfuSe-demonstratie" uit (Start -> Alle programma's -> STMicroelectronics -> DfuSe -> DfuSe-demonstratie).
- Klik op de knop "Kiezen" (item 12 in tabel 1 / figuur 9) om een DFU te selecteren file. de weergegeven informatie zoals VID, PID, versie en doelnummer wordt uit de DFU gelezen file.
- Vink het selectievakje "Upgradeduur optimaliseren" aan om FF-blokken tijdens het uploaden te negeren.
- Vink het selectievakje "Verifiëren na downloaden" aan als u het verificatieproces wilt starten na het downloaden van gegevens.
- Klik op de knop "Upgrade" (item 13 in tabel 1 /afbeelding 9) om te beginnen met upgraden file inhoud in het geheugen.
- Klik op de knop "Verifiëren" (item 14 in tabel 1 /afbeelding 9) om te controleren of de gegevens met succes zijn gedownload.
4.2 DFU file leidinggevende procedures
4.2.1 Hoe DFU te genereren files van S19/Hex/Bin files
- Voer de "DFU" uit File Manager”-toepassing (Start -> Alle programma's -> STMicroelectronics > DfuSe-> DFU File Manager).
- Selecteer de "Ik wil een DFU GENEREREN" file van S19, HEX of BIN files” in het dialoogvenster “Wil ik doen” (tabel 1 1 ) en klik vervolgens op “OK”.
- Maak een DFU-afbeelding van een S19/Hex of binair file.
a) Stel een niet-gebruikt doel-ID-nummer in (item 5 in tabel 2 / figuur 12).
b) Vul de VID, PID, Versie en de doelnaam in
c) Om de afbeelding te maken van een S19 of Hex file, klik op de knop "S19 of Hex" (item 6 in tabel 2 / figuur 4) en selecteer uw file, er wordt een DFU-afbeelding gemaakt voor elke toegevoegde file.
d) Om de afbeelding van een of meer binaire bestanden te maken files, klikt u op de knop "Multi Bin" (item 7 in tabel 2 /Figuur 12) om het dialoogvenster "Multi Bin Injection" (Figuur 13.) weer te geven.
Klik op de knop Bladeren (item 2 in tabel 3 / afbeelding 13) om een binair bestand te selecteren file(*.bin) of een ander formaat van file (Golf, Video, Tekst,…).
Stel het startadres in het adresveld in (item 3 in tabel 3 /afbeelding 13).
Klik op de knop "Toevoegen aan lijst" (item 4 in tabel 3 / figuur 13) om het geselecteerde binaire bestand toe te voegen file met het opgegeven adres.
Een bestaande verwijderen file, selecteer het en klik vervolgens op de knop "Verwijderen" (item 5 in tabel 3 /afbeelding 13).
Herhaal dezelfde reeks om een ander binair bestand toe te voegen files, Klik op "OK" om te valideren. - Herhaal stap (3.) om andere DFU-afbeeldingen te maken.
- De DFU maken file, klik op "Genereren".
4.2.2 Hoe S19/Hex/Bin te extraheren files van DFU files
- Voer "DFU" uit File Manager”-toepassing (Start -> Alle programma's -> STMicroelectronics -> DfuSe -> DFU File Beheren).
- Selecteer "Ik wil S19, HEX of BIN EXTRACTEREN" files van een DFU one” keuzerondje in het “Wil to do” dialoogvenster (Figuur 11) en klik vervolgens op “OK”.
- Extraheer een S19/Hex of binair file van een DFU file.
a) Klik op de knop Bladeren (item 4 in tabel 4 /afbeelding 14) om een DFU te selecteren file. De afbeeldingen die erin staan, worden weergegeven in de lijst met afbeeldingen (item 4 in tabel 4 / afbeelding 14).
b) Selecteer een afbeelding uit de lijst met afbeeldingen.
c) Selecteer het keuzerondje Hex, S19 of Multiple Bin (item 6 in tabel 4 /afbeelding 14).
d) Klik op de knop "Extract" (item 7 in tabel 4 /afbeelding 14) om de geselecteerde afbeelding uit te pakken. - Herhaal stap (3.) om andere DFU-afbeeldingen te extraheren.
Revisiegeschiedenis
Tabel 5. Document revisiegeschiedenis
| Datum | Herziening | Wijzigingen |
| 6-07-XNUMX | 1 | Eerste release. |
| 2-jan-08 | 2 | Sectie 4 toegevoegd. |
| 24-08-XNUMX | 3 | Bijgewerkt Afbeelding 9 naar Afbeelding 14. |
| 2-09-XNUMX | 4 | gebruik demo geüpgraded naar versie V3.0. Sectie 3.1: DfuSe-demonstratie bijgewerkt: — Afbeelding 9: DfuSe-demodialoogvenster bijgewerkt — Nieuwe functie toegevoegd voor STM32F105/107xx-apparaten — Afbeelding 10: dialoogvenster Optie byte bewerken toegevoegd Bijgewerkt in sectie 3.2: DFU file manager — Afbeelding 11: dialoogvenster “Wil ik doen” — Afbeelding 12: Dialoogvenster "Generatie" — Afbeelding 13: Dialoogvenster “Injectie met meerdere bakken” — Afbeelding 14: Dialoogvenster "Uitpakken" |
Lees aandachtig:
De informatie in dit document wordt uitsluitend verstrekt in verband met ST-producten. STMicroelectronics NV en haar dochterondernemingen (“ST”) behouden zich het recht voor om te allen tijde en zonder voorafgaande kennisgeving wijzigingen, correcties, aanpassingen of verbeteringen aan dit document en de hierin beschreven producten en diensten aan te brengen.
Alle ST-producten worden verkocht volgens de verkoopvoorwaarden van ST.
Kopers zijn als enige verantwoordelijk voor de keuze, selectie en het gebruik van de ST-producten en diensten die hierin worden beschreven, en ST aanvaardt geen enkele aansprakelijkheid met betrekking tot de keuze, selectie of het gebruik van de ST-producten en diensten die hierin worden beschreven.
Onder dit document wordt geen licentie, expliciet of impliciet, door uitsluiting of anderszins, verleend voor intellectuele eigendomsrechten. Als enig deel van dit document verwijst naar producten of diensten van derden, wordt dit niet beschouwd als een licentieverlening door ST voor het gebruik van dergelijke producten of diensten van derden, of enig intellectueel eigendom dat daarin is vervat of beschouwd als een garantie die het gebruik dekt op welke manier dan ook van dergelijke producten of diensten van derden of enig intellectueel eigendom daarin.
TENZIJ ANDERS IN DE VERKOOPVOORWAARDEN VAN ST IS VERMELD, WIJST ST ELKE UITDRUKKELIJKE OF IMPLICIETE GARANTIE AF MET BETREKKING TOT HET GEBRUIK EN/OF DE VERKOOP VAN ST-PRODUCTEN, INCLUSIEF MAAR NIET BEPERKT TOT IMPLICIETE GARANTIES VAN VERKOOPBAARHEID, VAN EEN JURISDICTIE), OF INBREUK OP ENIG OCTROOI, AUTEURSRECHT OF ANDER INTELLECTUEEL EIGENDOMSRECHT.
TENZIJ UITDRUKKELIJK SCHRIFTELIJK GOEDGEKEURD DOOR EEN ERKENDE ST-VERTEGENWOORDIGER, WORDEN ST-PRODUCTEN NIET AANBEVOLEN, GEMACHTIGD OF GEGARANDEERD VOOR GEBRUIK IN MILITAIRE, VLIEGTUIG-, RUIMTE-, LEVENSREDDENDE OF LEVENSONDERHOUDENDE SYSTEEMTOEPASSINGEN RESULTEREN IN PERSOONLIJK LETSEL, DE DOOD OF ERNSTIGE SCHADE AAN EIGENDOMMEN OF HET MILIEU. ST-PRODUCTEN DIE NIET ZIJN GESPECIFICEERD ALS “AUTOMOTIEVE RANG” KUNNEN ALLEEN OP EIGEN RISICO VAN DE GEBRUIKER WORDEN GEBRUIKT IN AUTO-TOEPASSINGEN.
Doorverkoop van ST-producten met bepalingen die afwijken van de verklaringen en/of technische kenmerken die in dit document zijn uiteengezet, maakt elke garantie die door ST wordt verleend voor het ST-product of de hierin beschreven service onmiddellijk ongeldig en creëert of breidt op geen enkele manier enige aansprakelijkheid uit van ST.
ST en het ST-logo zijn handelsmerken of gedeponeerde handelsmerken van ST in verschillende landen.
De informatie in dit document vervangt en vervangt alle eerder verstrekte informatie.
Het ST-logo is een geregistreerd handelsmerk van STMicroelectronics. Alle andere namen zijn eigendom van hun respectievelijke eigenaren.
© 2009 STMicroelectronics – Alle rechten voorbehouden
STMicroelectronics-bedrijvengroep
Australië – België – Brazilië – Canada – China – Tsjechië – Finland – Frankrijk – Duitsland – Hong Kong – India – Israël – Italië – Japan –
Maleisië – Malta – Marokko – Filippijnen – Singapore – Spanje – Zweden – Zwitserland – Verenigd Koninkrijk – Verenigde Staten van Amerika
www.st.com
Doc-ID 13379 Rev 4
Documenten / Bronnen
 |
ST DfuSe USB-apparaatfirmware-upgrade STMicroelectronics-extensie [pdf] Gebruikershandleiding DfuSe USB-apparaat, firmware-upgrade STMicroelectronics-extensie, DfuSe USB-apparaatfirmware-upgrade, STMicroelectronics-extensie, DfuSe USB-apparaatfirmware-upgrade STMicroelectronics-extensie, UM0412 |
