=====================================================================
=   Connecting CONPROSYS with �gHULFT IoT�h                         =
=                                                        Ver1.0.0   =
=                                                 CONTEC Co., Ltd.  =
=====================================================================

�Ÿ TABLE OF CONTENTS
=======
  Introduction
  About CONPROSYS Linux SDK (Software Development Kit)
  How to connect CONPROSYS with �gHULFT IoT�h
  Version upgrading history

�Ÿ Introduction
===========
  "HULFT IoT" is a file transfer service provided by
  Saison Information Systems Co., Ltd. to utilize IoT data
  CONPROSYS can be used as a data transmitting device for the service stated
  above.
  File transferring with CONPROSYS has been confirmed by CONTEC Co., Ltd.
  To transfer a file, installing the HULFT IoT Agent with CONPROSYS Linux SDK
  is required.

�Ÿ About CONPROSYS Linux SDK(Software Development Kit)
===========
  CONPROSYS Linux SDK 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.

  By installing the HULFT IoT Agent into the Ubuntu, files can be sent to HULFT
  from CONPROSYS.
  (Contec also offers the cross-build edition, which enables users to edit more
  detailed settings.)

  Have the followings ready.
    -CONPROSYS
    -SD card (2Gbyte or larger) 
    -Cable for serial monitoring (recommended: TTL-232R-3V3 AJ by FTDI)  
    -LAN Cable
    -Host PC

  For details of CONPROSYS Linux SDK, please refer to 
  �gCONPROSYS Linux SDK Self-Build Edition User�fs Manual�h.


�Ÿ How to connect CONPROSYS with �gHULFT IoT�h
===========
  This section describes the HULFT IoT Agent installation procedure to
  CONPROSYS. 

  1) Go to the �gHULFT IoT�h page in the Saison Information Systems and download    HULFT IoT Agent into the Host PC. 
    -See the link below.
    https://www.hulft.com/software/hulft-iot/product

  For setting details of �gHULFT IoT�h, refer to the�gHULFT IoT first step-up
  guide�h provided by Saison Information Systems Co, Ltd. (Japanese)

  2) Mount the downloaded "hulftiot - v100.iso" file on the host PC, and unzip
    the "HULFT_IoT_Agent_Linux_AArch32_V100.tar.gz" file.
    The following four files will be unzipped.
    Copy these four files to CONPROSYS.

    -huliotcore
    -huliotsend
    -huliotservice
    -huliotsetup

  3) For copying files to CONPROSYS, there is a way to directly use the FAT
    area in the SD card storing "CONPROSYS Linux SDK Self-Build Edition" image.
    On the host PC, copy four files listed above into the �gCONPROSYS Linux SDK
    Self-Build Edition�h SD card.

  4) Insert the SD card into the CONPROSYS and start it up.
    From here, operations will be on CONPROSYS.

  5) Mount the SD card with Ubuntu on CONPROSYS.

    sudo mount /dev/mmcblk0p1 /mnt/mmc/

  6) Copy the file from the mounted folder.

    cd /mnt/mmc
    sudo cp huliotcore ~
    sudo cp huliotsend ~
    sudo cp huliotservice ~
    sudo cp huliotsetup ~
   cd ~

  7) Use the command �ghuliotsetup�h to install HULFT IoT Agent.

An installation example)

    sudo ./huliotsetup --key XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX --server XXX.XXX.XXX.XXX:XXXX

Command usage:

sudo huliotsetup [--path INSTALL_PATH] --key ACTIVATION_KEY --server SERVER_NAME[:SERVER_PORT]
[--proxy PROXY_NAME[:PROXY_PORT]] [--proxy-user USERNAME:PASSWORD] [--ssl]
[--devicename DEVICE_NAME] [--start]

Parameter description:

--path INSTALL_PATH
A directory for installing the HULFT IoT Agent (optional)
Unless a user makes their own directory, the �g/opt/hulftiot�h directory will be created to install the HULFT IoT Agent.

--key ACTIVATION_KEY
An activation key in the connected HULFT IoT Manager 
On the HULFT IoT Manager screen, select the icon [License] to check the HULFT IoT activation key on the license page.
For details regarding how to check the activation key, please refer to the �gHULFT IoT first step-up guide�h ? �g2.1.4 HULFT IoT Manager start-up�h-�g(3) The activation key check of HULFT IoT�h (Japanese).

--server SERVER_NAME :SERVER_PORT
The server name run by the connected HULFT IoT Manager and the port number of the HULFT IoT Manager.
When a user skips the port number �g:SERVER_PORT�h, the port number "8765" will be used.

--proxy PROXY_NAME :PROXY_PORT
A proxy server name used upon connecting to the HULFT IoT Manager and a port number of the proxy server (optional)
If a user skips the �g:PROXY_PORT�h, the port number �g80�h will be used. 

--proxy-user USERNAME :PASSWORD
A Proxy server name and a password used when connecting to the HULFT IoT Manager (optional). 

--ssl
Communication with HULFT IoT Manager by HTTPS (optional)
Unless a user communicates by HTTPS, HTTP communication will be performed.

--devicename DEVICE_NAME
An arbitrary device name for installing HULFT IoT Agent (optional)
Unless a user sets the own name, the host name set in the installation environment will be used.

--start
After installing, this starts up the HULFT IoT Agent (optional).

  8) Use the command �ghuliotservice�h to start up HULFT IoT Agent.

    sudo /opt/hulftiot/huliotservice


�Ÿ Version upgrading history
===========

Ver 1.0.0
--------------------------------
  Released the first edition.