{"id":8482,"date":"2024-11-20T16:34:52","date_gmt":"2024-11-20T07:34:52","guid":{"rendered":"https:\/\/hasu0707.duckdns.org\/blog\/?p=8482"},"modified":"2024-12-08T20:11:43","modified_gmt":"2024-12-08T11:11:43","slug":"zigbee2mqtt-%ec%83%88%eb%a1%9c%ec%9a%b4-%ec%9e%a5%ec%b9%98-%ec%b6%94%ea%b0%80","status":"publish","type":"post","link":"https:\/\/hasu0707.duckdns.org\/blog\/?p=8482","title":{"rendered":"Zigbee2MQTT \uc0c8\ub85c\uc6b4 \uc7a5\uce58 \ucd94\uac00"},"content":{"rendered":"\n

\ucc38\uace0: https:\/\/www.zigbee2mqtt.io\/advanced\/support-new-devices\/01_support_new_devices.html#instructions<\/a><\/span><\/p>\n

\ub9cc\uc77c Zigbee \uc7a5\uce58\uac00 Z2M\uc5d0\uc11c \uc815\uc0c1\uc801\uc73c\ub85c \uc778\uc2dd\ub418\uc9c0 \uc54a\uc744 \uacbd\uc6b0 \uc7a5\uce58\uc5d0 \ub300\ud55c \uc678\ubd80 \uc815\uc758\ub97c \ud30c\uc77c\ub85c \ub9cc\ub4e4\uc5b4 Z2M\uc5d0\uac8c \uc778\uc2dd\uc2dc\ucf1c\uc8fc\uba74 \ub41c\ub2e4.<\/span>
\uc774\ub97c \uc704\ud574 \uc544\ub798 \uacfc\uc815\uc744 \ub530\ub978\ub2e4.<\/span><\/p>\n

1. \uc81c\uc870\uc0ac \ucf54\ub4dc\ub85c \ube44\uc2b7\ud55c \uc81c\ud488\uc73c\ub85c \uc778\uc2dd \uc2dc\ud0a4\uae30<\/span>
  \u2474 Zigbee \uc81c\uc870\uc0ac \ucf54\ub4dc \uc54c\uc544\ub0b4\uae30<\/span>
    Zigbee2MQTT > 0xa4c138758807b972(\uc778\uc2dd\ubd88\uac00 \uae30\uae30) > Zigbee \uc81c\uc870\uc0ac: _TZE204_w1wwxoja<\/span><\/p>\n

  \u2475 \uc790\uc2e0\uc758 \uae30\uae30\uc640 \ube44\uc2b7\ud55c \uae30\uae30\uc758 \uc81c\uc870\uc0ac \ucf54\ub4dc \uc54c\uc544\ub0b4\uae30<\/span>
    https:\/\/github.com\/Koenkk\/zigbee-herdsman-converters\/blob\/master\/src\/devices\/tuya.ts<\/a><\/span>
    \uc5d0\uc11c \uc790\uc2e0\uc758 \uae30\uae30\uc640 \ube44\uc2b7\ud55c \ubaa8\ub378\uc744 \ucc3e\ub294\ub2e4.<\/span><\/p>\n

    \uc608\ub97c \ub4e4\uc5b4 6\uad6c \uc2a4\ub9c8\ud2b8 \uc2a4\uc704\uce58\ub77c\uba74 \"6 gang switch\"\ub97c \uac80\uc0c9\ud558\uc5ec fingerprint: tuya.fingerprint \ubaa9\ub85d\uc5d0\uc11c \uc790\uc2e0\uacfc \ube44\uc2b7\ud55c \uc7a5\uce58\uc758 \uc81c\uc870\uc0ac \ucf54\ub4dc\ub97c \uc54c\uc544\ub0b8\ub2e4.<\/span>
    \ucf54\ub4dc\ub97c \ucc3e\uc558\ub2e4\uba74(_TZE204_g4au0afs) \uad6c\uae00\ub9c1\uc744 \ud1b5\ud574 \ud574\ub2f9 \ucf54\ub4dc\uc758 \uc81c\ud488\uc744 \uac80\uc0c9\ud574 \ubcf4\uace0 \uc790\uc2e0\uc758 \uae30\uae30\uc5d0 \uc801\uc6a9\ud574\ub3c4 \ub420 \uc815\ub3c4\ub85c \ube44\uc2b7\ud55c\uc9c0 \ud310\ub2e8\ud55c\ub2e4.<\/span><\/p>\n

  \u2476 Zigbee2MQTT \uc911\uc9c0<\/span>
    \uc124\uc815 > \uc560\ub4dc\uc628 > Zigbee2MQTT > \uc911\uc9c0<\/span><\/p>\n

  \u2477 \uc778\uc2dd\ubd88\uac00 \uae30\uae30\uc758 \uc81c\uc870\uc0ac \ucf54\ub4dc \ubcc0\uacbd<\/span>
    \/var\/hass\/homeassistant\/zigbee2mqtt\/database.db \ud3b8\uc9d1<\/span>
    \uc778\uc2dd\ubd88\uac00 \uae30\uae30\uc758 ieeeAddr(a4c138758807b972)\uc744 \uac80\uc0c9\ud558\uc5ec \ud574\ub2f9 \uc904\uc744 \ucc3e\uc544\ub0b8\ub2e4.<\/span>
    \uc778\uc2dd\ubd88\uac00 \uc81c\uc870\uc0ac \ucf54\ub4dc(_TZE204_w1wwxoja)\ub97c \uc778\uc2dd \uac00\ub2a5\ud55c \ucf54\ub4dc(_TZE204_g4au0afs)\ub85c manufName, manufacturerName \ud56d\ubaa9\uc744 \ubcc0\uacbd\ud55c\ub2e4.<\/span><\/p>\n

  \u2478 Zigbee2MQTT \uc2dc\uc791<\/span>
    \uc124\uc815 > \uc560\ub4dc\uc628 > Zigbee2MQTT > \uc2dc\uc791\ud558\uae30<\/span><\/p>\n

  \u2479 Zigbee2MQTT \ubaa9\ub85d\uc5d0\uc11c \uae30\uae30 \uc815\uc0c1\ub4f1\ub85d \ud655\uc778
  \u203b\uc774 \ubc29\ubc95\uc740 \uae30\uae30\uc758 \uc81c\uc870\uc0ac \ucf54\ub4dc\uac00 database.db\uc5d0\uc11c \uacc4\uc18d \uc6d0\uc0c1\ubcf5\uad6c \ub418\ubbc0\ub85c \ucd94\ucc9c\ud558\uc9c0\ub294 \uc54a\ub294\ub2e4.<\/span><\/p>\n


2. \uc678\ubd80 \uc815\uc758 \uc0dd\uc131<\/span>
  \u2474 Zigbee2MQTT > \ud574\ub2f9 \uc7a5\uce58 \ud074\ub9ad<\/span>
  \u2475 Exposes \ud0ed\uc5d0\uc11c \ub178\ucd9c(Expose)\ub41c \ubcc0\uc218\uac12\uc774 \uc788\ub294\uc9c0 \ud655\uc778\ud558\uace0 \uc5c6\ub2e4\uba74 \uc778\uc2dd\uc774 \uc548\ub41c \uac83\uc774\ubbc0\ub85c<\/span>
  \u2476 \uac1c\ubc1c\uc790 \ucf58\uc194 \ud0ed\uc5d0\uc11c [generate_external_definition]\uc744 \ud074\ub9ad\ud558\uc5ec \uc774 \uc7a5\uce58\uc5d0 \ub9de\ub294 \uc678\ubd80 \uc815\uc758\ub97c \uc0dd\uc131\ud55c\ub2e4.<\/span><\/p>\n

  \u203b\uc774 \ubc29\ubc95\uc740 \uc7a5\uce58\uac00 Zigbee ZCL(Cluster Library Specification) \uc0ac\uc591\uc744 \uad6c\ud604\ud560 \ub54c\ub9cc \uc791\ub3d9\uc774 \uac00\ub2a5\ud558\uace0 \uc2e4\ud328\ud560 \uc218\ub3c4 \uc788\ub2e4.<\/span><\/p>\n

  \ub9cc\ub4e4\uc5b4\uc9c4 \uc678\ubd80 \ud655\uc7a5\uc744 \/var\/hass\/homeassistant\/zig2mqtt\uc5d0 \uc784\uc758\uc758 \ud30c\uc77c\uba85(ts0222.js)\uc73c\ub85c \uc800\uc7a5\ud55c\ub2e4.<\/span>
  \uadf8\ub9ac\uace0 \/var\/hass\/homeassistant\/zig2mqtt\/configuration.yaml\uc5d0 \uc544\ub798\ub97c \ucd94\uac00 \ud6c4 Z2M\uc744 \uc7ac\uc2dc\uc791\ud55c\ub2e4.<\/span>
----------<\/span>
advanced:<\/span>
    log_level: debug<\/span>
external_converters:<\/span>
  - ts0222.js<\/span>
----------<\/span><\/p>\n

3. \uc678\ubd80 \uc815\uc758 \ud655\uc7a5<\/span>
  \ub9cc\uc77c \uc704\uc758 \ubc29\ubc95\uc774 \uc2e4\ud328\ud560 \uacbd\uc6b0 \uc544\ub798\uc758 \uacfc\uc815\uc744 \uc9c4\ud589\ud55c\ub2e4. (tuya \uc7a5\uce58\uc77c \uacbd\uc6b0)<\/span><\/p>\n

  https:\/\/github.com\/Koenkk\/zigbee-herdsman-converters\/blob\/master\/src\/devices\/tuya.ts<\/a><\/span>
  \ub97c \ucc38\uace0\ud558\uc5ec \ucee8\ubc84\ud130\uc758 \ub0b4\uc6a9 \uc77c\ubd80\ub97c \uc678\ubd80 \ud655\uc7a5 js \ud30c\uc77c \uc791\uc131\uc5d0 \uc0ac\uc6a9\ud55c\ub2e4.<\/span><\/p>\n

*** SAMPLE: \uc870\ub3c4\uc13c\uc11c(_TZ3000_9kbbfeho) ***<\/span>
----------<\/span>
const {battery, illuminance } = require('zigbee-herdsman-converters\/lib\/modernExtend');<\/span>

const definition = {<\/span>
    zigbeeModel: ['TS0222'],<\/span>
    model: 'TS0222',<\/span>
    vendor: '_TZ3000_9kbbfeho',<\/span>
    description: 'Light Sensor',<\/span>
    extend: [battery(), illuminance()],<\/span>
    meta: {},<\/span>
};<\/span>

module.exports = definition;<\/span>
----------

*** SAMPLE: 6\uad6c \uc2a4\uc704\uce58(_TZE204_w1wwxoja) ***
----------
const {} = require('zigbee-herdsman-converters\/lib\/modernExtend');
const fz = require('zigbee-herdsman-converters\/converters\/fromZigbee');
const tz = require('zigbee-herdsman-converters\/converters\/toZigbee');
const exposes = require('zigbee-herdsman-converters\/lib\/exposes');
const reporting = require('zigbee-herdsman-converters\/lib\/reporting');
const ota = require('zigbee-herdsman-converters\/lib\/ota');
const utils = require('zigbee-herdsman-converters\/lib\/utils');
const globalStore = require('zigbee-herdsman-converters\/lib\/store');
const tuya = require('zigbee-herdsman-converters\/lib\/tuya');
const e = exposes.presets;
const ea = exposes.access;

const definition = {
    fingerprint: tuya.fingerprint('TS0601', ['_TZE204_w1wwxoja']),
    model: 'TS0601_switch_6_gang',
    vendor: 'Tuya',
    description: '6 gang switch',
    fromZigbee: [tuya.fz.datapoints],
    toZigbee: [tuya.tz.datapoints],
    configure: async (device, coordinatorEndpoint, logger) => {
        const endpoint = device.getEndpoint(1);
        await reporting.bind(endpoint, coordinatorEndpoint, ['genOnOff']);
        await reporting.onOff(endpoint);
        device.powerSource = 'Mains (single phase)';
        device.save();
    },
    exposes: [
      tuya.exposes.switch().withEndpoint('l1'),
      tuya.exposes.switch().withEndpoint('l2'),
      tuya.exposes.switch().withEndpoint('l3'),
      tuya.exposes.switch().withEndpoint('l4'),
      tuya.exposes.switch().withEndpoint('l5'),
      tuya.exposes.switch().withEndpoint('l6'),
    ],
    endpoint: (device) => {
        return {l1: 1, l2: 1, l3: 1, l4: 1, l5: 1, l6: 1};
    },
    whiteLabel: [tuya.whitelabel('Tuya', 'TS0601_switch_6_gang', 'Living room main 6 gang switch', ['_TZE204_w1wwxoja'])],
    meta: {
      multiEndpoint: true,
      tuyaDatapoints: [
        [1, 'state_l1', tuya.valueConverter.onOff],
        [2, 'state_l2', tuya.valueConverter.onOff],
        [3, 'state_l3', tuya.valueConverter.onOff],
        [4, 'state_l4', tuya.valueConverter.onOff],
        [5, 'state_l5', tuya.valueConverter.onOff],
        [6, 'state_l6', tuya.valueConverter.onOff],
      ],
    },
};

module.exports = definition;
----------
<\/span><\/span>
  \uc815\uc0c1\uc801\uc73c\ub85c \ub3d9\uc791\ud560 \uacbd\uc6b0 Z2M\uc5d0\uc11c \uc544\ub798\uc640 \uac19\uc740 \ub85c\uadf8\ub97c \ucd9c\ub825\ud55c\ub2e4.<\/span>
  Zigbee2MQTT:debug  2019-11-09T12:24:22: No converter available for 'WSDCGQ01LM' with cluster 'msTemperatureMeasurement' and type 'attributeReport' and data '{\"measuredValue\":2512}'<\/span>
  \ub9cc\uc77c \ub85c\uadf8\uac00 \uc544\ubb34\uac83\ub3c4 \uc5c6\uc744 \uacbd\uc6b0 \ucd94\uac00 \uad6c\uc131\uc774 \ud544\uc694\ud558\uba70 \uc774\ub294 configure: \uc139\uc158\uc744 \ucd94\uac00\ud558\uc5ec \uad6c\uc131\ud560 \uc218 \uc788\ub2e4.<\/span>
  \uc608\ub97c \ub4e4\uc5b4 tuya \ud638\ud658 \uc7a5\uce58\uc77c \uacbd\uc6b0 \uc544\ub798 \uc8fc\uc18c\ub97c \ucc38\uace0\ud55c\ub2e4.<\/span>
  https:\/\/www.zigbee2mqtt.io\/advanced\/support-new-devices\/02_support_new_tuya_devices.html<\/a><\/span><\/p>\n

  \uba87 \uac00\uc9c0 \uae30\ubcf8\uc801\uc778 \uc678\ubd80 \ubcc0\ud658\uae30 \uc608:<\/span>
    \uc804\uad6c(\uc870\uba85): https:\/\/github.com\/Koenkk\/zigbee2mqtt.io\/blob\/master\/docs\/externalConvertersExample\/light.js<\/a><\/span>
    \ud50c\ub7ec\uadf8(\uc2a4\uc704\uce58): https:\/\/github.com\/Koenkk\/zigbee2mqtt.io\/blob\/master\/docs\/externalConvertersExample\/switch.js<\/a><\/span>
    \uace0\uae09 \uc608\uc81c: https:\/\/github.com\/Koenkk\/zigbee2mqtt.io\/blob\/master\/docs\/externalConvertersExample\/freepad_ext.js<\/a><\/span>
  \uc774\ubbf8 \uc9c0\uc6d0\ub418\ub294 \uae30\uae30\uc758 \uc815\uc758\ub294<\/span>
  https:\/\/github.com\/Koenkk\/zigbee-herdsman-converters\/tree\/master\/src\/devices<\/a><\/span>
  \uc6f9\ud398\uc774\uc9c0\ub97c \ucc38\uace0\ud55c\ub2e4.<\/span><\/p>\n","protected":false},"excerpt":{"rendered":"

\ucc38\uace0: https:\/\/www.zigbee2mqtt.io\/advanced\/support-new-devices\/01_support_new_devices.html#instructions \ub9cc\uc77c Zigbee \uc7a5\uce58\uac00 Z2M\uc5d0\uc11c \uc815\uc0c1\uc801\uc73c\ub85c \uc778\uc2dd\ub418\uc9c0 \uc54a\uc744 \uacbd\uc6b0 \uc7a5\uce58\uc5d0 \ub300\ud55c \uc678\ubd80 \uc815\uc758\ub97c \ud30c\uc77c\ub85c \ub9cc\ub4e4\uc5b4 Z2M\uc5d0\uac8c \uc778\uc2dd\uc2dc\ucf1c\uc8fc\uba74 \ub41c\ub2e4.\uc774\ub97c \uc704\ud574 \uc544\ub798 \uacfc\uc815\uc744 \ub530\ub978\ub2e4. 1. \uc81c\uc870\uc0ac \ucf54\ub4dc\ub85c \ube44\uc2b7\ud55c \uc81c\ud488\uc73c\ub85c \uc778\uc2dd \uc2dc\ud0a4\uae30  \u2474 Zigbee \uc81c\uc870\uc0ac \ucf54\ub4dc \uc54c\uc544\ub0b4\uae30    Zigbee2MQTT > 0xa4c138758807b972(\uc778\uc2dd\ubd88\uac00 \uae30\uae30) > Zigbee \uc81c\uc870\uc0ac: _TZE204_w1wwxoja   \u2475 \uc790\uc2e0\uc758 \uae30\uae30\uc640 \ube44\uc2b7\ud55c \uae30\uae30\uc758 \uc81c\uc870\uc0ac \ucf54\ub4dc \uc54c\uc544\ub0b4\uae30    https:\/\/github.com\/Koenkk\/zigbee-herdsman-converters\/blob\/master\/src\/devices\/tuya.ts  […]<\/p>\n","protected":false},"author":2,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_import_markdown_pro_load_document_selector":0,"_import_markdown_pro_submit_text_textarea":"","site-sidebar-layout":"default","site-content-layout":"","ast-site-content-layout":"default","site-content-style":"default","site-sidebar-style":"default","ast-global-header-display":"","ast-banner-title-visibility":"","ast-main-header-display":"","ast-hfb-above-header-display":"","ast-hfb-below-header-display":"","ast-hfb-mobile-header-display":"","site-post-title":"","ast-breadcrumbs-content":"","ast-featured-img":"","footer-sml-layout":"","theme-transparent-header-meta":"","adv-header-id-meta":"","stick-header-meta":"","header-above-stick-meta":"","header-main-stick-meta":"","header-below-stick-meta":"","astra-migrate-meta-layouts":"set","ast-page-background-enabled":"default","ast-page-background-meta":{"desktop":{"background-color":"","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"tablet":{"background-color":"","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"mobile":{"background-color":"","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""}},"ast-content-background-meta":{"desktop":{"background-color":"var(--ast-global-color-5)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"tablet":{"background-color":"var(--ast-global-color-5)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"mobile":{"background-color":"var(--ast-global-color-5)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""}},"footnotes":""},"categories":[93],"tags":[],"class_list":["post-8482","post","type-post","status-publish","format-standard","hentry","category-computing_iot"],"_links":{"self":[{"href":"https:\/\/hasu0707.duckdns.org\/blog\/index.php?rest_route=\/wp\/v2\/posts\/8482","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/hasu0707.duckdns.org\/blog\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/hasu0707.duckdns.org\/blog\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/hasu0707.duckdns.org\/blog\/index.php?rest_route=\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/hasu0707.duckdns.org\/blog\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=8482"}],"version-history":[{"count":0,"href":"https:\/\/hasu0707.duckdns.org\/blog\/index.php?rest_route=\/wp\/v2\/posts\/8482\/revisions"}],"wp:attachment":[{"href":"https:\/\/hasu0707.duckdns.org\/blog\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=8482"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/hasu0707.duckdns.org\/blog\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=8482"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/hasu0707.duckdns.org\/blog\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=8482"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}