Table of Contents

ExternalController coming soon

https://bladednextgen.dnv.com/schema/0.4.1/Turbine/BladedControl/ExternalController/ExternalController.json

Not supported yet

A definition of a single controller for the turbine.

  • Filepath: string
  • CallingConvention: string = __cdecl | __stdcall
  • FunctionName: string
  • PassParametersByFile: boolean
  • ForceLegacy: boolean
  • TimeStepMultiplier: string = Every | Second | Third | Fourth | Fifth | Sixth | Seventh | Eigth | Ninth | Tenth
  • Parameters: object
  • UseFloatingPointProtection: boolean

Properties

Filepath: stringcoming soon

The location of the external controller dll.

CallingConvention: string, optionalcoming soon

The calling convention to be used when calling the external controller. The default for all C-family languages is '__cdecl'. The default for FORTRAN is '__stdcall' unless the [C] qualifier is specfied immediately after the function name. Specifying the wrong calling convention can lead to unexplained system exceptions when attempting to call the external controller.

default = __cdecl

FunctionName: string, optionalcoming soon

The name of the function in the dll to run. This must satisfy the standard external controller typedef, found in the ExternalControllerApi.h.

default = ExternalController

PassParametersByFile: boolean, optionalcoming soon

If true, a file will be written containing the parameters in the above box. The location of this file can be obtained in the external controller using the function GetInfileFilepath. The name of this file will be "DISCON.IN" if there is only one controller, or of the pattern "DISCONn.IN", where 'n' is the number of the controller. If not checked (the default), this string will be directly available using the function GetUserParameters.

default = False

ForceLegacy: boolean, optionalcoming soon

If true, only the old-style 'DISCON' function will be looked for in the controller, and raise an error if it cannot be found. This is only used for testing legacy controllers where both CONTROLLER and DISCON functions are both defined, but the DISCON function is required.

default = False

TimeStepMultiplier: string, optionalcoming soon

Whether the controller should be called on every discrete timestep, set above.

default = Every

Parameters: object, optionalcoming soon

JSON data that will be passed to the constructor of the external module.

default =

UseFloatingPointProtection: boolean, optionalcoming soon

If true, this will apply floating point protection when calling the external controllers. When the protection is on, any floating point errors are trapped and reported. When this is switched off, the behaviour will default to that of the computer's floating point machine, but this can often be to not report the error, and to use a semi-random (but often very large) number instead of the correct result. This can lead to unrepeatable results and numeric errors.

default = True