Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

chore: readme #2

Merged
merged 1 commit into from
Oct 22, 2023
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
63 changes: 44 additions & 19 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,39 +1,64 @@
![Logo](http://svg.wiersma.co.za/glasslabs/module?title=CLOCK&tag=a%20simple%20clock%20module)
![Logo](http://svg.wiersma.co.za/glasslabs/module?title=SOLAR&tag=a%20solar%20inverter%20module)

Clock is a simple clock module for [looking glass](http://github.com/glasslabs/looking-glass)

![Screenshot](.readme/screenshot.png)
Solar inverter module for [looking glass](http://github.com/glasslabs/looking-glass)

## Usage

Clone the clock into a path under your modules path and add the module path
to under modules in your configuration.

```yaml
modules:
- name: simple-clock
url: https://github.com/glasslabs/clock/releases/download/v1.0.0/clock.wasm
- name: simple-solar
url: https://github.com/glasslabs/solar/releases/download/v1.0.0/solar.wasm
position: top:right
config:
timeFormat: 15:04
url: http://my-hass-instance:8123
token: <your-hass-token>
sensorIds:
load: sensor.deye_sunsynk_sol_ark_load_power
pv: sensor.deye_sunsynk_sol_ark_pv_power
battery: sensor.deye_sunsynk_sol_ark_battery_power
batterySoC: sensor.deye_sunsynk_sol_ark_battery_state_of_charge
grid: sensor.deye_sunsynk_sol_ark_generator_power
gridFrequency: sensor.deye_sunsynk_sol_ark_grid_frequency
battery:
warning: 50
low: 30
maxWatts: 6000
```

## Configuration

### Time Format (timeFormat)
### Load Sensor ID (sensorIds.load)

The Home Assistant load power sensor ID.

### PV Sensor ID (sensorIds.pv)

The Home Assistant PV power sensor ID.

### Battery Sensor ID (sensorIds.battery)

The Home Assistant Battery power sensor ID.

### Battery SoC Sensor ID (sensorIds.batterySoC)

The Home Assistant Battery State of Charge sensor ID.

### Grid Sensor ID (sensorIds.grid)

The Home Assistant Grid power sensor ID.

*Default: 15:04*
### Grid Frequency Sensor ID (sensorIds.gridFrequency)

Formats the time display of the clock using Go's [time formatting syntax](https://golang.org/pkg/time/#Time.Format).
The Home Assistant grid frequency sensor ID. This is used to determine if there is a grid connection.

### Date Format (dateFormat)
### Battery Warning Percentage (battery.warning)

*Default: Monday, January 2*
The Battery percentage for the battery bar to display in warning style.

Formats the date display of the clock using Go's [time formatting syntax](https://golang.org/pkg/time/#Time.Format).
### Battery Low Percentage (battery.low)

### Time Zone (timezone)
The Battery percentage for the battery bar to display in low style.

*Default: Local*
### Maximum Watts (maxWatts)

The timezone name according to [IANA Time Zone databse](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones)
The maximum Watts used to scale the other sensors.
Loading