Propeller Tool használata A következőkben a Propeller PC-n futó programjának jellegzetes tulajdonságait, a megjelenő képernyőablakok szerkezetét és rendeltetését mutatjuk be, valamint a menüpontokat is részletesen ismertetjük. A mérnökök a Parallax-nál sok fejlesztési környezetet használtak a több mint 20 éves időszakban. Használat közben rengeteg tapasztalat gyűlt össze, és számos kérdés is felmerült: • • • •
Sokkal jobb lenne, ha az „X” tulajdonság könnyebben megtalálhatóvá/lehívhatóvá válna; Hol vannak a project állományaim, és miért van olyan sok belőlük? Tudom ezt a rendszert praktikusan/legálisan telepíteni/újrafordítani/karbantartani egy másik számítógépen hosszú időszakot tekintve? Lehetséges-e jobb gyakorlati megoldás?
A tapasztalatok felhasználásával készült a PC-n futó Propeller Tool, amely a Propeller tokok egyszerű és olcsó fejlesztői környezete. Tervezése során felhasználtuk az összegyűjtött tapasztalatokat és ötleteket, hogy minél több hasznos funkció legyen, és egy olyan egyszerű és következetes fejlesztői környezet készüljön, amely támogatja Propeller programjainak gyors és egyszerű fejlesztését. A Propeller Tool fejlesztői környezet egyetlen futtatható állományból áll, néhány on-line súgó fájllal, és mindenki által felhasználható Propeller könyvtár állományokkal kiegészítve. Mindezek a fájlok abban a mappában jelennek meg, amelyet a telepítés során megadtunk. Ez alapértelmezés szerint: C:\Program Files\Parallax Inc\Propeller. A Propeller Tool futtatható állománya, a „Propeller.exe” a számítógép bármelyik mappájába másolható, illetve bármelyikből futtatható, nincs szüksége speciális rendszerfájlokra, vagy bármi másra. Mindegyik könyvtár (library) állomány (ezek a .spin kiterjesztéssel rendelkező állományok) egy független objektum, amelyek felhasználhatóak a Propeller fejlesztések során, a forráskódokkal és a beépített dokumentációval együtt. Ezek egyszerű szöveges állományok ANSI- vagy Unicode kódolással, amelyek minden olyan szövegszerkesztővel szerkeszthetőek, amelyek támogatják a fenti kódolásokat, mint például a Jegyzettömb a Windows 2000 (és azt követő) operációs rendszerben. Már megemlítettük, hogy egy objektum dokumentációja az objektum fájlba van beépítve. Egy objektumhoz tartozó felhasználói dokumentáció írását közvetlenül a objektum forrás állományába célszerű elhelyezni. Így kevesebb állományt kell karbantartani, és nagyobb valószínűséggel marad a dokumentáció szinkronban a forráskóddal. Lehetőségünk van: •
•
Létrehozni a forrás megjegyzések két típusát: o kód megjegyzéseket (a forráskód egy részének magyarázata), illetve a o dokumentum megjegyzéseket (szintén kódfeljegyzés, de azzal a céllal, hogy a „dokumentáció nézetben” lehessen elolvasni.) A „dokumentáció nézet” mód segítségével lehet a Propeller Tool-ban egy objektum dokumentációról kivonatot készíteni az objektum forráskódjából megtekintés céljából. Használni egy külön kialakított betűtípust, a Parallax betűtípust, amiben vannak olyan speciális karakterek, amelyek segítségével az objektum dokumentációja ellátható vázlatrajzzal, idődiagrammal és táblázatokkal. A Parallax betűtípus egy True Type betűtípus, amelyet a Propeller Tool futtatható állományába beépítettek. A betűtípus megjelenése pontosan olyan, mint amely a Propeller tok ROM-jában megtalálható. A betűtípus használatával akár a 2.1 ábrán látható rajzokat is el tudjuk készíteni. A Propeller Tool futtatáskor ez a betűtípus más programok számára is elérhetővé válik a számítógépen, így megjeleníthetőek ezek a speciális ábrák más szövegszerkesztő programmal is (pl. 2.1 ábra Karakterekkel rajzolt ábrák Jegyzettömb), vagy
1
akár a levelezési szoftverrel, amennyiben támogatja az Unicode kódolást (a speciális karakterekhez szükséges). A projekthez létrehozott objektumok ugyanolyan formátumban tárolódnak, mint a könyvtárfájlok (“.spin” kiterjesztéssel), a felhasználó által kiválasztott munkakönyvtárban. Ez elősegíti a már létező objektumok megosztását és a tanulmányozásukat, akár magunk, akár más Propeller felhasználó készítette őket.
Képernyő elrendezése A Propeller Tool program ablaka (2.2 ábra) négy fő részre van osztva, melyeket “mező”-nek nevezünk, egyenként más funkcióval.
2-2 ábra: A Propeller Tool szoftver fő ablaka négy fő részt, “mező”-t tartalmaz
Beépített fájlkezelő, az Integrated Explorer Az egyes, kettes és hármas mező a fájlokkal és a könyvtárakkal végzett munkát segítő beépített fájlkezelő, az Integrated Explorer része. Az Integrated Explorer a szerkesztő mezőtől (négyes) balra helyezkedik el, és tartalmazza az aktuális projekt nézeteit, az elérhető könyvtárakat és fájlokat. A szerkesztő mezőtől egy hosszú, függőleges sáv választja el, ami az egérrel tetszés szerint átméretezhető. A fájlkezelő el is rejthető átméretezéssel, nullára csökkentve a szélességét (bal egérgomb lenyomása mellett a függ őleges elválasztó sáv behúzásával), vagy a File menüből a Hide Explorer-t választva, vagy a Ctrl+E billentyűkombinációval. 1. mező: Objektum nézet mező Az első mező az Objektum nézet mező. A Propeller programozási nyelve, a Spin objektum-alapú, és egy Propeller projekt számos objektumból áll össze. Az Objektum nézet mutatja az aktuális projekt hierarchikus nézetét, ábrázolva a projekt szerkezetét. Az Objektum nézetből láthatjuk azt, hogy milyen objektumokat használunk, hogyan illeszkednek ezek más objektumokhoz, a fizikai elhelyezkedésüket a
2
merevlemezen (munkakönyvtár, könyvtár vagy szerkesztő), eredményeket és a lehetséges objektum-ütközéseket.
a
redundancia
optimalizációs
2. mező: Aktuális könyvtárak és Könyvtárlista Ez a mező két részből áll: 1) az Aktuális könyvtárak mező, és 2) a Könyvtárlista. Ez a két összetevő együttesen navigációs lehetőséget biztosít a számítógépen található meghajtókhoz való hozzáférésben. A Könyvtárlista hierarchikus nézetben mutat minden meghajtót, és a Windows Intézőhöz hasonló módon kezelhető. Az Aktuális könyvtárak mező (a Könyvtárlista felett) egy lenyíló listán mutatja a speciális mappákat, és a legutóbb használt könyvtárakat. Az Aktuális könyvtárak mezőben egy könyvtár kiválasztásánál a Könyvtárlista a megadott helyre ugrik. Ezen felül, ha a Könyvtárlistában olyan könyvtárat választunk, ami megtalálható az Aktuális könyvtárak listájában, a az Aktuális könyvtárak mez őjében megjelenik a választott elem. Az Aktuális könyvtárak listájában az első két elem a “Propeller könyvtár” és a “Propeller könyvtár – Demók”. Ezek alapértelmezésben szerepelnek itt, hogy könnyen elérhetőek legyenek a Propeller könyvtár fájljai és a könyvtár fájlok demói. Ezeket a fájlokat a Propeller Tool telepítője másolja be a könyvtárba. Ha olyan könyvtárat választunk, ami nem szerepel az Aktuális könyvtárak listájában, akkor az Aktuális könyvtárak listája üres lesz. Az Aktuális könyvtárak mezőjétől balra lévő gomb váltja az Aktuális könyvtárak és a Könyvtárlista funkcióit: 1) minden meghajtót és könyvtárat mutat, 2) csak a legutóbb használt meghajtókat és könyvtárakat mutatja. Ha úgy állítjuk be, hogy csak a legutóbb használt meghajtókat és könyvtárakat mutassa, könnyebben tudunk navigálni a rendszeresen használt Propeller projektkönyvtárakban a használaton kívüli könyvtárak kikerülésével. 2-3 ábra: Az Integrated Explorer és a részei átmérezhetőek az elválasztósávokkal
3. mező: Fájl-lista és Szűrőmező A hármas mező is két részből áll: 1) a Fájllista, és 2) a Szűrőmező. A Fájllista megjeleníti a Könyvtárlistában kiválasztott könyvtárban található összes olyan fájlt, ami megfelel a Szűrőmezőben beállított szűrési feltételeknek. A Fájllista a Windows Intéző-höz hasonló módon kezelhető. A Szűrőmezőben (a Fájllista alatt) legördülő listát találunk fájlkiterjesztésekkel, amelyek alapján szűrhetők a Fájllistában megjelenítendő fájlok. Alapvetően csak a Spin fájlok megjelenítésére lesz beállítva (“.spin” kiterjesztéssel), de szövegfájlok, vagy az összes fájl megjelenítését is választhatjuk. Amennyiben egy könyvtárt kiválasztva, ott nem találjuk a kívánt fájlokat, ellenőrizzük le a Szűrőmező beállításait. A Fájllistából a fájlok megnyitása a szerkesztővel a következőképp történhet: 1) dupla kattintással, 2) a fájl behúzása egérrel a Szerkesztőmezőbe (négyes mező), vagy 3) jobbkattintással a “Megnyitás” menüpontot választva 4. mező: Szerkesztő mező A négyes mező a Szerkesztő mező. A Szerkesztő mezőben jelenik meg a megnyitott fáljlhoz tartozó Spin forráskód, és itt lehet ellenőrizni, szerkeszteni, megváltoztatni a projekthez tartozó forráskód objektumokat. Mindegyik megnyitott fájl (forráskód objektum) külön fülön jelenik meg a Szerkesztő mezőben, a kapcsolódó fájl nevével megjelölve. Az éppen aktív szerkesztő fül megjelenítése különbözik a többitől. Korlátlan számú fájl lehet nyitva egyszerre, ennek csak a számítógép memóriája szab határt. A szereplő fülek között a következőképp lehet váltani: 1) a megfelelő fülre kattintva az egérrel, 2) Alt+Balkurzor vagy Alt+Jobbkurzor billentyűkombinációval, vagy 3) Ctrl+Tab vagy Ctrl+Shift+Tab billentyűkombinációval. Az egeret egy ideig a fülön tartva kijelzi a hozzá tartozó fájl fájlnevét és elérési útját.
3
A szerkesztőfülben látható forráskód különböző részei (blokkjai) az elő- és a háttérszínek segítségével automatikusan ki vannak emelve, hogy könnyen megkülönböztethetőek legyenek a blokk típusok, elem típusok, megjegyzések a forráskódtól, stb.
2-4 ábra: Tartsuk az egeret egy ideig a szerkesztő fülön, hogy kijelezze a hozzá tartozó fájl fájlnevét és elérési útját
A szerkesztőben jeleníthető meg: • • • •
a forráskód négyféle nézetben
Teljes forrás, Tömörített, Összegzés, Dokumentáció.
2-5 ábra: Több objektum elrendezése 1. lépés: Több objektum forráskódjának egyidejű megjelenítéséhez bal egérgombbal húzzuk a szerkesztő fület a Szerkesztőmező alja felé. 2. lépés: Engedjük el az egérgombot ledobva a szerkesztő fület. A szerkesztő fül és a tartalma egy új területban jelenik meg. 3. lépés: Ismételjük az 1. és 2. lépést szükség szerint a többi szerkesztő füllel, és méretezzük át mindkét területt a köztük lévő vízszintes elválasztó-sáv segítségével.
A nézetek közötti váltás többféle módon lehetséges: • • 2-6 ábra: Objektumok elrendezése
•
1. lépés:Amennyiben az asztalon van helyünk, a szerkesztő mezőből a füleket akár az alkalmazáson kívülre is húzhatjuk egérrel, a bal gombot lenyomva. 2. lépés: Engedjük el az egérgombot, hogy ledobjuk a szerkesztő fület; egy új ablakban nyílik meg, ami a Propeller Tool-tól függetlenül kezelhető. Ebbe az új ablakba további szerkesztő fülek húzhatóak.
volt sikeres.
•
az ide tartozó rádiógombok segítségével, Alt+Fel vagy Alt+Le billentyűkombinációval, Alt+
billentyűkombinációval, ahol a a nézethez tartozó aláhúzással jelölt betű, Alt billentyű lenyomása mellett az egér görgőjét le-fel mozgatva.
A Dokumentáció nézet addig nem hozzáférhető, amíg az objektum fordítása nem
Mivel a projektek több objektumból állnak, a projekt fejlesztése során kényelmetlen lehet, ha nem látható egyszerre az éppen használt objektum és az objektum, amihez illeszkednie kell. A Szerkesztő mező lehetővé teszi a szerkesztőfülek különböző helyekre való elhúzását egérrel. Például, ha több
4
objektum van nyitva, a bal egérgomb segítségével megragadható egy objektumhoz tartozó fül, és lehúzható a Szerkesztő mező alja felé, és ott egyszerűen ledobható. A képernyőn ekkor megjelenik egy új fül terület, ahová a szerkesztő fület ledobtuk. Kívánság szerint folytathatjuk ezt a műveletet a szerkesztőfülekkel. Ezek a lépések a 2-5 ábrán láthatók. A két terület vízszintes mérete a köztük lévő vízszintes elválasztó-sáv segítségével változtatható. Természetesen az illesztendő objektumok bármelyik nézetben megtekinthetőek (Teljes forrás, Tömörített, Összegzés, Dokumentáció), az éppen fejlesztett objektum Teljes Forrás nézetben marad (ez az egyedüli szerkeszthető nézet). A szerkesztő mezőből a füleket akár a Propeller Toolon kívülre is húzhatjuk egérrel. Ebben az esetben az új fülek egy új ablakban nyílnak meg, ami a Propeller Tool ablakától függetlenül kezelhető. Ez különösen olyan esetekben hasznos, amikor egy számítógéppel több monitoron fejlesztenek; az egyik monitoron lévő alkalmazásból a fülek áthúzhatóak a másik monitor asztalára.
Állapotsáv Az Állapotsáv a Propeller tool alján hat mezőre van osztva, mindegyikük hasznos információt jelenít meg a fejlesztés különböző stádiumaiban.
2-7 ábra: Állapotsáv
1. Az Állapotsáv első mezője az aktív szerkesztő fülben a kurzor vízszintes (sor) és függőleges (oszlop) pozícióját mutatja. 2. A második mező az aktuális szerkesztő fül módosítási állapotát mutatja: 1) üres – nem módosított 2) módosított, vagy 3) csak olvasható. 3. A harmadik mező az aktuális szerkesztési módot mutatja: 1) Igazítás (alapbeállítás a Spin kódhoz), 2) Beszúrás (alapbeállítás más kódokhoz) vagy 3) Felülírás. A szerkesztési mód az Insert billentyűvel változtatható. 4. A negyedik mező mutatja az aktuális szerkesztési fül összeállítási állapotát: 1) üres – nem fordított, vagy 2) Fordított. Ez a mező jelzi, hogy a forráskód változott-e a legutolsó fordítás státuszához képest. Ha a kód egyáltalán nem változott az utolsó összeállítás óta, a mező “Compiled” felirattal jelzi ezt. 5. Az ötödik mező környezetfüggő információt ad az aktuális szerkesztő fül forráskódjáról, ha a kód nem változott a legutóbbi összeállítás óta. Húzzuk a szerkesztő fül kurzorát a CON vagy DAT blokk jelhez, vagy bárhová a PUB/PRI blokkokban, hogy a területra vonatkozó információ megjelenjen. 6. A hatodik mező ideiglenes üzeneteket mutat az éppen aktuális műveletről. Ez az állapotsáv azon része, ahol megjelenik a hibaüzenet legutóbbi összeállításról, amíg egy újabb üzenet felül nem írja. Szintén itt jelenik meg a sikeres összeállítási üzenet, betűtípus méret változás, és más állapotok. Az egész Állapotsáv tippeket jelenít meg a menüsáv menüpontjainak funkciójáról, és számos más részről, amire az egérkurzort húzzuk.
Menü elemek File menü Új – Létrehoz egy új, üres szerkesztőfület. Minden létező szerkesztőfül érzéketlen. Megnyitás - Megnyit egy állományt egy új szerkesztőfülön a Fájl megnyitása dialógusablak segítségével. Megnyitás innen… - Megnyit egy állományt egy új szerkesztőfülön a legutoljára használt mappából a Fájl megnyitása dialógusablak segítségével. Mentés – Elmenti az aktuális szerkesztőfül tartalmát a lemezegységre a megnyitott fájl nevével, ha az felhasználható. Mentés másként… - Elmenti az aktuális szerkesztőfül tartalmát a lemezegységre egy új fájlnévvel a Mentés másként dialógusablakot használva. Mentés oda… - Elmenti az aktuális szerkesztőfül tartalmát a lemezegységre a legutóbb használt mappába a Mentés másként dialógusablak felhasználásával. Összes mentése – Elmenti az összes el nem mentett szerkesztőfül tartalmát a lemezegységre a már létező
5
fájlnévvel, ha ez lehetséges. Bezárás - Bezárja az aktuális szerkesztőfület (figyelmeztet, ha a fájl nincs elmentve) Összes bezárása – Bezárja az összes szerkesztőfület (figyelmeztet, ha valamelyik fájl nincs elmentve) Megjelöl Legfelső Objektum Fájlként… Megjelöli az aktuális projekt legfelső objektum állományát. Ezt a beállítást a Fordítás Legfelülről… össze művelete használja, és mindaddig megmarad, amíg meg nem változtatják. Archive almenü → Projekt… - A projekt összes objektumának és adatállományának gyűjteménye, amely az Objektum Nézet alatt látszik, és egy tömörített állomány (.zip) tárol egy „readme” állománnyal együtt, amely az archívum és struktúra információkat tartalmazza. → Projekt + Propeller Tool… - Ugyanazt csinálja, mint a fenti, de a teljes Propeller Tool futatható állomány hozzáteszi a tömörített állományhoz. Intéző Elrejtése/Mutatása – Elrejti/megmutatja a Beépített Intéző panelt (az alkalmazásablak bal oldalán). Nyomtatási kép… - A kimeneti minta megtekintése a nyomtatás előtt. Nyomtatás… - Kinyomtatja az aktuális szerkesztőfül tartalmát. - A Print… és az Exit menüelem közötti területen a legutóbb megnyitott állományok jelennek meg. A lista bármelyik elemét választva az adott állomány megnyílik. A legutóbbi fájlokra görgetve az egeret megtekinthető az állomány teljes elérési útja és fájlneve az állapotsoron. Bezár – Bezárja a Propeller Tool programot. Szerkesztés menü Visszavonás – Visszavonja a legutolsó szerkesztő műveletet az aktuális szerkesztőfülön. Minden egyes szerkesztőfül saját művelet előzménylistával rendelkezik. Többszörös visszavonás is lehetséges, ennek korlátja kizárólag a memóriaméret. Mégis - Megismétli a legutolsó végre nem hajtott művelet az aktuális szerkesztőfülön. Minden egyes szerkesztőfül saját művelet ismétléslistával rendelkezik. Többszörös ismétlés is lehetséges, ennek korlátja kizárólag a memóriaméret. Kivágás – Törli a kijelölt szöveget az aktuális szerkesztőfülről, és a Windows vágólapjára másolja. Másolás – Az aktuális szerkesztőfülön kijelölt szöveget a Windows vágólapjára másolja. Beillesztés – Beilleszti a Windows vágólapjára helyezett szöveget az aktuális szerkesztőfül kurzorpozíciójába. Mindet kijelöli – Kijelöli az aktuális szerkesztőfülön az összes szöveget. Keresés/Csere – Megnyitja a Keresés/Csere dialógusablakot. Erről az ablakról a részletek a 2-15 oldalon találhatóak. Következő Keresése – Megkeresi a előfordulását a legutoljára keresett szövegnek, amelyet a Keresés/Csere dialógusablakba gépeltek. Csere – Kicseréli az aktuálisan kijelölt szöveget arra a szövegre, amit a Keresés/Csere dialógusablakban a Csere mezőbe gépeltek. Ugrás a Könyvjelzőkhöz – Ugrás a Könyvjelzőkhöz. (csak akkor jelenik meg, ha a könyvjelzők látszanak) Nagyobb Szöveg – Megnöveli a betűméretet az összes szerkesztőfülön. Kisebb Szöveg – Lecsökkenti a betűméretet az összes szerkesztőfülön. Futtatás menü Aktuális Fordítása almenü → Információ Megtekintése… - Lefordítja az aktuális szerkesztőfül forráskódját, és ha az sikeres, megjeleníti az Objektum Információ űrlapot az eredménnyel. Az Objektum Információ űrlap részletes kimutatást tartalmaz az objektum struktúráról, a kódméretről, a változó területről, a szabad területről és a lehetséges optimalizálásról. → Állapot Frissítés - Lefordítja az aktuális szerkesztőfül forráskódját, és ha az sikeres, frissíti az állapotinformációkat az Állapotsoron a projekt összes objektumán. → RAM-ba Töltés + Futtatás - Lefordítja az aktuális szerkesztőfül forráskódját, és ha az sikeres, betölti az eredmény alkalmazás a Propeller chip RAM moduljába, majd futtatja azt.
6
→ EEPROM-ba Töltés + Futtatás - Lefordítja az aktuális szerkesztőfül forráskódját, és ha az sikeres, betölti az eredmény alkalmazás a Propeller chip EEPROM (és RAM) moduljába, majd futtatja azt. → EEPROM–ba Töltés - Lefordítja az aktuális szerkesztőfül forráskódját, és ha az sikeres, betölti az eredmény alkalmazás a Propeller chip EEPROM moduljába, de nem futtatja azt. A Propeller chip következő alapállapotba állításakor (reset) fog az alkalmazás az EEPROM-ból lefutni. Fordítás Legfelülről almenü → Információ Megtekintése… - Az Aktuális Fordítása → Információ Megtekintése ponthoz hasonlóan fut le a fordítás, a „Top Object File”-ként megjelölt állománytól kezdődően. → Állapot Frissítés - Az Aktuális Fordítása → Állapot Frissítés ponthoz hasonlóan fut le a fordítás, a „Top Object File”-ként megjelölt állománytól kezdődően. → RAM-ba Töltés + Futtatás - A Compile Current → RAM-ba Töltés + Futtatás ponthoz hasonlóan fut le a fordítás, a „Top Object File”-ként megjelölt állománytól kezdődően. → EEPROM-ba Töltés + Futtatás - Az Aktuális Fordítása → EEPROM-baTöltés + Futtatás ponthoz hasonlóan fut le a fordítás, a „Top Object File”-ként megjelölt állománytól kezdődően. → EEPROM–ba Töltés - Az Aktuális Fordítása → EEPROM–ba Töltés ponthoz hasonlóan fut le a fordítás, a „Top Object File”-ként megjelölt állománytól kezdődően. Hardver Felismerés…(F7) - Megvizsgálja az elérhető portokat a Propeller chip számára, és ha talál, megjeleníti a csatlakoztatott portot, és a hardver verziószámát. Súgó menü Propeller Tool… - Megjeleníti a Propeller Tool online súgóját. Karaktertábla megtekintése… - Megjeleníti az interaktív Parallax Karaktertáblát. Ez a karaktertábla a Parallax betűtípus karaktereit három lehetséges nézetben mutatja be: Standard Sorrend, ROM Bittérkép és Szimbólum Sorrend. A Standard Sorrend a szabványos ANSI sorrend. A ROM Bittérkép demonstrálja, ahogyan a karakter adatok a Propeller chip ROM-jában szerveződnek. A Szimbólum Sorrend egy kategorikus sorrend (pl. alfa karakterek, számok, írásjelek, sematikus szimbólumok, stb.). Lásd a Karaktertáblát a 2-24 oldalon. Parallax Weboldal megtekintése… - Megnyitja a Parallax weboldalát, a számítógép alapértelmezett böngészője segítségével. E-mail a Parallax Támogatáshoz… - Megnyitja a számítógép alapértelmezett levelező programját, és új üzenetet nyit a Parallax támogató központjának címezve. Rólunk… Megjeleníti a Rólunk ablakot a Propeller Tool részleteivel.
7
