Advertisement

Quick Links

User's Manual
(Self-Build Edition)
CONPROSYS Linux SDK
Ver. 2.0.0
CONTENTS
Introduction .................................................................. 4
Safety Precautions .................................................... 11
SDK preparation ........................................................ 15
Starting CONPROSYS .............................................. 19
Run environment setting ....................................... 24
Appendix ...................................................................... 44

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the CONPROSYS Linux SDK and is the answer not in the manual?

Questions and answers

Subscribe to Our Youtube Channel

Summary of Contents for Contec CONPROSYS Linux SDK

  • Page 1 User’s Manual (Self-Build Edition) CONPROSYS Linux SDK Ver. 2.0.0 CONTENTS Introduction ..............4 Safety Precautions ............ 11 SDK preparation ............15 Starting CONPROSYS ..........19 Run environment setting ........24 Appendix ..............44...
  • Page 2: Table Of Contents

    Table of Contents Introduction ..............4 1. Outline ..................................5 2. CONPROSYS products ............................6 3. SDK specification ..............................7 4. CONTEC Software License ...........................8 Safety Precautions ............11 1. Safety Information ............................... 12 2. Handling Precautions ............................13 3. Security Warning ..............................14 1.
  • Page 3 Table of Contents Appendix ................ 44 1. File system structure ............................45 2. Block diagram ............................... 46 3. Device I/F ................................48 4. FPGA I/O map ............................... 50 1. Integrated type CPS-MC341-ADSCx Series ..................50 5. Integrated type products LED / DIP Switch / Switch control .............. 57 6.
  • Page 4: Introduction

    Introduction — 4 —...
  • Page 5: Outline

    CONPROSYS Linux SDK User’s Manual (Self-Build Edition) 1. Outline CONPROSYS Linux SDK (Software Development Kit) is for creating software development environment to generate modules that operate on the CONPROSYS. Ubuntu will be run on CONPROSYS in the self-build edition, and the software can be developed in its CONPROSYS.
  • Page 6: Conprosys Products

    Multi Input and Output + LTE Model The functions such as HMI, VTC, OPC-UA, and Modbus that are installed in the M2M controller series are not provided in the CONPROSYS Linux SDK. The additional software is necessary for these functions.
  • Page 7: Sdk Specification

    — — Introduction CONPROSYS Linux SDK User’s Manual (Self-Build Edition) 3. SDK specification Kernel version: 4.19.79 ⚫ Distribution: arm edition Ubuntu 20.04 ⚫ GCC version: gcc 9.3 ⚫ — 7 —...
  • Page 8: Contec Software License

    To the extent not prohibited by law, in no event shall CONTEC be liable for personal injury, or any incidental, special, indirect or any other commercial damages or losses, arising out of or related to your use or inability to use the software and the like.
  • Page 9 Software. Article 7. Limited Warranty on Media CONTEC warrants the media on which the Software is recorded and delivered by CONTEC to be free from defects in materials and workmanship under normal use for a period of 30 days from the original retail purchase.
  • Page 10 — — Introduction CONPROSYS Linux SDK User’s Manual (Self-Build Edition) Article 10. Governing Law The provisions herein shall be construed and governed in accordance with the laws of Japan. This Agreement shall not be governed by the United Nations Convention on Contracts for the International Sale of Goods, the application of which is expressly excluded.
  • Page 11: Safety Precautions

    Safety Precautions — 11 —...
  • Page 12: Safety Information

    — — Safety Precautions CONPROSYS Linux SDK User’s Manual (Self-Build Edition) 1. Safety Information This document provides safety information using the following symbols to prevent accidents resulting in injury or death and the destruction of equipment and resources. Understand the meanings of these labels to operate the equipment safely.
  • Page 13: Handling Precautions

    CONTEC’s website and understand the contents. Do not modify the software. ⚫ CONTEC will bear no responsibility for any problems, etc., resulting from modifying the software. Regardless of the foregoing statement, CONTEC assumes no responsibility for any errors that ⚫...
  • Page 14: Security Warning

    — — Safety Precautions CONPROSYS Linux SDK User’s Manual (Self-Build Edition) 3. Security Warning When connecting to the network, be aware of security-related problems. See the examples of Security measures below and set up the product properly along with the network devices.
  • Page 15: Sdk Preparation

    SDK preparation — 15 —...
  • Page 16: Required Items For Development

    — — SDK preparation CONPROSYS Linux SDK User’s Manual (Self-Build Edition) 1. Required items for development CONPROSYS ⚫ SDHC card (2Gbyte or larger, non-SDXC-compliant) ⚫ Cable for serial monitor (Recommended cable: TTL-232R-3V3-AJ by FTDI) ⚫ LAN Cable ⚫ ⚫ — 16 —...
  • Page 17: Creating A Booting Sd Card For Conprosys

    When starting up, the system software recognizes the model type and configures the settings according to its hardware. The SD image file can also be created by using “CONPROSYS Linux SDK Cross building edition” on Ubuntu of the host PC for development. Please refer to the “Cross building”...
  • Page 18 — — SDK preparation CONPROSYS Linux SDK User’s Manual (Self-Build Edition) Select an image file to write Check whether the SD card is selected for writing destination in the Device field. Click “Write” button. Pop-up message appears to notify of the writing completion.
  • Page 19: Starting Conprosys

    Starting CONPROSYS — 19 —...
  • Page 20: Preparation

    — — Starting CONPROSYS CONPROSYS Linux SDK User’s Manual (Self-Build Edition) 1. Preparation Check DIP SW of each CONPROSYS product and make sure SD boot mode is enabled. ◆ Integrated type (e.g., CPS-Mx341-xxx) No.6 of DIP SW1 is ON. (SD boot mode enabled) Integrated type BOOT SW setting By connecting a serial cable from the host PC to CONPROSYS through the serial port (3.5Φ...
  • Page 21 — — Starting CONPROSYS CONPROSYS Linux SDK User’s Manual (Self-Build Edition) Connect LAN B to a Rooter connected to Internet so that the Ubuntu software package can be upgraded. A connecting example of CONPROSYS and PC (Serial monitor) In the default setting, 10.1.1.101 is set in LAN A port (I/F on Linux is eth0), and DHCP network is set in LAN B port (I/F on Linux is eth1).
  • Page 22: Start Up

    — — Starting CONPROSYS CONPROSYS Linux SDK User’s Manual (Self-Build Edition) 2. Start up Insert the created SD card and turn on the power of the product. The Ubuntu starts on the CONPROSYS. The LED of the PWR is lit when booting is completed.
  • Page 23: About File System

    CONPROSYS Linux SDK User’s Manual (Self-Build Edition) 3. About File System To prevent the system from crashing, the root file system (SD card) of CONPROSYS Linux SDK starts up in Read Only mode. By assenting with the software license agreement to log in, you are permitted to write into root file system.
  • Page 24: Run Environment Setting

    Run environment setting — 24 —...
  • Page 25: Web Setup Function

    — — Run environment setting CONPROSYS Linux SDK User’s Manual (Self-Build Edition) 1. Web Setup function CONPROSYS Linux contains the web server function. As standard functions of Self-Build edition SDK, settings of network, date & time, as well as displays of system information, network are supplied.
  • Page 26: Setting

    — — Run environment setting CONPROSYS Linux SDK User’s Manual (Self-Build Edition) Web Setup features following functions. 1. Setting Each setting below can be set. Setting menu Setting type Content Default value Note System Host name (Blank) Use the following host name when...
  • Page 27: Maintenance

    — — Run environment setting CONPROSYS Linux SDK User’s Manual (Self-Build Edition) 3. Maintenance Each maintenance menu is described below. Maintenance menu Item Description Password Password to access WEB setting page of the device can be changed. Configuration File The configuration file can be backed up and restored.
  • Page 28: Network Setting

    — — Run environment setting CONPROSYS Linux SDK User’s Manual (Self-Build Edition) 2. Network setting Default network setting is set as follows: [Default setting] LAN A (eth0): 10.1.1.101 LAN B (eth1): DHCP * When executing a kernel generated with 1lan (SINGLE EtherMAC), the setting of LAN B is invalid (operated by HUB mode).
  • Page 29 — — Run environment setting CONPROSYS Linux SDK User’s Manual (Self-Build Edition) 3G/LTE network configuration Item name Description m3g_connect Set 3G/LTE connection enabled or disabled. enabled disabled m3g_apn Set APN supplied by network service provider. m3g_user Set User ID supplied by network service provider.
  • Page 30 — — Run environment setting CONPROSYS Linux SDK User’s Manual (Self-Build Edition) Service startup setting Item name Description srv_ssh Set SSH server startup. enabled disabled srv_ftp Set FTP server startup. enabled disabled srv_samba Set Samba server startup. enabled disabled Rooter function setting...
  • Page 31 — — Run environment setting CONPROSYS Linux SDK User’s Manual (Self-Build Edition) PPPoE function setting Item name Description pppoek *1 Set PPPoE function. enabled disabled pppoe_connect Set PPPoE enabled or disabled. enabled disabled pppoe_if Set PPPoE interface. LAN A: eth0...
  • Page 32 — — Run environment setting CONPROSYS Linux SDK User’s Manual (Self-Build Edition) Port forwarding function setting Item name Description port_forward Set port forwarding function. enabled disabled port_fw_sif_1 Set port forwarding input interface. port_fw_sport_1 Set port forwarding input port. port_fw_daddr_1 Set port forwarding destination IP address.
  • Page 33 — — Run environment setting CONPROSYS Linux SDK User’s Manual (Self-Build Edition) Reboot the system after editing the configuration file. sudo reboot Example 1) set “eth0” to “DHCP” eth0_dhcp= enabled eth0_ipaddr= eth0_netmask= eth0_gateway= eth0_dns1= Example 2) set “eth0” to other fixed IP (192.168.30.11) eth0_dhcp=disabled eth0_ipaddr=192.168.30.11...
  • Page 34 — — Run environment setting CONPROSYS Linux SDK User’s Manual (Self-Build Edition) 3. Samba Setting CONPROSYS Linux contains the web server function. As standard functions of Self-Build edition SDK, settings of network, date & time, as well as displays of system information, network are supplied.
  • Page 35 — — Run environment setting CONPROSYS Linux SDK User’s Manual (Self-Build Edition) [Samba reboot procedure by command prompt] sudo systemctl restart smbd sudo systemctl restart nmbd — 35 —...
  • Page 36: Install The Software Package For Ubuntu

    — — Run environment setting CONPROSYS Linux SDK User’s Manual (Self-Build Edition) 4. Install the software package for Ubuntu Connecting CONPROSYS to the internet enables you to install the software package of Ubuntu by apt command. ◆ Preparation Before installing the software, update apt repository information by the command listed below.
  • Page 37: Expand The Size Of The Sd Card Memory

    — — Run environment setting CONPROSYS Linux SDK User’s Manual (Self-Build Edition) 5. Expand the size of the SD card memory. When a SD card image file is written into the SD card, and even the memory size of the SD card is larger than the image file, the whole memory size cannot be used.
  • Page 38 — — Run environment setting CONPROSYS Linux SDK User’s Manual (Self-Build Edition) [Create a new partition in the blank area of the memory.] Start the CONPROSYS. Open the SD card device by fdisk to add a new Linux partition. sudo fdisk /dev/mmcblk0 i) Add a new Linux partition by n command.
  • Page 39 — — Run environment setting CONPROSYS Linux SDK User’s Manual (Self-Build Edition) [Expand the rootfs partition of Linux to the maximum memory size in the SD card] Start the CONPROSYS. Open the SD card device by fdisk to change a Linux partition.
  • Page 40 — — Run environment setting CONPROSYS Linux SDK User’s Manual (Self-Build Edition) iv) Display the changed partition information by p command. Check whether the End address and Blocks of /dev/mmcblk0p2 are changed. A display example: a SD card with 4GByte is run by Ubuntu20.04]...
  • Page 41: Swap Memory Setting

    — — Run environment setting CONPROSYS Linux SDK User’s Manual (Self-Build Edition) 6. Swap memory setting CONPROSYS memory may not be enough for building large source code. You can expand the memory by creating a swap file on the disk.
  • Page 42: Initialization Setting With Dip Sw

    — — Run environment setting CONPROSYS Linux SDK User’s Manual (Self-Build Edition) 7. Initialization setting with DIP SW With the DIP SW, restoring the factory settings of LAN A or only initializing LAN A in IP address can be implemented when the power is turned on.
  • Page 43: Sample Programs

    Run environment setting CONPROSYS Linux SDK User’s Manual (Self-Build Edition) 8. Sample programs CONPROSYS Linux SDK contains the sample programs of C language available per model. (“Available Sample programs”) These sample programs can be self-built by gcc on CONPROSYS. Available Sample programs...
  • Page 44: Appendix

    Appendix...
  • Page 45: File System Structure

    — — Appendix CONPROSYS Linux SDK User’s Manual (Self-Build Edition) 1. File system structure ◆ SD / MMC card image structure SD / MMC card image structure boot section: u-boot, kernel etc. rootfs section: Ubuntu [SD card disk storage usage] boot section: approx.
  • Page 46: Block Diagram

    — — Appendix CONPROSYS Linux SDK User’s Manual (Self-Build Edition) 2. Block diagram CPS-Mx341-ADSCx series block diagram (Italic font means optional choices) CPS-Mx341G-ADSC1 (Japan Domestic model) block diagram — 46 —...
  • Page 47 — — Appendix CONPROSYS Linux SDK User’s Manual (Self-Build Edition) CPS-Mx341G-ADSC1 (Global model) block diagram CPS-MC341Q-ADSC1 block diagram CPS-MG341G5-ADSC1 block diagram — 47 —...
  • Page 48: Device I/F

    — — Appendix CONPROSYS Linux SDK User’s Manual (Self-Build Edition) 3. Device I/F The distinctive device I/F of CONPROSYS can be accessed on Linux as shown in the table below. Ports are vary depending on the models. UART control device...
  • Page 49 — — Appendix CONPROSYS Linux SDK User’s Manual (Self-Build Edition) GPIO control device (Board control) Model GPIO 22 GPIO 23 GPIO 36 GPIO 37 GPIO 105 CPS-MC341-ADSC1 Power RESET (Out) CPS-MC341-ADSC2 RS485 Power Power RESET (Out) (Out) CPS-MC341G-ADSC1 LDO_SHUTDOWN 3G Power...
  • Page 50: Fpga I/O Map

    — — Appendix CONPROSYS Linux SDK User’s Manual (Self-Build Edition) 4. FPGA I/O map 1. Integrated type CPS-Mx341-ADSCx Series Maker: Lattice Semiconductor Device model number: LCMXO2-640HC-4TG100l Interface: SPI signal timing MOSI: Slave latches the signal with a fall of SCLK MISO: Output slave signals with a rise of SCLK.
  • Page 51 — — Appendix CONPROSYS Linux SDK User’s Manual (Self-Build Edition) Digital I/O unit port map (Page 0h) Address Read/Write Meaning 00h – 01h System reservation area 02h – 03h System reservation area 04h – 0Ch Not used 0Eh – 0Fh System reservation area 10h –...
  • Page 52 — — Appendix CONPROSYS Linux SDK User’s Manual (Self-Build Edition) Counter I/O unit port map (Page 2h) Address Read/Write Meaning 00h – 01h System reservation area 02h – 03h System reservation area 04h – 0Fh Not used 10h – 11h...
  • Page 53 — — Appendix CONPROSYS Linux SDK User’s Manual (Self-Build Edition) Digital filter settings Name Meaning Set item Initial value ST4 - 0 Digital filter setting Set the digital filter 0: filter function not time time used [filter function not used] 1: 0.25μsec...
  • Page 54 — — Appendix CONPROSYS Linux SDK User’s Manual (Self-Build Edition) Analog input port (Page 1h / Address 28h - 29h) R/W This port obtains a value of analog input channel. When an isolation between channels is needed, do not turn on both switches simultaneously. It disables an isolation function.
  • Page 55 — — Appendix CONPROSYS Linux SDK User’s Manual (Self-Build Edition) Counter command port (Page 2h / Address 18h) W Cmd06 - 00 This port is an operation command port to execute the following command codes. Command code list: 08h: Ch0 counter mode (Write)
  • Page 56 — — Appendix CONPROSYS Linux SDK User’s Manual (Self-Build Edition) Ch0 / Ch1 comparison register 1 (counter command code: 20h / 21h) W Addr D15 D14 D13 D12 D11 D10 Data00 – 15 Data16 - 25 This sets data into Ch0 – Ch1 count value comparison register 1.
  • Page 57: Integrated Type Products Led / Dip Switch / Switch Control

    — — Appendix CONPROSYS Linux SDK User’s Manual (Self-Build Edition) 5. Integrated type products LED / DIP Switch / Switch control LEDs of Integrated types listed below can be controlled by GPIO port. LED control for integrated type Control device...
  • Page 58: Option Board Control

    — — Appendix CONPROSYS Linux SDK User’s Manual (Self-Build Edition) 6. Option Board control The models listed below contain an option board of 3G/LTE/920Hz communication. [Integrated type products M2M Controller Series] CPS-MC341G-ADSC1 Series Multi-I/O + 3G WAN (Japan domestic / Global) Model...
  • Page 59 — — Appendix CONPROSYS Linux SDK User’s Manual (Self-Build Edition) The models with 3G/LTE can control such as connection/disconnection, SIM check, and RSSI acquisition. 3G/LTE control Function How to control (Linux shell) Connection *1 /usr/local/cps-board/mobile/start_mobile.sh Disconnection *1 /usr/local/cps-board/mobile/stop_mobile.sh 3G/LTE module reset *1 /usr/local/cps-board/mobile/reset_mobile.sh...
  • Page 60 — — Revision History CONPROSYS Linux SDK User’s Manual (Self-Build Edition) Revision History MONTH YEAR Summary of Changes February 2022 1st edition — 60 —...
  • Page 61 3-9-31, Himesato, Nishiyodogawa-ku, Osaka 555-0025, Japan https://www.contec.com/ No part of this document may be copied or reproduced in any form by any means without prior written consent of CONTEC CO., LTD. CONPROSYS Linux SDK User’s Manual (Self-Build Edition) NA08766 (LXAU801) 02142022_rev1 [02142022] February 2022 Edition...

Table of Contents