From: Aurelien Jacobs Date: Mon, 23 Sep 2013 20:02:02 +0000 (+0200) Subject: teleinfo: Initial driver skeleton. X-Git-Tag: libsigrok-0.2.2~32 X-Git-Url: https://sigrok.org/gitaction?a=commitdiff_plain;h=8e796cb438a80c6bcab5d44afaae0c74d757b673;p=libsigrok.git teleinfo: Initial driver skeleton. --- diff --git a/configure.ac b/configure.ac index 98fa39e1..bf6603da 100644 --- a/configure.ac +++ b/configure.ac @@ -194,6 +194,15 @@ AC_ARG_ENABLE(serial-dmm, AC_HELP_STRING([--enable-serial-dmm], [HW_SERIAL_DMM="$enableval"], [HW_SERIAL_DMM=$HW_ENABLED_DEFAULT]) +AC_ARG_ENABLE(teleinfo, AC_HELP_STRING([--enable-teleinfo], + [enable Teleinfo support [default=yes]]), + [HW_TELEINFO="$enableval"], + [HW_TELEINFO=$HW_ENABLED_DEFAULT]) +AM_CONDITIONAL(HW_TELEINFO, test x$HW_TELEINFO = xyes) +if test "x$HW_TELEINFO" = "xyes"; then + AC_DEFINE(HAVE_HW_TELEINFO, 1, [Teleinfo support]) +fi + AC_ARG_ENABLE(tondaj-sl-814, AC_HELP_STRING([--enable-tondaj-sl-814], [enable Tondaj SL-814 support [default=yes]]), [HW_TONDAJ_SL_814="$enableval"], @@ -503,6 +512,7 @@ AC_CONFIG_FILES([Makefile version.h hardware/Makefile hardware/mic-985xx/Makefile hardware/rigol-ds1xx2/Makefile hardware/saleae-logic16/Makefile + hardware/teleinfo/Makefile hardware/tondaj-sl-814/Makefile hardware/victor-dmm/Makefile hardware/common/dmm/Makefile @@ -572,6 +582,7 @@ echo " - openbench-logic-sniffer......... $HW_OLS" echo " - rigol-ds1xx2.................... $HW_RIGOL_DS1XX2" echo " - saleae-logic16.................. $HW_SALEAE_LOGIC16" echo " - serial-dmm...................... $HW_SERIAL_DMM" +echo " - teleinfo........................ $HW_TELEINFO" echo " - tondaj-sl-814................... $HW_TONDAJ_SL_814" echo " - uni-t-dmm....................... $HW_UNI_T_DMM" echo " - uni-t-ut32x..................... $HW_UNI_T_UT32X" diff --git a/hardware/Makefile.am b/hardware/Makefile.am index aa6a93f0..0260c015 100644 --- a/hardware/Makefile.am +++ b/hardware/Makefile.am @@ -42,6 +42,7 @@ SUBDIRS = \ rigol-ds1xx2 \ saleae-logic16 \ serial-dmm \ + teleinfo \ tondaj-sl-814 \ uni-t-dmm \ uni-t-ut32x \ @@ -143,6 +144,10 @@ if HW_SERIAL_DMM libsigrokhardware_la_LIBADD += serial-dmm/libsigrok_hw_serial_dmm.la endif +if HW_TELEINFO +libsigrokhardware_la_LIBADD += teleinfo/libsigrok_hw_teleinfo.la +endif + if HW_TONDAJ_SL_814 libsigrokhardware_la_LIBADD += tondaj-sl-814/libsigrok_hw_tondaj_sl_814.la endif diff --git a/hardware/teleinfo/Makefile.am b/hardware/teleinfo/Makefile.am new file mode 100644 index 00000000..404029f6 --- /dev/null +++ b/hardware/teleinfo/Makefile.am @@ -0,0 +1,33 @@ +## +## This file is part of the libsigrok project. +## +## Copyright (C) 2013 Aurelien Jacobs +## +## This program is free software: you can redistribute it and/or modify +## it under the terms of the GNU General Public License as published by +## the Free Software Foundation, either version 3 of the License, or +## (at your option) any later version. +## +## This program is distributed in the hope that it will be useful, +## but WITHOUT ANY WARRANTY; without even the implied warranty of +## MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +## GNU General Public License for more details. +## +## You should have received a copy of the GNU General Public License +## along with this program. If not, see . +## + +if HW_TELEINFO + +# Local lib, this is NOT meant to be installed! +noinst_LTLIBRARIES = libsigrok_hw_teleinfo.la + +libsigrok_hw_teleinfo_la_SOURCES = \ + api.c \ + protocol.c \ + protocol.h + +libsigrok_hw_teleinfo_la_CFLAGS = \ + -I$(top_srcdir) + +endif diff --git a/hardware/teleinfo/api.c b/hardware/teleinfo/api.c new file mode 100644 index 00000000..4d8cecf0 --- /dev/null +++ b/hardware/teleinfo/api.c @@ -0,0 +1,185 @@ +/* + * This file is part of the libsigrok project. + * + * Copyright (C) 2013 Aurelien Jacobs + * + * This program is free software: you can redistribute it and/or modify + * it under the terms of the GNU General Public License as published by + * the Free Software Foundation, either version 3 of the License, or + * (at your option) any later version. + * + * This program is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU General Public License for more details. + * + * You should have received a copy of the GNU General Public License + * along with this program. If not, see . + */ + +#include "protocol.h" + +SR_PRIV struct sr_dev_driver teleinfo_driver_info; +static struct sr_dev_driver *di = &teleinfo_driver_info; + +static int init(struct sr_context *sr_ctx) +{ + return std_init(sr_ctx, di, LOG_PREFIX); +} + +static GSList *scan(GSList *options) +{ + struct drv_context *drvc; + GSList *devices; + + (void)options; + + devices = NULL; + drvc = di->priv; + drvc->instances = NULL; + + /* TODO: scan for devices, either based on a SR_CONF_CONN option + * or on a USB scan. */ + + return devices; +} + +static GSList *dev_list(void) +{ + return ((struct drv_context *)(di->priv))->instances; +} + +static int dev_clear(void) +{ + return std_dev_clear(di, NULL); +} + +static int dev_open(struct sr_dev_inst *sdi) +{ + (void)sdi; + + /* TODO: get handle from sdi->conn and open it. */ + + sdi->status = SR_ST_ACTIVE; + + return SR_OK; +} + +static int dev_close(struct sr_dev_inst *sdi) +{ + (void)sdi; + + /* TODO: get handle from sdi->conn and close it. */ + + sdi->status = SR_ST_INACTIVE; + + return SR_OK; +} + +static int cleanup(void) +{ + dev_clear(); + + /* TODO: free other driver resources, if any. */ + + return SR_OK; +} + +static int config_get(int key, GVariant **data, const struct sr_dev_inst *sdi) +{ + int ret; + + (void)sdi; + (void)data; + + ret = SR_OK; + switch (key) { + /* TODO */ + default: + return SR_ERR_NA; + } + + return ret; +} + +static int config_set(int key, GVariant *data, const struct sr_dev_inst *sdi) +{ + int ret; + + (void)data; + + if (sdi->status != SR_ST_ACTIVE) + return SR_ERR_DEV_CLOSED; + + ret = SR_OK; + switch (key) { + /* TODO */ + default: + ret = SR_ERR_NA; + } + + return ret; +} + +static int config_list(int key, GVariant **data, const struct sr_dev_inst *sdi) +{ + int ret; + + (void)sdi; + (void)data; + + ret = SR_OK; + switch (key) { + /* TODO */ + default: + return SR_ERR_NA; + } + + return ret; +} + +static int dev_acquisition_start(const struct sr_dev_inst *sdi, + void *cb_data) +{ + (void)sdi; + (void)cb_data; + + if (sdi->status != SR_ST_ACTIVE) + return SR_ERR_DEV_CLOSED; + + /* TODO: configure hardware, reset acquisition state, set up + * callbacks and send header packet. */ + + return SR_OK; +} + +static int dev_acquisition_stop(struct sr_dev_inst *sdi, void *cb_data) +{ + (void)cb_data; + + if (sdi->status != SR_ST_ACTIVE) + return SR_ERR_DEV_CLOSED; + + /* TODO: stop acquisition. */ + + return SR_OK; +} + +SR_PRIV struct sr_dev_driver teleinfo_driver_info = { + .name = "teleinfo", + .longname = "Teleinfo", + .api_version = 1, + .init = init, + .cleanup = cleanup, + .scan = scan, + .dev_list = dev_list, + .dev_clear = dev_clear, + .config_get = config_get, + .config_set = config_set, + .config_list = config_list, + .dev_open = dev_open, + .dev_close = dev_close, + .dev_acquisition_start = dev_acquisition_start, + .dev_acquisition_stop = dev_acquisition_stop, + .priv = NULL, +}; diff --git a/hardware/teleinfo/protocol.c b/hardware/teleinfo/protocol.c new file mode 100644 index 00000000..a7fde947 --- /dev/null +++ b/hardware/teleinfo/protocol.c @@ -0,0 +1,40 @@ +/* + * This file is part of the libsigrok project. + * + * Copyright (C) 2013 Aurelien Jacobs + * + * This program is free software: you can redistribute it and/or modify + * it under the terms of the GNU General Public License as published by + * the Free Software Foundation, either version 3 of the License, or + * (at your option) any later version. + * + * This program is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU General Public License for more details. + * + * You should have received a copy of the GNU General Public License + * along with this program. If not, see . + */ + +#include "protocol.h" + +SR_PRIV int teleinfo_receive_data(int fd, int revents, void *cb_data) +{ + const struct sr_dev_inst *sdi; + struct dev_context *devc; + + (void)fd; + + if (!(sdi = cb_data)) + return TRUE; + + if (!(devc = sdi->priv)) + return TRUE; + + if (revents == G_IO_IN) { + /* TODO */ + } + + return TRUE; +} diff --git a/hardware/teleinfo/protocol.h b/hardware/teleinfo/protocol.h new file mode 100644 index 00000000..3485d106 --- /dev/null +++ b/hardware/teleinfo/protocol.h @@ -0,0 +1,51 @@ +/* + * This file is part of the libsigrok project. + * + * Copyright (C) 2013 Aurelien Jacobs + * + * This program is free software: you can redistribute it and/or modify + * it under the terms of the GNU General Public License as published by + * the Free Software Foundation, either version 3 of the License, or + * (at your option) any later version. + * + * This program is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU General Public License for more details. + * + * You should have received a copy of the GNU General Public License + * along with this program. If not, see . + */ + +#ifndef LIBSIGROK_HARDWARE_TELEINFO_PROTOCOL_H +#define LIBSIGROK_HARDWARE_TELEINFO_PROTOCOL_H + +#include +#include +#include "libsigrok.h" +#include "libsigrok-internal.h" + +/* Message logging helpers with subsystem-specific prefix string. */ +#define LOG_PREFIX "teleinfo: " +#define sr_log(l, s, args...) sr_log(l, LOG_PREFIX s, ## args) +#define sr_spew(s, args...) sr_spew(LOG_PREFIX s, ## args) +#define sr_dbg(s, args...) sr_dbg(LOG_PREFIX s, ## args) +#define sr_info(s, args...) sr_info(LOG_PREFIX s, ## args) +#define sr_warn(s, args...) sr_warn(LOG_PREFIX s, ## args) +#define sr_err(s, args...) sr_err(LOG_PREFIX s, ## args) + +/** Private, per-device-instance driver context. */ +struct dev_context { + /* Model-specific information */ + + /* Acquisition settings */ + + /* Operational state */ + + /* Temporary state across callbacks */ + +}; + +SR_PRIV int teleinfo_receive_data(int fd, int revents, void *cb_data); + +#endif diff --git a/hwdriver.c b/hwdriver.c index 50615f55..1e476df8 100644 --- a/hwdriver.c +++ b/hwdriver.c @@ -148,6 +148,9 @@ extern SR_PRIV struct sr_dev_driver rigol_ds1xx2_driver_info; #ifdef HAVE_HW_SALEAE_LOGIC16 extern SR_PRIV struct sr_dev_driver saleae_logic16_driver_info; #endif +#ifdef HAVE_HW_TELEINFO +extern SR_PRIV struct sr_dev_driver teleinfo_driver_info; +#endif #ifdef HAVE_HW_TONDAJ_SL_814 extern SR_PRIV struct sr_dev_driver tondaj_sl_814_driver_info; #endif @@ -262,6 +265,9 @@ static struct sr_dev_driver *drivers_list[] = { #ifdef HAVE_HW_SALEAE_LOGIC16 &saleae_logic16_driver_info, #endif +#ifdef HAVE_HW_TELEINFO + &teleinfo_driver_info, +#endif #ifdef HAVE_HW_TONDAJ_SL_814 &tondaj_sl_814_driver_info, #endif