Beijer Electronics GL-9981-C-1 User Manual

Programmable io module, embedded pio, open linux (debian), docker support

Hide thumbs

Table Of Contents

Quick Links

Download this manual

User Manual

GL-9981-C-1, GL-9981-L Programmable

IO Module

Embedded PIO, Open Linux (Debian), Docker support

Doc ID: 53954

2025-02-21

Table of Contents

Need help?

Do you have a question about the GL-9981-C-1 and is the answer not in the manual?

Questions and answers

Summary of Contents for Beijer Electronics GL-9981-C-1

Page 1 User Manual GL-9981-C-1, GL-9981-L Programmable IO Module Embedded PIO, Open Linux (Debian), Docker support Doc ID: 53954 2025-02-21...
Page 2 The information in this document is subject to change without notice and is provided as available at the time of printing. Beijer Electronics AB reserves the right to change any information without updating this publication. Beijer Electronics AB assumes no responsibility for any errors that may appear in this document.
Page 3: Table Of Contents
4.1. Enviromental Specifications ..............9 4.2. General Specifications ................9 4.3. Interface Specifications ................ 10 4.4. GL-9981-L Specifications ............... 10 4.5. GL-9981-C-1 Specifications ..............10 5. Connectors and Ports ..................12 5.1. Wiring Diagram .................. 12 5.2. RJ-45 Socket ..................12 5.3.
Page 4 13.7. Functions Used in PibusIoTest.c ............. 48 13.8. Compile PibusIoTest.c in the Terminal ............49 13.9. Use the Geany Editor on Raspberry Pi ............50 2025-02 Beijer Electronics, Doc ID: 53954...
Page 5: About This Manual
About This Manual 1. About This Manual This manual contains information on the software and hardware features of the Beijer Electronics GL-9981 Programmable IO Module. It provides in-depth specifications, guidance on installation, setup, and usage of the product. 1.1. Symbols Used in This Manual This publication includes Warning, Caution, Note and Important icons where appropriate, to point out safety-related, or other important information.
Page 6: Safety
Before using this product, please read this manual and other relevant manuals carefully. Pay full attention to safety instructions! In no event will Beijer Electronics be responsible or liable for damages resulting from the use of this product. The images, examples and diagrams in this manual are included for illustrative purposes. Because of the many variables and requirements associated with any particular installation, Beijer Electronics cannot take responsibility or liability for actual use based on the examples and diagrams.
Page 7: About The G-Series System
IP, EtherCAT, PROFINET, CC-Link IE Field, PROFIBUS, CANopen, DeviceNet, CC-Link, MODBUS/Serial etc. • Expansion Module - Expansion module types: Digital IO, Analog IO, and Special modules. • Messaging - The system uses two types of messaging: Service messaging and IO messaging. Beijer Electronics, Doc ID: 53954 2025-02...
Page 8: Io Process Data Mapping
Valid parameter data depends on the modules in use. For example, analog modules have settings of either 0-20 mA or 4-20 mA, and temperature modules have settings such as PT100, PT200, and PT500. The documentation for each module provides a description of the parameter data. 2025-02 Beijer Electronics, Doc ID: 53954...
Page 9: Specifications
Make sure it has been shut down normally and then disconnect the power. ** If the load used exceeds the specifications, a throttling mode may occur due to heat, resulting in degraded performance or abnormal operation. The internal temperature must be less than 85°C. Beijer Electronics, Doc ID: 53954 2025-02...
Page 10: Interface Specifications
C/C++ (on Linux) 4.5. GL-9981-C-1 Specifications All GL-9981-C modules includes specific CODESYS capabilities based on the installed CODESYS Application-Based Runtime License. For instance, GL-9981-C-1 has the Control Basic L license. For further details about the CODESYS Application-Based Runtime License, refer to the CODESYS website.
Page 11 Specifications Programming environment CODESYS 3.5 SP19 Patch 4 Code size 3 MB Available I/O channels Fieldbuses Modbus TCP, 2 instances Communication OPC UA server, max. 512 tags Visualization Web Visualization, max. 128 tags Beijer Electronics, Doc ID: 53954 2025-02...
Page 12: Connectors And Ports
System power, ground Frame ground Field power, ground Field power, 24 V WARNING Never connect system power to field power! Use separate power supplies. 5.2. RJ-45 Socket For information on network installation, refer to chapter Network Installation. 2025-02 Beijer Electronics, Doc ID: 53954...
Page 13: Usb 2.0 Port
5.3. USB 2.0 Port USB 2.0 (Type-A) Signal name Description +5 VDC Data- Data+ Ground NOTE 250 mA continuous current per channel. 5.4. Monitor Port Monitor Signal Name Description TMDS Data2+ TMDS Lanes TMDS Data2 Shield Beijer Electronics, Doc ID: 53954 2025-02...
Page 14 TMDS Data1 Shield TMDS Data1- TMDS Data0+ TMDS Data0 Shield TMDS Data0- TMDS Clock+ TMDS Clock Shield TMDS Clock- CEC Remote Control Reserved DDC Clock DDC Data CEC/DDC/HEAC Ground Power EDID/DDC Hot Plug Detect 2025-02 Beijer Electronics, Doc ID: 53954...
Page 15: Buttons And Switches
OS installation is possible. Pin 2 ON EEPROM write protect. Write-protect to the onboard EEPROM that stores the boot code. WARNING Turn off the dip switch when the module is not in use. Beijer Electronics, Doc ID: 53954 2025-02...
Page 16: Led Indicator
LED Indicator 7. LED Indicator LED no. LED description LED color Module status Green Network status Green Custom Green/Red Expansion IO status Green/Red 2025-02 Beijer Electronics, Doc ID: 53954...
Page 17: Mod (Module Status)
Not powered Power is not supplied to the unit. Ethernet off LAN cable is not connected, or Ethernet is inactive. Ethernet activity Green LAN cable is physically connected to the Ethernet port and is active. Beijer Electronics, Doc ID: 53954 2025-02...
Page 18: Run (Custom Led)
• Detect invalid expansion module ID. • Initial protocol failure. • Mismatch vendor code between adapter and expansion module. • Changed expansion module configuration. • Too many expansion modules. • Communication failure. • Overflowed IO size. 2025-02 Beijer Electronics, Doc ID: 53954...
Page 19: Hardware Setup
Installation position is valid vertical and horizontal. The drawings are illustrative and may be out of proportion. CAUTION NOT following the space requirements may result in damaging the product. Beijer Electronics, Doc ID: 53954 2025-02...
Page 20 Hardware Setup 2025-02 Beijer Electronics, Doc ID: 53954...
Page 21: Mount Module To Din Rail
• GT-5XXX • GT-7XXX GN-9XXX modules have three locking levers, one at the bottom and two on the side. For mounting instructions, refer to Mount GN-9XXX Module. Mount to DIN rail Dismount from DIN rail Beijer Electronics, Doc ID: 53954 2025-02...
Page 22 8.3.2. Mount GN-9XXX Module To mount or dismount a network adapter or programmable IO module with the product name GN-9XXX, for example GN-9251 or GN-9371, see the following instructions: Mount to DIN rail Dismount from DIN rail 2025-02 Beijer Electronics, Doc ID: 53954...
Page 23: Mount Removable Terminal Block
Hardware Setup 8.4. Mount Removable Terminal Block To mount or dismount a removable terminal block (RTB), see the instructions below. Mount a removable terminal block Dismount a removable terminal block Beijer Electronics, Doc ID: 53954 2025-02...
Page 24: Connect Cables To Removable Terminal Block
To connect/disconnect cables to/from the removable terminal block (RTB), see the instructions below. WARNING Always use the recommended supply voltage and frequency to prevent damage to the equipment and ensure optimal performance. Connect cable Disconnect cable 2025-02 Beijer Electronics, Doc ID: 53954...
Page 25: How To Start The Module
9. How to Start the Module Turn on the power to boot up the device. After booting is complete, the BUS Scan process program is automatically executed. When the scan is completed, the IOS turns green. Beijer Electronics, Doc ID: 53954 2025-02...
Page 26: Ip Settings
IP Settings 10. IP Settings IP address 192.168.100.72 Subnet mask 255.255.255.0 Router 192.168.100.1 2025-02 Beijer Electronics, Doc ID: 53954...
Page 27: Configuration Diagrams
• Bus Scan Process (pibus.service) is automatically executed using SYSTEMD. • File location of pibus.service: /lib/systemd/system/pibus.service. • Location of actual executable file: /home/crevis/pibus/M_PibusScan. • Only one of the Linux Process or CODESYS process should be running (Cannot run concurrently). Beijer Electronics, Doc ID: 53954 2025-02...
Page 28: System Configuration Diagram
Configuration Diagrams 11.2. System Configuration Diagram 2025-02 Beijer Electronics, Doc ID: 53954...
Page 29: Codesys
SmartStore. 12.1. Download CODESYS Template Project A CODESYS template project file is available on the Beijer Electronics website. This file contains a complete project with all necessary files for an easy startup. Follow these steps to download and open the template:...
Page 30 11. Click Yes to activate user management on the device. 12. Enter the login credentials and click OK. 13. Write a test program and click Login in the top bar. 14. Click Start in the top bar to run the program. 2025-02 Beijer Electronics, Doc ID: 53954...
Page 31: Example: Activate Codesys License
Enter the Ticket ID, and click Next to complete the installation. 12.4. Add a Module XML to CODESYS Click Tools > Device Repository. Select the module XML, and click Open. After installation, the device will appear in the overview. Beijer Electronics, Doc ID: 53954 2025-02...
Page 32: I/O Control Functions In Codesys Project Example
Read the parameters of the specified slot. VAR_INPUT - Slot (slot number), pBuffer (buffer) VAR_OUTPUT - Execution result Set_Prm Write the parameters to the specified slot. VAR_INPUT - Slot (slot number), pBuffer (buffer) VAR_OUTPUT - Execution result 2025-02 Beijer Electronics, Doc ID: 53954...
Page 33 • io_rw_byte: The value to be written is stored in advance in the io_rw_byte buffer. • addr: Set variable for the starting address. • len: Set variable for the length. Refer to the Pibus_GL9981_Sample project for the complete program example. Beijer Electronics, Doc ID: 53954 2025-02...
Page 34: Add The Persistence Manager
CODESYS website. In CODESYS, click View > Modules. Click Add module library. Select AC_Persistence and click OK. Right click on project name and select Add Top-Level Module Instance. Select PersistenceManager and click Add Module. 2025-02 Beijer Electronics, Doc ID: 53954...
Page 35 All attributes have a reference to the file for the tags, marked in bold in the example below. Example PROGRAM PLC_PRG {attribute 'ac_persist' := 'PersistenceChannel1'} iMyInt: INT; //This variable is persistant wMyWord: WORD; //This tag is NOT persistant END_VAR Beijer Electronics, Doc ID: 53954 2025-02...
Page 36: Settings For Gl-9981-L (Linux Version)
Ensure that the cables are authentic and that all data lines are properly connected. Connect the module to the 24 VDC system power. Use rpi-boot program to recognize Raspberry Pi as a USB device. Download rpi-boot from the Raspberry Pi website. 2025-02 Beijer Electronics, Doc ID: 53954...
Page 37 Download and install Win32 Disk Imager from the Win32 Disk Imager website. Open Win32 Disk Imager. Select OS Image file. Select Device. Click Write. To save the OS in the module as an image file, click Read. Beijer Electronics, Doc ID: 53954 2025-02...
Page 38: Install Docker
Change the IP address: Open /etc/dhcpcd.conf for editing in nano. nano /etc/dhcpcd.conf In section interface eth0, change to your IP address and router (gateway) address. In the images below 192.168.1.210 and 192.168.1.1. Press CTRL+X to exit. 2025-02 Beijer Electronics, Doc ID: 53954...
Page 39 Settings for GL-9981-L (Linux Version) Press Y. Press Enter to save the file and reboot the hardware “Sudo reboot”. Beijer Electronics, Doc ID: 53954 2025-02...
Page 40 $(. /etc/os-release && echo "$VERSION_CODENAME") stable" | \ sudo tee /etc/apt/sources.list.d/docker.list > /dev/null sudo apt-get update Install the latest Docker packages: sudo apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin Press Y. Test the Docker engine: sudo docker run hello-world 2025-02 Beijer Electronics, Doc ID: 53954...
Page 41 Docker hub. Log in to the module in the console (e.g. CMD or Windows Power shell) with SSH “ssh beijer@192.168.100.72”. Default IP 192.168.100.72 Username beijer Password Jzy!q7 Beijer Electronics, Doc ID: 53954 2025-02...
Page 42 If a prototype is used, the existing port 10123 needs to be deactivated to avoid port conflicts. Log in to the portal with <IP:10123>. Create a user and a password. In the Settings section, click LISTEN PORT. Deactivate port and confirm. 2025-02 Beijer Electronics, Doc ID: 53954...
Page 43 Download the WebIQ server on X2 web App from Smart Store. Change the name from “webiq_2.15.6.bapp” to “webiq_2.15.6.zip” and copy “compose.yaml” from folder app to an USB stick and insert the USB stick in USB 1 (top) of the GL-998X-C-1. Verify correct operating system with uname: Uname -a Beijer Electronics, Doc ID: 53954 2025-02...
Page 44 Read out status and names of USB with fdisk: sudo fdisk -l Create a placeholder for USB drive (in this example USB1): sudo mkdir /media/USB1 Mount the drive to the placeholder: sudo mount /dev/sdb1 /media/USB1/ Install the WebIQ server from the USB drive: 2025-02 Beijer Electronics, Doc ID: 53954...
Page 45: Install Codesys Runtime
Open CODESYS on the PC that will connect to the Raspberry Pi. Click Tools > CODESYS Installer. In the AddOns section, click Browse. . In the search field, enter raspberry. Select CODESYS Control for Raspberry Pi, choose version, and click Install. Beijer Electronics, Doc ID: 53954 2025-02...
Page 46 Default credentials and IP Username beijer Password Jzy!q7 IP Address 192.168.100.72 10. Select the installed CODESYS Runtime Package version, then click Install. 11. Select Multicore, then click OK. 2025-02 Beijer Electronics, Doc ID: 53954...
Page 47: Delete Codesys Runtime
SW, and I/O. • PibusIoTest.h: Contains definitions of pointers and global variables used for I/O control. • PibusStruct.h: Defines structures used in the internal bus. TROUBLESHOOTING If the program does not close properly, restart the device. Beijer Electronics, Doc ID: 53954 2025-02...
Page 48 Read_Led(u8* pBuffer) Read the state value of the LED • pBuffer - use buffer void Write_Led(u8* pBuffer) Change the state of the LED • pBuffer - use buffer • 0: off, 1: Green, 2: Red 2025-02 Beijer Electronics, Doc ID: 53954...
Page 49 [5] GT-4118 Out: ff 0f ff 0f ff 0f ff 0f ff 0f ff 0f ff 0f ff 0f Get Prm: 00 00 00 00 ====================================================== [6] GT-2764 Out: ff Get Prm: 00 02 ====================================================== Beijer Electronics, Doc ID: 53954 2025-02...
Page 50 Add -lpthread -lrt at the end of the build command. Open the example program. Click the Build icon to compile the program. Once the build is complete, an executable file is created, and a confirmation message appears. 2025-02 Beijer Electronics, Doc ID: 53954...

This manual is also suitable for:

Gl-9981-l