Add ability to change the capture directory

[ginty]

From the documentation that is included in this PR:

Configuring the Capture Storage Location

By default, both sim_delay and sim_capture will save their captured data to Org files (Origen native pattern format) using the following file naming rule: Origen.root/pattern/org/<target name>/<capture ID>.org.

If your application is a top-level application then the default setting should work fine unless you wish to share/re-use captured data between multiple targets.

Another reason to change from the default would be if data is captured at plugin-level and this needs to be referenced later when running within a top-level application. There are potentially two issues in that case:

• Origen.root will point to the top-level application's root instead of the plugin's

  • The target name used at the top-level could be different from the one that was used within the plugin to capture the data

  In such cases, the default capture directory can be changed by setting the OrigenSim.capture_dir attribute. This can be set anytime before the first call is made to sim_delay or sim_capture.

  For example, a plugin that needs its captured data to work later as part of a top-level application, could set the capture directory in a [startup callback](<%= path "guides/misc/callbacks/#startup(options)" %>), like this:

  def startup(options)
  # Only modify this if we are the current app or plugin
  if Origen.app!.current? || Origen.app!.current_plugin?
  # Use a directory within our root and named after the current IP block, rather than the target
  OrigenSim.capture_dir = Origen.root!.join('pattern', 'org', dut.myip.name)
  end
  end

[priyavadan]

@ginty thanks for the quick update!

I'll try this out with our application this week and let you know by Monday!

[priyavadan]

Apologies, I wasn't able to get to this last week. I am currently trying it out on the PGE and will let you know soon. Thanks for being patient!

[ginty]

@priyavadan, any update?