Contec CONPROSYS SDK 取扱説明書

ユーザーズマニュアル

(クロスビルド版)

CONPROSYS Linux SDK

Ver. 1.4.0

はじめに ............................................. 4

安全にご使用いただくために ................. 10

開発環境 ........................................... 14

クロスビルド環境設定 .......................... 24

ターゲットのFirmware書き込み方法 ....... 30

ターゲット動作確認 ............................. 44

ビルド .............................................. 60

Appendix .......................................... 71

― 2 ―

はじめに ............................................................. 4

1. 概要 .........................................................................................................................5

2. 対応するCONPROSYS製品一覧 ......................................................................................6

3. ソフトウェア使用許諾契約書 .........................................................................................7

安全にご使用いただくために ................................. 10

1. 注意記号の説明 ......................................................................................................... 11

2. 取り扱い上の注意 ...................................................................................................... 12

3. セキュリティに関する注意 .......................................................................................... 13

1. セキュリティリスク .............................................................................................. 13

2. セキュリティ対策事例 ........................................................................................... 13

開発環境 ........................................................... 14

1. 開発に必要なもの ...................................................................................................... 15

2. SDKスペック ........................................................................................................... 16

3. SDK内容 ................................................................................................................. 17

4. 開発環境構成 ........................................................................................................... 18

5. SDKのインストール ................................................................................................... 19

1. SDKに必要なツールチェーンのインストール .............................................................. 20

2. CONPROSYS linux SDKのインストール .................................................................... 21

クロスビルド環境設定 ......................................... 24

1. SDカード作成フロー .................................................................................................. 25

2. 初期設定 ................................................................................................................. 26

3. 環境設定 ................................................................................................................. 29

ターゲットの Firmware 書き込み方法 .................... 30

1. システム起動について ................................................................................................ 31

2. SD起動用SDカードの作成 ........................................................................................... 32

1. SDカードへ直接書込み .......................................................................................... 33

2. SDイメージファイルを作成しイメージ書込みソフトでSDカードへ書込み .......................... 35

3. 内蔵NOR FLASH起動用のインストールSDカードの作成 .................................................... 37

1. 内蔵NOR FLASH起動用インストールするためのrootfsセクションを作成 .......................... 37

2. 内蔵NOR FLASHインストール用rootfsセクションへのコピー ......................................... 39

3. 内蔵NOR FLASHインストール用SDカードの作成(SDカードへ直接書込み) ........................ 40

4. 内蔵NOR FLASHインストール用SDカードの作成(SDイメージファイル作成) ..................... 42

4. 内蔵NOR FLASHへのインストール ............................................................................... 43

― 3 ―

ターゲット動作確認 ............................................ 44

1. ターゲット起動方法 ................................................................................................... 45

1. SDカードからの起動 ............................................................................................. 45

2. 内蔵NOR FLASHから起動 ...................................................................................... 45

2. シリアルケーブル接続によるログイン ............................................................................ 46

3. ssh接続によるログイン .............................................................................................. 47

4. ターゲットの起動シーケンス ....................................................................................... 48

5. ターゲットのネットワーク設定 .................................................................................... 49

6. ドライバソフトの起動方法 .......................................................................................... 55

7. Web Setupについて .................................................................................................. 56

1. 設定メニュー ....................................................................................................... 57

2. ステータスメニュー .............................................................................................. 57

3. メンテナンスメニュー ........................................................................................... 58

4. 終了メニュー ....................................................................................................... 58

8. DIP SWによる初期化設定 ........................................................................................... 59

ビルド .............................................................. 60

1. ビルド手順 .............................................................................................................. 61

2. ターゲットのbootloaderのビルド ................................................................................. 62

1. SDカード起動用のビルド ....................................................................................... 62

2. 内蔵NOR FLASH起動用のビルド .............................................................................. 62

3. ターゲットのkernelのビルド ....................................................................................... 63

4. CPS-MCS341シリーズドライバのビルド ........................................................................ 65

5. ターゲットのサンプルライブラリのビルド ...................................................................... 66

6. ターゲットのサンプルアプリケーションのビルド ............................................................. 67

7. 軽量版rootfsのビルド ................................................................................................ 69

8. 内蔵NOR FLASH起動用ramdisk.xzのビルド ................................................................... 70

Appendix ........................................................ 71

1. ブロック図 .............................................................................................................. 72

2. デバイスI/F ............................................................................................................. 77

3. FPGA I/Oマップ ....................................................................................................... 82

1. [コンパクトタイプ CPS-MC341-ADSCx / DSxシリーズ] .............................................. 82

2. [スタックタイプ CPS-MCS341-DSxシリーズ] ........................................................... 89

4. 内蔵NOR FLASHメモリマップ ..................................................................................... 90

5. コンパクトタイプシリーズ LED/DIP Switch/Switch制御 .............................................. 91

6. スタックタイプシリーズ DIO/LED/DIP Switch/Switch制御 .............................................. 92

7. オプションボード制御 ................................................................................................ 95

8. ターゲット搭載アプリケーション ................................................................................. 97

― 4 ―

はじめに

■

はじめに

■

CONPROSYS Linux SDK ユーザーズマニュアル(クロスビルド版)

― 5 ―

1. 概要

CONPROSYS Linux SDK(Software Development Kit) は、CONPROSYS上で動作するモジュールの生成

するためのソフトウェア開発環境を目的とします。

本SDKは、次の範囲になります。

 CONPROSYSが動作するソフトウェアを生成するための開発用ホストPC上のツール

(ソースコード(kernel, ライブラリ、ドライバ等)やビルドスクリプト等)

 CONPROSYSのソフトウェアをSDカードに書込むための開発用ホストPC上のツール

 CONPROSYS上のソフトウェア動作をモニタするためのツール

(シリアルコンソール等)

SDK範囲(SCOPE)

本SDKは、CONPROSYSのソフトウェアモジュールを開発用ホストPC上でクロスビルドによって生成します。

CONPROSYS上でセルフビルドを行いたい場合は、セルフビルド版のマニュアルを参照ください。

また、本SDKではセルフビルド版のCONPROSYS Linux SDKを生成することも可能です。詳細については、

『ビルド (P60)』以降の章を参照ください。

■

はじめに

■

CONPROSYS Linux SDK ユーザーズマニュアル(クロスビルド版)

― 6 ―

2. 対応するCONPROSYS製品一覧

本SDKに対応する製品は次に示します。

【コンパクトタイプ M2Mコントローラシリーズ】

CPS-MC341-ADSCxシリーズマルチI/Oモデル

CPS-MC341G-ADSC1シリーズマルチI/O + 3G(日本国内 / グローバル)モデル

CPS-MC341Q-ADSC1 マルチI/O + 920MHz帯通信モデル

CPS-MC341-A1 アナログ入出力モデル

CPS-MC341-DSxシリーズデジタル入出力モデル

CPS-MC341-DS11 デジタル入出力モデル

【コンパクトタイプ M2M Gatewayシリーズ】

CPS-MG341-ADSC1シリーズマルチI/Oモデル

CPS-MG341G-ADSC1シリーズマルチI/O + 3Gモデル

CPS-MG341G5-ADSC1 マルチI/O + LTEモデル

【スタックタイプ M2Mコントローラシリーズ】

CPS-MCS341-DS1シリーズ CPUモジュール

CPS-MCS341G-DS1 CPUモジュール + 3Gモデル

CPS-MCS341G5-DS1 CPUモジュール + LTEモデル

CPS-MCS341Q-DS1 CPUモジュール + 920MHz帯通信モデル

※ M2Mコントローラシリーズに搭載されているHMI、VTC、OPC-UA、Modbus等の機能は、

CONPROSYS Linux SDKに備わっておりません。別途、ソフトウェアの組込が必要です。

※ M2M Gatewayシリーズに搭載されているHMI、VTC、OPC-UA、Modbus、PLC、CNC等の機能は、

CONPROSYS Linux SDKに備わっておりません。別途、ソフトウェアの組込が必要です。

※ PACシステムシリーズ、nanoシリーズは対応しておりません。

■

はじめに

■

CONPROSYS Linux SDK ユーザーズマニュアル(クロスビルド版)

― 7 ―

3. ソフトウェア使用許諾契約書

本契約は、お客様と株式会社コンテック（以下「当社」といいます。）との間で、本製品に含まれるソフ

トウェアプログラム（以下「本ソフトウェア」といいます。）の使用許諾に関して合意するものです。本

ソフトウェアを使用、又は本ソフトウェアをインストールした機器を使用することによって、お客様は本

契約の各条項に同意されたものとさせていただきます。このお客様の同意をもって、本契約は成立し、効

力を生じます。本契約に同意されない場合、本ソフトウェアの使用、又は本ソフトウェアをインストール

した機器を使用することはできません。

第１条(知的財産権)

本ソフトウェア及びマニュアル等付属するドキュメント並びにその複製物（以下「本ソフトウェア等」とい

います。）の著作権、特許権その他知的財産権は当社もしくは正当な権利者が所有するものであり、お客様に

は、本契約書において明示的に許諾されたものを除き、何らの権利も発生しません。

第2条(使用許諾)

1. 当社は、お客様に対し、本ソフトウェアに対応する当社ハードウェア製品を使用する目的で、本ソフトウ

ェアをインストール及び使用する非独占的な権利を許諾します。

2. お客様は、緊急時のバックアップの目的でのみ、本ソフトウェアを使用する上で最低限必要な本数に限

り、本ソフトウェアを複製することができます。但し、複製物には、当社が提供する、本ソフトウェアに

ついての諸権利に関する表示を添付するものとします。

3. お客様は、当社がライブラリとして提供するソフトウェアをお客様の作成するソフトウェアに組み込む

ことができます。

第3条(利用の制限)

お客様は、次の各号に定める行為を行わないとします。

(1) 本契約に定める場合以外の本ソフトウェアから派生するソフトウェアの制作

(2) 本契約に定める場合以外の本ソフトウェアの複製

(3) 本ソフトウェアの改変、翻案、逆コンパイル、逆アセンブル、リバース・エンジニアリング

(4) 本ソフトウェア上の権限の表示や商標の削除又は変更

第4条(免責)

1. 当社は本ソフトウェアに関しいかなる保証もいたしません。

2. 本ソフトウェアをダウンロード、インストール、使用又は利用した結果、ハードウェア又はデータに支障

が生じた場合等、本ソフトウェアに起因し又は関連して損害が発生した場合であっても、当社は一切責

任を負いません。本ソフトウェアを複製し、組み込み又は改変したソフトウェア及びこれらを使用又は

利用して作成されたソフトウェアについても同様とします。

■

はじめに

■

CONPROSYS Linux SDK ユーザーズマニュアル(クロスビルド版)

― 8 ―

第5条(譲渡)

1. お客様は、次の各号に定める条件を全て満たした場合に限り、本ソフトウェア及び本契約において許諾

されたお客様の権利を第三者に対し、譲渡することができます。

(1) 本契約書と共に本ソフトウェア等を全て当該第三者に譲渡すること

(2) 本ソフトウェアがダウンロードされた当社のハードウェア製品の全てを当該第三者に譲渡すること

(3) 譲渡を受ける方が本契約の条件に同意すること

2. 前項の規定によって本ソフトウェア及び権利の譲渡がなされた場合には、譲渡を受けた方は、譲渡を受

けたときからこの契約に拘束されるものとします。

第6条（契約の解除）

1. お客様が本契約の各条項に従わなかった場合、当社は、お客様に対し、何らの通知・催告を行うことなく

直ちに本契約を終了させることができます。

2. 本契約の終了と同時に、お客様に与えられていた使用許諾は全て失われます。直ちに本ソフトウェアの

一切の使用を中止し、本ソフトウェアをアンインストールし、全ての複製物を破棄するものとします。

第7条（物理的欠陥について）

1. 本ソフトウェア等が格納されている記録媒体に本ソフトウェア等の使用に支障をきたす物理的欠陥があ

った場合、当社は、お客様が本ソフトウェア等をお受け取りになった日から30日以内にご購入いただい

た販売店を通して記録媒体を交換するものとします。

第8条（ソフトウェアプログラムに関する情報）

1. 本ソフトウェアに関する各種情報やアップデートプログラムは、当社ウェブサイトで提供するものとし

ます。

2. 前項の情報やアップデートプログラムは、本契約に基づきお客様に対して許諾されます。お客様は、必要

に応じて独自の判断でこれらの情報やアップデートプログラムを、使用することができますが、その場

合には、その情報やアップデートプログラムについても本契約の条項を遵守しなければなりません。

第9条（輸出規制）

1. 本ソフトウェア等を外国に持ち出す場合には、お客様は日本国外国為替及び外国貿易法、米国輸出管理

法及びその他の国の法令を遵守しなければなりません。

2. お客様は、本ソフトウェア等を核兵器、生物化学兵器の設計、開発、製造若しくはミサイルの設計、開

発、製造に使用するおそれがある個人又は法人に譲渡、輸出又は再輸出してはいけません。

3. 次の各号で定める国、地域、個人又は法人に、本ソフトウェア等を譲渡、輸出、再輸出してはいけませ

ん。

(1) キューバ、イラン、イラク、リビア、北朝鮮

(2) 輸出貿易管理令に基づく「外国ユーザーリスト」又は、米国商務省の「Denied Persons List」に記

載されている個人又は法人

(3) 日本国政府、米国政府、その他関係国の政府により指定された国、地域、個人又は法人

第10条（準拠法）

1. 本契約は日本国法に従い理解、解釈されるものとします。

■

はじめに

■

CONPROSYS Linux SDK ユーザーズマニュアル(クロスビルド版)

― 9 ―

第11条（管轄の合意）

1. 本契約ないし本ソフトウェアに関して紛争が生じ、訴訟提起等の法的手続きが必要となった場合には、

大阪簡易裁判所ないし大阪地方裁判所をもって、第１審の専属的合意裁判所とします。

第12条（契約の分離）

1. 本契約の一部の条項が無効とされ又は法的強制力を失ったとしても、その他の条項には影響を与えるこ

とはなく、各条項は有効であり、法により許された範囲内で法的強制力を有するものとします。

― 10 ―

安全にご使用いただくために

■

安全にご使用いただくために

■

CONPROSYS Linux SDK ユーザーズマニュアル(クロスビルド版)

― 11 ―

1. 注意記号の説明

本書では、人身事故や機器の破壊をさけるため、次のシンボルで安全に関する情報を提供しています。

内容をよく理解し、安全に機器を操作してください。

危険

死亡または重傷を負うことがあり、かつその切迫の度合いが高い内容

警告

死亡または重傷を負うことが想定される内容

注意

傷害を負うことが想定されるか、または物的損害の発生が想定される内容

■

安全にご使用いただくために

■

CONPROSYS Linux SDK ユーザーズマニュアル(クロスビルド版)

― 12 ―

2. 取り扱い上の注意

注意

 本製品または本書は機能追加、品質向上のため予告なく仕様を変更する場合があります。継続的にご利

用いただく場合でも、必ず当社ホームページのマニュアルを読み、内容を確認してください。

 本製品を改造しないでください。

改造をしたものに対しては、当社は一切の責任を負いません。

 本製品の運用を理由とする損失、逸失利益などの請求につきましては、前項にかかわらず、いかなる責

任も負いかねますのであらかじめご了承ください。

■

安全にご使用いただくために

■

CONPROSYS Linux SDK ユーザーズマニュアル(クロスビルド版)

― 13 ―

3. セキュリティに関する注意

ネットワークに接続する際は、存在するセキュリティリスクを考慮の上、セキュリティ対策事例を参考に本

体および関連するネットワーク機器を適切に設定してください。

1. セキュリティリスク

 外部ネットワークからの不正侵入に伴うシステムの停止、データの破損、情報の窃取、マルウェア※1

への感染。

 侵入後にその機器を踏み台として、外部ネットワークへの攻撃。(被害者から加害者になる)

 外部へのネットワーク接続に伴う意図しない情報漏洩。

 これら事故の二次被害として、風評被害、損害賠償負担、信用の失墜、機会損失等。

※1：マルウェア(Malicious Software)：悪意あるプログラム。ユーザーの望まない動作をするプログラム

2. セキュリティ対策事例

 初期パスワードを変更する。(パスワード設定方法は、ご使用の製品の解説書/マニュアルを参照してくだ

さい)

 パスワード強度の高いものを設定する。

半角英字小文字、大文字、数字等を含み、類推されにくいパスワードを使用する



定期的にパスワードを変更する。

 不要なネットワークサービスや、不要な機能を停止(無効化)する。

 ネットワーク接続機器において、ネットワークでのアクセス元を制限する。※2

 ネットワーク接続機器において、ネットワークの解放ポートを制限する。※2

 専用ネットワークやVPN※3 など閉域網を使ってネットワークを構築する。

※2：設定方法はネットワーク機器のメーカー各社へお問い合わせください。

※3： VPN(Virtual Private Network)：通信経路を認証や暗号化を用いて保護することにより、第三者が

侵入することができない、安全なネットワークです。

不正アクセスの手段や抜け道(セキュリティホール)は、日夜新たに発見されており、それを防ぐ完璧

な手段はありません。

インターネット接続には、常に危険が伴うことをご理解いただくとともに、常に新しい情報を入手し、

セキュリティ対策を行うことを強くおすすめします。

― 14 ―

開発環境

■

開発環境

■

CONPROSYS Linux SDK ユーザーズマニュアル(クロスビルド版)

― 15 ―

1. 開発に必要なもの

 開発用ホストPC (Linux)

 SDHCカード (2Gbyte以上。SDXC非対応)

 シリアルモニタ用ケーブル (推奨ケーブル： FTDI製 TTL-232R-3V3-AJ)

 LAN Cable

■

開発環境

■

CONPROSYS Linux SDK ユーザーズマニュアル(クロスビルド版)

― 16 ―

2. SDKスペック

開発用ホストPC Linux Distribution: Ubuntu 14.04 / 16.04 (64bit版) Desktop

40Gbyte以上の空きHDD容量必要

sudoの実行出来る管理者権限ユーザー

ターゲットKernel version: 3.2.0

ターゲットDistribution: arm版 Ubuntu 14.04 (SDブート用のみ)

クロスコンパイルGCC version: gcc 4.9 (Hardware float) / gcc 4.7 (Software float)

必要なLinux toolchain：

apt, gcc-arm-linux-gnueabi, libncurses5-dev, gawk, u-boot-tools, openssh-server,

samba, binutils-arm-linux-gnueabi, binutils-arm-linux-gnueabihf, xinetd, kpartx, gperf, bison, flex

※上記は本SDKを動作させるための必要なものを示しています。

各々の開発環境で他に必要なパッケージがあれば、別途入手しインストールしてください。

(例：git, wget, subversion等)

■

開発環境

■

CONPROSYS Linux SDK ユーザーズマニュアル(クロスビルド版)

― 17 ―

3. SDK内容

 SDKドキュメント

 クロスコンパイラ/ツールチェーン

パッケージ（Debian/Ubuntu用）：

gcc-arm-linux-gnueabihf-4.9.3, gcc-arm-linux-gnueabi-4.7, libncurses5-dev, gawk,

u-boot-tools, openssh-server, samba, binutils-arm-linux-gnueabi,

binutils-arm-linux-gnueabihf, xinetd, kpartx, gperf, bison, flex

 ビルドツール

 ソースコード

u-boot, kernel, サンプルアプリケーション, サンプルライブラリ, サンプルドライバ

 CONPROSYS製品毎のベースモジュール(u-boot, kernel, 設定等)

■

開発環境

■

CONPROSYS Linux SDK ユーザーズマニュアル(クロスビルド版)

― 18 ―

4. 開発環境構成

ホストPC（ビルド、モニター用）とターゲットの構成例を次に示します。

例1) 開発ホストPC１台でビルドとターゲットにシリアルモニタを使用する場合

Linux PC１台でビルドおよびシリアルモニタリングする場合

例2) 開発ホストPCでビルド(またはソースコード編集）、ターゲットにシリアル

モニタを別のWindows PCの２台で使用する場合

ビルド用にLinux PC１台、シリアルモニタリング用にWindows PCを使う場合

例3) Windows OS等に仮想OSシステム(VM Ware, Virtual BOX等)を入れ

て、その上でLinux OSをインストールし開発ホストPCとして使用する場

合

１台のPCでビルド用にLinux(VM Ware利用）、シリアルモニタリング用に

Windowsを使う場合

■

開発環境

■

CONPROSYS Linux SDK ユーザーズマニュアル(クロスビルド版)

― 19 ―

5. SDKのインストール

ダウンロード版またはDVD版を次のように準備します。

 ダウンロード版(tgzファイル)の場合：

1 ダウンロードした.tgzファイルを展開します。

tar xvfz CPS_SDK_installer_xxxx.tgz[–C 展開先ディレクトリ]

2 展開先のディレクトリに移ります。

※展開先がカレントの場合は必要ありません。

 ダウンロード版(isoファイル)の場合：

1 ダウンロードした.isoファイルをマウントします。

マウント先ディレクトリは任意で作成してください。

sudo -E mount –o loop CPSSDK_xxxx.iso マウント先ディレクトリ

2 マウント先のディレクトリに移ります。

 DVD版の場合：

1 DVDメディアをホストPCに挿入します。

2 挿入したメディアは自動マウントされるので、そのマウント先のディレクトリに移ります。

■

開発環境

■

CONPROSYS Linux SDK ユーザーズマニュアル(クロスビルド版)

― 20 ―

1. SDKに必要なツールチェーンのインストール

 ホストPCがインターネット接続可能の時

ubuntu のOS上で次のツールチェーンをapt-getコマンドによってインストールします。

libncurses5-dev, gawk, u-boot-tools, openssh-server, samba, binutils-arm-linux-gnueabi, binutils-

arm-linux-gnueabihf, xinetd, kpartx, gcc-4.7-arm-linux-gnueabi, gperf, bison

ツールチェーンをインストールする前に、apt-getのパッケージリストを更新してください。

apt-getのパッケージリスト更新コマンド：

sudo apt-get update

インストールコマンド：

sudo apt-get install libncurses5-dev gawk u-boot-tools openssh-server samba \

binutils-arm-linux-gnueabi binutils-arm-linux-gnueabihf xinetd kpartx gperf \

bison flex

コンパイラはCONPROSYS linux SDK付属のパッケージをインストールします。

インストールコマンド：

cd Toolchain

sudo ./compiler_pkginstall.sh

cd ..

 ホストPCがインターネット接続出来ない時

CONPROSYS linux SDKには必要なツールチェーンのパッケージを用意しています。[Toolchain]のディレク

トリに移り、toolchain_pkginstall.shを実行してください。（『CONPROSYS linux SDKのインストール

(P21)』で説明する./install_sdk.shでもインストールできます。）

コマンド：

cd Toolchain

sudo ./toolchain_pkginstall.sh

cd ..

ページが読み込まれています...

Contec CONPROSYS SDK 取扱説明書

Contec CONPROSYS SDK 取扱説明書

関連論文

その他のドキュメント