Flash programátor GangPro430
pre mikrokontroléry MSP430Fxx TI
Príručka používateľa tlmočníka príkazového riadka
PM015A03 Rev.0
12. apríla 2007

Flash programátor GangPro430

Spoločnosť Elprotronic Inc.
16 Križovatka Drive
Richmond Hill,
Ontário, L4E-5C9
KANADA

Web miesto: www.elprotronic.com
E-mail: info@elprotronic.com
Fax: 905-780-2414
hlas: 905-780-5789

Copyright © Elprotronic Inc. Všetky práva vyhradené.
Vylúčenie zodpovednosti:
Žiadna časť tohto dokumentu nesmie byť reprodukovaná bez predchádzajúceho písomného súhlasu spoločnosti Elprotronic Inc.
Informácie v tomto dokumente sa môžu zmeniť bez predchádzajúceho upozornenia a nepredstavujú záväzok žiadnej časti spoločnosti Elprotronic Inc. Zatiaľ čo informácie uvedené v tomto dokumente sa považujú za presné, spoločnosť Elprotronic Inc. nepreberá žiadnu zodpovednosť za žiadne chyby alebo opomenutia.
Elprotronic Inc, jej zamestnanci alebo autori tohto dokumentu nebudú v žiadnom prípade zodpovední za špeciálne, priame, nepriame alebo následné škody, straty, náklady, poplatky, nároky, požiadavky, nároky na ušlý zisk, poplatky alebo výdavky akejkoľvek povahy alebo milý.
Softvér popísaný v tomto dokumente je poskytovaný na základe licencie a môže sa používať alebo kopírovať iba v súlade s podmienkami takejto licencie.
Zrieknutie sa záruk: Súhlasíte s tým, že spoločnosť Elprotronic Inc. vám neposkytla žiadne výslovné záruky týkajúce sa softvéru, hardvéru, firmvéru a súvisiacej dokumentácie. Softvér, hardvér, firmvér a súvisiaca dokumentácia vám budú poskytnuté „AKO SÚ“ bez záruky alebo podpory akéhokoľvek druhu. Elprotronic Inc. sa zrieka všetkých záruk týkajúcich sa softvéru, výslovných alebo implicitných, vrátane, bez obmedzenia, akýchkoľvek implicitných záruk vhodnosti na konkrétny účel, predajnosti, predajnej kvality alebo neporušovania práv tretích strán.
Obmedzenie zodpovednosti: Spoločnosť Elprotronic Inc. vám v žiadnom prípade nenesie zodpovednosť za akúkoľvek stratu používania, prerušenie podnikania alebo akékoľvek priame, nepriame, špeciálne náhodné alebo následné škody akéhokoľvek druhu (vrátane ušlého zisku) bez ohľadu na formu konania. či už na základe zmluvy, deliktu (vrátane nedbanlivosti), striktnej zodpovednosti za výrobok alebo inak, aj keď spoločnosť Elprotronic Inc. bola upozornená na možnosť takýchto škôd.

LICENČNÁ ZMLUVA KONCOVÉHO POUŽÍVATEĽA

PRED POUŽITÍM SOFTVÉRU A SÚVISIACEHO HARDVÉRU SI POZORNE PREČÍTAJTE TENTO DOKUMENT. SPOLOČNOSŤ ELPROTRONIC INC. A/ALEBO JEJ Dcérske spoločnosti („ELPROTRONIC“) JE OCHOTNÉ POSKYTNÚŤ LICENCIU NA SOFTVÉR VÁM AKO JEDNOTLIVCOV, SPOLOČNOSTI ALEBO PRÁVNICKEJ OSOBE, KTORÁ BUDE SOFTVÉR POUŽÍVAŤ (NIŽŠIE OZNAČENÉ LEN „VAŠE“) ALEBO POD PODMIENKOU, ŽE SÚHLASÍTE SO VŠETKÝMI PODMIENKAMI TEJTO LICENČNEJ ZMLUVY. TOTO JE ZÁKONNÁ A VYKONATEĽNÁ ZMLUVA MEDZI VAMI A SPOLOČNOSŤOU ELPROTRONIC. OTVORENÍM TOHTO BALÍKA, ROZLOMENÍM PEČAŤ, KLIKNUTÍM NA TLAČIDLO „SÚHLASÍM“ ALEBO INAK ELEKTRONICKÝM OZNAČENÍM SÚHLASU ALEBO NAČTENÍM SOFTVÉRU SÚHLASÍTE S PODMIENKAMI TEJTO DOHODY. AK NESÚHLASÍTE S TÝMITO ZMLUVNÝMI PODMIENKAMI, KLIKNITE NA TLAČIDLO „NESÚHLASÍM“ ALEBO INAK OZNAČTE ODMIETNUTIE, ĎALŠIE NEPOUŽÍVAJTE KOMPLETNÝ PRODUKT A VRÁŤTE HO S DOKLADOM O NÁKUPE PREDAJCU, OD KTORÉHO HO ZÍSKAL DO TRIDSIATIA (30) DNÍ OD NÁKUPU A PENIAZE VÁM BUDÚ VRÁTENÉ.

1. Licencia.
   Softvér, firmvér a súvisiaca dokumentácia (súhrnne „Produkt“) sú majetkom spoločnosti Elprotronic alebo jej poskytovateľov licencií a sú chránené autorským zákonom. Zatiaľ čo spoločnosť Elprotronic naďalej vlastní Produkt, po prijatí tejto licencie budete mať určité práva na používanie Produktu.
   Táto licencia upravuje všetky vydania, revízie alebo vylepšenia Produktu, ktoré vám Elprotronic môže poskytnúť. Vaše práva a povinnosti v súvislosti s používaním tohto produktu sú nasledovné: MÔŽETE:
   A. používať tento produkt na mnohých počítačoch;
   B. vytvorte jednu kópiu softvéru na účely archivácie alebo skopírujte softvér na pevný disk vášho počítača a originál si ponechajte na účely archivácie;
   C. používať softvér v sieti
   NESMIETE: 
   A. sublicencovať, spätne analyzovať, dekompilovať, rozoberať, upravovať, prekladať, vykonávať akýkoľvek pokus o odhalenie zdrojového kódu produktu; alebo vytvárať odvodené diela z Produktu;
   B. redistribuovať, vcelku alebo čiastočne, akúkoľvek časť softvérového komponentu tohto produktu;
   C. používajte tento softvér s programovacím adaptérom (hardvérom), ktorý nie je produktom spoločnosti Elprotronic Inc.
2. Autorské práva
   Všetky práva, tituly a autorské práva na Produkt a všetky kópie Produktu sú majetkom spoločnosti Elprotronic. Produkt je chránený autorskými právami a ustanoveniami medzinárodných zmlúv.
   Preto musíte s produktom zaobchádzať ako s akýmkoľvek iným materiálom chráneným autorskými právami.
3. Obmedzenie zodpovednosti.
   Elprotronic vám v žiadnom prípade nenesie zodpovednosť za akúkoľvek stratu používania, prerušenie podnikania alebo akékoľvek priame, nepriame, špeciálne, náhodné alebo následné škody akéhokoľvek druhu (vrátane ušlého zisku) bez ohľadu na formu konania, či už ide o zmluvný, delikt. (vrátane nedbalosti), prísnej zodpovednosti za výrobok alebo inak, aj keď bola spoločnosť Elprotronic upozornená na možnosť takýchto škôd.
4. ODMIETNUTIE ZÁRUK.
   Súhlasíte s tým, že spoločnosť Elprotronic vám neposkytla žiadne výslovné záruky týkajúce sa softvéru, hardvéru, firmvéru a súvisiacej dokumentácie. Softvér, hardvér, firmvér a súvisiaca dokumentácia vám budú poskytnuté „AKO SÚ“ bez záruky alebo podpory akéhokoľvek druhu. Elprotronic sa zrieka všetkých záruk týkajúcich sa softvéru a hardvéru, výslovných alebo implicitných, vrátane, bez obmedzenia, akýchkoľvek implicitných záruk vhodnosti na konkrétny účel, predajnosti, predajnej kvality alebo neporušovania práv tretích strán.

Toto zariadenie je v súlade s časťou 15 pravidiel FCC.
Prevádzka podlieha nasledujúcim dvom podmienkam: (1) toto zariadenie nesmie spôsobovať škodlivé rušenie a (2) toto zariadenie musí akceptovať akékoľvek prijaté rušenie vrátane rušenia, ktoré môže spôsobiť nežiaduce fungovanie.

POZNÁMKA: Toto zariadenie bolo testované a bolo zistené, že vyhovuje limitom pre digitálne zariadenia triedy B v súlade s časťou 15 pravidiel FCC. Tieto limity sú navrhnuté tak, aby poskytovali primeranú ochranu pred škodlivým rušením pri inštalácii v obytných priestoroch. Toto zariadenie generuje, používa a môže vyžarovať rádiofrekvenčnú energiu a ak nie je nainštalované a používané v súlade s návodom na použitie, môže spôsobiť škodlivé rušenie rádiovej komunikácie. Neexistuje však žiadna záruka, že pri konkrétnej inštalácii nedôjde k rušeniu. Ak toto zariadenie spôsobuje škodlivé rušenie rádiového alebo televízneho príjmu, čo sa dá zistiť vypnutím a zapnutím zariadenia, používateľovi sa odporúča, aby sa pokúsil napraviť rušenie jedným alebo viacerými z nasledujúcich opatrení:

• Presmerujte alebo premiestnite prijímaciu anténu
• Zväčšite vzdialenosť medzi zariadením a prijímačom
• Zapojte zariadenie do zásuvky v inom okruhu, než ku ktorému je pripojený prijímač
• Požiadajte o pomoc predajcu alebo skúseného rádio/TV technika.
  POZOR: Zmeny alebo úpravy, ktoré nie sú výslovne schválené spoločnosťou Elprotronic Inc., môžu zrušiť oprávnenie používateľa prevádzkovať zariadenie.

Toto digitálne zariadenie triedy B spĺňa všetky požiadavky kanadských predpisov o zariadeniach spôsobujúcich rušenie.

Tlmočník príkazového riadku GangPro430

GangPro430 Multi-FPA API-DLL možno použiť s shellom tlmočníka príkazového riadku. Tento shell umožňuje použiť štandardné okno príkazového riadka alebo skript file na spustenie funkcií API-DLL. Podrobný popis funkcií API-DLL nájdete v GangPro430 Multi-FPA API-DLL Užívateľskej príručke ( PM025A02 ).
Keď je nainštalovaný štandardný softvérový balík, potom je všetko potrebné files sa nachádzajú v adresári
C:\Program Files\Elprotronic\MSP430\USB GangPro430\CMD-line a obsahuje

GP430-commandline.exe	-> interpret príkazového riadku shell
GangPro430FPA.dll	-> štandardné API-DLL files
GangPro430FPA1.dll	-> —-,,,,,——–
MSPlist.ini	-> inicializácia file

Všetky API-DLL files by sa mal nachádzať v rovnakom adresári, kde sa nachádza GP430-commandline.exe je umiestnený. Na spustenie tlmočníka príkazového riadka by sa mal spustiť súbor GP430-commandline.exe.

Syntax príkazu:
názov_inštrukcie ( parameter1, parameter2, …. )
parameter:

1. reťazec ( file meno atď.) – “filenázov"
2. čísla celé desiatkové číslo napr. 24 alebo celé číslo, napr. 0x18
   Poznámka: Medzery sa ignorujú Pokyny nerozlišujú veľké a malé písmená F_OpenInstancesAndFPAs( “*# *” )
   a f_openinstancesandfpas( “*# *” ) sú rovnaké.

Example-1:
Spustite súbor GP430-commandline.exe
Typ:
F_OpenInstancesAndFPAs( “*# *” ) // otvorte inštancie a nájdite prvý adaptér (akékoľvek SN)
Stlačte ENTER – výsledok ->1
(OK)
Typ:
F_Initialization()
//inicializácia s konfiguráciou prevzatou z config.ini
//nastavenie prevzaté z GangPro430 – s definovaným typom MSP430, kódom file atď.
Stlačte ENTER – výsledok ->1
(OK)
Typ:
F_AutoProgram( 0 )
Stlačte ENTER – výsledok ->63 ( 63-> 0011 1111 -> naprogramovaných šesť cieľov -> OK )
Typ:
F_Report_Message()

Stlačte ENTER – výsledok ->zobrazí sa posledná správa správy (z F_Autoprogram(0)) Výsledok nájdete na obrázku A-1:

Napíšte quit() a stlačením klávesu ENTER zatvorte GP430-commandline.exe program.

Example-2:

F_OpenInstancesAndFPAs( “*# *” )// otvorte inštancie a nájdite prvý adaptér (akékoľvek SN)
F_Initialization()
F_Report_Message()
F_ConfigFileNaložiť( "filename” )//zadajte platnú cestu a konfiguráciu file meno
F_ReadCodeFile( 1, “FileName” )//zadajte platnú cestu a kód file názov (formát TI.txt)
F_AutoProgram( 0 )
F_Report_Message()
........................
........................
F_Put_Byte_to_Gang_Buffer( 1, 0x8000, 0x11 )
F_Put_Byte_to_Gang_Buffer( 1, 0x8001, 0x21 )
........................
F_Put_Byte_to_Gang_Buffer( 1, 0x801F, 0xA6 )
F_Open_Target_Device()
F_Segment_Erase( 0x8000)
F_Copy_Buffer_to_Flash( 0x8000, 0x20 )
F_Copy_Flash_to_Gang_Buffer( 0x8000, 0x20 )
F_Get_Byte_from_Gang_Buffer( 1, 0x8000 )
F_Get_Byte_from_Gang_Buffer( 2, 0x8000 )
F_Get_Byte_from_Gang_Buffer( 1, 0x8001 )
F_Get_Byte_from_Gang_Buffer( 2, 0x8001 )
........................
F_Get_Byte_from_Gang_Buffer( 1, 0x801F )
F_Get_Byte_from_Gang_Buffer( 2, 0x801F )
F_Close_Target_Device()
quit ()

Zoznam inštrukcií príkazového riadku

quit();zatvorte program na interpretáciu príkazov
help();zobrazí zoznam nižšie
F_Trace_ON()
F_Trace_OFF()
F_OpenInstances( no )
F_CloseInstances()
F_OpenInstancesAndFPAs( “FileNázov" )
F_Set_FPA_index( fpa )
F_Get_FPA_index()
F_LastStatus( fpa )
F_DLLTypeVer()
F_Multi_DLLTypeVer()
F_Check_FPA_access(index )
F_Get_FPA_SN( fpa
F_APIDLL_Directory( “APIDLLpath” )
F_Initialization()
F_DispSetup()
F_Close_All()
F_Power_Target( OnOff )
F_Reset_Target()
F_Report_Message()
F_ReadCodeFile( file_format, “FileNázov" )
F_Get_CodeCS( cieľ )\n” );
F_ReadPasswFile( file_format, “FileNázov" )
F_ConfigFileNaložiť( "filenázov" )
F_SetConfig( index, údaje )
F_GetConfig( index )
F_Put_Byte_to_Gang_Buffer( target_no, addr, data )
F_Get_Byte_from_Gang_Buffer( target_no, addr )
F_Clr_Code_Buffer()
F_Put_Byte_to_Code_Buffer( adresa, údaje )
F_Put_Byte_to_Password_Buffer( adresa, údaje )
F_Get_Byte_from_Code_Buffer( addr )
F_Get_Byte_from_Password_Buffer( addr )
F_AutoProgram( 0 )
F_VerifyFuseOrPassword()
F_Memory_Erase( režim )
F_Memory_Blank_Check()
F_Memory_Write( režim )
F_Memory_Verify( režim )
F_Gang_Flash_Read()
F_Open_Target_Device()
F_Close_Target_Device()
F_Segment_Erase( adresa )
F_Sectors_Blank_Check( start_addr, stop_addr )
F_Copy_Buffer_to_Flash( start_addr, size )
F_Copy_Gang_Buffer_to_Flash( start_addr, size )
F_Flash_to_Gang_Buffer( start_addr, size )
F_Blow_Fuse()
F_Write_Word( adresa, údaje )
F_Write_Byte( adresa, údaje )
F_Copy_Buffer_to_RAM( start_addr, size )
F_Copy_Gang_Buffer_to_RAM( start_addr, size )
F_Copy_RAM_to_Gang_Buffer( start_addr, size )
F_Set_PC_and_RUN( PC_addr )
F_Sync_CPU_JTAG()
F_Get_Targets_Vcc()
F_Get_Targets_Result()
F_Get_Active_Targets_Mask()
F_Disable_FPA_index( fpa )
F_Enable_FPA_index( fpa )
F_Customize( cieľ, údaje )

Podrobný popis vyššie uvedených pokynov nájdete v kapitole 4.
Poznámka:
Nie všetky pokyny uvedené v kapitole 4 sú implementované v interpretači príkazového riadka. Naprample – všetky inštrukcie využívajúce ukazovatele nie sú implementované, to však neobmedzuje prístup ku všetkým funkciám API-DLL, pretože všetky inštrukcie využívajúce ukazovatele sú implementované aj jednoduchším spôsobom bez ukazovateľov.

GangPro430 Príručka používateľa tlmočníka príkazového riadka
PM015A03 Rev.0

Dokumenty / zdroje

Flash programátor Elprotronic GangPro430 [pdf] Používateľská príručka GangPro430, GangPro430 Flash Programátor, Flash Programátor, Programátor

Referencie

• Používateľská príručka