다원 AIPM 스마트플러그 디바이스를 제어하기 위한 비공식 API 서버입니다.
Firmware 버전 1.01.34에서 B530-W, B540-W 기기로 테스트되었습니다.
- Packet Capture를 통해
user_id
,sso_token
,terminal_id
,user_ssid_info
값을 추출해야 합니다.
- 프로젝트 디렉토리에
settings.ini
파일이 필요합니다. settings.ini
파일은settings_sample.ini
파일을 참고하여 작성합니다.- Note) Docker를 사용할 경우 환경변수로 대체할 수 있습니다.
- Packet Capture 를 설치합니다.
- Packet Capture앱을 실행하고, 다원 AIPM 앱을 선택하여 시작버튼을 누릅니다.
- 다원 AIPM 앱에서 로그인을 시도합니다.
Note) 자동로그인이 설정되어 있으면 로그아웃을 하지 않아도 됩니다. - Packet Capture 앱으로 돌아와서 다원 AIPM 앱을 선택하고,
PUT
/api/v1/accounts/put/userSsid
요청 클릭하여 Request Body를 확인합니다. user_id
,sso_token
,terminal_id
,user_ssid_info
값을 확인합니다.- 각 값들을 복사하여
settings.ini
파일에 붙여넣습니다.
Note)settings_smaple.ini
파일의 이름을settings.ini
으로 변경하여 사용합니다.
- Proxyman를 설치합니다.
- 공식문서를 참고하여 초기설정을 합니다.
- 다원 AIPM 앱을 실행하고, 로그인을 시도합니다.
Note) 자동로그인이 설정되어 있으면 로그아웃을 하지 않아도 됩니다. - Proxyman 앱으로 돌아와서
dwapi.dawonai.com
도메인을 선택하고PUT
/api/v1/accounts/put/userSsid
요청 클릭하여 Request Body를 확인합니다.
Note) 만약Enable SSL Proxying
버튼이 보인다면, 클릭하여 활성화한 후 3번 과정을 다시 진행합니다. user_id
,sso_token
,terminal_id
,user_ssid_info
값을 확인하여settings.ini
파일에 붙여넣습니다.
Note)settings_smaple.ini
파일의 이름을settings.ini
으로 변경하여 사용합니다.
-
이 저장소를 클론합니다:
git clone https://github.com/bsy0317/Dawon-PowerManager.git
-
프로젝트 디렉토리로 이동합니다:
cd Dawon-PowerManager
-
Python dependencies를 설치합니다:
pip install -r requirements.txt
run_windows.bat
스크립트를 실행합니다.
run_windows.bat
run_linux.sh
스크립트를 실행합니다.
./run_linux.sh
docker pull westkite/dawon_pm
명령어로 이미지를 다운로드합니다.- 환경변수를 설정하여 settings.ini 파일을 대체할 수 있습니다.
- 다음 명령어를 통해 컨테이너를 실행합니다.
docker run --hostname=dawon_pm_api
--name=dawon_pm
--env=user_id=YOUR_USER_ID
--env=sso_token=YOUR_SSO_TOKEN
--env=terminal_id=YOUR_TERMINAL_ID
--env=connected_ap=YOUR_CONNECTED_AP
--workdir=/app -p 5001:5001
-d westkite/dawon_pm:latest
- Endpoint:
/status
- Methods: GET
- Description: 디바이스의 상태를 확인합니다.
- Response:
{
"responses": [
{
"conn_status": 1,
"device_id": "DAWONDNS-B540_W-{MAC_ADDR}",
"value_power": "true",
"value_product_temp": 45.1,
"value_watt": 1.0,
"value_watth": "1.04"
},
{
"conn_status": 1,
"device_id": "DAWONDNS-B540_W-{MAC_ADDR}",
"value_power": "false",
"value_product_temp": 39.4,
"value_watt": 0.0,
"value_watth": "0"
}
],
"status": true
}
- Endpoint:
/control/<action>/<device_id>
- Methods: GET
- Description: 디바이스의 전원을 제어합니다.
- Actions:
on
: 디바이스의 전원을 켭니다.off
: 디바이스의 전원을 끕니다.
- Device ID:
device_id
를 입력합니다. - Response:
{
"message": {
"devices": [
{
"device_id": "DAWONDNS-B540_W-{MAC_ADDR}",
"msg": {
"e": [
{
"n": "/100/0/31",
"sv": "true",
"ti": "1712199860"
}
],
"o": "n"
}
}
],
"status": "devices/control/set : execute success"
},
"status": true
}
- 이 프로젝트를 사용함으로써 발생하는 모든 문제에 대해 책임지지 않습니다.
- 이 프로젝트를 개인적인 목적으로만 사용하여 주시고 상업적인 목적으로 사용하지 마십시오.
- This application is provided as-is without any warranties.
- Use this application only for personal use and do not use it for commercial purposes.