detectors/slsDetectorPackage
25
0
Fork 0
mirror of https://github.com/slsdetectorgroup/slsDetectorPackage.git synced 2025-06-23 18:17:59 +02:00
Code Issues Actions Packages Releases Activity

Dev/document autocomplete (#1004)

Browse Source 
* fixed the gendoc to reflect the new parser, updated documentation to include info about autocomplete in the command line part, error in createing docs

* fixed list deprecated, fixed command help (to show properly on a html, fixed other help warnings

* minor indents

---------

Co-authored-by: Erik Fröjdh <erik.frojdh@gmail.com>
This commit is contained in:
maliakal_d
2024-10-21 16:39:50 +02:00
committed by GitHub
parent 0b9fd0664e
commit 6fcdba56a4
12 changed files with 137 additions and 375 deletions
Download Patch File Download Diff File Expand all files Collapse all files

1
slsDetectorSoftware/generator/Caller.in.h
View File

@ -55,6 +55,7 @@ class Caller {
}
std::vector<std::string> getAllCommands();
std::map<std::string, std::string> GetDeprecatedCommands();
std::string list(int action);
// THIS COMMENT TO BE REPLACED BY THE ACTUAL CODE (1)

18
slsDetectorSoftware/generator/commands.yaml
View File

@ -793,7 +793,7 @@ selinterface:
input_types: [ bool ]
udp_firstdst:
help: "\n[0 - 31 (or number of udp destinations)]\n\t[Jungfrau][Moench][Gotthard2]\n[0-63]\n\t[Mythen3]\n\n\t One can set which is the first destination that the detector will stream images out from in a round robin fashion. The entry must not have been empty. Default: 0"
help: "\n\t[0 - N]\n\twhere N is the max number of udp destinations - 1.\n\t[Jungfrau][Moench][Gotthard2] Max number of udp destinations is 32.\n\t[Mythen3] Max number of udp destination is 64.\n\t One can set which is the first destination that the detector will stream images out from in a round robin fashion. The entry must not have been empty. Default: 0"
inherit_actions: INTEGER_COMMAND_VEC_ID
actions:
GET:
@ -1074,7 +1074,7 @@ interruptsubframe:
input_types: [ bool ]
activate:
help: "[0, 1] \n\t[Eiger] 1 is default. 0 deactivates readout and does not send data."
help: "[0, 1]\n\t[Eiger] 1 is default. 0 deactivates readout and does not send data."
inherit_actions: INTEGER_COMMAND_VEC_ID
actions:
GET:
@ -1779,7 +1779,7 @@ udp_validate:
clearroi:
inherit_actions: EXECUTE_SET_COMMAND
help: "[Gotthard] Resets Region of interest in detector. All channels enabled. Default is all channels enabled."
help: "\n\t[Gotthard] Resets Region of interest in detector. All channels enabled. Default is all channels enabled."
actions:
PUT:
function: clearROI
@ -2034,7 +2034,7 @@ framecounter:
################# GET_COMMAND_HEX ############################
serialnumber:
inherit_actions: GET_COMMAND
help: "\n\t[Jungfrau][Moench][Gotthard][Mythen3][Gotthard2][Ctb]\nSerial number of detector."
help: "\n\t[Jungfrau][Moench][Gotthard][Mythen3][Gotthard2][Ctb]\n\tSerial number of detector."
actions:
GET:
function: getSerialNumber
@ -3429,7 +3429,7 @@ udp_dstlist:
output: [ ToString(args) ]
txdelay:
help: "[n_delay]\n\t[Eiger][Jungfrau][Moench][Mythen3] Set transmission delay for all modules in the detector using the step size provided.Sets up \n\t\t[Eiger] txdelay_left to (2 * mod_index * n_delay), \n\t\t[Eiger] txdelay_right to ((2 * mod_index + 1) * n_delay) and \n\t\t[Eiger] txdelay_frame to (2 *num_modules * n_delay) \n\t\t[Jungfrau][Moench][Mythen3] txdelay_frame to (num_modules * n_delay) \nfor every module."
help: "[n_delay]\n\t[Eiger][Jungfrau][Moench][Mythen3] Set transmission delay for all modules in the detector using the step size provided.Sets up \n\t[Eiger] txdelay_left to (2 * mod_index * n_delay), \n\t[Eiger] txdelay_right to ((2 * mod_index + 1) * n_delay) and \n\t[Eiger] txdelay_frame to (2 *num_modules * n_delay)\n\t[Jungfrau][Moench][Mythen3] txdelay_frame to (num_modules * n_delay) for every module."
actions:
GET:
argc: 0
@ -3963,7 +3963,7 @@ patloop:
output: [level,"' '" , "'['" , "ToStringHex(start, 4)" , '", "' , "ToStringHex(stop, 4)", "']'" ]
patloop0:
help: "Deprecated command. Use patloop."
help: "\n\tDeprecated command. Use patloop."
inherit_actions: patloop
actions:
GET:
@ -4010,7 +4010,7 @@ patnloop:
output: [ level,"' '" , nloops ]
patnloop0:
help: "Deprecated command. Use patnloop."
help: "\n\tDeprecated command. Use patnloop."
inherit_actions: patnloop
actions:
GET:
@ -4056,7 +4056,7 @@ patwait:
output: [level,"' '" , "ToStringHex(addr, 4)" ]
patwait0:
help: "Deprecated command. Use patwait."
help: "\n\tDeprecated command. Use patwait."
inherit_actions: patwait
actions:
GET:
@ -4102,7 +4102,7 @@ patwaittime:
output: [level,"' '" , "waittime" ]
patwaittime0:
help: "Deprecated command. Use patwaittime."
help: "\n\tDeprecated command. Use patwaittime."
inherit_actions: patwaittime
actions:
GET:

52
slsDetectorSoftware/generator/extended_commands.yaml
View File

@ -67,8 +67,7 @@ activate:
store_result_in_t: false
command_name: activate
function_alias: activate
help: "[0, 1] \n\t[Eiger] 1 is default. 0 deactivates readout and does not send\
\ data."
help: "[0, 1]\n\t[Eiger] 1 is default. 0 deactivates readout and does not send data."
infer_action: true
template: true
adcclk:
@ -1206,8 +1205,8 @@ clearroi:
store_result_in_t: false
command_name: clearroi
function_alias: clearroi
help: '[Gotthard] Resets Region of interest in detector. All channels enabled. Default
is all channels enabled.'
help: "\n\t[Gotthard] Resets Region of interest in detector. All channels enabled.\
\ Default is all channels enabled."
infer_action: true
template: true
clientversion:
@ -6078,7 +6077,7 @@ patloop0:
store_result_in_t: false
command_name: patloop0
function_alias: patloop0
help: Deprecated command. Use patloop.
help: "\n\tDeprecated command. Use patloop."
infer_action: true
patloop1:
actions:
@ -6147,7 +6146,7 @@ patloop1:
store_result_in_t: false
command_name: patloop1
function_alias: patloop1
help: Deprecated command. Use patloop.
help: "\n\tDeprecated command. Use patloop."
infer_action: true
patloop2:
actions:
@ -6216,7 +6215,7 @@ patloop2:
store_result_in_t: false
command_name: patloop2
function_alias: patloop2
help: Deprecated command. Use patloop.
help: "\n\tDeprecated command. Use patloop."
infer_action: true
patmask:
actions:
@ -6377,7 +6376,7 @@ patnloop0:
store_result_in_t: false
command_name: patnloop0
function_alias: patnloop0
help: Deprecated command. Use patnloop.
help: "\n\tDeprecated command. Use patnloop."
infer_action: true
patnloop1:
actions:
@ -6435,7 +6434,7 @@ patnloop1:
store_result_in_t: false
command_name: patnloop1
function_alias: patnloop1
help: Deprecated command. Use patnloop.
help: "\n\tDeprecated command. Use patnloop."
infer_action: true
patnloop2:
actions:
@ -6493,7 +6492,7 @@ patnloop2:
store_result_in_t: false
command_name: patnloop2
function_alias: patnloop2
help: Deprecated command. Use patnloop.
help: "\n\tDeprecated command. Use patnloop."
infer_action: true
patsetbit:
actions:
@ -6700,7 +6699,7 @@ patwait0:
store_result_in_t: false
command_name: patwait0
function_alias: patwait0
help: Deprecated command. Use patwait.
help: "\n\tDeprecated command. Use patwait."
infer_action: true
patwait1:
actions:
@ -6758,7 +6757,7 @@ patwait1:
store_result_in_t: false
command_name: patwait1
function_alias: patwait1
help: Deprecated command. Use patwait.
help: "\n\tDeprecated command. Use patwait."
infer_action: true
patwait2:
actions:
@ -6816,7 +6815,7 @@ patwait2:
store_result_in_t: false
command_name: patwait2
function_alias: patwait2
help: Deprecated command. Use patwait.
help: "\n\tDeprecated command. Use patwait."
infer_action: true
patwaittime:
actions:
@ -6937,7 +6936,7 @@ patwaittime0:
store_result_in_t: false
command_name: patwaittime0
function_alias: patwaittime0
help: Deprecated command. Use patwaittime.
help: "\n\tDeprecated command. Use patwaittime."
infer_action: true
patwaittime1:
actions:
@ -6995,7 +6994,7 @@ patwaittime1:
store_result_in_t: false
command_name: patwaittime1
function_alias: patwaittime1
help: Deprecated command. Use patwaittime.
help: "\n\tDeprecated command. Use patwaittime."
infer_action: true
patwaittime2:
actions:
@ -7053,7 +7052,7 @@ patwaittime2:
store_result_in_t: false
command_name: patwaittime2
function_alias: patwaittime2
help: Deprecated command. Use patwaittime.
help: "\n\tDeprecated command. Use patwaittime."
infer_action: true
patword:
actions:
@ -9754,7 +9753,7 @@ serialnumber:
store_result_in_t: true
command_name: serialnumber
function_alias: serialnumber
help: "\n\t[Jungfrau][Moench][Gotthard][Mythen3][Gotthard2][Ctb]\nSerial number\
help: "\n\t[Jungfrau][Moench][Gotthard][Mythen3][Gotthard2][Ctb]\n\tSerial number\
\ of detector."
infer_action: true
template: true
@ -11913,11 +11912,11 @@ txdelay:
command_name: txdelay
function_alias: txdelay
help: "[n_delay]\n\t[Eiger][Jungfrau][Moench][Mythen3] Set transmission delay for\
\ all modules in the detector using the step size provided.Sets up \n\t\t[Eiger]\
\ txdelay_left to (2 * mod_index * n_delay), \n\t\t[Eiger] txdelay_right to ((2\
\ * mod_index + 1) * n_delay) and \n\t\t[Eiger] txdelay_frame to (2 *num_modules\
\ * n_delay) \n\t\t[Jungfrau][Moench][Mythen3] txdelay_frame to (num_modules\
\ * n_delay) \nfor every module."
\ all modules in the detector using the step size provided.Sets up \n\t[Eiger]\
\ txdelay_left to (2 * mod_index * n_delay), \n\t[Eiger] txdelay_right to ((2\
\ * mod_index + 1) * n_delay) and \n\t[Eiger] txdelay_frame to (2 *num_modules\
\ * n_delay)\n\t[Jungfrau][Moench][Mythen3] txdelay_frame to (num_modules * n_delay)\
\ for every module."
infer_action: true
txdelay_frame:
actions:
@ -12417,10 +12416,11 @@ udp_firstdst:
store_result_in_t: false
command_name: udp_firstdst
function_alias: udp_firstdst
help: "\n[0 - 31 (or number of udp destinations)]\n\t[Jungfrau][Moench][Gotthard2]\n\
[0-63]\n\t[Mythen3]\n\n\t One can set which is the first destination that the\
\ detector will stream images out from in a round robin fashion. The entry must\
\ not have been empty. Default: 0"
help: "\n\t[0 - N]\n\twhere N is the max number of udp destinations - 1.\n\t[Jungfrau][Moench][Gotthard2]\
\ Max number of udp destinations is 32.\n\t[Mythen3] Max number of udp destination\
\ is 64.\n\t One can set which is the first destination that the detector will\
\ stream images out from in a round robin fashion. The entry must not have been\
\ empty. Default: 0"
infer_action: true
template: true
udp_numdst:

1
slsDetectorSoftware/generator/gen_commands.py
View File

@ -60,7 +60,6 @@ def generate(
if command["help"].startswith('code:'):
codegen.write_line(command["help"].strip('code:'))
else:
codegen.write_line(f'os << "Command: {command_name}" << std::endl;')
codegen.write_line(f'os << R"V0G0N({command["help"]} )V0G0N" << std::endl;')
codegen.write_line('return os.str();')