RoC: Add dedicated README.md for ALF

Author: PascalBoeschoten

README.md

@@ -331,42 +331,4 @@ Also, the PDA kernel module must be inserted as root in any case.
 ALICE Low-level Front-end (ALF) DIM Server  <div id='alf'/>
 ===================
 The utilities contain a DIM server for DCS control of the cards 
-
-Usage
--------------------
-`DIM_DNS_NODE=mydimdns roc-alf-server --serial=11225 --channel=0`
-
-Service description
--------------------
-
-Services names are under: 
-`ALF/SERIAL_[a]/CHANNEL_[b]/[service name]`
-
-where [a] = card serial number
-      [b] = BAR index
-
-* The RPC calls take a string argument and return a string.
-* When the argument must contain multiple values, they must be comma-separated.
-* The return string will contain an 8-byte prefix indicating success or failure "success:" or "failure:", 
-  optionally followed by a return value or error message.
-
-For example: a register write call could have the argument string "504,42" meaning write value 42 to address 504.
-The return string could be "success:" or "failure:Address out of range".
-
-#### Register read
-* Service type: RPC call
-* Service name: REGISTER_READ 
-* Parameters: register address
-* Return: register value
-
-#### Register write
-* Service type: RPC call
-* Service name: REGISTER_WRITE
-* Parameters: register address, register value
-* Return:
-
-#### Temperature
-Card's core temperature in degrees Celsius
-* Service type: Published
-* Service name: TEMPERATURE
-* Value type: double
+For more information, see the dedicated readme at `src/CommandLineUtilities/AliceLowlevelFrontend/README.md`

src/CommandLineUtilities/AliceLowlevelFrontend/ProgramAliceLowlevelFrontendServer.cxx

@@ -240,10 +240,10 @@ class ProgramAliceLowlevelFrontendServer: public Program
         [&](auto parameter){return publishStartCommand(parameter, mCommandQueue);});
       auto serverPublishStop = makeServer(names.publishStopCommandRpc(),
         [&](auto parameter){return publishStopCommand(parameter, mCommandQueue);});
-//      auto serverScaRead = makeServer(names.scaRead(),
-//        [&](auto parameter){return scaRead(parameter, bar2);});
-//      auto serverScaWrite = makeServer(names.scaWrite(),
-//        [&](auto parameter){return scaWrite(parameter, bar2);});
+      auto serverScaRead = makeServer(names.scaRead(),
+        [&](auto parameter){return scaRead(parameter, bar2);});
+      auto serverScaWrite = makeServer(names.scaWrite(),
+        [&](auto parameter){return scaWrite(parameter, bar2);});
       auto serverScaGpioWrite = makeServer(names.scaGpioWrite(),
         [&](auto parameter){return scaGpioWrite(parameter, bar2);});
 
@@ -351,7 +351,7 @@ class ProgramAliceLowlevelFrontendServer: public Program
 
     static std::string scaRead(const std::string& parameter, ChannelSharedPtr bar2)
     {
-      getInfoLogger() << "SCA_READ: '" << parameter << "'" << endm;
+      getInfoLogger() << "SCA_READ" << endm;
       //auto params = split(parameter, ",");
       auto result = Sca(*bar2, bar2->getCardType()).read();
       return (b::format("%1%,%2%") % result.data % result.command).str();
@@ -361,8 +361,8 @@ class ProgramAliceLowlevelFrontendServer: public Program
     {
       getInfoLogger() << "SCA_WRITE: '" << parameter << "'" << endm;
       auto params = split(parameter, ",");
-      auto command = b::lexical_cast<uint32_t>(params.at(0));
-      auto data = b::lexical_cast<uint32_t>(params.at(1));
+      auto data = b::lexical_cast<uint32_t>(params.at(0));
+      auto command = b::lexical_cast<uint32_t>(params.at(1));
       Sca(*bar2, bar2->getCardType()).write(command, data);
       return "";
     }

src/CommandLineUtilities/AliceLowlevelFrontend/README.md

@@ -0,0 +1,65 @@
+# ALICE Low-level Front-end (ALF) DIM Server
+DIM server for DCS control of the cards
+
+
+# Usage
+`DIM_DNS_NODE=mydimdns roc-alf-server --serial=11225`
+
+
+# Services
+
+Service names are organized by card serial number:
+`ALF/SERIAL_[serial number]/[service name]`
+
+## RPC calls
+Some of the services are RPC calls.
+* RPC calls take a string argument and return a string.
+* When the argument must contain multiple values, they must be comma-separated.
+* The return string will contain an 8-byte prefix indicating success or failure "success:" or "failure:",
+  optionally followed by a return value or error message.
+* Numbers and addresses are all in base-10.
+
+For example: a register write call could have the argument string "504,42" meaning write value 42 to address 504.
+The return string could be "success:" or "failure:Address out of range".
+
+## Service description
+
+#### Register read
+* Service type: RPC call
+* Service name: REGISTER_READ
+* Parameters: register address
+* Return: register value
+
+#### Register write
+* Service type: RPC call
+* Service name: REGISTER_WRITE
+* Parameters: register address, register value
+* Return: empty
+
+#### SCA read
+A basic read from the SCA
+* Service type: RPC call
+* Service name: SCA_READ
+* Parameters: empty
+* Return: SCA data, SCA command
+
+#### SCA write
+A basic write to the SCA
+* Service type: RPC call
+* Service name: SCA_WRITE
+* Parameters: SCA data, SCA command
+* Return: empty
+
+#### SCA GPIO write
+Set enabled the selected GPIO pins
+* Service type: RPC call
+* Service name: SCA_GPIO_WRITE
+* Parameters: SCA data
+* Return: SCA data, SCA command
+
+#### Temperature
+Card's core temperature in degrees Celsius
+* Service type: Published
+* Service name: TEMPERATURE
+* Value type: double
+