Introduction
Electronic Drive Development Platform (EDDP) provides all necessary software and hardware components for development and evaluation of motor control applications. While those components (both software and hardware) can also be used separatly this manual describes EDDP usage with default reference hardware platform (EDDP Kit) only.
Hardware components/boards delivered in EDDP Kit are not intended to be used in finished products. All the software and hardware parts of the EDDP are intended for Developers evaluating Motor Control Applications with Xilinx FPGA and/or SoC Devices.
Requirements for Evaluation with the Kit
The following is required in addition to what is supplied in the EDDP Kit:
- Micro-USB Cable for the USB console of the Controller Board.
- Ethernet-based LAN with a DHCP server.
- RJ45 ethernet Cable.
- Computer with web broweser to access the Web UI.
In order to pass EMC radiatied emission (EN 55011) class B requirements option "Spread Spectrum" must be activated (standard setting).
Software version that was used in EMC test: (Visible in the GUI main scren) 2017-7-31 (SVN Tag 5745).
Requirements for Development
The following is required in addition to what is supplied in the EDDP Kit:
- Basic knowledge of Xilinx All Programmable FPGA and/or SoC devices, basic knowledge of Xilinx SDK and C/C++ programming in order to be able to adapt the firmware to your requirements.
- A PC capable of running the Xilinx SDSoC 2017.1 and a web Browser for the Web UI.
- Micro-USB Cable for the JTAG and USB console of the Controller Board.
- Ethernet-based LAN with a DHCP server.
- RJ45 ethernet Cable.
Installation
todo
EDDP System Components
Hardware - TODO
EDDP Kit Content
- Control Board: ARTY-Z-7010
- EDPS Driver Board: TEC0053
- EDPS Motor Adapter Board: TEC0060
- EDPS Reference Motor with Encoder: BLRW-111D-24V-10000-1000-SI
- One 6 Pin PMoD cable
- Micro SD Card
<< todo INSERT FOTO with full kit all parts visible, also power supply etc..>>
Software
The software consists of the following parts:
- A Linux operating system.
- Kernel driver for providing access to the IP cores and buffer memory for the data capture
- A user-space program that provides access to the motor control IP cores through the Network API and simultaneously serves as a Web server.
- A user interface in the form of a Web UI to the Network API.
The Web UI lets one to operate the motor in one of the following modes:
- Speed control.
- Stator current Iq control.
To access the Web UI, point a web browser to the IP of the Controller Board. The following web site appears:
Motor
The default motor is supplied in the EDDP Kit; see the chapter Reference Motor for details
A custom motor must be a three-phase synchronous motor with a quadrature encoder (either single-ended or differential outputs) in order to be able to controlled with the default firmware supplied.
Block Diagram - TODO
Functional description - TODO
A 3-phase motor with an encoder is connected to a TEC0053 board. The TEC0053 board boards consists of a 3-phase power stage to be driven by bipolar PWM signals, current transducers and ADCs to monitor current on 2 (optionally 3) phases and isolating circuitry to provide electrical isolation for the signals on the Control Board Connector.
A TEC0060 board, included in the EDDP Kit, is used as a mechanical and electrical adaptor for the reference motor.
A Control Board connected to the TEC0053 provides the PWM signals for the TEC0053 and the clock signal to the ADC-s; the ADC datastream is read by the Control Board.
TODO: elaborate.
List of the documents for further information:
Title | Description |
---|---|
FOC SDSoC | Implementation of a Field-Oriented Control algorithm in C++ with Vivado SDSoC |
SDSoC Hardware Platform ARTY-Z7 | A basis for building Vivado SDSoC applications running on an Arty-Z7 board connected to a TEC0053 board |
AXI4-Stream AD7403 | An IP core for filtering the delta-sigma bitstream read from one or more ADC-s of type of AD7403 to an AXI4-Stream of samples |
AXI4-Stream Encoder | An IP core for converting impulses from a relative index encoder with an index signal to an AXI4-Stream of position and speed data |
AXI4-Stream PWM | An IP core for generating PWM signals according to the input AXI4-Stream |
AXI4-Stream Concat | An IP core for concatenating AXI4-Streams |
Web GUI | A Web UI to control and monitor an EDPS board over the Network API |
Network API | A communication protocol, based on Websockets, to control an EDPS board |
Embedded Linux Code | A server program interfacing to an EDPS board and implementing the Network API and the functions of a Web Server |
Control Board
The default Control Board is the Digilent ARTY-Z 7010, which is delivered as part of the EDDP Kit. This manual contains information relevent to the actual use of the ARTY-Z as a Control Board within the EDDP only; all technical data and user guides and manuals for the Controller Board are provided by the controller board manufacturer.
Disclaimer
Document Warranty
The material contained in this document is provided “as is” and is subject to being changed at any time without notice. Trenz Electronic does not warrant the accuracy and completeness of the materials in this document. Further, to the maximum extent permitted by applicable law, Trenz Electronic disclaims all warranties, either express or implied, with regard to this document and any information contained herein, including but not limited to the implied warranties of merchantability, fitness for a particular purpose or non infringement of intellectual property. Trenz Electronic shall not be liable for errors or for incidental or consequential damages in connection with the furnishing, use, or performance of this document or of any information contained herein.
Limitation of Liability
In no event will Trenz Electronic, its suppliers, or other third parties mentioned in this document be liable for any damages whatsoever (including, without limitation, those resulting from lost profits, lost data or business interruption) arising out of the use, inability to use, or the results of use of this document, any documents linked to this document, or the materials or information contained at any or all such documents. If your use of the materials or information from this document results in the need for servicing, repair or correction of equipment or data, you assume all costs thereof.
Copyright Notice
No part of this manual may be reproduced in any form or by any means (including electronic storage and retrieval or translation into a foreign language) without prior agreement and written consent from Trenz Electronic.
Technology Licenses
The hardware / firmware / software described in this document are furnished under a license and may be used /modified / copied only in accordance with the terms of such license.
Environmental Protection
To confront directly with the responsibility toward the environment, the global community and eventually also oneself. Such a resolution should be integral part not only of everybody's life. Also enterprises shall be conscious of their social responsibility and contribute to the preservation of our common living space. That is why Trenz Electronic invests in the protection of our Environment.
REACH, RoHS and WEEE
REACH
Trenz Electronic is a manufacturer and a distributor of electronic products. It is therefore a so called downstream user in the sense of REACH. The products we supply to you are solely non-chemical products (goods). Moreover and under normal and reasonably foreseeable circumstances of application, the goods supplied to you shall not release any substance. For that, Trenz Electronic is obliged to neither register nor to provide safety data sheet. According to present knowledge and to best of our knowledge, no SVHC (Substances of Very High Concern) on the Candidate List are contained in our products. Furthermore, we will immediately and unsolicited inform our customers in compliance with REACH - Article 33 if any substance present in our goods (above a concentration of 0,1 % weight by weight) will be classified as SVHC by the European Chemicals Agency (ECHA).
RoHS
Trenz Electronic GmbH herewith declares that all its products are developed, manufactured and distributed RoHS compliant.
WEEE
Information for users within the European Union in accordance with Directive 2002/96/EC of the European Parliament and of the Council of 27 January 2003 on waste electrical and electronic equipment (WEEE).
Users of electrical and electronic equipment in private households are required not to dispose of waste electrical and electronic equipment as unsorted municipal waste and to collect such waste electrical and electronic equipment separately. By the 13 August 2005, Member States shall have ensured that systems are set up allowing final holders and distributors to return waste electrical and electronic equipment at least free of charge. Member States shall ensure the availability and accessibility of the necessary collection facilities. Separate collection is the precondition to ensure specific treatment and recycling of waste electrical and electronic equipment and is necessary to achieve the chosen level of protection of human health and the environment in the European Union. Consumers have to actively contribute to the success of such collection and the return of waste electrical and electronic equipment. Presence of hazardous substances in electrical and electronic equipment results in potential effects on the environment and human health. The symbol consisting of the crossed-out wheeled bin indicates separate collection for waste electrical and electronic equipment.
Trenz Electronic is registered under WEEE-Reg.-Nr. DE97922676.