QSB36

Query SunnyBoy 3.6 inverter for current output in watts, total yield and other information via the inverter's internal web interface.

Note:

• the inverter only supports http, not https
• the inverter limits the number of active sessions, so it is a good idea to log out when your program terminates
• the inverter may close your session after a period of inactivity
• in your application, you probably want to poll the current ouput every n seconds, where n is small
• you probably want to poll the other values much less frequently
• be careful not to put too much pressure on the inverter's web server by excessive querying of historical yields
• you will have to interpret the data yourself and calculate your own deltas
• there is currently next to no input value verification; use carefully
• this module has so far only been tested on one specific actual device; there is no guarantee that this module is fit for your purpose / inverter; use at your own risk

Example

iex> {:ok, session} = QSB36.user_login("192.168.1.90", "password_for_user_group")
{:ok, %QSB36.Session{host: "192.168.1.90", sid: "mOi0Eg_N4kaNhg_R"}}

iex> QSB36.device_info(session)
{:ok, {"SB3.6-1AV-40 231", 1234567890}}

iex> QSB36.health_status(session)                      
{:ok, {307, :ok}}

iex> QSB36.current_time(session)
{:ok, {1584382357, 0}}

iex> QSB36.current_watts(session)
{:ok, 262}

iex> QSB36.total_yield(session)
{:ok, 3388801}

iex> QSB36.yield_daily(session, 1584309600, 1584410400) 
{:ok, [{1584316800, 3356183}, {1584403200, 3370444}]}

iex> QSB36.yield_5min(session, 1584316800, 1584403200)  
{:ok,                    
  [                       
    {1584316800, 3356183},
    ...
    {1584403200, 3370444}
  ]
}

iex> QSB36.logout(session)
:ok

Installation

Add qsb36 to your list of dependencies in mix.exs:

def deps do
  [
    {:qsb36, "~> 0.1.0"}
  ]
end

The docs can be found at https://hexdocs.pm/qsb36.