[proxmark3-svn] / armsrc / lfsampling.h

#ifndef LFSAMPLING_H
#define LFSAMPLING_H

/**
* Initializes the FPGA for reader-mode (field on), and acquires the samples.
* @return number of bits sampled
**/
uint32_t SampleLF();

/**
* Initializes the FPGA for snoop-mode (field off), and acquires the samples.
* @return number of bits sampled
**/

uint32_t SnoopLF();

/**
 * @brief Does sample acquisition, ignoring the config values set in the sample_config.
 * This method is typically used by tag-specific readers who just wants to read the samples
 * the normal way
 * @param trigger_threshold
 * @param silent
 * @return number of bits sampled
 */
uint32_t DoAcquisition_default(int trigger_threshold, bool silent);
/**
 * @brief Does sample acquisition, using the config values set in the sample_config.
 * @param trigger_threshold
 * @param silent
 * @return number of bits sampled
 */

uint32_t DoAcquisition_config( bool silent);

/**
* Setup the FPGA to listen for samples. This method downloads the FPGA bitstream
* if not already loaded, sets divisor and starts up the antenna.
* @param divisor : 1, 88> 255 or negative ==> 134.8 KHz
* 				   0 or 95 ==> 125 KHz
*
**/
void LFSetupFPGAForADC(int divisor, bool lf_field);


/**
 * Called from the USB-handler to set the sampling configuration
 * The sampling config is used for std reading and snooping.
 *
 * Other functions may read samples and ignore the sampling config,
 * such as functions to read the UID from a prox tag or similar.
 *
 * Values set to '0' implies no change (except for averaging)
 * @brief setSamplingConfig
 * @param sc
 */
void setSamplingConfig(sample_config *sc);

sample_config * getSamplingConfig();
#endif // LFSAMPLING_H
Commit	Line	Data
31abe49f MHS	1	#ifndef LFSAMPLING_H
	2	#define LFSAMPLING_H
	3
	4	/**
	5	* Initializes the FPGA for reader-mode (field on), and acquires the samples.
	6	* @return number of bits sampled
	7	**/
	8	uint32_t SampleLF();
	9
	10	/**
	11	* Initializes the FPGA for snoop-mode (field off), and acquires the samples.
	12	* @return number of bits sampled
	13	**/
	14
	15	uint32_t SnoopLF();
	16
	17	/**
	18	* @brief Does sample acquisition, ignoring the config values set in the sample_config.
	19	* This method is typically used by tag-specific readers who just wants to read the samples
	20	* the normal way
	21	* @param trigger_threshold
	22	* @param silent
	23	* @return number of bits sampled
	24	*/
	25	uint32_t DoAcquisition_default(int trigger_threshold, bool silent);
	26	/**
	27	* @brief Does sample acquisition, using the config values set in the sample_config.
	28	* @param trigger_threshold
	29	* @param silent
	30	* @return number of bits sampled
	31	*/
	32
	33	uint32_t DoAcquisition_config( bool silent);
	34
	35	/**
	36	* Setup the FPGA to listen for samples. This method downloads the FPGA bitstream
	37	* if not already loaded, sets divisor and starts up the antenna.
	38	* @param divisor : 1, 88> 255 or negative ==> 134.8 KHz
	39	* 0 or 95 ==> 125 KHz
	40	*
	41	**/
	42	void LFSetupFPGAForADC(int divisor, bool lf_field);
	43
	44
	45	/**
	46	* Called from the USB-handler to set the sampling configuration
	47	* The sampling config is used for std reading and snooping.
	48	*
	49	* Other functions may read samples and ignore the sampling config,
	50	* such as functions to read the UID from a prox tag or similar.
	51	*
	52	* Values set to '0' implies no change (except for averaging)
	53	* @brief setSamplingConfig
	54	* @param sc
	55	*/
	56	void setSamplingConfig(sample_config *sc);
	57
	58	sample_config * getSamplingConfig();
	59	#endif // LFSAMPLING_H