dsx.soft

Software

class dsx.soft.soft.Software

__init__()

Creates a new Software.

Nodes should be accessed with the relevant dsx.ware.Ware API.

Note

Software is a dsx.ware.Ware.

Software Drivers

The software driver is a base class that is subclassed by MutekHSoftDriver. It is also subclassed by Posix, even if Posix is one of the TCG drivers.

class dsx.soft.driver.SoftDriver

A Software Driver.

Note

SoftDriver is a dsx.driver.Driver.

__init__(outdir, backend, parent=None, binlink=None, **args)

Creates a new SoftDriver. This is a base class that can be inherited to implement specific backend’s needs.

Parameters:

• outdir (str) – Output directory, relative to current directory or parent’s.
• backend (str) – Backend to use. Known values are “srloverhexo” (MutekS/MutekH), “posix”, and “wrapped_task” (SyntheticTask).
• parent (Driver or None) – Parent driver
• binlink (str or None) – If set, name of the symlink for the produced binary to put in root directory
• args – Arguments added to the make execution.

• dsx.driver.Driver API:

  drive(sw)

  See dsx.driver.Driver.drive().

  Parameters:sw (Software) – a software

• Custom API:

  binary()

  Accessor to resulting binary filename

  Returns:an absolute file path

  callMake(**args)

  Calls make with relevant backend’s options.

  Relies on the selected Runner.

  Parameters:args – A mapping for environment variables to set on the make command-line.

• Code generators:

  mkHwInit(sw)

  Generates the C code able to initialize the Mwmr coprocessors used by this software in dsx_hw_init.c.

  Parameters:sw (Software) – a software

  mkDesc(sw)

  Generates the C code containing the static description structures of all software resources and tasks used by this software in desc.c.

  Parameters:sw (Software) – a software

  genTaskProto(model)

  Generates the C header file for the given task model in <model>_proto.h.

  Parameters:model (TaskModel) – a task model

  mkMf(sw)

  Generates the Makefile file relevant for make invocation. Depends on the selected backend.

  Parameters:sw (Software) – a software

class dsx.soft.mutekh_app_driver.MutekHSoftDriver

A Software Driver specific to mapping on MutekH.

Note

MutekHSoftDriver is a dsx.soft.driver.SoftDriver.

__init__(outdir, parent=None)

Creates a new MutekHSoftDriver.

Parameters:

• outdir (str) – Output directory, relative to current directory or parent’s.
• parent (Driver or None) – Parent driver

• dsx.driver.Driver API:

  drive(sw)

  See dsx.soft.driver.SoftDriver.drive().

  Parameters:sw (Software) – a software

• dsx.soft.driver.SoftDriver API:

  mkMf(sw)

  See dsx.soft.driver.SoftDriver.mkMf().

• Custom API:

  mkConfig()

  Creates the relevant MutekH application configuration file in app.config.