OrCAD Capture TCL IDE med Eclipse OrCAD Capture TCL er et script sprog til at lave applikationer til OrCAD Capture. Eclipse er et gratis udviklingsmiljø med debug muligheder. Denne guide hjælper med at opsætte Eclipse til at udvikle TCL scripts med mulighed for at debugge, altså finde ud af om applikationen gør som forventet eller afhjælpe eventuelle problemer. Eksempel: Der findes et antal OrCAD Capture specifikke TCL kommandoer som kun kan kaldes inde fra OrCAD Capture samt i kommando linjen i OrCAD Capture. Dette er indbyggede kommandoer der ikke er stillet til rådighed som færdige pakker. Disse indbyggede kommandoer er f.eks. CIS specifikke kommandoer der kræver en licens til OrCAD Capture CIS. Derfor kan disse ikke genkendes og testes med Eclipse. I sådanne tilfælde skal koden testes og debugges inde fra OrCAD Capture. Nordcad Systems A/S support@nordcad.dk Side 1 af 17
Indhold OrCAD Capture TCL IDE med Eclipse... 1 Download af Eclipse IDE og tilhørende programmer... 3 Java... 4 Eclipse... 5 Activestate Komodo Tcl Remote Debugging... 5 TCL 8.4 Dokumentation... 5 Nordcad filer... 5 Installation og opsætning... 6 Java... 6 Activestate Komodo Tcl Remote Debugging... 6 TCL 8.4 Dokumentation... 6 Nordcad Filer... 6 Eclipse... 6 Installation og opsætning af TCL development toolkit... 7 Opsætning af TCL debugger... 9 Opsætning af TCL interpreter... 10 Opsætning af TCL dokumentation... 12 Afprøv Eclipse opsætningen... 14 Kom godt I gang med Capture TCL udvikling... 17 Gode links... 17 Nordcad Systems A/S support@nordcad.dk Side 2 af 17
Download af Eclipse IDE og tilhørende programmer Der skal downloades følgende programmer for at kunne bruge Eclipse til TCL IDE. Java JRE (Java Runtime Environment) Eclipse IDE for Java Developers Activestate Komodo Tcl Remote Debugging TCL 8.4 Dokumentation Nordcad Filer Der skal desuden downloades et antal development toolkits inde i Eclipse, dette uddybes senere. Nordcad Systems A/S support@nordcad.dk Side 3 af 17
Java http://www.oracle.com/technetwork/java/javase/downloads/index.html Nordcad Systems A/S support@nordcad.dk Side 4 af 17
Eclipse https://www.eclipse.org/downloads/ Bemærk at der skal vælges 32-bit Eclipse download selvom PC en kører med et 64-bit operativsystem. Eclipse.org finder et mirror link som du skal klikke på, eller du kan vælge et mirror selv fra listen nedenunder. Activestate Komodo Tcl Remote Debugging http://code.activestate.com/komodo/remotedebugging/ TCL 8.4 Dokumentation http://nordcad.dk/download/teknik/e-service/19x/tcl8.4.19-html.zip Nordcad filer http://nordcad.dk/download/teknik/e-service/19x/tclpackageindex.zip Nordcad Systems A/S support@nordcad.dk Side 5 af 17
Installation og opsætning Java Kør exe filen der lige er blevet downloadet. Activestate Komodo Tcl Remote Debugging Åben komodo zip filen Åben mappen komodo Udpak dbgp_tcldebug.exe til C:\TCL\ TCL 8.4 Dokumentation Udpak tcl8.4.19-html.zip til C:\TCL\ Nordcad Filer Udpak TclPackageIndex.zip filen til C:\TCL\ Kør C:\Tcl\TclPackageIndex\set_needed_tcl_envvars.vbs Det tilføjer stier til miljøvariabler som skal bruges for at Eclipse, Tcl debugger og tcl shell virker korrekt. Eclipse Udpak eclipse zip filen til C:\TCL\ Kør C:\Tcl\eclipse\eclipse.exe Du vil nu se følgende Browse til den placering du ønsker at gemme de tcl filer du arbejder på, altså din default projekt folder. Klik derefter OK Nordcad Systems A/S support@nordcad.dk Side 6 af 17
Installation og opsætning af TCL development toolkit Når Eclipse er startet gå til Help Install new software. Klik på pilen ved drop down boksen og vælg den installerede version af Eclipse. Det er den øverste i listen lige efter All Available Sites Nordcad Systems A/S support@nordcad.dk Side 7 af 17
Fold Programming Languages ud og vælg Dynamic Languages Toolkit TCL Development Tools Klik Next > og Next > igen og vælg I accept the terms of the license agreement. Klik Finish Så går den i gang med at installere TCL development toolkitet Klik Yes til at genstarte Eclipse. Klik OK til det før valgte Workspace. Nordcad Systems A/S support@nordcad.dk Side 8 af 17
Opsætning af TCL debugger Når Eclipse er startet gå til Window og Preferences. Vælg Tcl Debug Engines Active State Klik en gang i Path: ud for External Debugging Engine feltet Klik på knappen med de 3 prikker. Nordcad Systems A/S support@nordcad.dk Side 9 af 17
Naviger til C:\TCL og vælg filen dbgp_tcldebug.exe og klik Open Opsætning af TCL interpreter I samme dialog som ovenfor (Window Preferences Tcl Interpreters) Klik derefter Add Nordcad Systems A/S support@nordcad.dk Side 10 af 17
Klik Browse Indsæt C:\Cadence\SPB_16.6\tools\tcltk\8.4\bin\tclsh.exe Klik Open Klik OK Nordcad Systems A/S support@nordcad.dk Side 11 af 17
Opsætning af TCL dokumentation I samme dialog som ovenfor (Window Preferences Tcl Man pages) Klik derefter Configure Klik Add Klik på Add igen og browse til C:\tcl\tcl8.4.19_doc" Klik OK Nordcad Systems A/S support@nordcad.dk Side 12 af 17
Skriv en beskrivelse i Name f.eks. TCL Tk 8.4 Doc som vist herunder og Klik OK 2 gange. Klik nu OK en sidste gang for at færdiggøre TCL opsætningen Nordcad Systems A/S support@nordcad.dk Side 13 af 17
Afprøv Eclipse opsætningen Opret et nyt TCL projekt med File New Project Vælg Tcl Tcl Project i New Project Wizarden Angiv et navn på projektet f.eks. my_first_project og tryk på Next Tryk nu på Finish for at oprette projektet Nordcad Systems A/S support@nordcad.dk Side 14 af 17
Svar Yes til dialogboksen omkring Tcl perspective (og sæt evt. checkmark i Remember my decision) Luk nu Welcome Screen på krydset i fanebladet. Nu er det netop oprettede projekt synligt. Opret nu den første Tcl fil i projektet ved at højreklikke på projektet og vælge New TCL File Angiv nu navnet på Tcl filen i dialogboksen, f.eks. my_first_file og tryk på Finish Nordcad Systems A/S support@nordcad.dk Side 15 af 17
Eclipse opretter nu en tcl fil med noget default kode Indsæt nu følgende koden puts my first tcl program i linje 4 således at koden ser ud som vist herunder For at eksekvere programmet og se om det skriver my first tcl program vælges Console panelet nederst og herefter vælges Run Run eller ikonen Herefter køres programmet og der skrives my first tcl program til konsollen. Nordcad Systems A/S support@nordcad.dk Side 16 af 17
Kom godt I gang med Capture TCL udvikling I applikationsnoten omkring OrCAD Capture TCL/TK Extensions File://C:\Cadence\spb_16.6\tools\capture\tclscripts\OrCAD_Capture_TclTk_Extensions.pdf Findes på side 29 og frem en række kode eksempler på f.eks. at gennemløbe alle åbne designs, gennemløbe alle komponenter på en side mv. Det er et rigtig godt udgangspunkt for at komme i gang med TCL til OrCAD Capture. Gode links OrCAD Capture TCL/Tk Extension: File://C:\Cadence\spb_16.6\tools\capture\tclscripts\OrCAD_Capture_TclTk_Extensions.pdf TCL/TK Tutorial: http://www.tutorialspoint.com/tcl-tk/ TCL Reference manual: http://tmml.sourceforge.net/doc/tcl/ TCL/TK kommando reference: https://www.tcl.tk/man/tcl/tclcmd/contents.htm Nordcad Systems A/S support@nordcad.dk Side 17 af 17