SourcePoint Intel Help
Table of Contents
- Using Help
- Contacting ASSET InterTech
- Introduction to SourcePoint
- SourcePoint Environment
- SourcePoint Overview
- SourcePoint Parent Window Introduction
- SourcePoint Icon Toolbar
- File Menu
- File Menu - Project Menu Item
- File Menu - Layout Menu Item
- File Menu - Program Menu Item
- File Menu - Macro Menu Item
- File Menu - Print Menu Items
- File Menu - Update Emulator Flash Menu Item
- File Menu - Program Target Device Menu Item
- File Menu - Other Menu Items
- Edit Menu
- View Menu
- Processor Menu
- Options Menu
- Options Menu - Preferences Menu Item
- Options Menu - Target Configuration Menu Item
- Options Menu - Load Target Configuration File Menu Item
- Options Menu - Save Target Configuration File Menu Item
- Options Menu - Emulator Configuration Menu Item
- Options Menu - Emulator Connection Menu Item
- Options Menu - Emulator Reset Menu Item
- Options Menu - Confidence Tests Menu Item
- Window Menu
- Help Menu
- How To -- SourcePoint Environment
- Add Emulator Connections
- Configure Custom Macro Icons
- Configure Autoloading Macros
- Display Text on the Icon Toolbar
- Edit Icon Groups to Customize Your Toolbars
- Modify a Defined Memory Region
- Refresh SourcePoint Windows
- Save a Program
- Start SourcePoint With Command Line Arguments
- Use the New Project Wizard
- Verify Emulator Network Connections
- SourcePoint Overview
- Breakpoints Window
- Breakpoints Window Overview
- How To - Breakpoints
- Code Window
- Command Window
- Command Window Overview
- Confidence Tests Window
- Confidence Tests Window Overview
- Descriptors Tables Window
- Descriptors Tables Window Overview
- How To - Descriptors
- Devices Window
- Devices Window Overview
- How To - Devices Window
- Log Window
- Log Window Overview
- Memory Window
- Memory Window Overview
- How To - Memory Window
- Page Translation Window
- Page Translation Windows Overview
- PCI Devices Window
- PCI Devices Window Overview
- How To - PCI Devices Window
- Registers Window
- Registers Window Overview
- How To - Registers
- Symbols Windows
- Symbols Window Overview
- How To - Symbols Window
- Trace Window
- Trace Window Overview
- How To - Trace Window
- Advanced
- Viewpoint Window
- Viewpoint Window Overview
- Watch Window
- Watch Window Overview
- How To - Watch Window
- Technical Notes
- Descriptor Cache: Revealing Hidden Registers
- UEFI Framework Debugging
- Memory Casting
- Microsoft PE Format Support in SourcePoint
- Multi-Clustering
- Python/CScripts
- OpenIPC Integration, Installation and Usage
- Registers Keyword Table
- SourcePoint Licensing
- Stepping
- Symbols Textsym Format
- Target Configuration
- Using Bookmarks
- Which Processor Is Which
- Getting Started with DbC
- SourcePoint Command Language
- Overview
- Commands and Control Variables
- aadump
- abort
- abs
- acos
- advanced
- asin
- asm
- asmmode
- atan
- atan2
- autoconfigure
- base
- bell (beep)
- bits
- break
- breakall
- cachememory
- cause
- Character Functions
- clock
- continue
- cos
- cpubreak commands
- cpuid_eax
- cpuid_ebx
- cpuid_ecx
- cpuid_edx
- createprocess
- cscfg, local_cscfg
- csr
- ctime
- cwd
- dbgbreak commands
- defaultpath
- #define
- define
- definemacro
- deviceconfigure
- devicelist
- devicescan
- disconnect
- displayflag
- do while
- dos
- dport
- drscan
- edit
- editor
- emubreak, emuremove, emudisable, emuenable
- emulatorstate
- encrypt
- error
- eval
- evalprogramsymbol
- execution point ($)
- exit
- exp
- fc
- fclose
- feof
- fgetc
- fgets
- first_jtag_device
- flist
- flush
- fopen
- for
- forward
- fprintf
- fputc
- fputs
- fread
- fseek
- ftell
- fwrite
- getc
- getchar
- getnearestprogramsymbol
- getprogramsymboladdress
- gets
- globalsourcepath
- go
- halt
- help
- homepath
- idcode
- if
- include
- invd
- irscan
- isdebugsymbol
- isem64t
- isprogramsymbol
- isrunning
- issleeping
- issmm
- itpcompatible
- jtagchain
- jtagconfigure
- jtagdeviceadd
- jtagdeviceclear
- jtagdevices
- jtagscan
- jtagtest
- keys
- last
- last_jtag_device
- left
- libcall
- license
- linear
- list, nolist
- load
- loadbreakpoints
- loadlayout
- loadproject
- loadtarget
- loadwatches
- log, nolog
- log10
- loge
- logmessage
- macropath
- Memory Access
- messagebox
- mid
- msgclose
- msgdata
- msgdelete
- msgdr
- msgdump
- msgir
- msgopen
- msgreturndatasize
- msgscan
- msr
- num_activeprocessors
- num_all_devices
- num_devices
- num_jtag_chains
- num_jtag_devices
- num_processors
- num_uncore_devices
- openipc
- pause
- physical
- port
- pow
- print cycles
- printf
- proc
- processorcontrol
- processorfamily
- processormode
- processors
- processortype
- projectpath
- putchar
- puts
- rand
- readsetting
- reconnect
- Register Access
- reload
- reloadproject
- remove
- reset
- restart
- return
- right
- runcontroltype
- safemode
- save
- savebreakpoints
- savelayout
- savewatches
- selectdirectory
- selectfile
- shell
- show
- sin
- sizeof
- sleep
- softbreak, softremove, softdisable, softenable
- sprintf
- sqrt
- srand
- step
- stop
- strcat
- strchr
- strcmp
- strcpy
- _strdate
- string [ ] (index into string)
- strlen
- _strlwr
- strncat
- strncmp
- strncpy
- strpos
- strstr
- _strtime
- strtod
- strtol
- strtoul
- _strupr
- swbreak
- switch
- swremove
- tabs
- tan
- tapdatashift
- tapstateset
- targpower
- targstatus
- taskattach
- taskbreak, taskremove, taskdisable, taskenable
- taskend
- taskgetpid
- taskstart
- tck
- time
- uncoreconfigure
- uncorescan
- #undef
- unload
- unloadproject
- upload
- use
- verify
- verifydeviceconfiguration
- verifyjtagconfiguration
- version
- viewpoint
- vpalias
- wait
- wbinvd
- while
- windowrefresh
- wport
- writesetting
- yield
- yieldflag
Code Window Menu
Once a Code window is open, a Code menu displays on the SourcePoint menu bar. The same menu can be accessed as a context menu by right-clicking within the Code window.
Code window menu
Source [Code] menu item. Select the Source menu item to enable you to view C or assembler source code. Source functions the same way as the Source option on the Code View drop down list on the dialog bar of the Code window.
Mixed [Code] menu item. Select Mixed to concurrently view both source code and the associated processor instructions as disassembled from memory. The Mixed menu item functions the same way as the Mixed option on the Code View drop down list on the dialog bar of the Code window.
Disassembly [Code] menu item. Select Disassembly to view processor instructions as disassembled from memory. The menu item functions the same way as the Disassembly option on the Code View drop down list on the dialog bar of the Code window.
Open Code Window menu item. This menu item allows you to click on a function and open a second Code window displaying its code.
Open Memory Window menu item. When this menu item is selected, the field at the current caret position in the Code window is evaluated as a data address, and a Memory window is opened at that address. This includes addresses, symbols, operand values, register values, and constants.
Copy to Watch menu item. This menu item allows you to copy a variable name, register name, or expression to a Watch window.
Quick Watch menu item. This menu item allows you to copy a variable name, register name, or expression to a Quick Watch window.
Set/Clear Breakpoint menu item. Select Set Breakpoint or Clear Breakpoint (the menu items toggle) to set or clear a breakpoint quickly and easily.
Set Alternate Breakpoint menu item. In the Breakpoints tab of the Options|Preferences dialog box, you selected a default type. Set Alternate Breakpoint lets you override that default on a one-time basis without having to change the default in the Breakpoints tab.
Enable/Disable Breakpoint menu item. Select Enable Breakpoint or Disable Breakpoint (the menu items toggle) to enable or disable processor register breakpoints at the caret position.
Add/Edit Breakpoint menu item. Place the caret at the position on the Code window where you want to add or edit a breakpoint. From the options menu, click Add Breakpoint or Edit Breakpoint (the menu items toggle) to bring up the Breakpoints window. Click on the Add or Edit button to access the Add Breakpoint or Edit Breakpoint dialog box.
For more information on how to add or edit a breakpoint, see "Edit Breakpoint and Add Breakpoint Dialog Boxes," part of "Breakpoints Window Overview," found under Breakpoints Window.
Go Until Cursor menu item. Select Code|Go Until Cursor to set a temporary breakpoint at a caret position and let the processor run (starting at the current instruction pointer) until it encounters a breakpoint. The Go Until Cursor menu item functions the same way as the Go Cursor button on the Code window dialog bar.
Set IP menu item. Select Set IP to change the EIP quickly and easily. The EIP value is modified to reflect the selected instruction, and the yellow EIP icon is moved to the instruction, as well. Applications for this feature include skipping over instructions (without executing them) or re-executing previously executed instructions.
Display menu item. Select the Display menu item to access the following options:
-
Line Number/Address. Changes the display of line numbers (Source or Mixed) and instruction addresses (Mixed or Disassembly). When enabled, line numbers and/or instruction addresses are shown. When disabled, the line number and/or instruction addresses are not shown.
-
Code Bytes. Toggles the display of an instruction object code field in the Code window.
-
Symbols. Displays/hides symbols.
-
Pseudo-Ops. Pseudo-ops are mnemonics that appear like register or instruction names but are really shorthand for a more memorable name.
-
Annotation. Indicates boundaries between source files and areas of memory that have no corresponding source. All annotation lines have a line of underscores before and after the annotation text.
-
Line Highlights. Options are Current IP or None.
-
Disassembly Case. Options are Mixed, Upper, and Lower.
-
Radix. Options are Command Default, Binary, Octal, Decimal, and Hexadecimal.
-
Radix Indicators. Options are Prefix, Suffix, and None.
-
Tab Spacing. Options are 2, 3, 4, 5, 6, 7, and 8.
Refresh menu item. Select Refresh to update the Code window by re-reading from target memory the instructions in the current address range. This menu item is useful when code resides in RAM and may be subject to change. The Refresh menu item found within the Code menu functions the same way as the Refresh button on Code window dialog bar.
Disassembly Mode menu item. Select Disassembly Mode to select the 16- or 32-bit instruction set for disassembly purposes. Options are Current Processor Default, 16-bit, and 32-bit.
Disassembly Uses menu item. Use this menu item to determine whether you want to view target memory or cached memory associated with disassembly mode. Options are Target Memory and Cached Program.
-
Target Memory causes disassembly operations to read target memory. Use this mode if there is a potential for the code space in target memory to be changing while the target is running.
-
Cached Program allows you to view disassembly without reading target memory. When this option is enabled, SourcePoint reads target memory from a cached copy, thus eliminating the need to refresh the Code window. Enabling this option minimizes the use of resources and speeds up single stepping.
Note: Program caching only works for Elf/Dwarf files.
Address menu item. Select the Address menu item to modify the view within the Code window. Options are Track IP , View Code at Address, and View Code at IP.
-
Track IP. When this option is selected, it toggles the function of the Code window to always show the address of the IP.
-
View Code at Address. When this option is selected, the Address dialog box displays. When an address is entered in the text box, it causes the Code window to bring this address into view.
View Code at Address text box
ย
Address Style |
Description |
Linear Address (exprL) |
Real or Protected mode. |
Physical Address (exprP) |
Real or Protected mode (same as the linear address if paging is not in effect). |
Offset (expr) |
Offset relative to selector CS. |
Segment Value: Offset (expr:expr) |
Value selected for segment plus value selected for offset. |
Segment Register: Offset (XS:expr) |
Uppercase designation for CS, DS, ES, FS, GS, or SS register plus value selected for offset. |
LDTR: Selector: Offset (expr:expr:expr) |
Value selected for LDTR plus values selected for selector (segment register) and offset. (This style is used in Protected mode only.) |
Symbolic |
When symbols are loaded through SourcePoint, this option is available. |
-
View Code at IP. When this option is selected, it causes the Code window to bring the IP address into view if it is not currently showing.
Viewpoint menu item. This menu item indicates the status of the processor viewpoint. If you have enabled one of the processor options, that processor is tracked. If you have enabled the Track Viewpoint option, the current processor is tracked.
Copy menu item. This menu item allows you to copy data from the Code window to another source (e.g., Notepad).
Add Code Profiling Function(s) menu item. Not functional.
ย
ย