File: README.md

package info (click to toggle)
python-plugwise 1.7.4-1
  • links: PTS, VCS
  • area: main
  • in suites: trixie
  • size: 6,080 kB
  • sloc: xml: 90,006; python: 5,344; sh: 326; makefile: 2
file content (80 lines) | stat: -rw-r--r-- 5,908 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
# Setups included for testing (help us out!)

Below you'll find a list of setups we have (green) and are still looking for (yellow). If you are willing to help out the community, please share your setup with us. Below the list you'll find a paragraph detailing how you can best submit your data without everybody on the Internet being able to control your precious Smile.

## Setups

Help wanted / submit yours (links to issue tracker)

- [![Generic badge](https://img.shields.io/badge/Adam-v4-yellow.svg)](https://github.com/plugwise/python-plugwise/issues/new?assignees=&labels=userdata&projects=&template=todo_item.yml&title=%5BTODO%5D%3A%20Userdata%20for%20adam%20with%20everything+) setup with a boiler, Floor, Koen, Plug, Tom and Lisa (i.e. the whole shebang) (`adam_full_option`)
- [![Generic badge](https://img.shields.io/badge/Adam-v4-yellow.svg)](https://github.com/plugwise/python-plugwise/issues/new?assignees=&labels=userdata&projects=&template=todo_item.yml&title=%5BTODO%5D%3A%20Userdata%20for%20adam%20without%20boiler+) setup without a boiler, but with Lisa and either a Plug or a Tom (`adam_without_boiler`)

Existing setups

- [![Generic badge](https://img.shields.io/badge/Adam-v3-green.svg)](https://github.com/plugwise/python-plugwise/tree/main/userdata/adam_living_floor_plus_3_rooms) setup with a boiler, Floor, Lisa and 3x Toms (riemers)
- [![Generic badge](https://img.shields.io/badge/Adam-v3-green.svg)](https://github.com/plugwise/python-plugwise/tree/main/userdata/adam_multiple_devices_per_zone) setup with everything but Koen and Anna, multiple devices per zone (tane)
- [![Generic badge](https://img.shields.io/badge/Adam-v3-green.svg)](https://github.com/plugwise/python-plugwise/tree/main/userdata/adam_zone_per_device) setup with everything but Koen and Anna, device per zone (tane)

- [![Generic badge](https://img.shields.io/badge/Adam_Anna-v3-green.svg)](https://github.com/plugwise/python-plugwise/tree/main/userdata/adam_plus_anna) a boiler, Adam, Anna and Tom (bouwew)

- [![Generic badge](https://img.shields.io/badge/Anna-v4-green.svg)](https://github.com/plugwise/python-plugwise/tree/main/userdata/anna_v4) setup with a boiler ()
- [![Generic badge](https://img.shields.io/badge/Anna-v3-green.svg)](https://github.com/plugwise/python-plugwise/tree/main/userdata/anna_without_boiler_fw3) without boiler(i.e. attached to city heating) (compatech)
- [![Generic badge](https://img.shields.io/badge/Anna-v4-green.svg)](https://github.com/plugwise/python-plugwise/tree/main/userdata/anna_without_boiler_fw4) without boiler(i.e. attached to city heating) (compatech)
- [![Generic badge](https://img.shields.io/badge/Anna-v1-green.svg)](https://github.com/plugwise/python-plugwise/tree/main/userdata/legacy_anna) setup with a boiler, but legacy firmware (1.8) ()
- [![Generic badge](https://img.shields.io/badge/Anna-v1-green.svg)](https://github.com/plugwise/python-plugwise/tree/main/userdata/legacy_anna_2) another setup with a boiler, but legacy firmware (1.8), but with a location ()

- [![Generic badge](https://img.shields.io/badge/P1-v3-green.svg)](https://github.com/plugwise/python-plugwise/tree/main/userdata/p1v3) electricity only (compatech)
- [![Generic badge](https://img.shields.io/badge/P1-v3-green.svg)](https://github.com/plugwise/python-plugwise/tree/main/userdata/p1v3solarfake) electricity only - just the above with added data, please submit **yours** (from above)
- [![Generic badge](https://img.shields.io/badge/P1-v3-green.svg)](https://github.com/plugwise/python-plugwise/tree/main/userdata/p1v3_full_option) electricity, solar and gas ()
- [![Generic badge](https://img.shields.io/badge/P1-v2-green.svg)](https://github.com/plugwise/python-plugwise/tree/main/userdata/smile_p1_v2) electricity and gas ()
- [![Generic badge](https://img.shields.io/badge/P1-v2-green.svg)](https://github.com/plugwise/python-plugwise/tree/main/userdata/smile_p1_v2_2) another electricity and gas ()

## Sharing

If you see a yellow item and feel your setup fits in, please **MAIL** one of the authors the output of the below links. Feel free to create a PR if you follow the below privacy hint:

They should al start with `<xml` and copied as plain text (i.e. not preformatted like Chrome and Safari do).
Either use wget/curl or use your 'developer view' from your browser to copy the source text.

``` txt
http://{ip_of_your_smile}/core/appliances
http://{ip_of_your_smile}/core/domain_objects
http://{ip_of_your_smile}/core/locations
http://{ip_of_your_smile}/core/modules
```

## Important

Don't commit test-data in `tests` that shouldn't be available to 'the internet'.
To prevent this we've included a pre-commit hook that checks and validates that no private information is there (but do double-check yourselves!)
See 'scripts/pre-commit.sh' for details

### Excerpt

- [ ] modify `domain_objects` and set `short_id` to `abcdefgh`
- [ ] modify `domain_objects` and set `wifi_ip` to `127.0.0.2`
- [ ] modify `domain_objects` and set `lan_ip` to `127.0.0.1`
- [ ] modify `domain_objects` and set all `ip_addresses` to `127.0.0.3`
- [ ] modify `domain_objects` and set `hostname` to `smile000000`
- [ ] modify `domain_objects` and set `longitude` to `4.49`
- [ ] modify `domain_objects` and set `latitude` to `52.21`
- [ ] modify `domain_objects` and set `city` to `Sassenheim`
- [ ] modify `domain_objects` and set `postal_code` to `2171`

### Obfuscating mac-addresses

We used to obfuscate them as they weren't used within our module nor HomeAssistant.
From v0.16.4 this was changed as such we recommend leaving them in, if you do wish to obfuscate
Note: Zigbee mac addresses are 64bit (not 48bit like Ethernet mac addresses)

Prefix:

- `ABCD01234567`

Postfix:

- Anything you'd normally have (last 4 digits can remain)
- When standardizing:
  - 0001 = Network Mac Address
  - 0101 = Controller Zigbee Mac Address
  - 0Axx = Nodes Zigbee mac addresses