This version (11 May 2022 11:02) was approved by Andrei Drimbarean.The Previously approved version (04 May 2022 12:47) is available.
Table of Contents
Optical Gesture Sensor Demo (w/ EVAL-CN0569-PMDZ)
The EVAL-CN0569-PMDZ is a PMOD form factor circuit board that allows evaluation of ADPD1080 working in tandem with two ADPD2140 to create a Infrared Light Gesture Sensor. This example uses the EVAL-ADICUP3029 as a motherboard as well as no-OS/ software implementing an IIO server and pyadi-iio/ code that runs on a host computer and implements gesture sensing algorithm.
General Description/Overview
The example software is divided in two parts:
- Firmware (written in C)
- Python application
The two parts work together to initialize the hardware, sample de system and implement the gesture sensing algorithm. The firmware is a part of code written in C language that runs on the controller on the EVAL-ADICUP3029 and initializes the hardware and runs an IIO server. The python application runs on a host computer connected to the system via an USB serial connection and is responsible for sampling the current passing through the photodiodes and implement different algorithms with it, in this case gesture sensing.
Demo Requirements
The following is a list of items needed in order to replicate this demo.
- Hardware
- EVAL-ADICUP3029
- EVAL-CN0569-PMDZ
- Mirco USB to USB cable
- PC or Laptop with a USB port
- Software
- no-OS/ repository and specifically the example project
- pyadi-iio/ repository and specifically the examples
- CrossCore Embedded Studio (2.10.1 or higher)
- ADuCM302x DFP (3.2.0 or higher)
- ADICUP3029 BSP (1.1.0 or higher)
- Python 3
- GNU make (added in path) or the pre-compiled .hex file
Setting up the Hardware
- Connect the EVAL-CN0569-PMDZ to the EVAL-ADICUP3029 via the P9 connector. Use pins 3-6 on the CN0569 PMOD connector to connect to the top row of the P9 PMOD connector on the ADICUP3029 board. Pins 1 an 2 will remain unconnected towards the center of the motherboard. Your setup should look like in the picture below.
- Use a mother-to-father breadboard wire to connect pin 1 from the CN0569 to pin 5 on the ADICUP3029 P7 header. The connection should look like in the below picture. What this does is connecting the GPIO0 of the APDP1080 to one of the interrupt GPIOs from the ADuCM3029. We will use theis to calibrate the system clocks.
- Connect a micro-USB cable to P10 connector of the EVAL-ADICUP3029 and connect it to a computer.
Building the software
After installing CrossCore Embedded Studio and necessary support pack the user can open a command line terminal (with admin privileges on Windows) and navigate to the project folder in the cloned no-OS repository. There the following list of commands can be used:
make
This is the complete compilation process. It is made up of three rules, that can be used separately: project, update, build
make project
- creates the build directory and the required directory structure
- uses SDK to create a project under the build directory
make update
- updates the no-OS sources under the build directory with files specified in src.mk
make build
- performs the build of files under the build directory using gcc
make sdkbuild
- performs the build of files under the build directory using SDK
When modifications are performed, the following three commands trigger the necessary clean actions:
make clean
- deletes the artifacts generated during build
make reset
- deletes the build directory (this results in a fresh setup for starting the complete compilation process)
make sdkclean
- cleans the artifacts (.o, .elf, .hex, etc.) created by the build command using the SDK
make run
- downloads and runs the executable on the target board
make debug
- downloads the executable on the target board and opens a command-line gdb instance to
debug it (only on some platforms)
Workflows
Compilation Using Generic Tools
Compilation Using Platform-Specific Tools
Running the example
After the controller has been programmed and the firmware is running on the ADICUP3029 the IIO server is up and a connection to it can be established. This can be done either by using IIO-Oscilloscope or the pyadi-iio code.
To use the gesture sensor and theremin examples, the python library must be installed first using pip:
pip install pyadi-iio
After the installation is complete the example must be configured to connect to the correct COM port. For the theremin example that means changing line 97 accordingly, with the correct COM port number.
The example can then be run using:
python cn0569_theremin_module.py
Obtaining the Software
There are two basic ways to program the ADICUP3029 with the software for the CN0569.
- Dragging and Dropping the .Hex to the Daplink drive
- Building and debugging using CCES and the command line
Using the drag and drop method, the software is going to be a version that Analog Devices creates for testing and evaluation purposes. This is the EASIEST way to get started with the reference design
Importing the project into CrossCore is going to allow you to change parameters and customize the software to fit your needs, but will be a bit more advanced and will require you to download the CrossCore toolchain.
The software for the ADuCM3029_demo_cn0569 can be found here:
Prebuilt CN0569 Hex File for the EVAL-ADICUP3029
The name of the file is currently iio_adpd1080.zip
Github release is in progress. Please use this pre-generated hex file. (To be removed after release.)
CN0569 Firmware Source Files
CN0569 Python Application Examples
How to use the Tools
The official tool we promote for use with the EVAL-ADICUP3029 is CrossCore Embedded Studio. For more information on downloading the tools and a quick start guide on how to use the tool basics, please check out the Tools Overview page.
Useful Links
End of Document
resources/eval/user-guides/circuits-from-the-lab/cn0569/sw.txt · Last modified: 11 May 2022 11:02 by Andrei Drimbarean