Safe Haskell	None
Language	Haskell2010

SDR.Util

Contents

Classes
Conversion to floating point for reception
- RTLSDR
- BladeRF
Conversion from floating point for transmission
- BladeRF
Scaling
Mapping over complex numbers
Frequency shifting
Data streams
Automatic gain control
Squashing initialization into the Pipe

Description

Various utiliy signal processing functions

Synopsis

class Mult a b
mult :: Mult a b => a -> b -> a
interleavedIQUnsigned256ToFloat :: (Num a, Integral a, Num b, Fractional b, Vector v1 a, Vector v2 (Complex b)) => v1 a -> v2 (Complex b)
interleavedIQUnsignedByteToFloat :: Vector CUChar -> Vector (Complex Float)
interleavedIQUnsignedByteToFloatSSE :: Vector CUChar -> Vector (Complex Float)
interleavedIQUnsignedByteToFloatAVX :: Vector CUChar -> Vector (Complex Float)
interleavedIQUnsignedByteToFloatFast :: CPUInfo -> Vector CUChar -> Vector (Complex Float)
interleavedIQSigned2048ToFloat :: (Num a, Integral a, Num b, Fractional b, Vector v1 a, Vector v2 (Complex b)) => v1 a -> v2 (Complex b)
interleavedIQSignedWordToFloat :: Vector CShort -> Vector (Complex Float)
interleavedIQSignedWordToFloatSSE :: Vector CShort -> Vector (Complex Float)
interleavedIQSignedWordToFloatAVX :: Vector CShort -> Vector (Complex Float)
interleavedIQSignedWordToFloatFast :: CPUInfo -> Vector CShort -> Vector (Complex Float)
complexFloatToInterleavedIQSigned2048 :: (Integral b, RealFrac a, Vector v1 (Complex a), Vector v2 b) => v1 (Complex a) -> v2 b
complexFloatToInterleavedIQSignedWord :: Vector (Complex Float) -> Vector CShort
scaleC :: Float -> Vector Float -> MVector RealWorld Float -> IO ()
scaleCSSE :: Float -> Vector Float -> MVector RealWorld Float -> IO ()
scaleCAVX :: Float -> Vector Float -> MVector RealWorld Float -> IO ()
scaleFast :: CPUInfo -> Float -> Vector Float -> MVector RealWorld Float -> IO ()
cplxMap :: (a -> b) -> Complex a -> Complex b
halfBandUp :: (Vector v n, Num n) => Int -> v n
quarterBandUp :: (Vector v (Complex n), Num n) => Int -> v (Complex n)
streamString :: forall m b. (FiniteBits b, Monad m) => [b] -> Int -> Producer (Vector Float) m ()
streamRandom :: forall m. PrimMonad m => Int -> Producer (Vector Float) m ()
agc :: (Num a, Storable a, RealFloat a) => a -> a -> a -> Vector (Complex a) -> (a, Vector (Complex a))
agcPipe :: (Num a, Storable a, RealFloat a, Monad m) => a -> a -> Pipe (Vector (Complex a)) (Vector (Complex a)) m ()
combineInit :: (Monad m, MonadTrans t, Monad (t m)) => m (t m a) -> t m a
combineInitTrans :: (Monad (t1 m), Monad (t (t1 m)), MonadTrans t, Monad m, MFunctor t, MonadTrans t1) => t1 m (t m a) -> t (t1 m) a

Classes

class Mult a b Source #

A class for things that can be multiplied by a scalar.

Minimal complete definition

mult

Instances

Num a => Mult a a Source #
Instance details Defined in SDR.Util Methods mult :: a -> a -> a Source #
Num a => Mult (Complex a) a Source #
Instance details Defined in SDR.Util Methods mult :: Complex a -> a -> Complex a Source #

mult :: Mult a b => a -> b -> a Source #

Conversion to floating point for reception

RTLSDR

interleavedIQUnsigned256ToFloat :: (Num a, Integral a, Num b, Fractional b, Vector v1 a, Vector v2 (Complex b)) => v1 a -> v2 (Complex b) Source #

Create a vector of complex floating samples from a vector of interleaved I Q components. Each input element ranges from 0 to 255. This is the format that RTLSDR devices use.

interleavedIQUnsignedByteToFloat :: Vector CUChar -> Vector (Complex Float) Source #

Same as interleavedIQUnsigned256ToFloat but written in C and specialized for unsigned byte inputs and Float outputs.

interleavedIQUnsignedByteToFloatSSE :: Vector CUChar -> Vector (Complex Float) Source #

Same as interleavedIQUnsigned256ToFloat but written in C using SSE intrinsics and specialized for unsigned byte inputs and Float outputs.

interleavedIQUnsignedByteToFloatAVX :: Vector CUChar -> Vector (Complex Float) Source #

Same as interleavedIQUnsigned256ToFloat but written in C using AVX intrinsics and specialized for unsigned byte inputs and Float outputs.

interleavedIQUnsignedByteToFloatFast :: CPUInfo -> Vector CUChar -> Vector (Complex Float) Source #

Same as interleavedIQUnsigned256ToFloat but uses the fastest SIMD instruction set your processor supports and specialized for unsigned byte inputs and Float outputs.

BladeRF

interleavedIQSigned2048ToFloat :: (Num a, Integral a, Num b, Fractional b, Vector v1 a, Vector v2 (Complex b)) => v1 a -> v2 (Complex b) Source #

Create a vector of complex float samples from a vector of interleaved I Q components. Each input element ranges from -2048 to 2047. This is the format that the BladeRF uses.

interleavedIQSignedWordToFloat :: Vector CShort -> Vector (Complex Float) Source #

Same as interleavedIQUnsigned256ToFloat but written in C and specialized for signed short inputs and Float outputs.

interleavedIQSignedWordToFloatSSE :: Vector CShort -> Vector (Complex Float) Source #

Same as interleavedIQUnsigned256ToFloat but written in C using SSE intrinsics and specialized for signed short inputs and Float outputs.

interleavedIQSignedWordToFloatAVX :: Vector CShort -> Vector (Complex Float) Source #

Same as interleavedIQUnsigned256ToFloat but written in C using AVX intrinsics and specialized for signed short inputs and Float outputs.

interleavedIQSignedWordToFloatFast :: CPUInfo -> Vector CShort -> Vector (Complex Float) Source #

Same as interleavedIQSigned2048ToFloat but uses the fastest SIMD instruction set your processor supports and specialized for signed short inputs and Float outputs.

Conversion from floating point for transmission

BladeRF

complexFloatToInterleavedIQSigned2048 :: (Integral b, RealFrac a, Vector v1 (Complex a), Vector v2 b) => v1 (Complex a) -> v2 b Source #

Create a vector of interleaved I Q component integral samples from a vector of complex Floats. Each input ranges from -2048 to 2047. This is the format the BladeRF uses.

complexFloatToInterleavedIQSignedWord :: Vector (Complex Float) -> Vector CShort Source #

Same as complexFloatToInterleavedIQSigned2048 but written in C and specialized for Float inputs and signed short outputs.

Scaling

scaleC Source #

Arguments

:: Float	Scale factor
-> Vector Float	Input vector
-> MVector RealWorld Float	Output vector
-> IO ()

Scale a vector, written in C

scaleCSSE Source #

Arguments

:: Float	Scale factor
-> Vector Float	Input vector
-> MVector RealWorld Float	Output vector
-> IO ()

Scale a vector, written in C using SSE intrinsics

scaleCAVX Source #

Arguments

:: Float	Scale factor
-> Vector Float	Input vector
-> MVector RealWorld Float	Output vector
-> IO ()

Scale a vector, written in C using AVX intrinsics

scaleFast :: CPUInfo -> Float -> Vector Float -> MVector RealWorld Float -> IO () Source #

Scale a vector. Uses the fastest SIMD instruction set your processor supports.

Mapping over complex numbers

cplxMap Source #

Arguments

:: (a -> b)	The function
-> Complex a	Input complex number
-> Complex b	Output complex number

Apply a function to both parts of a complex number

Frequency shifting

halfBandUp Source #

Arguments

:: (Vector v n, Num n)
=> Int	The length of the Vector
-> v n

Multiplication by this vector shifts all frequencies up by 1/2 of the sampling frequency

quarterBandUp Source #

Arguments

:: (Vector v (Complex n), Num n)
=> Int	The length of the Vector
-> v (Complex n)

Multiplication by this vector shifts all frequencies up by 1/4 of the sampling frequency

Data streams

streamString Source #

Arguments

:: (FiniteBits b, Monad m)
=> [b]	The string whose bits are to be streamed
-> Int	The size of each streamed vector
-> Producer (Vector Float) m ()

A Producer that streams vectors of the bits that make up the string argument concatenated repeatedly. Each bit is encoded as a float with value (+1) for 1 and (-1) for 0.

streamRandom Source #

Arguments

:: PrimMonad m
=> Int	The size of each streamed vector
-> Producer (Vector Float) m ()

A Producer that streams vectors of random bits. Each bit is encoded as a float with value (+1) for 1 and (-1) for 0.

Automatic gain control

agc Source #

Arguments

:: (Num a, Storable a, RealFloat a)
=> a	a
-> a	reference
-> a	initial state
-> Vector (Complex a)	input vector
-> (a, Vector (Complex a))	(final state, output vector)

Simple automatic gain control

agcPipe Source #

Arguments

:: (Num a, Storable a, RealFloat a, Monad m)
=> a	a
-> a	reference
-> Pipe (Vector (Complex a)) (Vector (Complex a)) m ()

Simple automatic gain control pipe

Squashing initialization into the Pipe

combineInit :: (Monad m, MonadTrans t, Monad (t m)) => m (t m a) -> t m a Source #

Specializes to combineInit :: IO (Pipe a b IO ()) -> Pipe a b IO ()

combineInitTrans :: (Monad (t1 m), Monad (t (t1 m)), MonadTrans t, Monad m, MFunctor t, MonadTrans t1) => t1 m (t m a) -> t (t1 m) a Source #

Specializes to combineInitTrans :: EitherT String IO (Pipe a b IO ()) -> Pipe a b (EitherT String IO) ()