DataSource Enumeration

• The response format for almost all DataSources is: 16-bits, signed or unsigned as appropriate, left-aligned in a 20-bit field.

  C#

  Copy

  // NB: we assume the use of suitable commands here...
  uint[] responses = client.ScannerCommunication.TransceiveEnhanced(head, axes, commands, timeoutMs);
  
  short signedDataValue = (short)(responses[0] >> 4);
  
  ushort unsignedDatavalue = (ushort)(responses[1] >> 4);

• A few DataSources return positions in their responses:

  • CurrentPosition
  • TargetPosition
  • PositionError

  These are all signed values, with 16 or 20 significant bits, left-aligned in a 20-bit field.

  C#

  Copy

  // NB: we assume the use of suitable commands here...
  uint[] responses = client.ScannerCommunication.TransceiveEnhanced(head, axes, commands, timeoutMs);
  
  short position16bit = (short)(responses[0] >> 4);
  
  int position20bit = ((int)(responses[0] << 12)) >> 12; // sign-extension trick
  
  // 
  // NB: the sign-extension trick extracts the raw 20-bit signed position
  // from the surrounding unsigned 32-bit response frame,
  // and converts it into a signed 32-bit signed int value.
  

Reference