# 시작하기

## 서비스 생성

&#x20;Nubison IoT 플랫폼에 로그인 후 다음의 사용자 매뉴얼을 참조하여 서비스를 생성합니다.

{% content-ref url="<https://app.gitbook.com/s/-M15-9aZHuZTyx7mCmrY/nubison-iot-features/service-list/service-add>" %}
[서비스 추가](https://app.gitbook.com/s/-M15-9aZHuZTyx7mCmrY/nubison-iot-features/service-list/service-add)
{% endcontent-ref %}

## 제품모델 생성

Nubison IoT 플랫폼에 로그인 후 다음의 사용자 매뉴얼을 참조하여 제품 모델을 생성합니다.

{% content-ref url="<https://app.gitbook.com/s/-M15-9aZHuZTyx7mCmrY/nubison-iot-features/iot/product-model-management/add-product-model>" %}
[제품 모델 추가](https://app.gitbook.com/s/-M15-9aZHuZTyx7mCmrY/nubison-iot-features/iot/product-model-management/add-product-model)
{% endcontent-ref %}

이후 디바이스의 데이터 규격에 맞게 유닛을 생성합니다.

{% content-ref url="<https://app.gitbook.com/s/-M15-9aZHuZTyx7mCmrY/nubison-iot-features/iot/product-model-management/undefined>" %}
[유닛 추가](https://app.gitbook.com/s/-M15-9aZHuZTyx7mCmrY/nubison-iot-features/iot/product-model-management/undefined)
{% endcontent-ref %}

Nubison IoT 클라우드와 디바이스가 통신하려면, 다음 정보가 필요합니다.

* 제품코드

## 드라이버 생성

Nubison IoT 플랫폼은 디바이스가 전송하는 데이터를 제품모델의 “**드라이버**”를 이용하여 처리 & 저장합니다.

제품모델 상세 페이지에서 “**드라이버 자동생성**”을 클릭하면 **드라이버**가 구성되는데, 이후 기본 규격대로 데이터를 전송하면 Nubison IoT 플랫폼을 통해 디바이스 데이터를 저장, 이용하실 수 있습니다.

제품모델을 생성한 후, 제품모델 상세 페이지로 진입하면 우측 하단에 "**드라이버 구성**" 메뉴가 있습니다.

<figure><img src="https://320013998-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MA-UhhU9aafUtZckIt9%2Fuploads%2FrGQgCK0ernDVF41e5NQ9%2F%E1%84%89%E1%85%B3%E1%84%8F%E1%85%B3%E1%84%85%E1%85%B5%E1%86%AB%E1%84%89%E1%85%A3%E1%86%BA%202023-02-14%20%E1%84%8B%E1%85%A9%E1%84%92%E1%85%AE%201.27.17.png?alt=media&#x26;token=ee7e62f9-1530-4c65-b879-dde0a9991115" alt=""><figcaption><p>제품모델 상세 > 우측 하단 “드라이버 구성” 메뉴</p></figcaption></figure>

"**자동생성**" 탭으로 들어가, "**드라이버 자동생성**"을 클릭하여 드라이버를 자동생성합니다.

드라이버를 자동생성하고, 이후 해당 제품모델로 디바이스를 추가하여 디바이스 데이터를 전송할 때 각 프로토콜에 맞게 데이터를 전송하면 데이터가 각 유닛의 값으로 저장됩니다.

최초 생성 이후 제품모델에 유닛 추가, 유닛 삭제, 유닛의 데이터 유형 수정이 발생하는 경우에 “**드라이버 자동생성**”을 한번 더 클릭해주세요.

{% hint style="info" %}
현재 드라이버 자동생성은 MQTT, MQTTS, TCP/IP, HTTP, HTTPS 프로토콜만 지원됩니다. 다른 프로토콜의 경우 "드라이버 제작 요청"을 이용해주세요.
{% endhint %}

## 디바이스 추가

다음의 사용자 매뉴얼을 참조하여 디바이스를 추가합니다.

{% content-ref url="<https://app.gitbook.com/s/-M15-9aZHuZTyx7mCmrY/nubison-iot-features/iot/device-management/add-device>" %}
[디바이스 추가](https://app.gitbook.com/s/-M15-9aZHuZTyx7mCmrY/nubison-iot-features/iot/device-management/add-device)
{% endcontent-ref %}

{% hint style="info" %}
디바이스의 식별키(identifier)는 디바이스를 식별하기 위한 값으로, 디바이스 별로 유일한 값이어야 합니다. MAC주소, 시리얼 번호 등 디바이스 자체 키를 사용하거나 Nubison IoT 플랫폼 서버에서 발급해드리는 UUID를 사용하세요.
{% endhint %}

Nubison IoT 클라우드와 디바이스가 통신하려면, 다음 정보가 필요합니다.

* 식별키

## 인증키 발급&#x20;

다음의 사용자 매뉴얼을 참조하여 인증 키를 발급합니다. 인증키는 디바이스가 Nubison IoT 플랫폼에 연결할 때 필요합니다. 사용 방법은 각 프로토콜 섹션에 기술되어 있습니다.

{% content-ref url="<https://app.gitbook.com/s/-M15-9aZHuZTyx7mCmrY/nubison-iot-features/service-management/certify-management/add-client>" %}
[클라이언트 추가](https://app.gitbook.com/s/-M15-9aZHuZTyx7mCmrY/nubison-iot-features/service-management/certify-management/add-client)
{% endcontent-ref %}

Nubison IoT 클라우드와 디바이스가 통신하려면, 다음 정보가 필요합니다.

* 클라이언트 ID
* 클라이언트 시크릿

## 디바이스 키 (Device Key) 구성

**디바이스 키(Device Key)**&#xB294; Nubison IoT 플랫폼이 각 디바이스를 식별하는 ID 역할을 합니다.

디바이스가 Nubison IoT 플랫폼과 통신할 때는 이 **디바이스 키(Device Key)**&#xB97C; 이용하여 자신을 인증하기 때문에 통신 시작 이전에 **디바이스 키(Device Key)**&#xB97C; 구성해두시기 바랍니다.

[제품모델 생성](#undefined-1) 단계에서 만들어진 "제품 코드"와, \
[디바이스 추가](#undefined-2) 단계에서 입력한 "식별키"를 다음과 같이 조합하여 **디바이스 키(Device Key)**&#xB97C; 구성합니다.

```
디바이스 키 = "${제품코드}_${식별키}"
```

예를 들어

제품코드가 `ABCDEFGH`

식별키가 `XYZ123` 이라면

**디바이스 키(Device Key)**&#xB294; `ABCDEFGH_XYZ123`가 됩니다.

이제 디바이스가 Nubison IoT 플랫폼에 연결될 준비가 끝났습니다.&#x20;

디바이스가 지원하는 프로토콜에 해당하는 섹션으로 이동하여 디바이스를 Nubison IoT 플랫폼에 연결해 보세요!
