...

Introduction

The Electronic Drive Development Platform (EDDP) provides all necessary software and hardware components for development and evaluation of motor control applications. While those these components (both software and hardware) can also be used separatly separately, this manual describes EDDP usage with default reference hardware platform (EDDP Kit) only.

Use of Terms

The terms and acronyms used in the EDDP User Manual and EDPS User Manual are listed in the Table 1.

Table 1: Terms and acronyms used.

Requirements for

...

the

...

Functional Test

The purpose of the Functional Test is to verify the functionality of the hardware by using the default firmware supplied.

Following items are 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 browser to access the Web UI.
• Card reader supporting micro-SD Cards.
• Access to internent internet (to download SD Card images).

...

Requirements for the Development

...

Requirements for the development with SDSoC:

• All items listed under the Requirements for Functional Test.
• 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 Xilinx SDSoC 2017.1 development environment.
• A valid Xilinx SDSoC license or voucher.

Requirements for the development with HLS:

• All items listed under Requirements for Functional Test.
• 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.
• Valid Xilinx SDSoC License or Voucher.
• Card reader supporting micro-SD Cards.
• Access to internent (to download SD Card images).

 

Installation

todo

EDDP System Components

Hardware - TODO

• Vivado 2017.1

Installation

Hardware Assembly

When delivered as full EDDP Kit several components are pre-assembled.

Motor Adapter Board

The Reference Motor with Encoder is connected to the EDPS Board using the Adapter Board (see Figure 1). In the EDDP Kit the Reference Motor is pre-assembled.

Image Added

Figure 1: Top view of the EDPS Board with the Adapter Board mounted.

The Adapter Board is mounted to the EDPS Board using 5 x M6 screws (Labels 0V, A, B, C, 12V on Adapter Board) and with M3 screws and spacer - marked 12V at the left. This Adapter Board "forwards" (the yellow arrow) the EDPS Board pre-driver supply (12V) to the DC Link main terminal on the EDPS board, so that separate DC Link power supply is not needed allowing easy evaluation of the complete system.

Note terminal marked+DC must be left open when using the Adapter Board!

Image Added

Figure 2: M3 spacer and two M3 screws connect 12V from the EDPS board to the Adapter Board.

Motor Connection

In the EDDP Kit the Reference Motor stator wires for all three phases are already connected to the Adapter Board. Instructions for manual assembly below:

Image Added

Figure 3: Red dots and arrow mark the place where wire terminal can be released for insertion or removal.

Use a ball-point pen or similar tool to apply gentle force at the dot to release the wires. Do not try to remove the wires by simply pulling them out without releasing them first! Do not apply force in any other region of the white plastic except as marked, because it is easy to damage the plastic.

Encoder Connection

One 6-pin Pmod cable is included with the EDDP Kit. It is already assembled between the encoder and the EDPS Board. Instructions for manual assembly are below:

Image Added

Figure 4: Pmod cable alignment to the Encoder connector.

Notice that there are 5 pins in the Encoder header while the PMoD female connector has 6 terminals. Red Arrow marks the "empty" terminal at the PMoD Cable.

Image Added

Figure 5: Pmod cable installation.

Pin 1 markings are indicated with the arrows, on the EDPS Board a white dot marks 6-pin Pmod header pin 1. This pin should be aligned to the Encoder Pin marked "G" and "1" visible when looking from the bottom up. Please note that Encoder header has 5 terminals while the driver board and Pmod cable have 6 terminals.

Network configuration on the Host PC (Optional)

An overview of network configuration and some methods for network troubleshooting are given.

It is assumed that the operating system on the Host PC is Microsoft Windows 7 or newer. For other operating systems, the basic network principles are the same, but the means of configuration are different; consult the corresponding user guides.

Open the Control Panel and click on the Network and Sharing Center. The following window appears:

Image Added

Figure 6: The Network and Sharing Centre, with the network connection used for communication with the Control Board highlighted.

Viewing network connection status

Locate the network connection that is to be used for communication with the Control Board and click on it. The network connection status dialog appears (Figure 7).

Image Added

Figure 7: A network connection status dialog, with the media status and number of bytes sent and received highlighted.

For normal operation, the media state should read "Enabled".

During normal operation, the number of bytes sent and received should increase when there is network traffic, for example, when pinging the Control Board, when operating the Web UI, when pinging, etc.

Checking network connectivity to the Control Board

On the Start Menu, select "All Programs" → "Accessories" → "Command Prompt. A command prompt window appears. Enter the command

    ping IP

where IP is the IP address of the Control Board. The result should be similar to the one on the following figure (Figure 8):

Image Added

Figure 8: Successful check of network connectivity to the Control Board. The command entered by the user is highlighted, as are the important keywords that should be present in the output of the command "ping".

Note: After a recent change of network settings, it can happen that the ping is not successful because the changes haven't propagated to the other participiants on the network yet. It can be sometimes remedied by running the command "ping" on the other computer, in this case, on the Control Board, pinging the IP address of the Host PC.

Verifying network adapter settings

In the network connection status dialog (Figure 7), click "Details". A Network Connection Details dialog appears: 

Image Added

Figure 8: A Network Connection Details dialog, with the important IP settings highlighted.

The network settings should be such that the Control Board is reachable from the Host PC. In the case when they are in the same network segment (gateway is not involved), the following conditions should hold:

1. The subnet mask should be the same for the Control Board and the Host PC.
2. The IP addresses for the Control Board and Host PC must be different.
3. The subnet mask divides the IP address into two parts according to the the bits set in the binary notation (255 in decimal = 11111111 in binary):
   1. The network address, which corresponds to the the bits set in the subnet mask. This should be the same for the Control Board and the Host PC.
   2. The host address, which corresponds to the bits not set in the subnet mask. This should be different for the Control Board and the Host PC. Additional constraint: it cannot be neither null nor the maximum value.

On the example of settings shown on Figure 8 and the default configuration in the default firmware, the conditions are fulfilled as follows:

1. The subnet mask, 255.255.255.0, is the same for both.
2. The IP addresses, 192.168.42.100 for the Host PC and 192.168.42.123 for the Control Board, differ.
3. The subnet mask checks out as follows:
   1. The network address, 192.168.42.0, is the same for the Host PC and the Control Board.
   2. The host addresses, 0.0.0.100 for the Host PC and 0.0.0.123 for the Control Board, are different. In addition, neither is 0 nor the maximum value, 255 in this case.

Alternative method of viewing network settings: Open command prompt (see Figure 8) and execute the following command:

    ipconfig

It will list all network connections and their associated IP addresses.

Changing the IP settings of a network connection

On the network connection status dialog (Figure 7), click "Properties". The following dialog (Figure 9) appears:

Image Added

Figure 9: A network connection properties dialog. The item "Internet Protocol Version 4 (TCP/IPv4)" is selected and highlighted.

In the list of items used, select "Internet Protocol Version 4 (TCP/IPv4)" and click "Properties". The following dialog appears:

Image Added

Figure 10: A TCP/IPv4 Properties dialog.

The settings on this dialog have to match the actual network settings.

In most network setups, settings are as follows:

• Checked: Obtain an IP address automatically.
• Checked: Obtain DNS server address automatically.

In the case when using an network adapter dedicated solely for nothing else but communication with the Control Board, a static IP configuration (as shown on Figure 10) is to be used as follows:

• Checked: Use the following IP address:
  • IP address: 192.168.42.100
  • Subnet mask: 255.255.255.0
  • Default gateway: not configured.

Other cases are not considered here; consultation with network administration and/or appropriate handbooks is recommended.

EDDP System Components

Image Added

Figure 11: EDDP Kit assembly.

EDDP Kit Content

1. Control Board: ARTY-Z-7010
2. EDPS Driver Board: TEC0053
3. EDPS Motor Adapter Board: TEC0060
4. EDPS Reference Motor with Encoder: BLRW-111D-24V-10000-1000-SI
5. Plastic DEMO load for Motor
6. One 6 Pin PMoD cable
7. Two 12V Power Supplies
8. Screws and other accessories used to mount the motor
9. One spare M6 Screw
10. Plastic cover for Driver Board use without TEC0060
11. 30A Fuse for Driver Board use without TEC0060
12. Micro SD Card
13. Quickstart Guide

<< 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 I_q control.

To access the Web UI, point a web browser to the IP of the Controller Board. The following web site appears:

Image Removed

Motor

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 (Digilent Inc.). Use of the other Control boards with the EDPS Board is also outside the scope of this manual. Primary support for other control boards is currently provided by QDESYS.

Software

The software delivered on the SD card configures the FPGA on the ARTY-Z board with the Field-Oriented Control algorithm and starts the web server to serve the Web UI.

To observe the IP address of the Control Board, open the USB serial console at the baud rate of 115200 shortly after powering up the Control Board. There should be boot messages on the console and they should contain the IP address shown on the following Figure:

Image Added

Figure 12: USB serial console log, with the network status message and IP address obtained via DHCP highlighted.

In the case the boot message was not seen for any reason, the network configuration can be seen by logging in as "root" with the password "root" and executing the command "ifconfig" as shown on the following figure:

Image Added

Figure 13: USB serial console, with login dialog, command "ifconfig" and the IP address highlighted.

To access the EDDP Web UI, enter IP address of the Control Board to the web browser address field. The following page appears:

Image Added

Figure 14: The Web UI.

To start the motor, click the button "Motor". The motor will make 3 rotations in order to make sure that encoder finds the initial position before starting in correct mode and the button will turn red. To stop the motor, click the button "Motor" again; the button will turn green.

The gauges show the stator current I_q and the motor speed in RPM.

To see the charts live, enable checkbox "Live charts". The following charts are available:

• I_a,I_b - shows stator currents I_a,I_b, the calculated current I_c and motor speed.
• I_d,I_q - shows stator currents I_d, I_q and motor speed.
• V_d,V_q - shows stator voltages V_d and V_q.

The radio buttons "Current" and "Speed" permit switching the control modes.

The sliders permit selecting the target speed and target current when in the appropriate mode. The direction radio buttons "Forward" and "Reverse" will be changed accordingly when the sign of the value is changed.

The radio buttons "Forward" and "Reverse" can be used to change the direction; the target slider will be changed accordingly.

Motor/Encoder

The Reference Motor The default motor is supplied in the EDDP Kit; see the chapter Reference Motor in the EDPS User Manual for details. Use of custom motors is outside the scope of this manual. 

Block Diagram - TODO

Functional description

...

A 3-phase permanent-magnet synchronous motor with

...

attached encoder and mechanical load is mounted to a EDPS Board by using an Adapter Board. The EDPS Board is connected to a

...

Control Board through PMOD connectors. A Host PC running a Web Browser connects to the Control Board through a Network.

On the EDPS Board, the 3-phase power stage

...

drives the motor according to the PWM signal. The current transducers on the Driver Board transform the phase currents on 2 (optionally 3) phases

...

into voltages, which, along with the DC Link voltage, are converted by ADC-s into a delta-sigma bitstream. The encoder signals and the sigma-delta bitstream are passed through the galvanic isolation to the Control Board. The PWM signal and ADC clock from the Control Board are passed through the galvanic isolation as well.

On the Control Board, the FPGA configuration is determined with the SDSoC Application built on top of the SDSoC Hardware Platform and the ARM Cortex-A9 CPU is running the Embedded Linux Code.

The SDSoC Hardware Platform provides a stream-oriented interface of the underlying hardware to the FOC algorithm. The streams are as follows:

1. The data stream to the FOC algorithm consists of the concatenated stream of rotor angle and motor speeds and the stream of discrete ADC samples.
2. The stream of PWM duty cycles from the FOC algorithm, which are converted to the PWM signals for the power stage.
3. The stream of monitor data from the FOC algorithm, which is captured and written to the DMA buffer in the main memory. This monitor data stream consists either of phase current data, stator current data or stator voltage data.

The SDSoC Application provides the FOC algorithm. The FOC algorithm operates on the AXI4 Stream to and from the SDSoC Hardware Platform and provides a set of AXI registers to control and monitor the status of the FOC algorithm. The control registers determine the FOC algorithm operating parameters and the source of the monitor data stream.

 

The Embedded Linux Code, running on the ARM Cortex-A9 CPU consists of the following:

1. The Linux OS, that manages the hardware and provides execution environment for the programs to run in, which includes a TCP/IP network stack. The drivers included provide access to the control and status registers of the FOC algorithm and to the DMA buffer of the monitor data stream.
2. The Network API, a server program, which provides an API built on top of Websockets protocol to control and monitor the FOC algorithm and to capture the monitor data stream.
3. The Web Server, which is used to host the Web UI.

The Web UI running in a web browser on the Host PC enables use of the EDDP Kit from anywhere in the network.

Block Diagram

Image Added

Figure 15: Block diagram of the EDDP.

FPGA resources utilization

An excerpt of the FPGA resource utilization by the FOC SDSoC Application Project is shown in the Table 2. The FPGA used on the Controller Board is Xilinx 7z010clg400-1.

The power draw of the design is about 220mW as measured by the increase of the power draw of the Control Board after configuring the FPGA.

Table 2: FPGA resources utilization.

List of additional documents

The additional documents, listed in the Table 3,  can be downloaded from Trenz EDDP Web Hub:

http://trenz.org/EDDP

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:

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.

Table 3: List of additional documents.

References

All resource links for other relevant documents and websites are available from Trenz EDDP Web Hub:

http://trenz.org/EDDP

Document Change History

Table 4: Document change history.