Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

The modules TEI0015, TEI0016 and TEI0023 implement a handler for executing commands. The serial interface speed
must be set to 115200 bits, commands consists of a single character in UTF-8 encoding.
Each command must be transmitted individually.


All commands are identical for all tree modules, except commands for setting the gain.


The modules TEI0015 and TEI0016 recognizes the following gain commands since module revision 02:

"1" Sets the pre-amplification of the ADC's input to 1

"2" Sets the pre-amplification of the ADC's input to 2

"4" Sets the pre-amplification of the ADC's input to 4

"8" Sets the pre-amplification of the ADC's input to 8


The following gain commands are recognized by all TEI0023 modules in every module revision:

"0" Deactivates the pre-amplifier

"1" Sets the pre-amplification of the ADC's input to 0.25

"2" Sets the pre-amplification of the ADC's input to 0.5

"3" Sets the pre-amplification of the ADC's input to 1

"4" Sets the pre-amplification of the ADC's input to 2

"5" Sets the pre-amplification of the ADC's input to 4

"6" Sets the pre-amplification of the ADC's input to 8

"8" Sets the pre-amplification of the ADC's input to 16


The modules TEI0015 and TEI0023 have an ADC with additional features since revision 02 for TEI0015 and revision 03 for TEI0023:

"S" Activates the Input Span Compression

"s" Deactivates the Input Span Compression

"H" Activates the High-Z Mode

"h" Deactivates the High-Z Mode


These commands are recognized by every module:

"t"    The ADC measures 1 mega samples and saves the values into its SD-RAM

"x"    Instead of ADC values, the value "12345" is stored 1M times into its SD-RAM, values are transmitted via ".", "+" and "*"

"y"    Instead of ADC value, hexadecimal values, in ascending order, are generated and stored into the SD-RAM,
        the values are transmitted in via "." ,  "+" and "*"


"z"   The value "12345" is generated and direct transmitted 256 times

"r"    The ADC measure once and transmits this value


"."     A single value of stored ADC or generated measurement is transmitted

"+"   128 values of stored ADC or generated measurements are transmitted

"*"    16 kbit values of stored ADC or generated measurements are transmitted


"?"   The module returns its ID:
               TEI0015 with ADC AD4003 / 2 MSps returns "1"
               TEI0016-0x-08-C8A with ADC ADAQ7988 / 0.5 MSps returns "2"
               TEI0016-0x-08-C8B with ADC ADAQ7980 / 1 MSps returns "3"
               TEI0023A with ADC AD4003 / 2 MSps returns "4"

"F"   The module activates a square wave signal,
        frequency = 10 kHz and  amplitude is +3,3 V / ground
        the signal is accessible on the pads
               - D5 in normal mode and
               - D6 in time inverted mode

"f"   Deactivation of the square wave signal

Einleitung → Bildchen's der module

The modules of the the AnalogMax series offer software demonstrations of their basic functionality and
communication interface.

This manuel provides a step by step guide for installing the required software and running the demos in general

For the ease of access and programability the programming language Python(since version 3.5) has been chosen.
The project Jupyter provides an excellent and open source entry for beginners.
Jupyter files are called Notebooks and have the ending name.ipynb, this manuel refers to them as demo.

The following description of steps applies in its details to computers running windows, for other
operation systems they are in general similar.

So running and editing the Demos requires the following steps:

  • Step 1 - Installation of Anaconda respectively jupyter
  • Step 2 - Installion of "pyserial"
  • Step 3 - Driver installation for the module
  • Step 4 - Making the demos accessible for jupyter
  • Step 5 - Starting Jupyter
  • Step 6 - Opening a demo
  • Step 7 - Alter the comport to yours
  • Step 8 - Run the Notebook
  • Annotations

...

The simplest way to get the demos running in Jupyter is accomplished throw the installion of Anaconda.
This will install more than is needed but nearly all requierementsin one step.

The Anaconda website provides detailed instructions on how to install the application, just follow the link
http://docs.anaconda.com/anaconda/install/windows/
If the installer offers you the installation of optional application, just skip those, they are
not needed to run the demos or edit their code.

Installation of Pyserial

At least with Anaconda installation on Windows, pyserial (python serial port support library) is not
included and has to be installed. This can be done froma Anaconda command prompt. To open the
Anaconda command prompt, just press the windows key, type Anaconda prompt and open it. Enter

conda install -c anaconda pyserial

into the command prompt an press enter. This starts the search for software dependencies of pyserial,
to prceed you are asked to confirm the installtion, press Y to confirm.
The console shows a message when pyserial is installed and thereafter the console is no longer needed
and can be closed.

Driver installation for the module

The communication with a module supposes a comport, and therefor a driver is requiered.
When connecting the modul with your computer, windows starts the Automatic driver Installation,
but often the automatic driver installation fails and the driver needs to be installed manually.

So it is best practice to connect the module, give the opperation system some time, and check
afterwards in the device manager for the apperance of a "comport" and two devices labeld
"USB Serial Convert A and B".

The device manager can be opened either via a right mouse click onto the windows symbole
or by pressing the windows button and typing device manager.

Image Removed

When instead two devices labeld "Arrow USB Blaster" are listed under "other devices", the manuell
approach has to betaken.
Image Removed

Update driver / context menu

...

Check its number (“ComX” ) and memorize it for the later use within the demos.

In dependency to the modules firmware, the driver installation can lead to the appearance of two comports,
in this instance, the higher numbered comport is of importance.

Making the demos accessible for jupyter

The demos for a module are compressed into a zip archieve and need to be extracted, to be accessible for
Jupyter. Jupyter has access to the user folder, so a convenient way is to copy the extracted demo folder
into your users folder, for example:

C:\Users\Username\distribution-folder

Starting Jupyter

Alternative kann man auch einfach nur Jupyter starten, es öffnet sich als Konsolenfenster, dass nicht
geschlßen werden, wohl aber minimiert werden darf

...

When you no longer

it opens a console, in which Jupyter messages are displayed and also your default browser

press the windows key and type Anaconda
Navigator. Anaconda opens and to open jupyter, click launch, in the screenshot below, marked within
the red rectangle.

Image Removed

The application opens a tab inside your browser which displays your user folder.

Opening a demo

In our case, a left click on the demo
folder opens it an from there one can open a demo.
In the pictures below the steps are:

  • Home folder
  • Folder - AnalogMax
  • Demo - AnalogMax_Accelerometer_Demo

Image Removed

Hints for the Notebook use:

IPython (Interactive Python) - is a command shell for interactive computing in multiple programming languages, originally developed for the Python programming language
ipywidgets - Interactive Widgets/GUI elements for the Jupyter Notebook

Step 7 - Show linenumber / Starting with clearing the caches

Clicking on the folder AnalogMax opens it.

Choose a demo and another click opens

the demo in a new tab.