LeafLabs Garden » Topic: sampling

LeafLabs Garden » Topic: sampling http://forums.leaflabs.com/topic.php?id=2004 A place to share, learn, and grow... en-US Fri, 22 Jan 2016 00:23:49 +0000 http://bbpress.org/?v=1.0.2 <![CDATA[Search]]> q http://forums.leaflabs.com/search.php crenn on "sampling" http://forums.leaflabs.com/topic.php?id=2004&page=2#post-11594 Fri, 06 Jul 2012 00:33:40 +0000 crenn 11594@http://forums.leaflabs.com/ I'll note that I found it easily as it was (to me anyway) a logical place to look, but I agree with you, and a link between the Wirish API and components in libmaple would assist users who wish to change various settings. Lastly, I'll note that I rarely look at the Docs and just look into the header files. xD; gbulmer on "sampling" http://forums.leaflabs.com/topic.php?id=2004#post-11588 Thu, 05 Jul 2012 21:36:04 +0000 gbulmer 11588@http://forums.leaflabs.com/ <blockquote>Docs -> libmaple -> APIs -> adc.h -> Functions (in the list) </blockquote> Yup! Dreadful, isn't it?-) A good answer would be: Docs -> Language -> analogRead() #Discussion Docs -> Language -> analogRead() -> ADC Tutorial Docs -> Language -> analogRead() -> pinMode() // if the functionality were a pinMode overload :-) Docs -> Language -> analogRead() -> ADC Functions Docs -> Language -> analogRead() -> Low-level ADC Functions etc. IMHO only a C/C++ programmer is going to feel looking in a header file is a good place to look for documentation. And I don't think this is good once it is found: <blockquote>void adc_set_sample_rate(const adc_dev * dev, adc_smp_rate smp_rate) Turn the given sample rate into values for ADC_SMPRx. Don’t call this during conversion. Parameters: dev -adc device smp_rate -sample rate to set See: adc_smp_rate ... adc_smp_rate enum ADC sample times, in ADC clock cycles. These control the amount of time spent sampling the input voltage. Values: ADC_SMPR_1_5 - 1.5 ADC cycles ADC_SMPR_7_5 - 7.5 ADC cycles ADC_SMPR_13_5 - 13.5 ADC cycles ADC_SMPR_28_5 - 28.5 ADC cycles ADC_SMPR_41_5 - 41.5 ADC cycles ADC_SMPR_55_5 - 55.5 ADC cycles ADC_SMPR_71_5 - 71.5 ADC cycles ADC_SMPR_239_5 - 239.5 ADC cycles </blockquote> I don't like the throwaway line "ADC sample times, in ADC clock cycles." Not even "ADC sample times, in ADC clock cycles. The ADC clock is set up to be 12MHz on Maple." or "The default for all ADC pins is set to ADC_SMPR_55_5 which is x.y microseconds when the ADC clock is at the default 12MHz."