bindings/swig/classes.i

   1 /*
   2  * This file is part of the libsigrok project.
   3  *
   4  * Copyright (C) 2014 Martin Ling <martin-sigrok@earth.li>
   5  *
   6  * This program is free software: you can redistribute it and/or modify
   7  * it under the terms of the GNU General Public License as published by
   8  * the Free Software Foundation, either version 3 of the License, or
   9  * (at your option) any later version.
  10  *
  11  * This program is distributed in the hope that it will be useful,
  12  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  13  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  14  * GNU General Public License for more details.
  15  *
  16  * You should have received a copy of the GNU General Public License
  17  * along with this program.  If not, see <http://www.gnu.org/licenses/>.
  18  */
  19
  20 #pragma SWIG nowarn=325,401
  21
  22 %{
  23 #include <libsigrokcxx/libsigrokcxx.hpp>
  24 using namespace std;
  25 %}
  26
  27 %include "typemaps.i"
  28 %include "std_string.i"
  29 %include "std_vector.i"
  30 %include "std_map.i"
  31 %include "std_shared_ptr.i"
  32 %include "exception.i"
  33
  34 %{
  35
  36 static int swig_exception_code(int sigrok_exception_code) {
  37     switch (sigrok_exception_code) {
  38         case SR_ERR_MALLOC:
  39             return SWIG_MemoryError;
  40         case SR_ERR_ARG:
  41             return SWIG_ValueError;
  42         default:
  43             return SWIG_RuntimeError;
  44     }
  45 }
  46
  47 %}
  48
  49 %exception {
  50     try {
  51         $action
  52     } catch (sigrok::Error &e) {
  53         SWIG_exception(swig_exception_code(e.result),
  54             const_cast<char*>(e.what()));
  55     }
  56 }
  57
  58 template< class T > class enable_shared_from_this;
  59
  60 %template(ContextShared) enable_shared_from_this<Context>;
  61
  62 %shared_ptr(sigrok::Context);
  63 %shared_ptr(sigrok::Driver);
  64 %shared_ptr(sigrok::Device);
  65 %shared_ptr(sigrok::Configurable);
  66 %shared_ptr(sigrok::HardwareDevice);
  67 %shared_ptr(sigrok::Channel);
  68 %shared_ptr(sigrok::ChannelGroup);
  69 %shared_ptr(sigrok::Session);
  70 %shared_ptr(sigrok::SessionDevice);
  71 %shared_ptr(sigrok::Packet);
  72 %shared_ptr(sigrok::PacketPayload);
  73 %shared_ptr(sigrok::Header);
  74 %shared_ptr(sigrok::Meta);
  75 %shared_ptr(sigrok::AnalogOld);
  76 %shared_ptr(sigrok::Logic);
  77 %shared_ptr(sigrok::InputFormat);
  78 %shared_ptr(sigrok::Input);
  79 %shared_ptr(sigrok::InputDevice);
  80 %shared_ptr(sigrok::Option);
  81 %shared_ptr(sigrok::OutputFormat);
  82 %shared_ptr(sigrok::Output);
  83 %shared_ptr(sigrok::Trigger);
  84 %shared_ptr(sigrok::TriggerStage);
  85 %shared_ptr(sigrok::TriggerMatch);
  86 %shared_ptr(sigrok::UserDevice);
  87
  88 %template(StringMap) std::map<std::string, std::string>;
  89
  90 %template(DriverMap)
  91     std::map<std::string, std::shared_ptr<sigrok::Driver> >;
  92 %template(InputFormatMap)
  93     std::map<std::string, std::shared_ptr<sigrok::InputFormat> >;
  94 %template(OutputFormatMap)
  95     std::map<std::string, std::shared_ptr<sigrok::OutputFormat> >;
  96
  97 %template(HardwareDeviceVector)
  98     std::vector<std::shared_ptr<sigrok::HardwareDevice> >;
  99
 100 %template(DeviceVector)
 101     std::vector<std::shared_ptr<sigrok::Device> >;
 102
 103 %template(ChannelVector)
 104     std::vector<std::shared_ptr<sigrok::Channel> >;
 105
 106 %template(ChannelGroupMap)
 107     std::map<std::string, std::shared_ptr<sigrok::ChannelGroup> >;
 108
 109 /* Workaround for SWIG bug. The vector template instantiation
 110    isn't needed but somehow fixes a bug that stops the wrapper
 111    for the map instantiation from compiling. */
 112 %template(ConfigVector)
 113     std::vector<const sigrok::ConfigKey *>;
 114 %template(ConfigMap)
 115     std::map<const sigrok::ConfigKey *, Glib::VariantBase>;
 116
 117 %template(OptionVector)
 118     std::vector<std::shared_ptr<sigrok::Option> >;
 119 %template(OptionMap)
 120     std::map<std::string, std::shared_ptr<sigrok::Option> >;
 121
 122 %template(VariantVector)
 123     std::vector<Glib::VariantBase>;
 124 %template(VariantMap)
 125     std::map<std::string, Glib::VariantBase>;
 126
 127 %template(QuantityFlagVector)
 128     std::vector<const sigrok::QuantityFlag *>;
 129
 130 %template(TriggerStageVector)
 131  std::vector<std::shared_ptr<sigrok::TriggerStage> >;
 132
 133 %template(TriggerMatchVector)
 134  std::vector<std::shared_ptr<sigrok::TriggerMatch> >;
 135
 136 #define SR_API
 137 #define SR_PRIV
 138
 139 %ignore sigrok::DatafeedCallbackData;
 140
 141 #define SWIG_ATTRIBUTE_TEMPLATE
 142
 143 %include "attribute.i"
 144
 145 %inline {
 146 typedef std::map<std::string, std::shared_ptr<sigrok::Driver> >
 147     map_string_Driver;
 148 typedef std::map<std::string, std::shared_ptr<sigrok::InputFormat> >
 149     map_string_InputFormat;
 150 typedef std::map<std::string, std::shared_ptr<sigrok::OutputFormat> >
 151     map_string_OutputFormat;
 152 typedef std::map<std::string, std::shared_ptr<sigrok::ChannelGroup> >
 153     map_string_ChannelGroup;
 154 typedef std::map<std::string, std::shared_ptr<sigrok::Option> >
 155     map_string_Option;
 156 typedef std::map<std::string, Glib::VariantBase>
 157     map_string_Variant;
 158 typedef std::map<const sigrok::ConfigKey *, Glib::VariantBase>
 159     map_ConfigKey_Variant;
 160 }
 161
 162 %attributemap(Context,
 163     map_string_Driver, drivers, drivers);
 164 %attributemap(Context,
 165     map_string_InputFormat, input_formats, input_formats);
 166 %attributemap(Context,
 167     map_string_OutputFormat, output_formats, output_formats);
 168
 169 %attributestring(sigrok::Context,
 170     std::string, package_version, package_version);
 171 %attributestring(sigrok::Context,
 172     std::string, lib_version, lib_version);
 173
 174 %attribute(sigrok::Context,
 175     const sigrok::LogLevel *, log_level, log_level, set_log_level);
 176
 177 %attributestring(sigrok::Driver, std::string, name, name);
 178 %attributestring(sigrok::Driver, std::string, long_name, long_name);
 179
 180 %attributestring(sigrok::InputFormat,
 181     std::string, name, name);
 182 %attributestring(sigrok::InputFormat,
 183     std::string, description, description);
 184
 185 %attributestring(sigrok::Input,
 186     std::shared_ptr<sigrok::InputDevice>, device, device);
 187
 188 %attributestring(sigrok::Option,
 189     std::string, id, id);
 190 %attributestring(sigrok::Option,
 191     std::string, name, name);
 192 %attributestring(sigrok::Option,
 193     std::string, description, description);
 194 /* Currently broken on Python due to some issue with variant typemaps. */
 195 /* %attributevector(Option,
 196     Glib::VariantBase, default_value, default_value); */
 197 %attributevector(Option,
 198     std::vector<Glib::VariantBase>, values, values);
 199
 200 %attributestring(sigrok::OutputFormat,
 201     std::string, name, name);
 202 %attributestring(sigrok::OutputFormat,
 203     std::string, description, description);
 204 %attributemap(OutputFormat,
 205     map_string_Option, options, options);
 206
 207 %attributestring(sigrok::Device, std::string, vendor, vendor);
 208 %attributestring(sigrok::Device, std::string, model, model);
 209 %attributestring(sigrok::Device, std::string, version, version);
 210
 211 %attributevector(Device,
 212     std::vector<std::shared_ptr<sigrok::Channel> >,
 213     channels, channels);
 214
 215 %attributemap(Device, map_string_ChannelGroup,
 216     channel_groups, channel_groups);
 217
 218 /* Using %attributestring for shared_ptr attribute. See
 219    http://sourceforge.net/p/swig/mailman/message/31832070/ */
 220 %attributestring(sigrok::HardwareDevice,
 221     std::shared_ptr<sigrok::Driver>, driver, driver);
 222
 223 %attributestring(sigrok::Channel, std::string, name, name, set_name);
 224 %attribute(sigrok::Channel, bool, enabled, enabled, set_enabled);
 225 %attribute(sigrok::Channel, const sigrok::ChannelType *, type, type);
 226 %attribute(sigrok::Channel, unsigned int, index, index);
 227
 228 %attributestring(sigrok::ChannelGroup, std::string, name, name);
 229 %attributevector(ChannelGroup,
 230     std::vector<std::shared_ptr<sigrok::Channel> >,
 231     channels, channels);
 232
 233 %attributestring(sigrok::Trigger, std::string, name, name);
 234 %attributevector(Trigger,
 235     std::vector<std::shared_ptr<sigrok::TriggerStage> >,
 236     stages, stages);
 237
 238 %attribute(sigrok::TriggerStage, int, number, number);
 239 %attributevector(TriggerStage,
 240     std::vector<std::shared_ptr<sigrok::TriggerMatch> >,
 241     matches, matches);
 242
 243 %attributestring(sigrok::TriggerMatch,
 244     std::shared_ptr<sigrok::Channel>, channel, channel);
 245 %attribute(sigrok::TriggerMatch, const sigrok::TriggerMatchType *, type, type);
 246 %attribute(sigrok::TriggerMatch, float, value, value);
 247
 248 %attributevector(Session,
 249     std::vector<std::shared_ptr<sigrok::Device> >,
 250     devices, devices);
 251
 252 %attributestring(sigrok::Session,
 253     std::shared_ptr<sigrok::Trigger>, trigger, trigger, set_trigger);
 254
 255 %attributestring(sigrok::Session, std::string, filename, filename);
 256
 257 %attribute(sigrok::Packet,
 258     const sigrok::PacketType *, type, type);
 259
 260 %attributemap(Meta, map_ConfigKey_Variant, config, config);
 261
 262 %attributevector(AnalogOld,
 263     std::vector<std::shared_ptr<sigrok::Channel> >, channels, channels);
 264 %attribute(sigrok::AnalogOld, int, num_samples, num_samples);
 265 %attribute(sigrok::AnalogOld, const sigrok::Quantity *, mq, mq);
 266 %attribute(sigrok::AnalogOld, const sigrok::Unit *, unit, unit);
 267 %attributevector(AnalogOld, std::vector<const sigrok::QuantityFlag *>, mq_flags, mq_flags);
 268
 269 %include <libsigrokcxx/libsigrokcxx.hpp>
 270
 271 %include "swig/enums.i"
 272
 273 namespace sigrok {
 274 %include <libsigrokcxx/enums.hpp>
 275 }