bitscope

bitscope is a comprehensive library for programming and data collection from Bitscope Micro.

It is a python wrapper for bitlib package installed using bitscope-library_2.0.FE26B and python3-bindings-2.0-DC01L

Usage

#!/usr/bin/env python

import matplotlib.pyplot as plt
import numpy as np
- from bitlib import *
+ from bitscope import *

# initialisation of scope collects all the device data and stores them in
# scope.devices list 
- BL_Open('USB:/dev/ttyUSB1',1)
+ scope = Scope('USB:/dev/ttyUSB1',1)

# collect the list of devices
devices = scope.devices

#Setup acquisition in FAST mode, where the whole of the 12288 samples in
#the buffer are used by one channel alone.
- BL_Select(BL_SELECT_DEVICE,0)
- BL_Mode(BL_MODE_FAST)

+ devices[0].mode(BL_MODE_FAST)


#Setup channel-nonspecific parameters for capture.
#How many seconds to capture before the trigger event- 0 by default
- BL_Intro(BL_ZERO)
#How many seconds to capture after the trigger event- 0 by default
- BL_Delay(BL_ZERO) 
# optional, default BL_MAX_RATE
- BL_Rate(MY_RATE)
# optional default BL_MAX_SIZE
- BL_Size(MY_SIZE)

+ scope.tracer.configure(
+     rate=BL_MAX_RATE, 
+     size=BL_MAX_SIZE, 
+     pre_capture=BL_ZERO, 
+     post_capture=BL_ZERO
+ ) 

#Set up channel A properties - A has channel index 0, B has 1.
#All the subsequent properties belong to channel A until another is selected.
- BL_Select(BL_SELECT_CHANNEL,0);
# use the POD input - the only one available
- BL_Select(BL_SELECT_SOURCE,BL_SOURCE_POD);
# Y-axis offset is set to zero as BL_ZERO
- BL_Offset(BL_ZERO)
# maximum range for y-axis - use this whenever possible
- BL_Range(BL_Count(BL_COUNT_RANGE)) 

+ devices[0].channels[0].configure(
+    source=BL_SOURCE_POD,
+    offset=BL_ZERO,
+    range=BL_Count(BL_COUNT_RANGE)
+)


#Enable the currently selected channel, i.e. channel A
#This ensures the recorded data goes into the memory-buffer in Bitscope device
- BL_Enable(TRUE);
+ devices[0].channels[0].enable()


- BL_Trace(0.01,BL_SYNCHRONOUS)
+ scope.tracer.trace(0.01,BL_SYNCHRONOUS)

- Data = BL_Acquire()
+ Data = devices[0].channels[0].acquire()
print Data

Install

• clone this repository using

  $ git clone git@github.com:codenio/bitscope.git

• install bitlib library from ./src directory

  # cd into bitscope/src/ directory
  $ cd bitscope/src/
  
  # install the bitscope-library_2.0 debian package
  $ sudo apt-get install bitscope-library_2.0.FE26B_amd64.deb

• to use bitlib in python3

  # to install python3 binding
  # unzip and cd into bitscope/src/python3-bindings-2.0-DC01L/ 
  $ unzip python3-bindings-2.0-DC01L.zip
  $ cd python3-bindings-2.0-DC01L/
  
  # install bitlib using the python-binding script 
  $ sudo python3 setup-bitlib.py install
  
  # in case of errors.. try
  $ sudo BASECFLAGS="" OPT="" CFLAGS="-O3" python3 setup-bitlib.py install

  Note: visit python3-bindings-2.0-DC01L for further details.

• to install stable version of bitscope package

  $ sudo pip install bitscope
  
  or 
  
  $ sudo pip install bitscope==0.0.3

• connect your bitscope to your pc and test the functionality using the example file at examples/basics/bitscope-read-data.py

  $ python examples/basics/bitscope-read-data.py

Documentation

• Library Overview
• Library Reference
• Examples
  • Basics
  • Matplotlib

Develope

• make the suitable changes and from the root directory of this repository, install the bitscope python package using the install.sh script

  $ sudo ./scripts/install.sh

Contribute

• You've discovered a bug or something else you want to change - excellent! - feel free to raise a issue.
• You've worked out a way to fix it – even better! - submit your PR
• You want to tell us about it – best of all!

Start contributing !