USB Device Firmware Upgrade STMicroelectronics Extension
UM0412
User manual

Pasiuna

Kini nga dokumento naghulagway sa demonstration user interface nga gihimo aron ihulagway ang paggamit sa STMicroelectronics device firmware upgrade library. Usa ka deskripsyon niini nga librarya, lakip ang interface sa pagprograma sa aplikasyon niini, naa sa dokumento nga "DfuSe application programming interface" ug gi-install sa software nga DfuSe.

Pagsugod

1.1 Mga kinahanglanon sa sistema
Aron magamit ang demonstrasyon sa DfuSe sa Windows operating system, ang bag-ong bersyon sa Windows, sama sa Windows 98SE, Millennium, 2000, XP, o VISTA, kinahanglan
gi-install sa PC.
Ang bersyon sa Windows OS nga na-install sa imong PC mahimong matino pinaagi sa pag-right-click sa icon nga "My Computer" sa desktop, dayon pag-klik sa item nga "Properties" sa gipakita nga PopUpMenu. Ang matang sa OS gipakita sa "System Properties" dialog box ubos sa "System" label sa "General" nga tab sheet (tan-awa ang Figure 1).

Figure 1. System properties dialog box

1.2 Mga sulod sa package
Ang mosunod nga mga butang gihatag niini nga pakete:
Mga sulod sa software

1. STTube driver nga gilangkoban sa duha ka mosunod files:
   – STTub30.sys: Ang drayber ikarga para sa demo board.
   – STFU.inf: Configuration file para sa driver.
2. DfuSe_Demo_V3.0_Setup.exe: Pag-instalar file nga nag-install sa mga aplikasyon sa DfuSe ug source code sa imong kompyuter.

Mga sulud sa hardware
Kini nga himan gidesinyo sa pagtrabaho uban sa tanang STMicroelectronics device nga nagsuporta sa Device Firmware Upgrade pinaagi sa USB interface. Para sa dugang detalye, palihog kontaka ang imong ST
representante o bisitaha ang ST weblugar (http://www.st.com).

1.3 Pag-instalar sa demonstrasyon sa DfuSe
1.3.1 Pag-instalar sa software

Pagdalagan ang DfuSe_Demo_V3.0_Setup.exe file: ang InstallShield Wizard mogiya kanimo sa pag-instalar sa DfuSe nga mga aplikasyon ug source code sa imong computer. Kung ang software malampuson nga na-install, i-klik ang "Finish" button. Mahimo nimong susihon ang direktoryo sa drayber.
Ang drayber files nahimutang sa folder nga "Driver" sa imong agianan sa pag-install (C:\Program files\STMicroelectronics\DfuSe).
Ang source code alang sa Demo application ug DfuSe library nahimutang sa “C:\Program Files\STMicroelectronics\DfuSe\Sources" folder.
Ang dokumentasyon nahimutang sa "C:\Program Files\STMicroelectronics\DfuSe\Sources\Doc" nga folder.

1.3.2 Pag-instalar sa hardware

• Ikonektar ang device ngadto sa usa ka ekstrang USB port sa imong PC.
• Ang "Nakita nga Bag-ong Hardware Wizard" unya magsugod. Pilia ang "I-install gikan sa usa ka lista o piho nga lokasyon" sama sa gipakita sa ubos ug dayon i-klik ang "Sunod".
• Pilia ang “Ayaw pangitaa. Akong pilion ang drayber nga i-install" ingon sa gipakita sa ubos ug dayon i-klik ang "Sunod".
  
• Kung na-install na ang usa ka drayber, ang lista sa modelo magpakita sa mga katugbang nga modelo sa hardware, kung dili i-klik ang "Adunay Disk ..." aron makit-an ang drayber files.
  
• Sa "Install From Disk" dialog box, i-klik ang "Browse ..." aron mahibal-an ang drayber files lokasyon, ang direktoryo sa drayber nahimutang sa imong agianan sa pag-install (C:\Program files\STMicroelectronics\DfuSe\Driver), unya i-klik ang "OK".
  Gipili sa PC ang husto nga INF file, sa niini nga kaso, STFU.INF. Kung nakit-an na sa Windows ang gikinahanglan nga driver.INF file, ang compatible nga modelo sa hardware ipakita sa listahan sa modelo. I-klik ang "Sunod" aron magpadayon.
  
• Sa diha nga ang Windows nagpahigayon sa pag-instalar sa drayber, usa ka pasidaan nga dialog ang ipakita nga nagpakita nga ang drayber wala nakapasar sa Windows logo testing, i-klik ang "Continue Anyway" aron magpadayon.
  
• Ang Windows kinahanglan unya magpakita sa usa ka mensahe nga nagpaila nga ang pag-install malampuson.
  I-klik ang "Finish" aron makompleto ang instalasyon.

DFU file

Ang mga tiggamit nga nakapalit sa mga aparato sa DFU nanginahanglan katakus sa pag-upgrade sa firmware sa kini nga mga aparato. Sa naandan, ang firmware gitipigan sa Hex, S19 o Binary files, apan kini nga mga format wala maglangkob sa gikinahanglan nga kasayuran aron mahimo ang pag-upgrade nga operasyon, kini naglangkob lamang sa aktwal nga datos sa programa nga ma-download. Bisan pa, ang operasyon sa DFU nanginahanglan dugang nga kasayuran, sama sa identifier sa produkto, identifier sa vendor, bersyon sa Firmware ug ang Alternate setting number (Target ID) sa target nga gamiton, kini nga kasayuran naghimo sa pag-upgrade nga gipunting ug mas luwas. Aron idugang kini nga kasayuran, usa ka bag-o file format kinahanglang gamiton, nga tawgon nga DFU file format. Alang sa dugang nga mga detalye tan-awa ang "DfuSe File Pagtino sa Format" nga dokumento (UM0391).

Pagbatbat sa interface sa tiggamit

Kini nga seksyon naghulagway sa lain-laing mga user interface nga anaa sa DfuSe package ug nagpatin-aw sa unsa nga paagi sa paggamit kanila sa pagbuhat sa DFU operasyon sama sa Upload, Download ug
firmware file pagdumala.

3.1 Demonstrasyon sa DfuSe
Ang pag-upgrade sa firmware kinahanglan nga mahimo nga wala’y espesyal nga pagbansay, bisan sa mga bag-ong tiggamit. Busa, ang user interface gidisenyo aron mahimong lig-on ug yano nga gamiton kutob sa mahimo (tan-awa ang Figure 9). Ang mga numero sa Figure 9 nagtumong sa deskripsyon sa Ta bl e 1 nga naglista sa mga magamit nga kontrol sa DfuSe Demonstration interface.

Talaan 1. gamita ang demo dialog box nga paghulagway

Pagkontrol	Deskripsyon
1	Naglista sa anaa nga DFU ug compatible HID device, ang napili mao ang gigamit karon. Ang Compatible HID device kay HID class device nga naghatag ug HID detach feature (USAGE_PAGE OxFF0O ug USAGE_DETACH 0x0055) sa report descriptor niini. Example: Oxa1, Ox00, // Koleksyon(Pisikal) 0x06, Ox00, OxFF, // Gihubit sa vendor ang panid sa paggamit - OxFP00 0x85, 0x80, // REPORT_ID (128) 0x09, 0x55, // PAGGAMIT (HID Detach) 0x15, Ox00, // LOGICAL_MINIMUM (0) 0x26, OxFF, Ox00, // LOGICAL_MAXIMUM (255) 0x75, 0x08, // REPORT_SIZE (8 bits) 0x95, Ox01, // REPORT_COUNT (1) Ox131, 0x82, // FEATURE (Data, Var, Abs, Vol) OxCO, // END_COLLECTION (Gipasabot ang vendor)
2	Mga identifier sa device alang sa DFU mode; PID, VID ug Bersyon.
3	Mga identifier sa device para sa Application mode; PID, VID ug Bersyon.
4	Ipadala ang Enter DFU mode command. Ang target mobalhin gikan sa Application ngadto sa DFU mode o magpadala ug HID Detach kon ang device usa ka compatible HID device.
5	Ipadala ang Leave DFU mode command. Ang target mobalhin gikan sa DFU ngadto sa Application mode.
6	Memory mapping, Doble-klik ang matag aytem aron view dugang nga mga detalye bahin sa bahin sa memorya.
7	Pilia ang destinasyon DFU file, ang gi-upload nga datos makopya niini file.
8	Pagsugod sa operasyon sa Pag-upload.
9	Gidak-on sa gibalhin nga datos sa panahon sa kasamtangan nga operasyon (Upload/Upgrade).
10	Gidugayon sa panahon sa kasamtangan nga operasyon (Upload/Upgrade).
11	Anaa nga mga target sa gikarga nga DFU file.
12	Pilia ang tinubdan DFU file, ang na-download nga datos ikarga gikan niini file.
13	Sugdi ang operasyon sa pag-upgrade (Para dayon i-download).
14	Tinoa kung malampuson nga na-upload ang datos.
15	Ipakita ang pag-uswag sa operasyon.
16	I-abort ang kasamtangan nga operasyon.
17	Paggawas sa aplikasyon.

Kung ang microcontroller nga gigamit sa usa ka STM32F105xx o usa ka STM32F107xx, ang DfuSe demo nagpakita sa usa ka bag-ong bahin nga naglangkob sa pagbasa sa opsyon nga byte data sa ibabaw sa gi-eksport nga "Option byte" nga bahin sa memorya. Ang doble nga pag-klik sa may kalabutan nga butang sa memory map (Item 6 sa Ta bl e 1 / Figure 9) magbukas sa bag-ong dialog box nga nagpakita sa read option bytes. Mahimo nimong gamiton kini nga kahon sa pag-edit ug paggamit sa imong kaugalingong configuration (tan-awa ang Figure 10).
Ang himan makahimo sa pag-ila sa mga kapabilidad sa pinili nga bahin sa panumduman (pagbasa, pagsulat ug pagpapas). Kung adunay dili mabasa nga panumduman (gi-aktibo ang proteksyon sa pagbasa), kini nagpaila sa
kahimtang sa pagbasa sa memorya ug nag-aghat sa pagpangutana kung i-deactivate ba ang proteksyon sa pagbasa o dili.

3.2 DFU file manedyer
3.2.1 “Gusto buhaton” dialog box
Sa diha nga ang DFU file manager application kay gipatuman, ang "Gustong buhaton" nga dialog box makita, ug ang user kinahanglang mopili sa file operasyon nga gusto niyang buhaton. Pilia ang unang Radio button aron makamugna og DFU file gikan sa S19, Hex, o Bin file, o ang ikaduha sa pagkuha sa usa ka S19, Hex, o Bin file gikan sa DFU file (tan-awa ang Figure 11). Pilia ang "Gusto ko nga MAGHIMO og DFU file gikan sa S19, HEX, o BIN files” radio button kung gusto nimo nga makamugna og DFU file gikan sa S19, Hex, o Binary files.
Pilia ang "Gusto kong I-EXTRACT ang S19, HEX, o BIN files gikan sa usa ka DFU one” radio button kung gusto nimo magkuha ug S19, Hex, o Binary file gikan sa DFU file.

3.2.2 File henerasyon nga dialog box
Kung gipili ang una nga kapilian, i-klik ang OK button aron ipakita ang "File Generation dialog box". Kini nga interface nagtugot sa user sa pagmugna sa usa ka DFU file gikan sa S19, Hex, o Bin file.

Talaan 2. File paghulagway sa kahon sa dialogo sa henerasyon

Pagkontrol	Deskripsyon
1	Identifier sa vendor
2	Nagpaila sa produkto
3	Bersyon sa firmware
4	Anaa nga mga hulagway nga isulod sa DFU file
5	Target nga identifier nga numero
6	Ablihi ang S19 o Hex file
7	Bukas nga Binary files
8	Target nga ngalan
9	Kuhaa ang pinili nga hulagway gikan sa listahan sa mga hulagway
10	Paghimo DFU file
11	Pagkansela ug paggawas sa aplikasyon

Tungod kay ang S19, Hex ug Bin files wala maglangkob sa target nga detalye, ang tiggamit kinahanglan nga mosulod sa mga kabtangan sa Device (VID, PID, ug bersyon), ang Target ID ug ang target nga ngalan sa wala pa maghimo sa DFU file.

Talaan 3. Deskripsyon sa dialog box sa multi-bin injection

Pagkontrol	Deskripsyon
1	Path sa katapusang giablihan nga binary file
2	Bukas nga binary files. Usa ka binary file mahimong a file sa bisan unsang format (Wave, video, Text, ug uban pa)
3	Pagsugod sa adres sa gikarga file
4	Idugang file ngadto sa file listahan
5	Pagtangtang file gikan sa file listahan
6	File listahan
7	Confirm file pagpili
8	Pagkansela ug paggawas sa operasyon

3.2.3 File kahon sa dialogo sa pagkuha
Kung ang ikaduha nga kapilian sa "Gusto buhaton" nga dialog box gipili, I-klik ang OK nga buton aron ipakita ang "File extraction" nga dialog box. Kini nga interface nagtugot kanimo sa pagmugna og S19, Hex, o Bin file gikan sa DFU file.

Talaan 4. File Deskripsyon sa dialog box sa pagkuha

Pagkontrol	Deskripsyon
1	Identifier sa vendor sa device
2	Identifier sa produkto sa device
3	Bersyon sa firmware
4	Ablihi ang DFU file
5	Listahan sa hulagway sa gikarga nga DFU file
6	Uri sa file nga mamugna
7	I-extract ang hulagway ngadto sa S19, Hex, o Bin file
8	Pagkansela ug paggawas sa aplikasyon

Mga lakang-sa-lakang nga mga pamaagi

4.1 Mga pamaagi sa pagpakita sa DfuSe
4.1.1 Unsaon pag-upload og DFU file

1. Pagdalagan ang aplikasyon nga "DfuSe demonstration" (Start -> All Programs -> STMicroelectronics -> DfuSe -> DfuSe Demonstration).
2. I-klik ang “Pilia” nga buton (Item 7 sa Ta bl e 1 /Figure 9) aron makapili og DFU file.
3. Pilia ang (mga) target sa memorya sa listahan sa memory mapping (Item 6 sa Tala 1 /Figure 9).
4. I-klik ang “Upload” nga buton (Item 8 sa Ta bl e 1 /Figure 9) aron magsugod sa pag-upload sa sulod sa memorya ngadto sa pinili nga DFU file.

4.1.2 Unsaon pag-download sa DFU file

1. Pagdalagan ang aplikasyon nga "DfuSe demonstration" (Start -> All Programs -> STMicroelectronics -> DfuSe -> DfuSe Demonstration).
2. I-klik ang “Pilia” nga buton (Item 12 sa Ta bl e 1 /Figure 9) aron makapili og DFU file. ang gipakita nga Impormasyon sama sa VID, PID, Bersyon, ug target nga numero gibasa gikan sa DFU file.
3. Susiha ang checkbox nga "I-optimize ang gidugayon sa pag-upgrade" aron dili ibalewala ang mga bloke sa FF sa panahon sa pag-upload.
4. Susiha ang checkbox nga "I-verify pagkahuman sa pag-download" kung gusto nimo ilunsad ang proseso sa pag-verify pagkahuman sa pag-download sa datos.
5. I-klik ang “Upgrade” nga buton (Item 13 sa Ta bl e 1 /Figure 9) aron magsugod sa pag-upgrade file sulod sa memorya.
6. I-klik ang “Verify” nga buton (Item 14 sa Ta bl e 1 /Figure 9) para ma-verify kung ang data malampuson nga na-download.

4.2 DFU file mga pamaagi sa manager
4.2.1 Giunsa paghimo ang DFU files gikan sa S19/Hex/Bin files

1. Pagdalagan ang "DFU File Manager" nga aplikasyon (Start -> All Programs -> STMicroelectronics> DfuSe-> DFU File Manager).
2. Pilia ang "Gusto ko nga MAGHIMO og DFU file gikan sa S19, HEX, o BIN files” nga butang sa “Want to do” dialog box(Tabla 1 1 ) unya i-klik ang “OK”.
3. Paghimo og DFU nga hulagway gikan sa S19/Hex o binary file.
   a) Pagbutang ug wala gigamit nga Target ID nga numero (Item 5 sa Ta bl e 2 /Figure 12).
   b) Isulat ang VID, PID, Bersyon, ug ang target nga ngalan
   c) Sa paghimo sa imahe gikan sa usa ka S19 o Hex file, i-klik ang “S19 o Hex” nga buton (Item 6 sa Ta bl e 2 /Figure 4) ug pilia ang imong file, usa ka DFU nga hulagway ang pagabuhaton alang sa matag idugang file.
   d) Sa paghimo sa imahe gikan sa usa o daghan pa nga binary files, i-klik ang “Multi Bin” nga buton (Item 7 sa Ta bl e 2 /Figure 12) aron ipakita ang “Multi Bin Injection” dialog box (Figure 13.).
   I-klik ang Browse button (Item 2 sa Tab 3/Figure 13) para makapili ug binary file(*.bin) o laing pormat sa file (Wave, Video, Text,…).
   Itakda ang pagsugod nga adres sa natad sa adres (Item 3 sa Ta bl e 3 /Figure 13).
   I-klik ang “Add to list” button (Item 4 sa Tala 3 /Figure 13) aron idugang ang pinili nga binary file uban sa gihatag nga adres.
   Aron mapapas ang anaa na file, pilia kini, dayon i-klik ang “Delete” button (Item 5 sa Ta bl e 3 /Figure 13).
   Usba ang parehas nga pagkasunod-sunod aron idugang ang uban nga binary files, I-klik ang "OK" aron ma-validate.
4. Balika ang lakang (3.) sa paghimo og ubang mga hulagway sa DFU.
5. Sa paghimo sa DFU file, i-klik ang "Pagmugna".

4.2.2 Giunsa pagkuha ang S19/Hex/Bin filegikan sa DFU files

1. Dagan ang “DFU File Manager" nga aplikasyon (Start -> All Programs -> STMicroelectronics -> DfuSe -> DFU File Pagdumala).
2. Pilia ang "Gusto nako i-EXTRACT ang S19, HEX o BIN files gikan sa usa ka DFU one” radio button sa “Want to do” dialog box (Figure 11) unya i-klik ang “OK”.
3. Pagkuha ug S19/Hex o binary file gikan sa DFU file.
   a) I-klik ang Browse button (Item 4 sa Ta bl e 4 /Figure 14) para makapili og DFU file. Ang anaa nga mga hulagway ilista sa listahan sa mga hulagway (Item 4 sa Ta bl e 4 /Figure 14).
   b) Pagpili og usa ka hulagway gikan sa listahan sa mga hulagway.
   c) Pilia ang Hex, S19 o Multiple Bin radio button (Item 6 sa Tala 4 /Figure 14).
   d) I-klik ang “Extract” nga buton (Item 7 sa Ta bl e 4 /Figure 14) aron makuha ang pinili nga hulagway.
4. Balika ang lakang (3.) aron makuha ang ubang mga imahe sa DFU.

Kasaysayan sa rebisyon

Talaan 5. Kasaysayan sa pagbag-o sa dokumento

Petsa	Rebisyon	Mga kausaban
6-Hun-07	1	Inisyal nga pagpagawas.
2-Ene-08	2	Gidugang ang Seksyon 4.
24-Sept-08	3	Gi-update nga Figure 9 hangtod Figure 14.
2-Hul-09	4	gamita ang demo nga gi-upgrade sa bersyon nga V3.0. Seksyon 3.1: Gi-update ang demonstrasyon sa DfuSe: — Hulagway 9: DfuSe demo dialog box updated — Bag-ong feature nga gidugang para sa STM32F105/107xx nga mga device — Figure 10: Edit option byte dialog box gidugang Gi-update sa Seksyon 3.2: DFU file manedyer — Hulagway 11: “Gusto buhaton” dialog box — Hulagway 12: “Generation” dialog box — Hulagway 13: “Multi bin injection” dialog box — Hulagway 14: “Extract” dialog box

Palihug basaha og maayo:

Ang impormasyon niini nga dokumento gihatag lamang may kalabotan sa mga produkto sa ST. Ang STMicroelectronics NV ug ang mga subsidiary niini ("ST") adunay katungod sa paghimo og mga pagbag-o, pagkorihir, pagbag-o, o pagpaayo, niini nga dokumento, ug ang mga produkto ug serbisyo nga gihulagway dinhi sa bisan unsang oras, nga wala’y pahibalo.
Ang tanang produkto sa ST gibaligya subay sa mga termino ug kondisyon sa pagbaligya sa ST.
Ang mga pumapalit mao ray responsable sa pagpili, pagpili, ug paggamit sa mga produkto ug serbisyo sa ST nga gihulagway dinhi, ug walay tulubagon ang ST bisan unsa may kalabotan sa pagpili, pagpili, o paggamit sa mga produkto ug serbisyo sa ST nga gihulagway dinhi.
Wala’y lisensya, gipahayag o gipasabut, pinaagi sa estoppel o kung dili, sa bisan unsang mga katungod sa intelektwal nga kabtangan ang gihatag sa ilawom sa kini nga dokumento. Kung adunay bahin sa kini nga dokumento nga nagtumong sa bisan unsang mga produkto o serbisyo sa ikatulo nga partido dili kini isipon nga usa ka gihatag nga lisensya sa ST alang sa paggamit sa ingon nga mga produkto o serbisyo sa ikatulo nga partido, o bisan unsang intelektwal nga kabtangan nga naa niini o giisip nga usa ka garantiya nga naglangkob sa paggamit. sa bisan unsa nga paagi sa ingon nga ikatulo nga partido nga mga produkto o serbisyo o bisan unsang intellectual property nga anaa niini.
GAWAS GAWAS NGA GIPAHIGAYON SA MGA TERMINO UG KONDISYON SA PAGBILI SA ST, GIPAHIGAYON SA ST ANG BISAN UNSA NGA PINADAYAG O GITUDLONG WARRANTY MAY RESPETO SA PAGGAMIT UG/O PAGBALIK SA ST PRODUCTS LAKIP NGA WALAY LIMITASYON IMPLIED WARRANTIES OF MERCHANTABILITY, WALA KATAWHAN SA PAGPAKITA SA BISAN UNSANG JURISDICTION), O PAGLABAS SA BISAN UNSANG PATENT, COPYRIGHT O UBANG INTELLECTUAL PROPERTY RIGHT.
Gawas kung maaprubahan sa pagsulat sa usa ka awtorisado nga representante sa St Representative, ang mga produkto sa St dili girekomenda, o mga produkto sa pagluwas, o mga sistema nga nagpatuman sa kinabuhi o mga sistema kung diin ang kapakyasan RESULTA SA PERSONAL NGA KASAMALAN, KAMATAYON, O GRABE NGA PROPERTY O KALIBOTAN NGA KAdaut. ST PRODUCTS NGA DILI SPECIFIED AS “AUTOMOTIVE GRADE” MAHIMO LANG GAMITON SA AUTOMOTIVE APPLICATIONS SA KAUGALINGONG RISGO SA USER.
Ang pagbaligya pag-usab sa mga produkto sa ST nga adunay mga probisyon nga lahi sa mga pahayag ug/o teknikal nga mga bahin nga gilatid sa kini nga dokumento kinahanglan nga magwagtang dayon sa bisan unsang warranty nga gihatag sa ST alang sa produkto o serbisyo sa ST nga gihulagway dinhi ug dili magmugna o molugway sa bisan unsang paagi, bisan unsang responsibilidad sa ST.
Ang ST ug ang ST logo kay mga marka sa pamatigayon o rehistradong tatak sa ST sa lain-laing mga nasud.
Ang impormasyon niini nga dokumento mopuli ug mopuli sa tanang impormasyon nga gihatag kaniadto.
Ang ST logo kay rehistrado nga marka sa STMicroelectronics. Ang tanan nga ubang mga ngalan mao ang kabtangan sa ilang tagsa-tagsa nga mga tag-iya.

© 2009 STMicroelectronics – Tanang katungod gigahin
STMicroelectronics nga grupo sa mga kompanya
Australia – Belgium – Brazil – Canada – China – Czech Republic – Finland – France – Germany – Hong Kong – India – Israel – Italy – Japan –
Malaysia – Malta – Morocco – Pilipinas – Singapore – Spain – Sweden – Switzerland – United Kingdom – United States of America
www.st.com
Doc ID 13379 Rev 4

Mga Dokumento / Mga Kapanguhaan

ST DfuSe USB Device Firmware Upgrade STMicroelectronics Extension [pdf] Manwal sa Gumagamit DfuSe USB Device, Firmware Upgrade STMicroelectronics Extension, DfuSe USB Device Firmware Upgrade, STMicroelectronics Extension, DfuSe USB Device Firmware Upgrade STMicroelectronics Extension, UM0412

Mga pakisayran

• Manwal sa Gumagamit