Expanded comments and simplified calculations on tx_device

[Toreil]

• Extra comments were added to try and make the communication between the various buffers and the card easier to understand.
• There were one or two instances of multiple variables being defined containing the same thing (memory addresses of the buffers) which has been removed.
• The calculation for the ring_buffer_position was very complicated but in the end a lot of the steps were unnecessary. In the original code it was creating a pointer to a slice of the ring buffer and then getting the memory location of that slice, in the new code it calculates that memory location directly from the location of the ring buffer and the memory offset of the slice.

[github-actions]

Coverage Report

File	Stmts	Miss	Cover	Missing
src/console/interfaces
acquisition_data.py	120	24	80%	127–132, 141–142, 148–149, 152–153, 157–161, 176–177, 188–193, 199, 245
acquisition_parameter.py	87	10	89%	91–95, 117, 135, 137, 145, 169
dimensions.py	34	9	74%	30, 35, 41–44, 49, 55, 60, 65
src/console/pulseq_interpreter
sequence_provider.py	256	47	82%	91, 93, 95, 97–99, 115, 145, 150, 153–155, 187–190, 218–221, 235–236, 278, 302, 331, 339–342, 350–352, 461, 467, 472–476, 504, 539–546, 556, 622–623
src/console/spcm_control
abstract_device.py	79	79	0%	2–149
acquisition_control.py	148	148	0%	3–347
rx_device.py	180	180	0%	2–435
tx_device.py	180	180	0%	2–475
src/console/spcm_control/spcm
pyspcm.py	143	143	0%	3–276
tools.py	54	54	0%	3–128
src/console/utilities
json_encoder.py	8	3	62%	22–24
load_config.py	27	27	0%	2–119
plot.py	17	17	0%	2–26
src/console/utilities/sequences/calibration
fid_tx_adjust.py	18	1	94%	54
se_tx_adjust.py	25	2	92%	56–57
src/console/utilities/sequences/spectrometry
fid.py	15	15	0%	2–61
se_spectrum.py	24	2	92%	42, 65
src/console/utilities/sequences/tse
tse_3d.py	243	82	66%	109–110, 112–113, 115–116, 123–124, 126–128, 130–133, 136–147, 152–155, 162–173, 190, 212–219, 225, 254, 317–334, 341–342, 407, 410–422, 440, 442, 531–541
TOTAL	4899	1023	79%

Tests	Skipped	Failures	Errors	Time
215	0 💤	0 ❌	0 🔥	33.071s ⏱️

[schote]

The renaming makes sense, but I would like to avoid introducing abbreviations for the variable names and would generally keep them to a minimum. I.e. rather use data_buffer_address than data_buffer_addr. I think num_ is fine, but for channel we could also just use the long version. I think that saves us a large glossary and improves readability. What do you think @Toreil ?