| | |
| | | /*- |
| | | * Copyright (c) 2013 Jan Breuer |
| | | * Richard.hmm |
| | | * Copyright (c) 2012 Jan Breuer |
| | | * BSD 2-Clause License |
| | | * |
| | | * All Rights Reserved |
| | | * |
| | | * Copyright (c) 2012-2018, Jan Breuer, Richard.hmm |
| | | * 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. |
| | | * modification, are permitted provided that the following conditions are met: |
| | | * |
| | | * * Redistributions of source code must retain the above copyright notice, this |
| | | * list of conditions and the following disclaimer. |
| | | * |
| | | * * 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 COPYRIGHT HOLDERS AND CONTRIBUTORS "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 COPYRIGHT HOLDER 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_types.h |
| | | * @date Thu Nov 15 10:58:45 UTC 2012 |
| | | * |
| | | * |
| | | * @brief SCPI data types |
| | | * |
| | | * |
| | | * |
| | | * |
| | | */ |
| | | |
| | | #ifndef SCPI_TYPES_H |
| | |
| | | |
| | | #include <stddef.h> |
| | | #include <stdint.h> |
| | | #include "scpi/config.h" |
| | | |
| | | #if HAVE_STDBOOL |
| | | #include <stdbool.h> |
| | | #endif |
| | | |
| | | #ifdef __cplusplus |
| | | extern "C" { |
| | | #endif |
| | | |
| | | #if !HAVE_STDBOOL |
| | | typedef unsigned char bool; |
| | | #endif |
| | | |
| | | #ifndef FALSE |
| | | #define FALSE 0 |
| | | #define FALSE 0 |
| | | #endif |
| | | #ifndef TRUE |
| | | #define TRUE (!FALSE) |
| | | #define TRUE (!FALSE) |
| | | #endif |
| | | |
| | | /* basic data types */ |
| | |
| | | SCPI_REG_ESE, /* Event Status Enable Register */ |
| | | SCPI_REG_OPER, /* OPERation Status Register */ |
| | | SCPI_REG_OPERE, /* OPERation Status Enable Register */ |
| | | SCPI_REG_OPERC, /* OPERation Status Condition Register */ |
| | | SCPI_REG_QUES, /* QUEStionable status register */ |
| | | SCPI_REG_QUESE, /* QUEStionable status Enable Register */ |
| | | SCPI_REG_QUESC, /* QUEStionable status Condition Register */ |
| | | |
| | | /* last definition - number of registers */ |
| | | SCPI_REG_COUNT |
| | |
| | | |
| | | typedef struct _scpi_command_t scpi_command_t; |
| | | |
| | | #define SCPI_CMD_LIST_END {NULL, NULL, 0} |
| | | #if USE_COMMAND_TAGS |
| | | #define SCPI_CMD_LIST_END {NULL, NULL, 0} |
| | | #else |
| | | #define SCPI_CMD_LIST_END {NULL, NULL} |
| | | #endif |
| | | |
| | | |
| | | /* scpi interface */ |
| | | typedef struct _scpi_t scpi_t; |
| | |
| | | char * data; |
| | | }; |
| | | typedef struct _scpi_buffer_t scpi_buffer_t; |
| | | |
| | | |
| | | struct _scpi_const_buffer_t { |
| | | size_t length; |
| | | size_t position; |
| | |
| | | enum _scpi_token_type_t { |
| | | SCPI_TOKEN_COMMA, |
| | | SCPI_TOKEN_SEMICOLON, |
| | | SCPI_TOKEN_COLON, |
| | | SCPI_TOKEN_SPECIFIC_CHARACTER, |
| | | SCPI_TOKEN_QUESTION, |
| | | SCPI_TOKEN_NL, |
| | | SCPI_TOKEN_HEXNUM, |
| | |
| | | |
| | | struct _scpi_token_t { |
| | | scpi_token_type_t type; |
| | | const char * ptr; |
| | | char * ptr; |
| | | int len; |
| | | }; |
| | | typedef struct _scpi_token_t scpi_token_t; |
| | | |
| | | struct _lex_state_t { |
| | | const char * buffer; |
| | | const char * pos; |
| | | char * buffer; |
| | | char * pos; |
| | | int len; |
| | | }; |
| | | typedef struct _lex_state_t lex_state_t; |
| | | |
| | | /* scpi parser */ |
| | | /* scpi parser */ |
| | | enum _message_termination_t { |
| | | SCPI_MESSAGE_TERMINATION_NONE, |
| | | SCPI_MESSAGE_TERMINATION_NL, |
| | | SCPI_MESSAGE_TERMINATION_SEMICOLON, |
| | | SCPI_MESSAGE_TERMINATION_SEMICOLON, |
| | | }; |
| | | typedef enum _message_termination_t message_termination_t; |
| | | |
| | | |
| | | struct _scpi_parser_state_t { |
| | | scpi_token_t programHeader; |
| | | scpi_token_t programData; |
| | |
| | | |
| | | typedef scpi_result_t(*scpi_command_callback_t)(scpi_t *); |
| | | |
| | | /* scpi error queue */ |
| | | typedef void * scpi_error_queue_t; |
| | | struct _scpi_error_info_heap_t { |
| | | size_t wr; |
| | | /* size_t rd; */ |
| | | size_t count; |
| | | size_t size; |
| | | char * data; |
| | | }; |
| | | typedef struct _scpi_error_info_heap_t scpi_error_info_heap_t; |
| | | |
| | | struct _scpi_error_t { |
| | | int16_t error_code; |
| | | #if USE_DEVICE_DEPENDENT_ERROR_INFORMATION |
| | | char * device_dependent_info; |
| | | #endif |
| | | }; |
| | | typedef struct _scpi_error_t scpi_error_t; |
| | | |
| | | struct _scpi_fifo_t { |
| | | int16_t wr; |
| | | int16_t rd; |
| | | int16_t count; |
| | | int16_t size; |
| | | scpi_error_t * data; |
| | | }; |
| | | typedef struct _scpi_fifo_t scpi_fifo_t; |
| | | |
| | | /* scpi units */ |
| | | enum _scpi_unit_t { |
| | |
| | | SCPI_UNIT_OHM, |
| | | SCPI_UNIT_HERTZ, |
| | | SCPI_UNIT_CELSIUS, |
| | | SCPI_UNIT_SECONDS, |
| | | SCPI_UNIT_DISTANCE |
| | | SCPI_UNIT_SECOND, |
| | | SCPI_UNIT_METER, |
| | | SCPI_UNIT_GRAY, |
| | | SCPI_UNIT_BECQUEREL, |
| | | SCPI_UNIT_MOLE, |
| | | SCPI_UNIT_DEGREE, |
| | | SCPI_UNIT_GRADE, |
| | | SCPI_UNIT_RADIAN, |
| | | SCPI_UNIT_REVOLUTION, |
| | | SCPI_UNIT_STERADIAN, |
| | | SCPI_UNIT_SIEVERT, |
| | | SCPI_UNIT_FARAD, |
| | | SCPI_UNIT_COULOMB, |
| | | SCPI_UNIT_SIEMENS, |
| | | SCPI_UNIT_ELECTRONVOLT, |
| | | SCPI_UNIT_JOULE, |
| | | SCPI_UNIT_NEWTON, |
| | | SCPI_UNIT_LUX, |
| | | SCPI_UNIT_HENRY, |
| | | SCPI_UNIT_ASTRONOMIC_UNIT, |
| | | SCPI_UNIT_INCH, |
| | | SCPI_UNIT_FOOT, |
| | | SCPI_UNIT_PARSEC, |
| | | SCPI_UNIT_MILE, |
| | | SCPI_UNIT_NAUTICAL_MILE, |
| | | SCPI_UNIT_LUMEN, |
| | | SCPI_UNIT_CANDELA, |
| | | SCPI_UNIT_WEBER, |
| | | SCPI_UNIT_TESLA, |
| | | SCPI_UNIT_ATOMIC_MASS, |
| | | SCPI_UNIT_KILOGRAM, |
| | | SCPI_UNIT_WATT, |
| | | SCPI_UNIT_DBM, |
| | | SCPI_UNIT_ATMOSPHERE, |
| | | SCPI_UNIT_INCH_OF_MERCURY, |
| | | SCPI_UNIT_MM_OF_MERCURY, |
| | | SCPI_UNIT_PASCAL, |
| | | SCPI_UNIT_TORT, |
| | | SCPI_UNIT_BAR, |
| | | SCPI_UNIT_DECIBEL, |
| | | SCPI_UNIT_UNITLESS, |
| | | SCPI_UNIT_FAHRENHEIT, |
| | | SCPI_UNIT_KELVIN, |
| | | SCPI_UNIT_DAY, |
| | | SCPI_UNIT_YEAR, |
| | | SCPI_UNIT_STROKES, |
| | | SCPI_UNIT_POISE, |
| | | SCPI_UNIT_LITER |
| | | }; |
| | | typedef enum _scpi_unit_t scpi_unit_t; |
| | | |
| | |
| | | lex_state_t lex_state; |
| | | scpi_const_buffer_t cmd_raw; |
| | | }; |
| | | typedef struct _scpi_param_list_t scpi_param_list_t; |
| | | |
| | | typedef struct _scpi_param_list_t scpi_param_list_t; |
| | | |
| | | struct _scpi_number_parameter_t { |
| | | double value; |
| | | scpi_bool_t special; |
| | | |
| | | union { |
| | | double value; |
| | | int32_t tag; |
| | | } content; |
| | | scpi_unit_t unit; |
| | | int8_t base; |
| | | scpi_special_number_t type; |
| | | }; |
| | | typedef struct _scpi_number_parameter_t scpi_number_t; |
| | | |
| | | struct _scpi_data_parameter_t { |
| | | const char * ptr; |
| | | int32_t len; |
| | | int32_t len; |
| | | }; |
| | | typedef struct _scpi_data_parameter_t scpi_data_parameter_t; |
| | | |
| | | |
| | | typedef scpi_token_t scpi_parameter_t; |
| | | |
| | | |
| | | struct _scpi_command_t { |
| | | const char * pattern; |
| | | scpi_command_callback_t callback; |
| | | #if USE_COMMAND_TAGS |
| | | int32_t tag; |
| | | #endif /* USE_COMMAND_TAGS */ |
| | | }; |
| | | |
| | | struct _scpi_interface_t { |
| | |
| | | int_fast16_t output_count; |
| | | int_fast16_t input_count; |
| | | scpi_bool_t cmd_error; |
| | | scpi_error_queue_t error_queue; |
| | | scpi_reg_val_t * registers; |
| | | scpi_fifo_t error_queue; |
| | | #if USE_DEVICE_DEPENDENT_ERROR_INFORMATION && !USE_MEMORY_ALLOCATION_FREE |
| | | scpi_error_info_heap_t error_info_heap; |
| | | #endif |
| | | scpi_reg_val_t registers[SCPI_REG_COUNT]; |
| | | const scpi_unit_def_t * units; |
| | | void * user_context; |
| | | scpi_parser_state_t parser_state; |
| | | const char * idn[4]; |
| | | size_t arbitrary_reminding; |
| | | }; |
| | | |
| | | enum _scpi_array_format_t { |
| | | SCPI_FORMAT_ASCII = 0, |
| | | SCPI_FORMAT_NORMAL = 1, |
| | | SCPI_FORMAT_SWAPPED = 2, |
| | | SCPI_FORMAT_BIGENDIAN = SCPI_FORMAT_NORMAL, |
| | | SCPI_FORMAT_LITTLEENDIAN = SCPI_FORMAT_SWAPPED, |
| | | }; |
| | | typedef enum _scpi_array_format_t scpi_array_format_t; |
| | | |
| | | #ifdef __cplusplus |
| | | } |
| | | #endif |