User`s guide
insert
Purpose Add debug point to source file or address in CCS
Syntax insert(cc,addr,'type')
insert(cc,addr,
'type',timeout)
insert(cc,addr)
insert(cc,filename,line,
'type')
insert(cc,filename,line,
'type',timeout)
insert(cc,filename,line)
Description insert(cc,addr,'type') adds a debug point located at the memory
address identified by
addr for your processor digital signal proce ssor.
The link
cc identifies w hich processor has the debug point to insert.
CCS provides several types of debug points specified by
type.Options
for
type include the following strings to define Breakpoints, Probe
Points, and Profile p oints:
•
'break' — add a bre akpoint. It definesapointatwhichprogram
execution stops.
•
'' —sameas'break'.
•
'probe' — add a Probe Point that updates a CCS window during
program execution. When CCS connects y our probe point to a
window, the window gets updated only when the executing program
reaches the Probe Point.
•
'profile' — add a point in an executing program at which CCS
gathers statistics about events that occurred after encountering the
previous profile point, or from the start of your program.
When you use it,
insert operates in blocking mode, meaning that
after you issue the
insert command, you do not regain control in
the MATLAB environment until the insert breakpoint operation is
completed successfully—you are blocked from further process ing.
insert waits for the period defined by either timeout or cc.timeout.If
the insert operation does no t get completed w ithin the specified time
period,
insert returns an error and control.
7-62