[subexp-daq] Adding a new module type to NURDLIB

[Hans Toshihide Törnqvist]

Dear Günter,

I would suggest that you take a look at the v560 implementation, it 
looks like a somewhat similar Caen module.


Distinguishable means if one can distinguish it from another module 
mainly by looking at the first word in the data. This is used to 
determine whether barriers will be needed between certain groupings of 
modules.
For example:

module-1 header description:
Bits 24..31 = module ID
Bits 16..23 = 0

module-2 header description:
Bits 24..31 = module ID
Bits 16..23 = 0

module-3 header description:
Bits 24..31 = Serial-number
Bits 16..23 = 1

module-4 header description:
Bits 24..31 = Serial-number
Bits 16..23 = module ID

First, if nurdlib knows about the module ID of some electronics (e.g. 
the GEO of Caen modules), it will throw an error and quit if two modules 
somehow got the same ID. Typically it can be set by software and nurdlib 
keeps a counter to assign unique ID's.

module-1 and module-2 can be easily distinguished by the module ID, but 
also by bits 16..23, so they are def. distinguishable.

module-1 and module-3 can be via bits 16..23. The module ID is useless 
here since the serial-number could probably take any value. module-3 
against itself would not be very safe however in case the same 
serial-number was used for reasons out of our control!

module-1 and module-4 are not distinguishable since there's no way to 
guarantee that the bits explained here do not collide.

If you are not certain, you could say that the v767 is not 
distinguishable with any other module type, not even against itself. 
Have a quick look at the other Caen implementations to get an idea.
This could be maintained better with masking module ID's and fixed bits, 
which is on my todo...


I'll put this explanation in the wip manual.
Other than that, the different functions are explained quite well in 
module/module.h. So far the module implementations by other people have 
worked quite well, so there's probably not too much to worry about.

I haven't been able to find a solid moment to go through the sis3316 
code yet.


Cheers,
Hans


On 2024-01-31 17:33, Weber, Guenter Dr. wrote:
> Dear Hans, dear Håkan,
> 
> 
> I would like to integrate a new module into NURDLIB. It is the V767A TDC 
> from CEAN.
> 
> 
> In NURDLIB there is a folder "dummy". Should one use this as a template? 
> How to decide if a module is 'distinguishable'? And is there anything 
> else one should keep in mind before starting to play around?
> 
> 
> 
> Thank you very much!
> 
> 
> 
> 
> Best greetings
> 
> Günter
> 
> 
> 
> 
>