Embedded Target for Motorola MPC555

MATLAB Commands for Working
with Target Preferences

You can create, modify, activate, or examine target preference objects via several MATLAB commands.

gettargetprefs Command

The gettargetprefs command retrieves the currently active target preferences. Note that until you have invoked settargetprefs, there are no active target preferences. If there are no active target preferences, gettargetprefs returns the factory default values.

The following example retrieves the active preferences into the target preference object tpObj:

• >> tpObj = gettargetprefs('mpc555dk')
   
  tpObj =
   
      target.mpc555dkprefs
  

settargetprefs Command

The settargetprefs command lets you create, clear, or modify your target preference settings. Until you have invoked settargetprefs, there are no active target preferences.Valid syntax for the settargetprefs command is shown below.

To reset to the factory default values for the target preferences:

• settargetprefs('mpc555dk','factory')
  

To make a target preference object active:

• settargetprefs('mpc555dk',tpObj)
  

To modify a property value for the target preferences:

• settargetprefs('mpc555dk','PropertyName','PropertyValue')
  

To clear the currently active target preferences:

• settargetprefs('mpc555dk',[])
  

In the sample MATLAB session below. the target preferences are set to the factory default values. The target preferences are then returned to an object, tpObj:

• >> settargetprefs('mpc555dk','factory')
  >> tpObj = gettargetprefs('mpc555dk')
   
  tpObj =
   
      target.mpc555dkprefs
  

display Command

The target preference object implements the display method. The display command allows you to retrieve a target preference structure from a target preference object. When the target preference object is already defined in your workspace, you can use the display command to view your current settings, as shown in the following example:

• >> display(tpObj)
   
  tpObj =
   
          TargetCompiler: 'CodeWarrior'
      TargetCompilerPath: 'D:\Applications\Metrowerks\CodeWarrior\Bin'
             CommTimeout: '4'
          TargetDebugger: 'SingleStep'
       TargetDebuggerExe: 'D:\Applications\SingleStep\sds762\cmd\bdmp58.exe'
            CommHostPort: 'COM1'
          CommTargetPort: 'COM1'
            CommBaudRate: '57600'
          PlugInIncludes: '  '
              PlugInLibs: '  '
       PlugInTLCIncludes: '  '
  
  

  Table 1-1: Target Preferences Summary

  Preference Name	Description	Default Value
  TargetCompiler	Choice of MPC555 cross-development system: 'Diab' or 'CodeWarrior'	'Diab'
  TargetCompilerPath	Path to your MPC555 cross-development system.	You must localize this to suit your PC.
  CommTimeout	Timeout value (in seconds) for the serial communications port.	4
  CommHostPort	Host serial port for host/target communications	'COM1'
  CommTargetPort	Target board serial port for host/target communications	'COM1'
  CommBaudRate	Baud rate (in bps) for host/target communications	57600
  TargetDebugger	Debugger to be invoked by PIL target. Currently used only when TargetCompiler = 'Diab'; ignored when TargetCompiler = 'CodeWarrior'	'SingleStep'
  TargetDebuggerExe	Fully qualified path and name for the debugger executable. The drive designated in the path must be either an actual hard drive on your PC, or a mapped drive. Do not use a UNC. Note: this field is ignored when TargetCompiler = 'CodeWarrior'	You must localize this to suit your PC.

Setting Target Preferences

Editing Target Preferences via the Property Inspector Window