]> sigrok.org Git - libsigrok.git/blobdiff - libsigrok.h
Remove obsolete output API.
[libsigrok.git] / libsigrok.h
index 9c69474e3f0f3260811f4a3286eb6cb565b728ae..f9678de76e4f7c6dca37a5b0d8401dd96e3f160d 100644 (file)
@@ -81,7 +81,7 @@ enum {
         */
 };
 
-#define SR_MAX_PROBENAME_LEN 32
+#define SR_MAX_CHANNELNAME_LEN 32
 
 /* Handy little macros */
 #define SR_HZ(n)  (n)
@@ -479,9 +479,6 @@ struct sr_output_format {
         */
        char *description;
 
-       /** Datafeed type, SR_DF_HEADER, etc. */
-       int df_type;
-
        /**
         * This function is called once, at the beginning of an output stream.
         *
@@ -499,72 +496,6 @@ struct sr_output_format {
         */
        int (*init) (struct sr_output *o);
 
-       /**
-        * Whenever a chunk of data comes in, it will be passed to the
-        * output module via this function. The <code>data_in</code> and
-        * <code>length_in</code> values refers to this data; the module
-        * must not alter or g_free() this buffer.
-        *
-        * The function must allocate a buffer for storing its output, and
-        * pass along a pointer to this buffer in the <code>data_out</code>
-        * parameter, as well as storing the length of the buffer in
-        * <code>length_out</code>. The calling frontend will g_free()
-        * this buffer when it's done with it.
-        *
-        * IMPORTANT: The memory allocation much happen using a glib memory
-        * allocation call (not a "normal" malloc) since g_free() will be
-        * used to free the memory!
-        *
-        * If there is no output, this function MUST store NULL in the
-        * <code>data_out</code> parameter, so the caller knows not to try
-        * and g_free() it.
-        *
-        * Note: This API call is obsolete, use receive() instead.
-        *
-        * @param o Pointer to the respective 'struct sr_output'.
-        * @param data_in Pointer to the input data buffer.
-        * @param length_in Length of the input.
-        * @param data_out Pointer to the allocated output buffer.
-        * @param length_out Length (in bytes) of the output.
-        *
-        * @retval SR_OK Success
-        * @retval other Negative error code.
-        */
-       int (*data) (struct sr_output *o, const uint8_t *data_in,
-                    uint64_t length_in, uint8_t **data_out,
-                    uint64_t *length_out);
-
-       /**
-        * This function is called when an event occurs in the datafeed
-        * which the output module may need to be aware of. No data is
-        * passed in, only the fact that the event occurs. The following
-        * events can currently be passed in:
-        *
-        *  - SR_DF_TRIGGER: At this point in the datafeed, the trigger
-        *    matched. The output module may mark this in some way, e.g. by
-        *    plotting a red line on a graph.
-        *
-        *  - SR_DF_END: This marks the end of the datafeed. No more calls
-        *    into the output module will be done, so this is a good time to
-        *    free up any memory used to keep state, for example.
-        *
-        * Any output generated by this function must have a reference to
-        * it stored in the <code>data_out</code> and <code>length_out</code>
-        * parameters, or NULL if no output was generated.
-        *
-        * Note: This API call is obsolete, use receive() instead.
-        *
-        * @param o Pointer to the respective 'struct sr_output'.
-        * @param event_type Type of event that occured.
-        * @param data_out Pointer to the allocated output buffer.
-        * @param length_out Length (in bytes) of the output.
-        *
-        * @retval SR_OK Success
-        * @retval other Negative error code.
-        */
-       int (*event) (struct sr_output *o, int event_type, uint8_t **data_out,
-                       uint64_t *length_out);
-
        /**
         * This function is passed a copy of every packed in the data feed.
         * Any output generated by the output module in response to the
@@ -597,19 +528,19 @@ struct sr_output_format {
        int (*cleanup) (struct sr_output *o);
 };
 
-/** Constants for probe type. */
+/** Constants for channel type. */
 enum {
-       /** Probe type is logic probe. */
-    SR_PROBE_LOGIC = 10000,
-       /** Probe type is analog probe. */
-    SR_PROBE_ANALOG,
+       /** Channel type is logic channel. */
+       SR_CHANNEL_LOGIC = 10000,
+       /** Channel type is analog channel. */
+       SR_CHANNEL_ANALOG,
 };
 
 /** Information on single channel. */
 struct sr_channel {
        /** Number of channels, starting at 0. */
        int index;
-       /** Channel type (SR_PROBE_LOGIC, ...) */
+       /** Channel type (SR_CHANNEL_LOGIC, ...) */
        int type;
        /** Is this channel enabled? */
        gboolean enabled;
@@ -803,11 +734,11 @@ enum {
         */
        SR_CONF_CENTER_FREQUENCY,
 
-       /** The device supports setting the number of logic probes. */
-       SR_CONF_NUM_LOGIC_PROBES,
+       /** The device supports setting the number of logic channels. */
+       SR_CONF_NUM_LOGIC_CHANNELS,
 
-       /** The device supports setting the number of analog probes. */
-       SR_CONF_NUM_ANALOG_PROBES,
+       /** The device supports setting the number of analog channels. */
+       SR_CONF_NUM_ANALOG_CHANNELS,
 
        /** Output voltage. */
        SR_CONF_OUTPUT_VOLTAGE,
@@ -992,9 +923,9 @@ struct sr_dev_driver {
        int (*config_set) (int id, GVariant *data,
                        const struct sr_dev_inst *sdi,
                        const struct sr_channel_group *cg);
-       /** Probe status change.
-        *  @see sr_dev_probe_enable(), sr_dev_trigger_set(). */
-       int (*config_probe_set) (const struct sr_dev_inst *sdi,
+       /** Channel status change.
+        *  @see sr_dev_channel_enable(), sr_dev_trigger_set(). */
+       int (*config_channel_set) (const struct sr_dev_inst *sdi,
                        struct sr_channel *ch, unsigned int changes);
        /** Apply configuration settings to the device hardware.
         *  @see sr_config_commit().*/