PiXtend V2 Software Manual Revision 10/08/18, V1.12 Qube Solutions GmbH Arbachtalstr. 6, 72800 Eningen, Germany https://www.pixtend.com PiXtend V2 Software Manual Version History Version Date Description Editor 1.00 13/10/2017 Document created, first release RT CODESYS Package renamed to 1.01 13/11/2017 RT PiXtend V2 Professional for CODESYS 1.02 20/01/2018 Signaling for error LED L1 added RT Name of the SD image adapted from "Linux Tools" to 1.03 26/01/2018 "Basic". The Basic Image contains more than just the TG classic PiXtend Linux tools 1.04 13/02/2018 Information about OpenPLC added RT CODESYS I/O mapping overview and device paramter 1.05 20/02/2018 RT description added 1.06 26/02/2018 CODESYS Retain memory usage example introduced RT Change Python Library V2 link to version 0.1.1, the 1.07 05/03/2018 previous version had a problem where the GPIO PullUps RT could not be used as intended 1.08 28/03/2018 Raspberry Pi 3 B+ added as a compatible model RT 1.09 18/07/2018 Information for the PiXtend V2 -L- added RT - PiXtend V2 -L- Process data + Control- & Statusbytes 1.10 31/07/2018 section added TG - UG (limited liability) chnaged to GmbH OpenPLC section updated to version 3 of OpenPLC, 1.11 06/08/2018 RT including information on PiXtend V2 -L- Added information on how to find out a Raspberry Pi‘s IP 1.12 10/08/2018 RT address and how to use the PiXtend V2 DAC in COEDSYS www.pixtend.com Copyright by Qube Solutions GmbH 2 / 317 PiXtend V2 Software Manual Table of Contents 1. About this Documentation..................................................................................................7 1.1. Scope..........................................................................................................................7 1.2. Copyright.....................................................................................................................7 1.3. Names, Brands, Wordmarks and Images...................................................................8 1.4. Symbols......................................................................................................................9 2. Important Information.......................................................................................................10 2.1. Subject to Change....................................................................................................10 2.2. Intended Use............................................................................................................10 2.3. Technical Condition...................................................................................................11 2.3.1. PiXtend V2 -S- model........................................................................................11 2.3.2. PiXtend V2 -L- model........................................................................................12 2.4. Certificates................................................................................................................13 2.5. Safety Instructions....................................................................................................14 2.6. Disclaimer.................................................................................................................15 2.7. Contact information...................................................................................................15 2.8. Assistance.................................................................................................................15 3. Overview..........................................................................................................................16 4. Prerequisites....................................................................................................................16 5. Licenses...........................................................................................................................17 6. Basic knowledge..............................................................................................................18 6.1. Definition "Safe State"..............................................................................................18 6.2. SPI Communication, Data Transmission and Cycle Time........................................18 6.3. Retain Memory.........................................................................................................20 6.4. Preparing a SD card.................................................................................................22 6.5. Find network address (IP address) of a Raspberry Pi.............................................24 6.6. Raspbian Login Information (Login).........................................................................26 6.7. Turning off the Raspberry Pi.....................................................................................27 6.8. Compatibility of the Software Components..............................................................28 6.9. Enable Serial Interface.............................................................................................28 7. CODESYS........................................................................................................................30 7.1. Information................................................................................................................31 7.1.1. Copyright of texts and images:..........................................................................31 7.1.2. Compatibility......................................................................................................31 7.2. Prerequisites.............................................................................................................32 7.2.1. System Requirements for CODESYS...............................................................32 7.2.2. Required Hardware...........................................................................................32 7.3. Installation of the required Software Components...................................................33 7.3.1. CODESYS Development System.....................................................................33 7.3.2. CODESYS Control for Raspberry Pi installation...............................................35 www.pixtend.com Copyright by Qube Solutions GmbH 3 / 317 PiXtend V2 Software Manual 7.3.3. Create a bootable SD-Card for the Raspberry Pi.............................................37 7.3.4. PiXtend V2 CODESYS device driver installation..............................................38 7.4. Further steps.............................................................................................................38 7.5. CODESYS – Create a project..................................................................................39 7.5.1. Step by Step to the first PiXtend V2 CODESYS program................................39 7.5.2. Step by Step to your first CODESYS Webvisu.................................................56 7.6. Step by step to your first DAC program....................................................................60 7.6.1. Create CODESYS Standard Project for PiXtend..............................................60 7.6.2. Add SPI device..................................................................................................62 7.6.3. Add PiXtend V2 DAC device.............................................................................65 7.6.4. Create Global Variable List................................................................................67 7.6.5. Mapping of variables.........................................................................................68 7.6.6. Task Configuration.............................................................................................70 7.6.7. Creating the main program................................................................................70 7.6.8. Connect to PiXtend V2 and download program................................................71 7.6.9. Create CODESYS Webvisu..............................................................................72 7.7. CODESYS Serial Communication............................................................................77 7.7.1. Prerequisites......................................................................................................77 7.7.2. RS232 Interface - Connecting the cable...........................................................77 7.7.3. RS485 Interface - Connecting the cable (only PiXtend V2 -L-)........................78 7.7.4. Preparing Linux.................................................................................................79 7.7.5. Terminal Program..............................................................................................81 7.7.6. CODESYS.........................................................................................................82 7.8. CAN-Bus Communication.........................................................................................85 7.8.1. introduction........................................................................................................85 7.8.2. Hardware connection to the CAN bus...............................................................86 7.8.3. Preparation and test under Linux......................................................................87 7.8.4. Preparations for CODESYS..............................................................................93 7.8.5. CODESYS project with CANopen.....................................................................96