The EVAL-ADXRS290-PMDZ is a simple Pmod form-factor evaluation board for the ADXRS290, a high-performance MEMS pitch-and-roll (dual-axis in-plane) angular rate sensor (gyroscope) designed for use in stabilization applications.

The solution senses and digitizes the X-axis and Y-axis (also called roll and pitch) angular rates, producing a positive reading for clockwise rotation about the x-axis and y-axis.

The ADXRS290 provides an output full-scale range of ±100°/s with a sensitivity of 200 LSB/°/s. Its resonating disk sensor structure enables angular rate measurement about the axes normal to the sides of the package around an in-plane axis. Angular rate data is formatted as a 16-bit two's complement and is accessible through an SPI digital interface. The ADXRS290 exhibits a low noise floor of 0.004°/s/√Hz and features programmable high-pass and lowpass filters.

The ADXRS290 communicates via 4-wire SPI and operates as a peripheral (slave) device, with a maximum clock frequency of 12MHz.

The Digital communication on the EVAL-ADXRS290-PMDZ is accomplished using a standard expanded SPI PMOD port.

• Pitch and roll rate gyroscope
• Ultralow noise: 0.004°/s/√Hz
• High vibration rejection over a wide frequency range
• Power saving standby mode
• 80 μA current consumption in standby mode
• Fast startup time from standby mode: <100 ms
• Low delay of <0.5 ms for a 30 Hz input at the widest bandwidth setting
• Serial peripheral interface (SPI) digital output
• Programmable high-pass and low-pass filters
• 2000 g powered acceleration survivability
• 2.7 V to 5.0 V operation
• ?25°C to +85°C operation
• PMOD form factor

Two example device driver solutions are provided for controling the EVAL-ADXRS290-PMDZ PMOD using the no-OS device driver on the EVAL-ADICUP3029 platform and Linux device driver on the Raspberry Pi platform.

The Linux driver uses the Industrial Input/Output (IIO) framework, greatly simplifying the development of applicaiton code via the cross-platform Libiio library, which is written in C and includes bindings for Python, MATLAB, C#, and other languages. Application code can run directly on the platform board, communicating with the device over the local bakend, or from a remote host over the network or USB backends.

The ADICUP3029 example application uses the ADXRS290 no-OS driver, and emulates the Linux IIO framework through the tinyiiod daemon library. The application communicates with the host computer via the serial backend, over a USB-UART physical connection. This facilitates rapid application development on a host computer, independent from embedded code development.

Similarly, utility software (iio_info, IIO Oscilloscope, PyADI-IIO, etc.) can be used for both the EVAL-ADXRS290-PMDZ on Raspberry PI and on ADICUP3029

The EVAL-ADXRS290-PMDZ can be used with ADICUP3029.

The following is a list of items needed in order to replicate this demo. Hardware:

• EVAL-ADICUP3029
• EVAL-ADXRS290-PMDZ
• Mirco USB to USB cable
• PC or Laptop with a USB port

Software:

• Either: pre-built HEX file:

To build the project from source, follow the instructions in the no-os wiki.

1. Connect EVAL-ADXRS290-PMDZ board at connector P8 of the EVAL-ADICUP3029.
2. Connect a micro-USB cable to the P10 connector of the EVAL-ADICUP3029 and connect it to a computer. The final setup should look similar to the picture below.

1. Make sure the following switches are as shown from the table below:
2. Connect the ADICuP3029 to the PC host via micro-USB cable as shown below.
3. From your PC, open My Computer and look for the DAPLINK drive, if you see this then the drivers are complete and correct.
4. Simply extract the zip file then drag and drop the provided .hex file to the DAPLINK drive, and your ADICUP3029 board will be programmed. The DS2 (red) LED will blink rapidly.
5. The DS2 will stop blinking and will stay ON once the programming is done.
6. Disconnect then reconnect the EVAL-ADICUP3029 to the host computer.

The EVAL-ADXRS290-PMDZ can be used with a Raspberry Pi.

The following is a list of items needed in order to replicate this demo.

• Hardware
  • EVAL-ADXRS290-PMDZ Circuit Evaluation Board
  • Raspberry PI Zero, Zero W, 3B+, or 4
  • 16GB (or larger) Class 10 (or faster) micro-SD card
  • 5Vdc, 2.5A power supply with micro USB connector (USB-C power supply for Raspberry Pi 4)
  • Electrical connection hardware (choose one):
    • 12x 15cm socket-to-socket jumpers such as these from Schmartboard
    • DesignSpark HAT to Pmod Adapter
  • User interface setup (choose one):
    • HDMI monitor, keyboard, mouse plugged directly into Raspberry Pi
    • Host Windows/Linux/Mac computer on same network as Raspberry Pi

• Software
  • Analog Devices Kuiper Linux

In order to control the EVAL-ADXRS290-PMDZ from the Raspberry Pi, you will need to install ADI Kuiper Linux on an SD card. Complete instructions, including where to download the SD card image, how to write it to the SD card, and how to configure the system are provided at Analog Devices Kuiper Linux.
Write the image and follow the system configuration procedure.

Follow the Hardware Configuration procedure under Preparing the Image: Raspberry Pi in the Analog Devices Kuiper Linux page, substituting the following lines in config.txt:

dtoverlay=rpi-adxrs290

To set up the circuit for evaluation, consider the following steps:

1. Connect EVAL-ADXRS290-PMDZ board at male header connector of the Raspberry Pi.
2. Burn the SD card with the proper ADI Kuiper Linux image. Insert the burned SD card on the designated slot on the RPi.
3. Connect the system to a monitor using an HDMI cable through the mini HDMI connector on the RPi.
4. Connect a USB keyboard and mouse to the RPi through the USB ports.
5. Power on the RPi board by plugging in a 5V power supply with a micro-USB connector. The final setup should look similar to the picture below.

To be able to connect your device, the software must be able to create a context. The context creation in the software depends on the backend used to connect to the device as well as the platform where the EVAL-ADXRS290-PMDZ is attached. Two platforms are currently supported for the ADXRS290: Raspberry Pi using the ADI Kuiper Linux and the ADICUP3029 running the ADXRS290 IIO demo project. The user needs to supply a URI which will be used in the context creation.

The iio_info command is a part of the libIIO package that reports all IIO attributes. Make sure that you have the libIIO package installed on your machine. Upon installation, simply enter the command on the terminal line to access it.

iio_info

iio_info -u ip:

Example:

• If your Raspberry Pi has the IP address 192.168.1.7, you have to use iio_info -u ip::192.168.1.7 as your URI

iio_info -u serial:

Examples:

• In a Windows machine, you can check the port of your ADICUP3029 via Device Manager in the Ports (COM & LPT) section. If your device is in COM4, you have to use iio_info -u serial:COM4 as your URI.
• In a Unix-based machine, you will see it under the /dev/ directory in this format “ttyUSBn”, where n is a number depending on how many serial USB devices attached. If you see that your device is ttyUSB0, you have to use serial:/dev/ttyUSB0 as your URI.

There are different commands that can be used to manage the device being used. The iio_attr command reads and writes IIO attributes.

analog@analog:~$ iio_attr [OPTION]...

Example:

• To look at the context attributes, enter this code on the terminal:

analog@analog:~$ iio_attr -a -C

The iio_reg command reads or writes SPI or I2C registers in an IIO device. This is generally not needed for end applications, but can be useful in debugging drivers. Note that you need to specify a context using the -u qualifier when you are not directly accessing the device via RPI or when you are using the ADICUP3029 platform.

analog@analog:~$ iio_reg -u    []

Example:

• To to read the device ID (register = 0x02) of an ADXRS90 interfaced via RPI from a Windows machine, enter the following code on the terminal:

iio_reg -u ip: adxrs290 0x02

1. Once done with the installation or an update of the latest IIO-Oscilloscope, open the application. The user needs to supply a URI which will be used in the context creation of the IIO Oscilloscope and the instructions can be seen from the previous section.
2. Press refresh to display available IIO Devices, once adxrs290 appeared, press connect.

Below is the Debug panel of ADXRS290 wherein you can directly access the attributes of the device.

Access the DMM panel to see the instantaneous reading of the X and Y's angular velocities.

The Waveform panel, also known as the Capture window, displays the real-time waveform of ADXRS290's response.

PyADI-IIO is a python abstraction module for ADI hardware with IIO drivers to make them easier to use. This module provides device-specific APIs built on top of the current libIIO python bindings. These interfaces try to match the driver naming as much as possible without the need to understand the complexities of libIIO and IIO.

Install PyADI-IIO using one of the methods in PyADI-IIO.

The ADXRS290 example requires a number of packages to be installed before it can be used. To ensure that all required packages are present, we will be installing them in a virtual environment so that other python projects will not be affected by this added configuration. Make sure that virtualenv has been installed before proceeding.

1. Open a command prompt and navigate to the pyadi-iio directory.
2. Create a virtual environment by entering the following command:

    D:/pyadi-iio>python -m venv adxrs290 

   Note that the last argument adxrs290 is just the name of the virtual environment to be created. It can be replaced by any other name or identifier that you prefer. In case the code above does not work, try:

    D:/pyadi-iio>virtualenv adxrs290 

3. Input the following command to activate the virtual environment:

    D:/pyadi-iio>adxrs290/Scripts/activate 

Upon activation of the virtual environment, enter the following commands:

(adxrs290) D:/pyadi-iio>pip install -r requirements.txt
(adxrs290) D:/pyadi-iio>pip install -r examples/requirements_adiplot.txt
(adxrs290) D:/pyadi-iio>python setup.py install 

1. Connect the ADXRS290 to the device platform you've chosen.
2. If interfaced via RPI, connect your laptop to the same network as the ADXRS290 and take note of its IP address. For ADICUP3029, take note of the serial port used.
3. On the source code, go to the examples folder and open adxrs290.py. Provide the necessary context in order to detect the device. Make sure that only one context source is active and the other one is commented out depending on whether you are using the RPI board or the ADICUP3029.
4. Run the example by typing this line on the command prompt:

    D:/pyadi-iio/examples>python adxrs290.py 

   Below is a copy of the python script:
   adxrs290.py

   It will return these lines of data on the terminal:

5. You can opt to see a real-time plot of ADXRS290's output. To do this, open adxrs290.py and set enable_plot to True. A plot will pop-up after running the code:

• ADXRS290 Product Page

• ADXRS290 No-OS Build Instruction Guide
• ADXRS290 No-OS Drivers
• ADXRS290 Kuiper Linux

End of Document