DfuSe logotypUSB-enhetsfirmware-uppgradering STMicroelectronics Extension
UM0412
Användarmanual

Introduktion

Det här dokumentet beskriver demonstrationsanvändargränssnittet som utvecklades för att illustrera användningen av STMicroelectronics enhetsfirmwareuppgraderingsbibliotek. En beskrivning av detta bibliotek, inklusive dess applikationsprogrammeringsgränssnitt, finns i dokumentet "DfuSe applikationsprogrammeringsgränssnitt" och installeras med DfuSe-programvaran.

Komma igång

1.1 Systemkrav
För att kunna använda DfuSe-demonstrationen med Windows-operativsystemet måste en ny version av Windows, såsom Windows 98SE, Millennium, 2000, XP eller VISTA, vara
installerat på datorn.
Den version av Windows OS som är installerad på din PC kan bestämmas genom att högerklicka på "Den här datorn"-ikonen på skrivbordet och sedan klicka på "Egenskaper" i popupmenyn som visas. OS-typen visas i dialogrutan "Systemegenskaper" under etiketten "System" på flikbladet "Allmänt" (se figur 1).

Figur 1. Dialogrutan Systemegenskaper

DfuSe USB Device Firmware Upgrade STMicroelectronics Extension

1.2 Förpackningens innehåll
Följande artiklar levereras i detta paket:
Programvaruinnehåll

  1. STtube-drivrutin som består av de två följande files:
    – STTub30.sys: Drivrutin som ska laddas för demokortet.
    – STFU.inf: Konfiguration file för föraren.
  2. DfuSe_Demo_V3.0_Setup.exe: Installation file som installerar DfuSe-applikationerna och källkoden på din dator.

Hårdvaruinnehåll
Det här verktyget är utformat för att fungera med alla STMicroelectronics-enheter som stöder uppgradering av enhetsfirmware via ett USB-gränssnitt. För mer information, kontakta din ST
representant eller besök ST webwebbplats (http://www.st.com).

1.3 DfuSe demonstrationsinstallation
1.3.1 Installation av programvara

Kör DfuSe_Demo_V3.0_Setup.exe file: InstallShield-guiden vägleder dig att installera DfuSe-applikationer och källkod på din dator. När programvaran har installerats, klicka på knappen "Slutför". Du kan sedan utforska drivrutinskatalogen.
Föraren files finns i mappen "Driver" i din installationssökväg (C:\Program files\STMicroelectronics\DfuSe).
Källkoden för demoapplikationen och DfuSe-biblioteket finns i "C:\Program Files\STMicroelectronics\DfuSe\Sources".
Dokumentationen finns i "C:\Program Files\STMicroelectronics\DfuSe\Sources\Doc”-mappen.

1.3.2 Installation av hårdvara

  • Anslut enheten till en extra USB-port på din PC.
  • "Guiden Hitta ny maskinvara" startar sedan. Välj "Installera från en lista eller specifik plats" som visas nedan och klicka sedan på "Nästa".DfuSe USB Device Firmware Upgrade STMicroelectronics Extension - Figur 2
  • Välj "Sök inte. Jag kommer att välja drivrutinen att installera” som visas nedan och klicka sedan på “Nästa”.
    DfuSe USB Device Firmware Upgrade STMicroelectronics Extension - Figur 3
  • Om en drivrutin redan är installerad kommer modelllistan att visa de kompatibla maskinvarumodellerna, annars klicka på "Har diskett..." för att hitta drivrutinen files.
    DfuSe USB Device Firmware Upgrade STMicroelectronics Extension - Figur 4
  • I dialogrutan "Installera från disk", klicka på "Bläddra..." för att ange drivrutinen files plats finns drivrutinskatalogen i din installationssökväg (C:\Program files\STMicroelectronics\DfuSe\Driver), klicka sedan på "OK".
    Datorn väljer automatiskt rätt INF file, i det här fallet STFU.INF. När Windows har hittat den nödvändiga drivrutinen.INF file, kommer den kompatibla hårdvarumodellen att visas i modelllistan. Klicka på "Nästa" för att fortsätta.
    DfuSe USB Device Firmware Upgrade STMicroelectronics Extension - Figur 5
  • När Windows utför drivrutinsinstallationen kommer en varningsdialogruta att visas som indikerar att drivrutinen inte har klarat Windows-logotyptestningen, klicka på "Fortsätt ändå" för att fortsätta.
    DfuSe USB Device Firmware Upgrade STMicroelectronics Extension - Figur 6DfuSe USB Device Firmware Upgrade STMicroelectronics Extension - Figur 7
  • Windows bör då visa ett meddelande som indikerar att installationen lyckades.
    Klicka på "Slutför" för att slutföra installationen.DfuSe USB Device Firmware Upgrade STMicroelectronics Extension - Figur 8

DFU file

Användare som har köpt DFU-enheter kräver möjligheten att uppgradera den fasta programvaran för dessa enheter. Traditionellt lagras firmware i Hex, S19 eller Binary files, men dessa format innehåller inte den nödvändiga informationen för att utföra uppgraderingen, de innehåller bara de faktiska data om programmet som ska laddas ner. DFU-operationen kräver dock mer information, såsom produktidentifierare, leverantörsidentifierare, Firmware-version och det alternativa inställningsnumret (Target ID) för målet som ska användas, denna information gör uppgraderingen målinriktad och säkrare. För att lägga till denna information, en ny file format bör användas, för att kallas DFU file formatera. För mer information se “DfuSe File Format Specification” dokument (UM0391).

Användargränssnittsbeskrivning

Det här avsnittet beskriver de olika användargränssnitten som är tillgängliga i DfuSe-paketet och förklarar hur man använder dem för att utföra DFU-operationer som t.ex. Ladda upp, Ladda ner och
firmware file förvaltning.

3.1 DfuSe-demonstration
Firmware-uppgraderingar måste kunna utföras utan någon speciell utbildning, även av nybörjare. Därför utformades användargränssnittet för att vara så robust och enkelt att använda som möjligt (se figur 9). Siffrorna i figur 9 hänvisar till beskrivningen i tabell 1 som listar de tillgängliga kontrollerna i DfuSe-demonstrationsgränssnittet.

DfuSe USB Device Firmware Upgrade STMicroelectronics Extension - Figur 9

Tabell 1. beskrivning av dialogrutan för användning av demo

Kontrollera Beskrivning
1 Listar tillgängliga DFU och kompatibla HID-enheter, den valda är den som används för närvarande.
En kompatibel HID-enhet är en HID-klassenhet som tillhandahåller HID-frånkopplingsfunktionen (USAGE_PAGE OxFF0O och USAGE_DETACH 0x0055) i sin rapportbeskrivning.
Exampde:
Oxa1, Ox00, // Samling (fysisk)
0x06, Ox00, OxFF, // Leverantörsdefinierad användningssida – OxFP00 0x85, 0x80, // REPORT_ID (128)
0x09, 0x55, // ANVÄNDNING (HID Lossa)
0x15, Ox00, // LOGICAL_MINIMUM (0)
0x26, OxFF, Ox00, // LOGICAL_MAXIMUM (255)
0x75, 0x08, // REPORT_SIZE (8 bitar)
0x95, Ox01, // REPORT_COUNT (1)
Ox131, 0x82, // FUNKTION (Data,Var,Abs,Vol)
OxCO, // END_COLLECTION (definierad leverantör)
2 Enhetsidentifierare för DFU-läge; PID, VID och version.
3 Enhetsidentifierare för applikationsläge; PID, VID och version.
4 Skicka Ange kommandot DFU-läge. Target växlar från applikation till DFU-läge eller skickar en HID-avskiljning om enheten är en kompatibel HID-enhet.
5 Skicka kommandot Lämna DFU-läge. Target växlar från DFU till applikationsläge.
6 Minneskartläggning, dubbelklicka på varje objekt för att view mer information om minnesdelen.
7 Välj destinations-DFU file, kommer den uppladdade informationen att kopieras till denna file.
8 Starta uppladdningsoperationen.
9 Storleken på överförd data under den aktuella operationen (Ladda upp/Uppgradera).
10 Varaktighetstid för den aktuella operationen (Ladda upp/Uppgradera).
11 Tillgängliga mål i den laddade DFU file.
12 Välj källan DFU file, kommer den nedladdade datan att laddas från denna file.
13 Starta uppgraderingen (Radera och ladda ner).
14 Kontrollera om data laddades upp.
15 Visa operationens förlopp.
16 Avbryt aktuell operation.
17 Avsluta applikationen.

Om mikrokontrollern som används i en STM32F105xx eller en STM32F107xx visar DfuSe-demon en ny funktion som består i att läsa alternativbytedata över den exporterade "Option byte"-minnesdelen. Ett dubbelklick på det relaterade objektet i minneskartan (objekt 6 i tabell 1/Figur 9) öppnar en ny dialogruta som visar byte för läsalternativ. Du kan använda den här rutan för att redigera och tillämpa din egen konfiguration (se figur 10).
Verktyget kan upptäcka funktionerna hos den valda minnesdelen (läsa, skriva och radera). I händelse av ett oläsbart minne (avläsningsskydd aktiverat), indikerar det
minneslässtatus och frågar om lässkyddet ska avaktiveras eller inte.

DfuSe USB Device Firmware Upgrade STMicroelectronics Extension - Figur 103.2 DFU file chef
3.2.1 Dialogrutan "Vill göra".
När DFU file managerapplikationen körs, dialogrutan "Vill göra" visas och användaren måste välja file operation han vill göra. Välj den första radioknappen för att skapa en DFU file från en S19, Hex eller Bin file, eller den andra för att extrahera en S19, Hex eller Bin file från en DFU file (se figur 11).DfuSe USB Device Firmware Upgrade STMicroelectronics Extension - Figur 11 Välj "Jag vill GENERERA en DFU file från S19, HEX eller BIN files” radioknapp om du vill skapa en DFU file från S19, Hex eller Binary files.
Välj "Jag vill EXTRAHERA S19, HEX eller BIN files från en DFU one” radioknapp om du vill extrahera en S19, Hex eller Binary file från en DFU file.

3.2.2 File generationsdialogrutan
Om det första valet valdes, klicka på OK-knappen för att visa "File Genereringsdialogrutan”. Detta gränssnitt tillåter användaren att generera en DFU file från en S19, Hex eller Bin file.
DfuSe USB Device Firmware Upgrade STMicroelectronics Extension - Figur 12

Tabell 2. File beskrivning av genereringsdialogrutan

Kontrollera Beskrivning
1 Leverantörsidentifierare
2 Produktidentifierare
3 Firmware-version
4 Tillgängliga bilder som ska infogas i DFU file
5 Målidentifieringsnummer
6 Öppna S19 eller Hex file
7 Öppna Binär files
8 Målnamn
9 Ta bort vald bild från bildlistan
10 Skapa DFU file
11 Avbryt och avsluta applikationen

Eftersom S19, Hex och Bin files inte innehåller målspecifikationen måste användaren ange enhetsegenskaper (VID, PID och version), mål-ID och målnamn innan DFU genereras file.

DfuSe USB Device Firmware Upgrade STMicroelectronics Extension - Figur 13
Tabell 3. Beskrivning av dialogrutan för insprutning med flera fack

Kontrollera Beskrivning
1 Sökväg för den senast öppnade binära filen file
2 Öppna binär files. En binär file kan vara en file av valfritt format (våg, video, text, etc.)
3 Startadress för den laddade file
4 Tillägga file till file lista
5 Radera file från file lista
6 File lista
7 Bekräfta file urval
8 Avbryt och avsluta operationen

3.2.3 File utvinningsdialogrutan
Om det andra valet i dialogrutan "Vill göra" valdes, klicka på OK-knappen för att visa "File extrahering” dialogrutan. Detta gränssnitt låter dig generera en S19, Hex eller Bin file från en DFU file.
DfuSe USB Device Firmware Upgrade STMicroelectronics Extension - Figur 14

Tabell 4. File beskrivning av extraktionsdialogrutan

Kontrollera Beskrivning
1 Identifierare för enhetsleverantör
2 Enhetens produktidentifierare
3 Firmware-version
4 Öppna DFU file
5 Bildlista i den laddade DFU:n file
6 Typ av file som ska genereras
7 Extrahera bilden till S19, Hex eller Bin file
8 Avbryt och avsluta applikationen

Steg-för-steg-procedurer

4.1 DfuSe demonstrationsprocedurer
4.1.1 Hur man laddar upp en DFU file

  1. Kör programmet “DfuSe demonstration” (Start -> Alla program -> STMicroelectronics -> DfuSe -> DfuSe Demonstration).
  2. Klicka på knappen "Välj" (objekt 7 i tabell 1 /Figur 9) för att välja en DFU file.
  3. Välj minnesmål i minnesmappningslistan (objekt 6 i tabell 1 /Figur 9).
  4. Klicka på knappen "Ladda upp" (objekt 8 i tabell 1 /Figur 9) för att börja ladda upp minnesinnehåll till den valda DFU:n file.

4.1.2 Hur man laddar ner en DFU file

  1. Kör programmet “DfuSe demonstration” (Start -> Alla program -> STMicroelectronics -> DfuSe -> DfuSe Demonstration).
  2. Klicka på knappen "Välj" (objekt 12 i tabell 1 /Figur 9) för att välja en DFU file. den visade informationen såsom VID, PID, version och målnummer läses från DFU file.
  3. Markera kryssrutan "Optimera uppgraderingslängd" för att ignorera FF-blockeringar under uppladdningen.
  4. Markera kryssrutan "Verifiera efter nedladdning" om du vill starta verifieringsprocessen efter nedladdning av data.
  5. Klicka på knappen "Uppgradera" (objekt 13 i tabell 1/Figur 9) för att börja uppgradera file innehåll till minnet.
  6. Klicka på "Verifiera"-knappen (Artikel 14 i tabell 1 /Figur 9) för att verifiera om data laddades ned.

4.2 DFU file chefsrutiner
4.2.1 Hur man genererar DFU files från S19/Hex/Bin files

  1. Kör "DFU File Manager” applikation (Start -> Alla program -> STMicroelectronics > DfuSe-> DFU File Chef).
  2. Välj "Jag vill GENERERA en DFU file från S19, HEX eller BIN files" i dialogrutan "Vill göra" (Tabl e 1 1 ) klicka sedan på "OK".
  3. Skapa en DFU-bild från en S19/Hex eller binär file.
    a) Ställ in ett oanvänt mål-ID-nummer (objekt 5 i tabell 2 /Figur 12).
    b) Fyll i VID, PID, Version och målnamnet
    c) Att skapa bilden från en S19 eller Hex file, klicka på knappen "S19 eller Hex" (objekt 6 i tabell 2 /Figur 4) och välj din file, kommer en DFU-bild att skapas för varje tillagd file.
    d) Att skapa bilden från en eller flera binära files, klicka på knappen "Multi Bin" (Artikel 7 i tabell 2 /Figur 12) för att visa dialogrutan "Multi Bin Injection" (Figur 13.).
    Klicka på knappen Bläddra (objekt 2 i tabell 3 /Figur 13) för att välja en binär file(*.bin) eller annat format av file (Våg, video, text,...).
    Ställ in startadressen i adressfältet (punkt 3 i tabell 3 /Figur 13).
    Klicka på knappen "Lägg till i lista" (objekt 4 i tabell 3 /Figur 13) för att lägga till den valda binära filen file med den angivna adressen.
    För att ta bort en befintlig file, välj den och klicka sedan på knappen "Radera" (objekt 5 i tabell 3 /Figur 13).
    Gör om samma sekvens för att lägga till andra binära filer files, Klicka på "OK" för att validera.
  4. Upprepa steg (3.) för att skapa andra DFU-bilder.
  5. För att skapa DFU file, klicka på "Generera".

4.2.2 Hur man extraherar S19/Hex/Bin files från DFU files

  1. Kör "DFU File Manager” applikation (Start -> Alla program -> STMicroelectronics -> DfuSe -> DFU File Klara av).
  2. Välj "Jag vill EXTRAHERA S19, HEX eller BIN files från en DFU one"-radioknapp i dialogrutan "Vill göra" (Figur 11) och klicka sedan på "OK".
  3. Extrahera en S19/Hex eller binär file från en DFU file.
    a) Klicka på knappen Bläddra (Artikel 4 i tabell 4 /Figur 14) för att välja en DFU file. De ingående bilderna kommer att listas i bildlistan (objekt 4 i tabell 4 /Figur 14).
    b) Välj en bild från bildlistan.
    c) Välj radioknapp Hex, S19 eller Multiple Bin (Artikel 6 i tabell 4 /Figur 14).
    d) Klicka på knappen "Extrahera" (objekt 7 i tabell 4 /Figur 14) för att extrahera den valda bilden.
  4. Upprepa steg (3.) för att extrahera andra DFU-bilder.

Revisionshistorik

Tabell 5. Dokumentrevisionshistorik

Datum Revision Ändringar
6 juni 07 1 Initial release.
2-08 januari 2 Lade till avsnitt 4.
24 september 08 3 Uppdaterade figur 9 till figur 14.
2-09 juli 4 använd demo uppgraderad till version V3.0.
Avsnitt 3.1: DfuSe-demonstration uppdaterad:
— Figur 9: DfuSe-demodialogrutan uppdaterad
— Ny funktion tillagd för STM32F105/107xx-enheter — Figur 10: Dialogrutan Redigera alternativbyte har lagts till Uppdaterad i avsnitt 3.2: DFU file chef
— Figur 11: Dialogrutan "Vill göra".
— Figur 12: Dialogrutan "Generation".
— Figur 13: Dialogrutan "Multi bin Injection".
— Figur 14: Dialogrutan "Extrahera".

Vänligen läs noggrant:

Informationen i detta dokument ges endast i samband med ST-produkter. STMicroelectronics NV och dess dotterbolag (“ST”) förbehåller sig rätten att göra ändringar, korrigeringar, modifieringar eller förbättringar av detta dokument och de produkter och tjänster som beskrivs häri när som helst och utan föregående meddelande.
Alla ST-produkter säljs i enlighet med ST:s försäljningsvillkor.
Köpare är ensam ansvarig för valet, urvalet och användningen av ST-produkterna och -tjänsterna som beskrivs häri, och ST tar inget som helst ansvar avseende valet, urvalet eller användningen av ST-produkterna och -tjänsterna som beskrivs häri.
Ingen licens, uttrycklig eller underförstådd, genom estoppel eller på annat sätt, till några immateriella rättigheter beviljas under detta dokument. Om någon del av detta dokument hänvisar till tredje parts produkter eller tjänster ska det inte betraktas som en licens beviljad av ST för användningen av sådana tredjepartsprodukter eller tjänster, eller någon immateriell egendom som finns däri eller betraktas som en garanti som täcker användningen på något sätt av sådana tredjepartsprodukter eller tjänster eller någon immateriell egendom som finns däri.
(OM INTE ANNAT SÄTTS I ST:S FÖRSÄLJNINGSVILLKOR FRÅNSÄGER ST sig ALLA UTTRYCKTA ELLER UNDERFÖRSTÅDDA GARANTIER MED REPETERANDE TILL ANVÄNDNING OCH/ELLER FÖRSÄLJNING AV ST-PRODUKTER INKLUSIVE UTAN BEGRÄNSNING UNDERFÖRSTÅDDA GARANTIER OCH ANSTÄLLDA GARANTIER OCH FÖRVALTNING AV ANVÄNDNINGEN AV NÅGON JURISDIKTION), ELLER BROTT PÅ NÅGOT PATENT, COPYRIGHT ELLER ANNAN IMMATERIELL RÄTTIGHET.
MAY OM INTE UTTRYCKLIGEN GODKÄNTS SKRIFTLIGT AV EN AUKTORISERAD ST-REPRESSENTANT, ÄR ST-PRODUKTER INTE REKOMMENDERADE, AUKTORISERADE ELLER GARANTERADE FÖR ANVÄNDNING I MILITÄR, FLYGFARTYG, RYMD, LIVSRÄDNING, ELLER LIVSRÄDNING ELLER LIVSSÄTTNING RESULTERA I PERSONSKADA, DÖDSFALL ELLER ALLVARLIG EGENDOM ELLER MILJÖSKADA. ST-PRODUKTER SOM INTE ÄR SPECIFICERADE SOM "AUTOMOTIV GRADE" FÅR ENDAST ANVÄNDAS I AUTOMOTIVA APPLIKATIONER PÅ ANVÄNDARENS EGEN RISK.
Återförsäljning av ST-produkter med bestämmelser som skiljer sig från de uttalanden och/eller tekniska egenskaper som anges i detta dokument ska omedelbart ogiltigförklara alla garantier som beviljats ​​av ST för ST-produkten eller tjänsten som beskrivs häri och ska inte skapa eller på något sätt utvidga något ansvar för ST.
ST och ST-logotypen är varumärken eller registrerade varumärken som tillhör ST i olika länder.
Informationen i detta dokument ersätter och ersätter all information som tidigare lämnats.
ST-logotypen är ett registrerat varumärke som tillhör STMicroelectronics. Alla andra namn tillhör sina respektive ägare.

© 2009 STMicroelectronics – Alla rättigheter reserverade
STMicroelectronics grupp av företag
Australien – Belgien – Brasilien – Kanada – Kina – Tjeckien – Finland – Frankrike – Tyskland – Hongkong – Indien – Israel – Italien – Japan –
Malaysia – Malta – Marocko – Filippinerna – Singapore – Spanien – Sverige – Schweiz – Storbritannien – USA
www.st.com
Dokument-ID 13379 Rev 4

Dokument/resurser

ST DfuSe USB Device Firmware Upgrade STMicroelectronics Extension [pdf] Användarmanual
DfuSe USB Device, Firmware Upgrade STMicroelectronics Extension, DfuSe USB Device Firmware Upgrade, STMicroelectronics Extension, DfuSe USB Device Firmware Upgrade STMicroelectronics Extension, UM0412

Referenser

Lämna en kommentar

Din e-postadress kommer inte att publiceras. Obligatoriska fält är markerade *