C-NET API 소개
=============================================

.. _C-NET_introduction_01:

C-NET
--------------------

* 커미조아의 C-NET은 Master Device 와 Slave Module을 통해서 네트워크를 구성하며, 마스터 장치의 Ring Connector 의 개수에 따라서 구성 할 수 있는 Ring 네트워크의 개수가 달라집니다
* LX412a 의 경우는 2 개의 네트워크를 구성 할 수 있으며, LX412b 의 경우는 한 개의 네트워크를 구성 할 수 있습니다.
* 한 개의 Ring 네트워크에 추가 할 수 있는 슬레이브 모듈의 개수는 최대 64 개이며, 최대 접점의 수는 2048(64 * 32)개 입니다.



.. _C-NET_introduction_02:

함수의 명명 규칙 - 접두어
-------------------------

* CNETSDK에서 제공하는 모든 함수는 다른 API 함수와 이름이 중복되는 것을 피하기 위하여 "cmn"이라는 접두어가 붙습니다. 
* "cmn" 뒤에 해당 함수가 속하는 기능의 그룹을 대표하는 접두어가 이어집니다.
* "[in]"은 함수에 값을 전달함을 의미하고, "[out]"은 함수로부터 값을 전달받는다는 것을 의미합니다. (단 이 표기는 메뉴얼에서만 사용되는 것이며 실제 헤더파일에는 표기되어 있지 않습니다.)






+-----------+----------------------------------------------------------------------------------------+---------+----------------+----------+----------+
| 접두어    | 설명                                                                                   | C/C++   | VB6.0          | Delphi   | C#       |
+===========+========================================================================================+=========+================+==========+==========+
| VT_EMPTY  | 반환값이 없는 데이터 표현형                                                            | void    | -              | -        | void     |
+-----------+----------------------------------------------------------------------------------------+---------+----------------+----------+----------+
| VT_HANDLE | 운영체제가 특정한 정보를 유지하기 위해서, 메모리에 유지하는 정보 블록에 붙은 고유 번호 | void*   | Long(ByRef)    | THandle  | IntPtr   |
+-----------+----------------------------------------------------------------------------------------+---------+----------------+----------+----------+
| VT_I4     | 4 바이트 부호있는 정수 표현형                                                          | long    | Long (ByVal)   | LongInt  | Int      |
+-----------+----------------------------------------------------------------------------------------+---------+----------------+----------+----------+
| VT_PI4    | 4 바이트 부호있는 정수 변수의 주소 값 (포인터) 또는 배열주소 표현형                    | long*   | Long (ByRef)   | PLongInt | Int[]    |
+-----------+----------------------------------------------------------------------------------------+---------+----------------+----------+----------+
| VT_R4     | 4 바이트 부호있는 실수 표현형                                                          | float   | Double (ByVal) | Double   | Float    |
+-----------+----------------------------------------------------------------------------------------+---------+----------------+----------+----------+
| VT_PR4    | 4 바이트 부호있는 실수 변수의 주소 값 (포인터) 또는 배열주소 표현형                    | float*  | Double (ByRef) | PDouble  | float[]  |
+-----------+----------------------------------------------------------------------------------------+---------+----------------+----------+----------+
| VT_R8     | 8 바이트 부호있는 실수 표현형                                                          | double  | Double (ByVal) | Double   | double   |
+-----------+----------------------------------------------------------------------------------------+---------+----------------+----------+----------+
| VT_PR8    | 8 바이트 부호있는 실수 변수의 주소 값 (포인터) 또는 배열주소 표현형                    | double* | Double (ByRef) | PDouble  | double[] |
+-----------+----------------------------------------------------------------------------------------+---------+----------------+----------+----------+
| VT_STR    | 선형 메모리 상의 문자열 선두 주소를 지시하는 4 바이트 주소 표현형                      | char*   | String (ByVal) | PChar    | String   |
+-----------+----------------------------------------------------------------------------------------+---------+----------------+----------+----------+