DSP Terminal V1.5.7 Users Guide

Size: px

Start display at page:

Download "DSP Terminal V1.5.7 Users Guide"

Daniela Austin
5 years ago
Views:

1 Faculty of electrical engineering and computer science INSTITUTE OF ROBOTICS DSP terminal V1.5.7 DSP Terminal V1.5.7 Users Guide Feb,

Overview Terminal program is used for communication between DSP card and user. Program runs on Windows 95/98/NT/2000/Millennium/XP operating system.

2 Overview Terminal program is used for communication between DSP card and user. Program runs on Windows 95/98/NT/2000/Millennium/XP operating system. The differences between this terminal and others are in some additional features that enable full utilization of the DSP-2 target system. DSP-2 system and terminal program can be connected together via serial RS232 channel, USB or TCP/IP. Terminal program consists of four pages that can be selected: Text classic text terminal with some additional options Visual - page containing variables with possibility of graphical representation in realtime Parameters selected parameters can be changed during program execution Options options and settings of terminal program Text text terminal Terminal screen Page selection tabs Popup menu Shortcuts for resetting terminal and program download Status line Terminal receives characters from DSP and shows them on the text terminal screen. Received characters are written down one after another to the right till the end of the line. When the line is filled, cursor scrolls down one line. When cursor reaches the last line, the content of the screen is scrolled up one line and the first line is lost. Terminal takes into account some special characters: CR (0x0d) Carriage Return sets cursor at the beginning of the line LF (0x0a) Line Feed sets cursor one line down Feb,

3 BS (0x08) Back Space deletes last character ESCape sequences (0x1b) o CLRSCR (0x1b [ 2 J) - Sequence Clear screen clears terminal screen o UP (0x1b [ n A) sets cursor n lines up ( 1 =0x31-one line, 2 -two lines ) o ToFile (0x1b 0x01 filename.ext 0x00) redirects printout from screen to file with name filename.ext. o End (0x1b 0x02) end of redirection to a file. Next incoming characters are again printed out on screen. Besides printing out received characters, terminal enables sending characters trough serial interface to DSP card. Characters are input by keyboard. Terminal screen should be focused in this case. If not, terminal screen receives focus by clicking on it with mouse. Text popup menu Popup menu within text page is selected by single mouse right-click with following options: Fontsize - The text font and size with fixed pitch can be set Clear screen Clears text screen contents Copy All Copy all text to clipboard Paste Paste text from clipboard Status line Status line of the terminal consists of three buttons and text line. First Reset button is used to reset the DSP board. The Download button is enabled after reset, when download is enabled and the DSP board is ready. (check Options settings). The Reset&Download button can be used to automatic reset the DSP board and after that download is automatically performed by a single click. Status line is used to show communication status and error messages when they occur. When connection is normal the status text consists of name of the selected communication port, followed with number of read errors and write errors that have occurred during communication. The (Ack) is a counter of acknowledges sent by the DSP. The real data transfer bit rate (BR) is shown as the last information. Feb,

4 Visual Data visualization Scope settings Visual page shows current values of the signals, selected by using DSP2_TT block in DSP2LIB. Variables can be shown in graphically form by selecting them in the checkbox. Trigger setting Selected variable scope When the variables are selected (AI_3, AO_1), time response is sampled and shown by the appropriate color on the scope. Number of variables is limited to data space on the DSP board depending on the available total number of samples (20000) stored in the DSP buffer. Top toolbar is used to navigate with scope that shows the time response of the selected variables using sample-time resolution Ts divided by the Decimation property. Decimation can be changed by entering new integer value. The response on the scope can be paused when the button Pause is clicked. With button Scroll/Alt mode of showing data is switched. By using SaveToFile button, current response shown on screen can be saved to a file with.dat extension that can be used in Matlab fur further data processing. ISR time shows time consumed by the algorithm. Trigger can be set on selected variable (A0_1 on figure). By clicking on the button trigger edge can be selected (none, rising edge, falling edge). By using parameter Pre samples, the scope response of the selected variables before trigger condition can be shown for entered number of samples. ParIns button is used to show/hide Parameter inspector window enabling easy parameter changing during performing an experiment. The parameters in Parameter inspector window consist of a name of the parameter, its current value, followed by the unit in text form. When a parameter value is clicked, its value can be changed. And after pressing <Enter> key, the new value is transferred to the DSP. The value is changed to? until DSP returns acknowledgment followed by the actual value of the changed parameter. Feb,

Also the type of the parameter is shown in last column. Parameter value can be changed during algorithm execution.

5 Parameter inspector Trigger condition Parameters Parameters, used in algorithm are shown in Parameters page or in Parameter Inspector window. Each parameter is represented by its unique identification number, parameter name, current value and unit. Also the type of the parameter is shown in last column. Parameter value can be changed during algorithm execution. It is updated in algorithm after pressing <Enter> key. Parameter name Parameter value can be changed Options Terminal settings Feb,

6 Selection of comm. channel Executable program path Program download Communication parameter settings Communication baudrate Graph & Text capture Additional settings Sheet named Options is used to set the terminal properties. On the left side of the page are communication settings: Selection of communication channel, bit rate, number of bits per byte, parity and number of stop bits. Default setting for the connection is Bd, 8-bits, None parity, 1 stop bit as shown on picture. Existing communication channels are marked with asterix. Please note that the availability of the communication channel is checked only at terminal startup. In case of not existing channel (ex. COM3, when there is only COM1 and COM2), we get an error shown in the status bar. In case when there is irregular setting of communication parameters, we get an error in the status bar. Please check the correct connection settings. The DSP board can be connected to the terminal via TCP/IP using static address. The terminal can connect to the DSP board when TCP/IP of the DSP board is set and then port TCP/IP is selected. When the terminal can not connect to the DSP, then the error status is shown. Please check if DSP board is powered on and connected via UTP cable. In order to avoid delay during connection, before setting the port on TCP/IP, set correct IP address of the DSP board and make sure, it is powered on, otherwise the system will try to connect to not responding address and during that time the terminal will appear frozen. Feb,

7 TCP/IP Server Another application can communicate to the DSP via the terminal using TCP/IP connection. In that case the terminal acts as a server. The service is enabled, when the option Enable TCP/IP server is checked. The service can be used on fixed port At this point, only simple current value of the variables is implemented. The current variable value can be read from the terminal using following text message: V[name] The terminal responds with the text value of the variable. The value of the variable can be stored with following: V[name],[value] On the right side of the terminal screen is Download frame. The path, where target executable program in HEX format is located is written in text frame. With one mouse click on the button new window is opened, where new target executable program can be selected. When using terminal for download of the code to the DSP Enable booting from terminal should be checked, otherwise DSP will start the program written in FLASH automatically after reset. Reset button is used to reset the DSP card. After reset, the welcome message on text terminal is shown. When button Dload is pressed, binary transfer of the target program to DSP controller is started using selected download bitrate when possible. Before download, the terminal checks if controller is in the download mode. When data is transferred, progress of download is shown on progress bar. Downloaded program is automatically started on target system. In case when correct answer is not received from DSP, an error message is shown. In that case correct communication setting, cable connection, reset of Feb,

the device should be performed. When target program is running, download is not possible; therefore reset of the DSP card is needed. The option Run hex.

8 the device should be performed. When target program is running, download is not possible; therefore reset of the DSP card is needed. The option Run hex.bat can be enabled when additional command needs to be performed before download. When using DSP-2 Library for Simulink, this option should not be checked. The algorithm on the DSP-2 board can be written also in FLASH, which can be performed by checking Enable FLASH programming and clicking the button Pgm FLASH. This option is designed for servicing personal only. Maximum communication baudrate setting is used for the download and also for the communication with the DSP board, after the algorithm is started. Default download speed is Bd, but can be changed to higher if hardware of the serial device permits that. Normally Bd can be achieved using serial RS232 device. After download the speed remains as selected. When DSP card is reset, the speed is automatically changed back to Connection speed Bd. Note that with manual reset, or powering on DSP card DSP responds at Bd, that can differ to last set speed on the terminal. In order to change it back to Bd, the Reset button must be clicked. Store settings frame serves to set the properties regarding storage data. A data can be stored using capture, or via terminal with the button. A redirection path is used to set the location of the scope responses should be saved. File auto numbering can be used to add automatically numbering of the saved responses. DSP Terminal has escape sequence to redirect printout from screen to file. The DSP Terminal has additional feature to set directory on disk where output file is generated. Store settings response redirection path The drawing of the graph shown in the Visual tab can be enabled or disabled by selecting the option Show graph. Feb,

9 The terminal allows to Automatically store the last value of the selected Variables in the file named VariablesAuto.dat. The data in the file are updated as soon the next set of values is available. This option can consume considerable process time that can be reduced by increasing the Decimation variable. Also entire response can be automatically stored by selecting Graph option in the file by the name GraphAuto.dat. Below Redirection path are Additional terminal settings: Text mode enable - When this option is enabled, in text mode to characters are shown on screen Cursor Enable Text mode cursor on/off Local Echo Sent characters are printed out on terminal screen when enabled Columns box enables limitation the number of characters printed on one line. Default setting is 79. Enable debugging shows additional sheet allowing sent and received characters in text mode to be displayed in hexadecimal form. Enable parameter inspector enables showing the parameter inspector Parameter store option is used when parameters should be saved to a file named Parameters.txt when changed Enable multiple instances option is used when more than one instance of the terminal needs to be used at the same time, for instance when using two DSP boards. When one DSP board is used in combination with DSP-2 Library for Simulink, this option should not be checked in order that automatic download is performed correctly. Q fixpoint box is used to set the location of the fixed point for FIXPOINT type of the variables. These variables are used in the combination with TMS320F2812 Board. Terminal program saves most important settings in file term.ini: Position and size of the terminal screen Communication settings Name of the last downloaded program All other settings like Echo, Input show, Output Show, Cursor Enable and Terminal Enable When program does not find file term.ini at startup, default file term.ini is automatic generated. Settings are default, and should be checked before starting. Additional information is available at: mailto:evgen.urlep@uni-mb.si Feb,

Beijer Electronics AB 2000, MA00453,

Beijer Electronics AB 2000, MA00453, VT100 emulation This manual presents installation and handling of the driver VT100 to the terminals in the E-series. The functionality in the E-terminals and in MAC Programmer+ are described in the E-manual.