xilinx/iiot-spyn

IIoT-SPYN gives users the ability to control, monitor, capture data, visualize and analyze industrial grade motors

IIoT-SPYN

IIoT-EDDP: Industrial IoT Electric Drive Demonstration Platform is an open-source project that provides all necessary software and hardware components for development and evaluation of motor control applications.

PYNQ: Python on Zynq is an open-source project from Xilinx that makes it easy to design embedded systems with Zynq All Programmable Systems on Chips (APSoCs). Using the Python language and libraries, designers can exploit the benefits of programmable logic and microprocessors in Zynq to build more capable and exciting embedded systems.

IIoT-SPYN: Industrial IoT SPYN is an open source project that leverages IIoT-EDDP and PYNQ. Using IIoT-SPYN users can control, monitor, capture data, visualize and analyze Industrial grade motors.

IIoT-SPYN is intended to work with the EDDP kit. Here is the link to purchase the kit: EDDP Kit

Quick Start for Arty-Z7-10

Step 1: Download the Arty-Z7-10 PYNQ image

Step 2: Write the image file to a SD card

Step 3: Use the following command in a terminal to install IIoT-SPYN

$ sudo pip3 install --upgrade git+https://github.com/Xilinx/IIoT-SPYN.git
$ sudo reboot now

After the setup, new Jupyter notebooks will be added under the spyn folder, ready to try out, no additional steps are needed.

Quick Start for Pynq-Z1 / Arty-Z7-20

Step 1: Download the PYNQ image

Step 2: Write the image file to a SD card

Step 3: Use the following command in a terminal to install IIoT-SPYN

$ sudo pip3 install --upgrade git+https://github.com/Xilinx/IIoT-SPYN.git
$ sudo reboot now

After the setup, new Jupyter notebooks will be added under the spyn folder, ready to try out, no additional steps are needed.

Folder Structure

• images : contains images that are used in the jupyter notebooks
• notebooks : contains jupyter notebooks that interact with the motor
• spyn : package that contains lib and overlays folders
  • spyn/lib: contains library files of the IIoT-SPYN project.
  • spyn/overlays : contains the bitstream and the tcl file.

Supported Boards

• Arty-Z7-7020
• PYNQ-Z1
• Arty-Z7-7010 support added 5.11.2018

Licenses

PYNQ License : BSD 3-Clause License

IIoT-EDDP License : BSD 3-Clause License

IIoT-SPYN License: BSD 3-Clause License

iiot-spyn's Issues

DASH notebook f/b

DASH Notebook - two small items:

1. I would add image of what DASH would look like at top of the notebook.
2. For all the pink warning text, I think you can minimize that cell when you save it (or cut directly out of the saved ipynb). All that messy text is expected, but you don't want it visible on github.

feedback

A few things to improve are:

1.   Setup.py we can delete unused functions.
   

2.   Notebooks can use small letters as file names. Inside SPYN-Starter_Demo_125_DASH.ipynb
   

I think usually we do not show red message (looks like an error!). Pictures can be put into a sub folder.
3. Overlays folder: maybe we want to rename them edpp is not a good name I assume. Maybe we should give a more meaningful (but still short) name.

PYNQ v2.1 dependencies

Does PYNQ v2.1 out-of-the-box have dependencies met for this repo?

Let us know what is needed and we would consider adding packages.

Dash is currently only working with static IP

Test setup.py and notebook

A question about api

In the description of class Motor_Controller:
def _read_controlreg(self, value): result = self.mmio_control.read(value) return result
Should the argument "value" transfer to "offset"?