From 7fd135dfb2a8c550252cb13327a6a84cd1815778 Mon Sep 17 00:00:00 2001
From: Jan Breuer <jan.breuer@jaybee.cz>
Date: 周二, 31 5月 2016 21:59:04 +0800
Subject: [PATCH] Fix test comment

---
 examples/common/scpi-def.cpp |  428 ++++++++++++++++++++++++++++++++++++++++++-----------
 1 files changed, 338 insertions(+), 90 deletions(-)

diff --git a/examples/common/scpi-def.cpp b/examples/common/scpi-def.cpp
index d5fc7ca..0633d06 100644
--- a/examples/common/scpi-def.cpp
+++ b/examples/common/scpi-def.cpp
@@ -2,7 +2,7 @@
  * Copyright (c) 2012-2013 Jan Breuer,
  *
  * All Rights Reserved
- * 
+ *
  * Redistribution and use in source and binary forms, with or without
  * modification, are permitted provided that the following conditions are
  * met:
@@ -11,7 +11,7 @@
  * 2. Redistributions in binary form must reproduce the above copyright
  *    notice, this list of conditions and the following disclaimer in the
  *    documentation and/or other materials provided with the distribution.
- * 
+ *
  * THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS OR
  * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
  * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
@@ -28,10 +28,10 @@
 /**
  * @file   scpi-def.c
  * @date   Thu Nov 15 10:58:45 UTC 2012
- * 
+ *
  * @brief  SCPI parser test
- * 
- * 
+ *
+ *
  */
 
 #include <stdio.h>
@@ -40,46 +40,73 @@
 #include "scpi/scpi.h"
 #include "scpi-def.h"
 
-scpi_result_t DMM_MeasureVoltageDcQ(scpi_t * context) {
+static scpi_result_t DMM_MeasureVoltageDcQ(scpi_t * context) {
     scpi_number_t param1, param2;
     char bf[15];
-    fprintf(stderr, "meas:volt:dc\r\n"); // debug command name   
+    fprintf(stderr, "meas:volt:dc\r\n"); // debug command name
 
     // read first parameter if present
-    if (!SCPI_ParamNumber(context, &param1, false)) {
+    if (!SCPI_ParamNumber(context, scpi_special_numbers_def, &param1, FALSE)) {
         // do something, if parameter not present
     }
 
     // read second paraeter if present
-    if (!SCPI_ParamNumber(context, &param2, false)) {
+    if (!SCPI_ParamNumber(context, scpi_special_numbers_def, &param2, FALSE)) {
         // do something, if parameter not present
     }
 
-    
-    SCPI_NumberToStr(context, &param1, bf, 15);
+
+    SCPI_NumberToStr(context, scpi_special_numbers_def, &param1, bf, 15);
     fprintf(stderr, "\tP1=%s\r\n", bf);
 
-    
-    SCPI_NumberToStr(context, &param2, bf, 15);
+
+    SCPI_NumberToStr(context, scpi_special_numbers_def, &param2, bf, 15);
     fprintf(stderr, "\tP2=%s\r\n", bf);
 
     SCPI_ResultDouble(context, 0);
-    
+
     return SCPI_RES_OK;
 }
 
-
-scpi_result_t DMM_ConfigureVoltageDc(scpi_t * context) {
-    double param1, param2;
-    fprintf(stderr, "conf:volt:dc\r\n"); // debug command name   
+static scpi_result_t DMM_MeasureVoltageAcQ(scpi_t * context) {
+    scpi_number_t param1, param2;
+    char bf[15];
+    fprintf(stderr, "meas:volt:ac\r\n"); // debug command name
 
     // read first parameter if present
-    if (!SCPI_ParamDouble(context, &param1, true)) {
+    if (!SCPI_ParamNumber(context, scpi_special_numbers_def, &param1, FALSE)) {
+        // do something, if parameter not present
+    }
+
+    // read second paraeter if present
+    if (!SCPI_ParamNumber(context, scpi_special_numbers_def, &param2, FALSE)) {
+        // do something, if parameter not present
+    }
+
+
+    SCPI_NumberToStr(context, scpi_special_numbers_def, &param1, bf, 15);
+    fprintf(stderr, "\tP1=%s\r\n", bf);
+
+
+    SCPI_NumberToStr(context, scpi_special_numbers_def, &param2, bf, 15);
+    fprintf(stderr, "\tP2=%s\r\n", bf);
+
+    SCPI_ResultDouble(context, 0);
+
+    return SCPI_RES_OK;
+}
+
+static scpi_result_t DMM_ConfigureVoltageDc(scpi_t * context) {
+    double param1, param2;
+    fprintf(stderr, "conf:volt:dc\r\n"); // debug command name
+
+    // read first parameter if present
+    if (!SCPI_ParamDouble(context, &param1, TRUE)) {
         return SCPI_RES_ERR;
     }
 
     // read second paraeter if present
-    if (!SCPI_ParamDouble(context, &param2, false)) {
+    if (!SCPI_ParamDouble(context, &param2, FALSE)) {
         // do something, if parameter not present
     }
 
@@ -89,88 +116,309 @@
     return SCPI_RES_OK;
 }
 
-static const scpi_command_t scpi_commands[] = {
-    /* {"pattern", callback} *
-    
+static scpi_result_t TEST_Bool(scpi_t * context) {
+    scpi_bool_t param1;
+    fprintf(stderr, "TEST:BOOL\r\n"); // debug command name
+
+    // read first parameter if present
+    if (!SCPI_ParamBool(context, &param1, TRUE)) {
+        return SCPI_RES_ERR;
+    }
+
+    fprintf(stderr, "\tP1=%d\r\n", param1);
+
+    return SCPI_RES_OK;
+}
+
+scpi_choice_def_t trigger_source[] = {
+    {"BUS", 5},
+    {"IMMediate", 6},
+    {"EXTernal", 7},
+    SCPI_CHOICE_LIST_END /* termination of option list */
+};
+
+static scpi_result_t TEST_ChoiceQ(scpi_t * context) {
+
+    int32_t param;
+    const char * name;
+
+    if (!SCPI_ParamChoice(context, trigger_source, &param, TRUE)) {
+        return SCPI_RES_ERR;
+    }
+
+    SCPI_ChoiceToName(trigger_source, param, &name);
+    fprintf(stderr, "\tP1=%s (%ld)\r\n", name, (long int) param);
+
+    SCPI_ResultInt32(context, param);
+
+    return SCPI_RES_OK;
+}
+
+static scpi_result_t TEST_Numbers(scpi_t * context) {
+    int32_t numbers[2];
+
+    SCPI_CommandNumbers(context, numbers, 2, 1);
+
+    fprintf(stderr, "TEST numbers %d %d\r\n", numbers[0], numbers[1]);
+
+    return SCPI_RES_OK;
+}
+
+static scpi_result_t TEST_Text(scpi_t * context) {
+    char buffer[100];
+    size_t copy_len;
+
+    if (!SCPI_ParamCopyText(context, buffer, sizeof (buffer), &copy_len, FALSE)) {
+        buffer[0] = '\0';
+    }
+
+    fprintf(stderr, "TEXT: ***%s***\r\n", buffer);
+
+    return SCPI_RES_OK;
+}
+
+static scpi_result_t TEST_ArbQ(scpi_t * context) {
+    const char * data;
+    size_t len;
+
+    if (SCPI_ParamArbitraryBlock(context, &data, &len, FALSE)) {
+        SCPI_ResultArbitraryBlock(context, data, len);
+    }
+
+    return SCPI_RES_OK;
+}
+
+struct _scpi_channel_value_t {
+    int32_t row;
+    int32_t col;
+};
+typedef struct _scpi_channel_value_t scpi_channel_value_t;
+
+/**
+ * @brief
+ * parses lists
+ * channel numbers > 0.
+ * no checks yet.
+ * valid: (@1), (@3!1:1!3), ...
+ * (@1!1:3!2) would be 1!1, 1!2, 2!1, 2!2, 3!1, 3!2.
+ * (@3!1:1!3) would be 3!1, 3!2, 3!3, 2!1, 2!2, 2!3, ... 1!3.
+ *
+ * @param channel_list channel list, compare to SCPI99 Vol 1 Ch. 8.3.2
+ */
+static scpi_result_t TEST_Chanlst(scpi_t *context) {
+    scpi_parameter_t channel_list_param;
+#define MAXROW 2    //maximum number of rows
+#define MAXCOL 6    //maximum number of columns
+#define MAXDIM 2    //maximum number of dimensions
+    scpi_channel_value_t array[MAXROW * MAXCOL]; //array which holds values in order (2D)
+    size_t chanlst_idx; //index for channel list
+    size_t arr_idx = 0; //index for array
+    size_t n, m = 1; //counters for row (n) and columns (m)
+
+    // get channel list
+    if (SCPI_Parameter(context, &channel_list_param, TRUE)) {
+        scpi_expr_result_t res;
+        scpi_bool_t is_range;
+        int32_t values_from[MAXDIM];
+        int32_t values_to[MAXDIM];
+        size_t dimensions;
+
+        bool for_stop_row = false; //true if iteration for rows has to stop
+        bool for_stop_col = false; //true if iteration for columns has to stop
+        int32_t dir_row = 1; //direction of counter for rows, +/-1
+        int32_t dir_col = 1; //direction of counter for columns, +/-1
+
+        // the next statement is valid usage and it gets only real number of dimensions for the first item (index 0)
+        if (!SCPI_ExprChannelListEntry(context, &channel_list_param, 0, &is_range, NULL, NULL, 0, &dimensions)) {
+            chanlst_idx = 0; //call first index
+            arr_idx = 0; //set arr_idx to 0
+            do { //if valid, iterate over channel_list_param index while res == valid (do-while cause we have to do it once)
+                res = SCPI_ExprChannelListEntry(context, &channel_list_param, chanlst_idx, &is_range, values_from, values_to, 4, &dimensions);
+                if (is_range == false) { //still can have multiple dimensions
+                    if (dimensions == 1) {
+                        //here we have our values
+                        //row == values_from[0]
+                        //col == 0 (fixed number)
+                        //call a function or something
+                        array[arr_idx].row = values_from[0];
+                        array[arr_idx].col = 0;
+                    } else if (dimensions == 2) {
+                        //here we have our values
+                        //row == values_fom[0]
+                        //col == values_from[1]
+                        //call a function or something
+                        array[arr_idx].row = values_from[0];
+                        array[arr_idx].col = values_from[1];
+                    } else {
+                        return SCPI_RES_ERR;
+                    }
+                    arr_idx++; //inkrement array where we want to save our values to, not neccessary otherwise
+                    if (arr_idx >= MAXROW * MAXCOL) {
+                        return SCPI_RES_ERR;
+                    }
+                } else if (is_range == true) {
+                    if (values_from[0] > values_to[0]) {
+                        dir_row = -1; //we have to decrement from values_from
+                    } else { //if (values_from[0] < values_to[0])
+                        dir_row = +1; //default, we increment from values_from
+                    }
+
+                    //iterating over rows, do it once -> set for_stop_row = false
+                    //needed if there is channel list index isn't at end yet
+                    for_stop_row = false;
+                    for (n = values_from[0]; for_stop_row == false; n += dir_row) {
+                        //usual case for ranges, 2 dimensions
+                        if (dimensions == 2) {
+                            if (values_from[1] > values_to[1]) {
+                                dir_col = -1;
+                            } else if (values_from[1] < values_to[1]) {
+                                dir_col = +1;
+                            }
+                            //iterating over columns, do it at least once -> set for_stop_col = false
+                            //needed if there is channel list index isn't at end yet
+                            for_stop_col = false;
+                            for (m = values_from[1]; for_stop_col == false; m += dir_col) {
+                                //here we have our values
+                                //row == n
+                                //col == m
+                                //call a function or something
+                                array[arr_idx].row = n;
+                                array[arr_idx].col = m;
+                                arr_idx++;
+                                if (arr_idx >= MAXROW * MAXCOL) {
+                                    return SCPI_RES_ERR;
+                                }
+                                if (m == (size_t)values_to[1]) {
+                                    //endpoint reached, stop column for-loop
+                                    for_stop_col = true;
+                                }
+                            }
+                            //special case for range, example: (@2!1)
+                        } else if (dimensions == 1) {
+                            //here we have values
+                            //row == n
+                            //col == 0 (fixed number)
+                            //call function or sth.
+                            array[arr_idx].row = n;
+                            array[arr_idx].col = 0;
+                            arr_idx++;
+                            if (arr_idx >= MAXROW * MAXCOL) {
+                                return SCPI_RES_ERR;
+                            }
+                        }
+                        if (n == (size_t)values_to[0]) {
+                            //endpoint reached, stop row for-loop
+                            for_stop_row = true;
+                        }
+                    }
+
+
+                } else {
+                    return SCPI_RES_ERR;
+                }
+                //increase index
+                chanlst_idx++;
+            } while (SCPI_EXPR_OK == SCPI_ExprChannelListEntry(context, &channel_list_param, chanlst_idx, &is_range, values_from, values_to, 4, &dimensions));
+            //while checks, whether incremented index is valid
+        }
+        //do something at the end if needed
+        //array[arr_idx].row = 0;
+        //array[arr_idx].col = 0;
+    }
+
+    {
+        size_t i;
+        fprintf(stderr, "TEST_Chanlst: ");
+        for (i = 0; i< arr_idx; i++) {
+            fprintf(stderr, "%d!%d, ", array[i].row, array[i].col);
+        }
+        fprintf(stderr, "\r\n");
+    }
+    return SCPI_RES_OK;
+}
+
+/**
+ * Reimplement IEEE488.2 *TST?
+ *
+ * Result should be 0 if everything is ok
+ * Result should be 1 if something goes wrong
+ *
+ * Return SCPI_RES_OK
+ */
+static scpi_result_t My_CoreTstQ(scpi_t * context) {
+
+    SCPI_ResultInt32(context, 0);
+
+    return SCPI_RES_OK;
+}
+
+const scpi_command_t scpi_commands[] = {
     /* IEEE Mandated Commands (SCPI std V1999.0 4.1.1) */
-    {"*CLS", SCPI_CoreCls,},
-    {"*ESE", SCPI_CoreEse,},
-    {"*ESE?", SCPI_CoreEseQ,},
-    {"*ESR?", SCPI_CoreEsrQ,},
-    {"*IDN?", SCPI_CoreIdnQ,},
-    {"*OPC", SCPI_CoreOpc,},
-    {"*OPC?", SCPI_CoreOpcQ,},
-    {"*RST", SCPI_CoreRst,},
-    {"*SRE", SCPI_CoreSre,},
-    {"*SRE?", SCPI_CoreSreQ,},
-    {"*STB?", SCPI_CoreStbQ,},
-    {"*TST?", SCPI_CoreTstQ,},
-    {"*WAI", SCPI_CoreWai,},
+    {"*CLS", SCPI_CoreCls, 0},
+    {"*ESE", SCPI_CoreEse, 0},
+    {"*ESE?", SCPI_CoreEseQ, 0},
+    {"*ESR?", SCPI_CoreEsrQ, 0},
+    {"*IDN?", SCPI_CoreIdnQ, 0},
+    {"*OPC", SCPI_CoreOpc, 0},
+    {"*OPC?", SCPI_CoreOpcQ, 0},
+    {"*RST", SCPI_CoreRst, 0},
+    {"*SRE", SCPI_CoreSre, 0},
+    {"*SRE?", SCPI_CoreSreQ, 0},
+    {"*STB?", SCPI_CoreStbQ, 0},
+    {"*TST?", My_CoreTstQ, 0},
+    {"*WAI", SCPI_CoreWai, 0},
 
     /* Required SCPI commands (SCPI std V1999.0 4.2.1) */
-    {"SYSTem:ERRor?", SCPI_SystemErrorNextQ,},
-    {"SYSTem:ERRor:NEXT?", SCPI_SystemErrorNextQ,},
-    {"SYSTem:ERRor:COUNt?", SCPI_SystemErrorCountQ,},
-    {"SYSTem:VERSion?", SCPI_SystemVersionQ,},
+    {"SYSTem:ERRor[:NEXT]?", SCPI_SystemErrorNextQ, 0},
+    {"SYSTem:ERRor:COUNt?", SCPI_SystemErrorCountQ, 0},
+    {"SYSTem:VERSion?", SCPI_SystemVersionQ, 0},
 
-    //{"STATus:OPERation?", scpi_stub_callback,},
-    //{"STATus:OPERation:EVENt?", scpi_stub_callback,},
-    //{"STATus:OPERation:CONDition?", scpi_stub_callback,},
-    //{"STATus:OPERation:ENABle", scpi_stub_callback,},
-    //{"STATus:OPERation:ENABle?", scpi_stub_callback,},
+    //{"STATus:OPERation?", scpi_stub_callback, 0},
+    //{"STATus:OPERation:EVENt?", scpi_stub_callback, 0},
+    //{"STATus:OPERation:CONDition?", scpi_stub_callback, 0},
+    //{"STATus:OPERation:ENABle", scpi_stub_callback, 0},
+    //{"STATus:OPERation:ENABle?", scpi_stub_callback, 0},
 
-    {"STATus:QUEStionable?", SCPI_StatusQuestionableEventQ,},
-    {"STATus:QUEStionable:EVENt?", SCPI_StatusQuestionableEventQ,},
-    //{"STATus:QUEStionable:CONDition?", scpi_stub_callback,},
-    {"STATus:QUEStionable:ENABle", SCPI_StatusQuestionableEnable,},
-    {"STATus:QUEStionable:ENABle?", SCPI_StatusQuestionableEnableQ,},
+    {"STATus:QUEStionable[:EVENt]?", SCPI_StatusQuestionableEventQ, 0},
+    //{"STATus:QUEStionable:CONDition?", scpi_stub_callback, 0},
+    {"STATus:QUEStionable:ENABle", SCPI_StatusQuestionableEnable, 0},
+    {"STATus:QUEStionable:ENABle?", SCPI_StatusQuestionableEnableQ, 0},
 
-    {"STATus:PRESet", SCPI_StatusPreset,},
+    {"STATus:PRESet", SCPI_StatusPreset, 0},
 
     /* DMM */
-    {"MEASure:VOLTage:DC?", DMM_MeasureVoltageDcQ,},
-    {"CONFigure:VOLTage:DC", DMM_ConfigureVoltageDc,},
-    {"MEASure:VOLTage:DC:RATio?", SCPI_StubQ,},
-    {"MEASure:VOLTage:AC?", SCPI_StubQ,},
-    {"MEASure:CURRent:DC?", SCPI_StubQ,},
-    {"MEASure:CURRent:AC?", SCPI_StubQ,},
-    {"MEASure:RESistance?", SCPI_StubQ,},
-    {"MEASure:FRESistance?", SCPI_StubQ,},
-    {"MEASure:FREQuency?", SCPI_StubQ,},
-    {"MEASure:PERiod?", SCPI_StubQ,},
-    
-    {"SYSTem:COMMunication:TCPIP:CONTROL?", SCPI_SystemCommTcpipControlQ,},
+    {"MEASure:VOLTage:DC?", DMM_MeasureVoltageDcQ, 0},
+    {"CONFigure:VOLTage:DC", DMM_ConfigureVoltageDc, 0},
+    {"MEASure:VOLTage:DC:RATio?", SCPI_StubQ, 0},
+    {"MEASure:VOLTage:AC?", DMM_MeasureVoltageAcQ, 0},
+    {"MEASure:CURRent:DC?", SCPI_StubQ, 0},
+    {"MEASure:CURRent:AC?", SCPI_StubQ, 0},
+    {"MEASure:RESistance?", SCPI_StubQ, 0},
+    {"MEASure:FRESistance?", SCPI_StubQ, 0},
+    {"MEASure:FREQuency?", SCPI_StubQ, 0},
+    {"MEASure:PERiod?", SCPI_StubQ, 0},
+
+    {"SYSTem:COMMunication:TCPIP:CONTROL?", SCPI_SystemCommTcpipControlQ, 0},
+
+    {"TEST:BOOL", TEST_Bool, 0},
+    {"TEST:CHOice?", TEST_ChoiceQ, 0},
+    {"TEST#:NUMbers#", TEST_Numbers, 0},
+    {"TEST:TEXT", TEST_Text, 0},
+    {"TEST:ARBitrary?", TEST_ArbQ, 0},
+    {"TEST:CHANnellist", TEST_Chanlst, 0},
 
     SCPI_CMD_LIST_END
 };
 
-static scpi_interface_t scpi_interface = {
-    /* error */ SCPI_Error,
-    /* write */ SCPI_Write,
-    /* control */ SCPI_Control,
-    /* flush */ SCPI_Flush,
-    /* reset */ SCPI_Reset,
-    /* test */ SCPI_Test,
+scpi_interface_t scpi_interface = {
+    .error = SCPI_Error,
+    .write = SCPI_Write,
+    .control = SCPI_Control,
+    .flush = SCPI_Flush,
+    .reset = SCPI_Reset,
 };
 
-#define SCPI_INPUT_BUFFER_LENGTH 256
-static char scpi_input_buffer[SCPI_INPUT_BUFFER_LENGTH];
+char scpi_input_buffer[SCPI_INPUT_BUFFER_LENGTH];
+scpi_error_t scpi_error_queue_data[SCPI_ERROR_QUEUE_SIZE];
 
-static scpi_reg_val_t scpi_regs[SCPI_REG_COUNT];
-
-
-scpi_t scpi_context = {
-    /* cmdlist */ scpi_commands,
-    /* buffer */ { /* length */ SCPI_INPUT_BUFFER_LENGTH, /* position */ 0,  /* data */ scpi_input_buffer, },
-    /* paramlist */ { /* cmd */ NULL, /* parameters */ NULL, /* length */ 0, },
-    /* interface */ &scpi_interface,
-    /* output_count */ 0,
-    /* input_count */ 0,
-    /* cmd_error */ FALSE,
-    /* error_queue */ NULL,
-    /* registers */ scpi_regs,
-    /* units */ scpi_units_def,
-    /* special_numbers */ scpi_special_numbers_def,
-    /* user_context */ NULL,
-};
-
+scpi_t scpi_context;

--
Gitblit v1.9.1