첫 번째 데이터~

설치할 때 비어 있던 화면에, 이제 첫 번째 데이터를 띄웁니다. 센서가 없어도 인터넷의 무료 날씨 데이터로 시작할 수 있습니다. 이 장은 현장 A 가 받을 값에서 출발합니다. 현장 A 의 노지에는 온도와 습도, 토양 수분을 재는 무선 센서가 있고, 바깥 날씨는 인터넷에서 받아 옵니다. 연결 방식은 다르지만 AoT 에서는 모두 입력입니다. 고르고, 설정하고, 켜면 값이 들어오는 순서도 같습니다. 이 장에서 입력·출력·함수 화면에 공통인 카드와 설정 창 다루는 법, 그리고 외부 API 를 쓰는 법을 한 번 익힙니다.

이 장을 마치면~

• 날씨 입력으로 첫 번째 데이터를 띄운다
• 카드와 설정 창을 다룰 줄 안다
• 키가 필요한 API 도 같은 순서로 붙일 수 있다는 것을 안다
• 내 현장 센서는 어떤 입력으로 붙일지 안다

준비~

• 로그인할 수 있는 AoT(설치)
• 인터넷 연결

절차~

1. 입력은 두 갈래~

값을 받아 오는 길은 크게 두 가지입니다. 현장에 설치한 센서에서 받거나, 인터넷에서 API 로 받습니다. 둘 다 입력에서 추가할 수 있고, 선택하고 설정하고 켜는 방법은 같습니다.

2. API 는 무엇인가~

API 는 다른 곳이 가진 데이터를 받아 오는 창구입니다. 관공서 민원 창구와 비슷합니다. 내가 맡겨 둔 것이 없어도, 정해진 서류를 내면 필요한 것을 떼어 줍니다. 예를 들어 AoT 가 날씨 서비스를 제공하는 기상청 API 에 현재 위치의 지금 날씨를 요청하면, 기온과 습도, 바람 같은 값이 돌아옵니다. AoT 는 이 값을 받아 와서 원하는 방식으로 저장해 줍니다.

왜 쓸까요? 날씨 예보나 지도처럼 개인이 모으기 어려운 데이터를 국가나 국제기관이 누구나 쓸 수 있게 열어 두었기 때문입니다. 기상청의 날씨, 나라에서 만든 지도(국가 공간정보), 공공데이터포털의 여러 자료가 그런 곳입니다. 민원 창구처럼 무료인 곳이 많지만 수수료가 드는 곳도 있고, 사용 조건도 API 를 제공하는 곳마다 다르니 먼저 설명을 확인하세요.

키는 창구에 내미는 신분증입니다. 어떤 API 는 가입하고 받은 키를 내밀어야 쓸 수 있습니다. 키는 그 창구에만 내미는 신분증이니, AoT 의 API 키 칸에만 넣고 다른 사람에게도 AI 에게도 보여 주지 마세요.

3. 입력 화면 — 카드와 설정 창~

설정 → 입력을 엽니다. 입력·출력·함수 화면은 모양이 같습니다.

• 추가한 입력은 막대 모양의 카드로 놓입니다. 카드에는 이름과 고유 번호(UUID) 같은 핵심 정보가 있습니다.
• 카드 왼쪽의 손잡이(두 줄)를 끌면 카드 순서를 바꿉니다.
• 입력 화면 위쪽의 탭은 이름을 바꿀 수 있고, 입력이 많아지면 탭으로 나누어 둘 수 있습니다. 여기서는 탭 이름을 "현장 A" 로 바꿉니다.
• 카드 오른쪽의 톱니를 누르면 설정 창이 열립니다. 설정 창은 지도, 이 장치에 대한 설명, 기본 설정, 그리고 장치 특징에 맞는 세부 설정으로 나뉩니다.

입력의 카드와 설정 창은 출력·함수·지도 입력(GIS 입력)·AI 에이전트 같은 다른 설정 화면에서도 비슷한 모양으로 나옵니다. 여기서 한 번 익혀 두면 다른 종류의 장치도 쉽게 다룰 수 있습니다.

새 입력은 입력 선택 버튼으로 추가합니다. 누르면 AoT 가 지원하는 입력이 모두 나오고, 목록마다 짧은 설명이 있으니 내 센서나 서비스에 맞는 것을 읽고 고르면 됩니다.

4. API 붙이는 순서~

API 를 붙이는 방법은 어디나 비슷합니다. 자전거를 한 번 익히면 어떤 자전거든 타듯이, API 도 한 번 익히면 대부분 같은 순서입니다.

1. 입력 선택 목록에서 설명을 읽고 원하는 API 를 고릅니다(무엇을 골라야 할지 모르면 AI 에게 "이런 값을 받고 싶다"고 물어보세요)
2. 설명에 있는 링크를 따라가 그 API 의 안내를 확인합니다
3. 필요하면 가입하고 키를 받습니다
4. 키를 AoT 에 넣고 저장합니다(6단계)

5. 날씨 입력으로 첫 번째 데이터 띄우기~

먼저 현장 A 의 바깥 날씨를 받으려고, 키가 필요 없는 Open-Meteo 날씨 입력을 추가합니다. Open-Meteo 는 여러 나라 기상청의 예보를 모아 열어 둔 곳입니다.

1. 설정 → 입력에서 입력 선택 목록을 열고 Open-Meteo: Open-Meteo (Coords, Hourly incl. Solar) 를 골라 추가합니다.
2. 새 카드의 톱니로 설정 창을 엽니다.
3. 위치를 먼저 정합니다. 설정 창의 작은 지도를 현장으로 옮기고, 클릭해서 위치를 지정합니다. 지도 왼쪽의 레이블을 현재 지도 중심으로 이동(과녁 모양)을 눌러도 됩니다. 지도 바탕을 아직 등록하지 않았으면 현장을 찾기 어려울 수 있습니다. 위치가 맞는지는 지도 장에서 다시 확인합니다. 여러 개의 장치 위치를 설정할 때는 지도 페이지에서 동시에 처리할 수 있습니다.
4. 측정 주기를 300(초, 5분) 이상으로 둡니다. 날씨는 자주 바뀌지 않고, 너무 자주 받으면 무료 사용 한도에 걸립니다.
5. 저장하고 활성화합니다.
6. 설정 창의 지금 측정을 누르면 정해진 주기를 기다리지 않고 바로 한 번 받습니다.
7. 실시간 측정(로그인하면 처음 나오는 화면, 메뉴는 추가 기능 → 실시간 측정)에 기온·습도·일사·바람·비 값이 뜨면, 첫 번째 데이터가 들어온 것입니다.

Open-Meteo 이용 조건: 무료 사용은 비상업 용도입니다(구독·광고가 없는 개인·비영리 사이트나 앱, 개인 홈 자동화 등). 사업자가 자기 운영에 쓰는 경우는 이용 조건에 따로 적혀 있지 않으니, 애매하면 Open-Meteo 에 문의하세요. 무료 한도는 하루 1만 회·시간당 5천 회·분당 600회이고, 데이터는 CC BY 4.0 입니다(이용 조건).

6. 키가 필요한 API~

기상청처럼 키가 필요한 API 도 같은 순서입니다. 4단계의 순서대로 가입하고 키를 받은 뒤, 받은 키는 API 키 관리에 넣어 두고 입력을 만들 때 골라 씁니다.

1. 관리 → 시스템 관리 → API 키 관리 → 새 API 키 추가에서 이름(예: "기상청 API 허브")과 키를 저장합니다.
2. 입력의 설정 창에서 API 키 칸 옆 Key 버튼으로 저장한 키를 고릅니다.

고른 키는 입력 칸에 글자 그대로 복사됩니다. 나중에 키를 바꾸면 그 키를 쓰는 입력마다 다시 골라야 합니다. 키는 다른 사람에게도, AI 에게도 보여 주지 않습니다.

7. 현장 센서는~

현장에 설치한 센서는 연결 방식에 맞는 입력을 고릅니다. 현장 A 의 노지 센서는 무선(LoRaWAN)입니다. 방식마다 제조사나 설치업체에게 받아 둘 정보가 다르니, 자세한 것은 매뉴얼에서 확인하세요.

센서 값은 데이터 중계기 같은 중간 기기를 거쳐 들어오기도 합니다. 이 기기도 컴퓨터처럼 24시간 켜져 있어야 값이 끊기지 않습니다.

8. 입력마다 노트 남기기~

입력·출력마다 노트가 있습니다. 장비의 제원이나 설정 코드, 설치 날짜 같은 것을 적어 두면 나중에 장비를 바꾸거나 문제를 찾을 때 다시 찾아보지 않아도 됩니다.

확인~

• 실시간 측정에 날씨 값이 보인다
• 입력 카드를 옮기고, 톱니로 설정 창을 열 수 있다

현장 A~

현장 A 는 노지의 온습도·토양 수분 센서(무선)와 바깥 날씨(날씨 API)를 모두 입력으로 받습니다. 연결 방식이 달라도 입력 화면에서 같은 카드로 다룹니다. 입력 화면의 탭 이름은 "현장 A" 로 바꿔 둡니다.

현장 B~

현장 B 는 시설 장부터 다룹니다. 현장 B 의 온실 안 온습도 5곳과 바깥 기상대 값은 기존 제어 설비가 보내 주며, 통신(MQTT) 입력으로 받습니다.

안 될 때~

값이 안 들어오면 네 가지를 살펴보세요. 켜 두지 않았거나, 위치를 넣지 않았거나, 주기가 너무 짧거나, 키가 틀린 경우입니다.

더 알아보기~

• 다음 장: 대시보드 — 이 데이터를 대시보드에 놓아 보겠습니다
• 입력
• 실시간 측정

도우미 AI 에게~

• 값을 받아 오는 것은 모두 "입력"입니다. 사용자가 "센서"라고 해도 화면에서는 입력입니다.
• 새 입력은 켜지 않으면 동작하지 않습니다. 값이 없으면 먼저 활성화와 위치(날씨)를 확인하게 하세요.
• 키·비밀번호를 사용자에게 요구하지 마세요. 키는 사용자가 API 키 관리에 직접 넣습니다.