/*- * 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: * 1. Redistributions of source code must retain the above copyright notice, * this list of conditions and the following disclaimer. * 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 * DISCLAIMED. IN NO EVENT SHALL THE AUTHORS OR CONTRIBUTORS BE LIABLE * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR * BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, * WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE * OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN * IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. */ /** * @file scpi_units.c * @date Thu Nov 15 10:58:45 UTC 2012 * * @brief SCPI units * * */ #include #include "scpi/parser.h" #include "scpi/units.h" #include "utils.h" #include "scpi/error.h" /* * multipliers IEEE 488.2-1992 tab 7-2 * 1E18 EX * 1E15 PE * 1E12 T * 1E9 G * 1E6 MA (use M for OHM and HZ) * 1E3 K * 1E-3 M (disaalowed for OHM and HZ) * 1E-6 U * 1E-9 N * 1E-12 P * 1E-15 F * 1E-18 A */ /* * units definition IEEE 488.2-1992 tab 7-1 */ const scpi_unit_def_t scpi_units_def[] = { /* voltage */ { .name = "UV", .unit = SCPI_UNIT_VOLT, .mult = 1e-6}, { .name = "MV", .unit = SCPI_UNIT_VOLT, .mult = 1e-3}, { .name = "V", .unit = SCPI_UNIT_VOLT, .mult = 1}, { .name = "KV", .unit = SCPI_UNIT_VOLT, .mult = 1e3}, /* current */ { .name = "UA", .unit = SCPI_UNIT_AMPER, .mult = 1e-6}, { .name = "MA", .unit = SCPI_UNIT_AMPER, .mult = 1e-3}, { .name = "A", .unit = SCPI_UNIT_AMPER, .mult = 1}, { .name = "KA", .unit = SCPI_UNIT_AMPER, .mult = 1e3}, /* resistance */ { .name = "OHM", .unit = SCPI_UNIT_OHM, .mult = 1}, { .name = "KOHM", .unit = SCPI_UNIT_OHM, .mult = 1e3}, { .name = "MOHM", .unit = SCPI_UNIT_OHM, .mult = 1e6}, /* frequency */ { .name = "HZ", .unit = SCPI_UNIT_HERTZ, .mult = 1}, { .name = "KHZ", .unit = SCPI_UNIT_HERTZ, .mult = 1e3}, { .name = "MHZ", .unit = SCPI_UNIT_HERTZ, .mult = 1e6}, { .name = "GHZ", .unit = SCPI_UNIT_HERTZ, .mult = 1e9}, /* temperature */ { .name = "CEL", .unit = SCPI_UNIT_CELSIUS, .mult = 1}, /* time */ { .name = "PS", .unit = SCPI_UNIT_SECONDS, .mult = 1e-12}, { .name = "NS", .unit = SCPI_UNIT_SECONDS, .mult = 1e-9}, { .name = "US", .unit = SCPI_UNIT_SECONDS, .mult = 1e-6}, { .name = "MS", .unit = SCPI_UNIT_SECONDS, .mult = 1e-3}, { .name = "S", .unit = SCPI_UNIT_SECONDS, .mult = 1}, { .name = "MIN", .unit = SCPI_UNIT_SECONDS, .mult = 60}, { .name = "HR", .unit = SCPI_UNIT_SECONDS, .mult = 3600}, SCPI_UNITS_LIST_END, }; const scpi_special_number_def_t scpi_special_numbers_def[] = { { .name = "MINimum", .type = SCPI_NUM_MIN}, { .name = "MAXimum", .type = SCPI_NUM_MAX}, { .name = "DEFault", .type = SCPI_NUM_DEF}, { .name = "UP", .type = SCPI_NUM_UP}, { .name = "DOWN", .type = SCPI_NUM_DOWN}, { .name = "NAN", .type = SCPI_NUM_NAN}, { .name = "INF", .type = SCPI_NUM_INF}, { .name = "NINF", .type = SCPI_NUM_NINF}, SCPI_SPECIAL_NUMBERS_LIST_END, }; static scpi_special_number_t translateSpecialNumber(const scpi_special_number_def_t * specs, const char * str, size_t len) { int i; if (specs == NULL) { return SCPI_NUM_NUMBER; } for (i = 0; specs[i].name != NULL; i++) { if (matchPattern(specs[i].name, strlen(specs[i].name), str, len)) { return specs[i].type; } } return SCPI_NUM_NUMBER; } static const char * translateSpecialNumberInverse(const scpi_special_number_def_t * specs, scpi_special_number_t type) { int i; if (specs == NULL) { return NULL; } for (i = 0; specs[i].name != NULL; i++) { if (specs[i].type == type) { return specs[i].name; } } return NULL; } static const scpi_unit_def_t * translateUnit(const scpi_unit_def_t * units, const char * unit, size_t len) { int i; if (units == NULL) { return NULL; } for (i = 0; units[i].name != NULL; i++) { if (compareStr(unit, len, units[i].name, strlen(units[i].name))) { return &units[i]; } } return NULL; } static const char * translateUnitInverse(const scpi_unit_def_t * units, const scpi_unit_t unit) { int i; if (units == NULL) { return NULL; } for (i = 0; units[i].name != NULL; i++) { if ((units[i].unit == unit) && (units[i].mult == 1)) { return units[i].name; } } return NULL; } static bool_t transformNumber(const scpi_unit_def_t * units, const char * unit, size_t len, scpi_number_t * value) { size_t s; const scpi_unit_def_t * unitDef; s = skipWhitespace(unit, len); if (s == len) { value->unit = SCPI_UNIT_NONE; return TRUE; } unitDef = translateUnit(units, unit + s, len - s); if (unitDef == NULL) { return FALSE; } value->value *= unitDef->mult; value->unit = unitDef->unit; return TRUE; } /** * Parse parameter as number, number with unit or special value (min, max, default, ...) * @param context * @param value return value * @param mandatory if the parameter is mandatory * @return */ bool_t SCPI_ParamNumber(scpi_t * context, scpi_number_t * value, bool_t mandatory) { bool_t result; char * param; size_t len; size_t numlen; result = SCPI_ParamString(context, ¶m, &len, mandatory); if (!value) { return FALSE; } if (!result) { if (mandatory) { return FALSE; } else { value->type = SCPI_NUM_DEF; return TRUE; } } value->unit = SCPI_UNIT_NONE; value->value = 0.0; value->type = translateSpecialNumber(context->special_numbers, param, len); if (value->type != SCPI_NUM_NUMBER) { // found special type return TRUE; } numlen = strToDouble(param, &value->value); if (numlen <= len) { if (transformNumber(context->units, param + numlen, len - numlen, value)) { return TRUE; } else { SCPI_ErrorPush(context, SCPI_ERROR_INVALID_SUFFIX); } } return FALSE; } size_t SCPI_NumberToStr(scpi_t * context, scpi_number_t * value, char * str, size_t len) { const char * type; const char * unit; size_t result; if (!value || !str) { return 0; } type = translateSpecialNumberInverse(context->special_numbers, value->type); if (type) { strncpy(str, type, len); return min(strlen(type), len); } result = doubleToStr(value->value, str, len); unit = translateUnitInverse(context->units, value->unit); if (unit) { strncat(str, " ", len); strncat(str, unit, len); result += strlen(unit) + 1; } return result; }