[libsigrokdecode.git] / decoders / guess_bitrate / __init__.py

##
## This file is part of the libsigrokdecode project.
##
## Copyright (C) 2013 Uwe Hermann <uwe@hermann-uwe.de>
##
## This program is free software; you can redistribute it and/or modify
## it under the terms of the GNU General Public License as published by
## the Free Software Foundation; either version 2 of the License, or
## (at your option) any later version.
##
## This program is distributed in the hope that it will be useful,
## but WITHOUT ANY WARRANTY; without even the implied warranty of
## MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
## GNU General Public License for more details.
##
## You should have received a copy of the GNU General Public License
## along with this program; if not, see <http://www.gnu.org/licenses/>.
##

'''
This protocol decoder tries to guess the bitrate / baudrate of the
communication on the specified channel.

Typically this will be used to guess / detect the baudrate used in a UART
communication snippet, but it could also be used to guess bitrates of certain
other protocols or buses.

It should be noted that this is nothing more than a simple guess / heuristic,
and that there are various cases in practice where the detection of the
bitrate or baudrate will not necessarily have the expected result.

The precision of the estimated bitrate / baudrate will also depend on the
samplerate used to sample the respective channel. For good results it is
recommended to use a logic analyzer samplerate that is much higher than
the expected bitrate/baudrate that might be used on the channel.

The last annotation emitted by the decoder will be the best bitrate guess.
'''

from .pd import Decoder
Commit	Line	Data
56c93143 UH	1	##
	2	## This file is part of the libsigrokdecode project.
	3	##
	4	## Copyright (C) 2013 Uwe Hermann <uwe@hermann-uwe.de>
	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 2 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
4539e9ca	17	## along with this program; if not, see <http://www.gnu.org/licenses/>.
56c93143 UH	18	##
	19
	20	'''
	21	This protocol decoder tries to guess the bitrate / baudrate of the
2787cf2a UH	22	communication on the specified channel.
	23
	24	Typically this will be used to guess / detect the baudrate used in a UART
	25	communication snippet, but it could also be used to guess bitrates of certain
	26	other protocols or buses.
56c93143 UH	27
	28	It should be noted that this is nothing more than a simple guess / heuristic,
	29	and that there are various cases in practice where the detection of the
	30	bitrate or baudrate will not necessarily have the expected result.
	31
	32	The precision of the estimated bitrate / baudrate will also depend on the
6a15597a	33	samplerate used to sample the respective channel. For good results it is
56c93143	34	recommended to use a logic analyzer samplerate that is much higher than
6a15597a	35	the expected bitrate/baudrate that might be used on the channel.
2787cf2a UH	36
2787cf2a UH	37	The last annotation emitted by the decoder will be the best bitrate guess.
56c93143 UH	38	'''
56c93143 UH	39
95d11271	40	from .pd import Decoder