X-Git-Url: http://sigrok.org/gitweb/?a=blobdiff_plain;f=libsigrok.h;h=2c117be1af5aef0b7664426e3b813a0289a6e1a1;hb=d5a669a9e0319531595a8a45b6c21f0c316a24f1;hp=a9c4cd487abfb7215c03f7df3f443d5b8187091d;hpb=fbec8bd2f3ead02358df65240c2cf786c8267f54;p=libsigrok.git

diff --git a/libsigrok.h b/libsigrok.h
index a9c4cd48..2c117be1 100644
--- a/libsigrok.h
+++ b/libsigrok.h
@@ -286,6 +286,7 @@ struct sr_datafeed_logic {
 };
 
 struct sr_datafeed_analog {
+	/** The probes for which data is included in this packet. */
 	GSList *probes;
 	int num_samples;
 	/** Measured quantity (voltage, current, temperature, and so on). */
@@ -294,7 +295,8 @@ struct sr_datafeed_analog {
 	int unit;
 	/** Bitmap with extra information about the MQ. */
 	uint64_t mqflags;
-	/** The analog value. */
+	/** The analog value(s). The data is interleaved according to
+	 * the probes list. */
 	float *data;
 };
 
@@ -388,7 +390,7 @@ enum {
 	/** The device can measure humidity. */
 	SR_CONF_HYGROMETER,
 
-	/*--- Driver options ------------------------------------------------*/
+	/*--- Driver scan options -------------------------------------------*/
 
 	/**
 	 * Specification on how to connect to a device.
@@ -461,20 +463,26 @@ enum {
 	/** Coupling. */
 	SR_CONF_COUPLING,
 
+	/** Trigger types.  */
+	SR_CONF_TRIGGER_TYPE,
+
 	/*--- Special stuff -------------------------------------------------*/
 
+	/** Scan options supported by the driver. */
+	SR_CONF_SCAN_OPTIONS = 40000,
+
+	/** Device options for a particular device. */
+	SR_CONF_DEVICE_OPTIONS,
+
 	/** Session filename. */
-	SR_CONF_SESSIONFILE = 40000,
+	SR_CONF_SESSIONFILE,
 
-	/* TODO: Better description. */
 	/** The device supports specifying a capturefile to inject. */
 	SR_CONF_CAPTUREFILE,
 
-	/* TODO: Better description. */
 	/** The device supports specifying the capturefile unit size. */
 	SR_CONF_CAPTURE_UNITSIZE,
 
-	/* TODO: Better description. */
 	/** The device supports setting the number of probes. */
 	SR_CONF_CAPTURE_NUM_PROBES,
 
@@ -540,37 +548,6 @@ enum {
 	SR_ST_STOPPING,
 };
 
-/*
- * TODO: This sucks, you just kinda have to "know" the returned type.
- * TODO: Need a DI to return the number of trigger stages supported.
- */
-
-/** Device info IDs. */
-enum {
-	/** A list of options supported by the driver. */
-	SR_DI_HWOPTS = 10000,
-	/** A list of capabilities supported by the device. */
-	SR_DI_HWCAPS,
-	/** Types of logic trigger supported, out of "01crf" (char *). */
-	SR_DI_TRIGGER_TYPES,
-	/** The currently set samplerate in Hz (uint64_t). */
-	SR_DI_CUR_SAMPLERATE,
-	/** Supported patterns (in pattern generator mode). */
-	SR_DI_PATTERNS,
-	/** Supported buffer sizes. */
-	SR_DI_BUFFERSIZES,
-	/** Supported time bases. */
-	SR_DI_TIMEBASES,
-	/** Supported trigger sources. */
-	SR_DI_TRIGGER_SOURCES,
-	/** Supported filter targets. */
-	SR_DI_FILTERS,
-	/** Valid volts/div values. */
-	SR_DI_VDIVS,
-	/** Coupling options. */
-	SR_DI_COUPLING,
-};
-
 /*
  * A device supports either a range of samplerates with steps of a given
  * granularity, or is limited to a set of defined samplerates. Use either