configure method

  1. @nonVirtual
void configure(
  1. TDeviceConfiguration configuration, [
  2. DeviceRegistration? registration
])

Configures this device manager with its configuration.

Optionally, a registration can be specified to provide runtime information about the real device, e.g., the BLE address of a Bluetooth device. Calls onConfigure and sets status to DeviceStatus.configured. Does nothing if already configured. A registration of another type than TRegistration is ignored, e.g. a DefaultDeviceRegistration stored by an older version of CAMS.

Implementation

@nonVirtual
void configure(TDeviceConfiguration configuration, [DeviceRegistration? registration]) {
  // fast out if already configured
  if (isConfigured) return;

  info('$runtimeType - Configuring, type: $typeName, configuration: $configuration, registration: $registration');

  _configuration = configuration;
  _registration = registration is TRegistration ? registration : null;
  onConfigure();

  // A device connecting after the study has started has its executors paused,
  // and nothing else resumes them.
  statusEvents.where((status) => status == DeviceStatus.connected).listen((_) => start());
  statusEvents.where((status) => status == DeviceStatus.disconnecting).listen((_) => isDisconnecting());
  statusEvents.where((status) => status == DeviceStatus.reconnected).listen((_) => restart());

  status = DeviceStatus.configured;
}