Changes between Version 40 and Version 41 of sysgen2opb


Ignore:
Timestamp:
Jun 20, 2006, 5:02:12 PM (18 years ago)
Author:
elliotng
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • sysgen2opb

    v40 v41  
    11= sysgen2opb Peripheral Conversion Tool =
    2 'sysgen2opb' is a MATLAB script which converts a model built in Xilinx System Generator into an OPB-compliant peripheral for use with the embedded PowerPCs. The script replaces all the model's gateways in/out with memory mapped registers. It also creates the necessary address decode logic and a C header file with the resulting register map.
    3 
    4 'sysgenGWSM2opb' is a similar script to 'sysgen2opb'. This script includes Shared Memory support by using Dual Port RAM's.
     2'sysgen2opb' is a MATLAB script which converts a model built in Xilinx System Generator into an OPB-compliant peripheral for use with the embedded PowerPCs. The script replaces all the model's gateways in/out with memory mapped registers. It also creates the necessary address decode logic and a C header file with the resulting register map.
     3It has two options to run:
     4 1. Original Script - This script is exactly what is described on the above.
     5 1. Shared Memory Extension Script - This script is the Original Script with the Shared Memory extension. The Shared Memory support requires the usage of Dual Port RAM's.
    56
    67The latest copy of this tool is available in the [source:/PlatformSupport/sysgen2opb/ repository].
     
    89== Using sysgen2opb ==
    910 1. Prepend `"no_reg_"` to a gateway's name to prevent its being converted to a register. These gateways will become top-level HDL ports in the exported peripheral.
    10  1. This script is supported for System Generator version 7.1 and 8.1.
     11 1. The original script is supported for System Generator version 7.1 and 8.1. The Shared Memory Extension Script is only supported for System Generator version 8.1.
    1112 1. Copy the conversion script (''sysgen2opb.m'') and its required skelton peripheral model (''skeleton_periph_model7.mdl'' or ''skeleton_periph_model8.mdl'') to the same directory as your model. ''skeleton_periph_model7.mdl'' is required for System Generator version 7.1 and ''skeleton_periph_model8.mdl'' is required for System Generator version 8.1.
    12  1. Make sure MATLAB's current working directory is the folder containing your model, the sysgen2opb script and skeleton model. Run the script on the MATLAB command line like `sysgen2opb('yourModelName', hex2dec('yourBaseAddress'), 'newPrefix')`.
    13    1. Replace `yourModelName` with your Simulink model's name without the `.mdl` extension.
    14    1. Replace `yourBaseAddress` with a 32-bit memory address in hexidecimal notation. `FF100000` is usually a safe choice.
    15    1. Replace `newPrefix` with a string which will replace the `"no_reg"` prefix attached to unconverted gateways. Use a blank string (`''`) to simply strip the `"no_reg_"` prefix.
     13 1. Make sure MATLAB's current working directory is the folder containing your model, the sysgen2opb script and skeleton model. Run the script on the MATLAB command line like `sysgen2opb('yourModelName', hex2dec('yourBaseAddress'), 'yourSelection', 'newPrefix')`.
     14   1. Replace 'yourModelName' with your Simulink model's name without the `.mdl` extension.
     15   1. Replace 'yourBaseAddress' with a 32-bit memory address in hexidecimal notation. `FF100000` is usually a safe choice.
     16   1. Replace 'yourSelection' with one of the following:
     17      1. 'orig' which will run the Original Script
     18      1. 'sm' which will run the Shared Memory Extension Script
     19   1. Replace 'newPrefix' with a string which will replace the `"no_reg"` prefix attached to unconverted gateways. Use a blank string (`''`) to simply strip the `"no_reg_"` prefix.
    1620
    17 == Using sysgenGWSM2opb ==
    18   1. This script is supported for System Generator version 8.1
    19   1. Copy the conversion script (''sysgenGWSM2opb.m'') and its required skelton peripheral model (''skeleton_periph_model8GWSM.mdl'') to the same directory as your model.
    20   1. Make sure MATLAB's current working directory is the folder containing your model, the sysgenGWSM2opb script and skeleton model. Run the script on the MATLAB command line like `sysgenGWSM2opb('yourModelName', hex2dec('yourBaseAddress'), 'newPrefix')`.
    21    1. Replace `yourModelName` with your Simulink model's name without the `.mdl` extension.
    22    1. Replace `yourBaseAddress` with a 32-bit memory address in hexidecimal notation. `FF100000` is usually a safe choice.
    23    1. Replace `newPrefix` with a string which will replace the `"no_reg"` prefix attached to unconverted gateways. Use a blank string (`''`) to simply strip the `"no_reg_"` prefix.
    2421
    25 == sysgenGWSM2opb Dual Port RAM Requirements ==
     22== sysgen2opb Shared Memory Extension Dual Port RAM Requirements ==
    2623Sample converted and unconverted models are available in the [source:/PlatformSupport/sysgen2opb/sysgenGWSM2opb_examples/ repository]. Note that the unconverted models are not meant to be simulated. The models are only for demonstration purposes in order to show the Dual Port RAM requirements.
    2724=== DPRAM (Read only) ===