Releases | Open Sustainable Technology

solarthing - Docker installs include netcat

This patch release only affects Docker installs. If you are migrating from an older SolarThing version, please read the release notes for v2025.1.0 to see if it affects you.

You are now able to use the nc command inside the Docker container like so:

docker compose exec rover nc localhost 5051
batteryVoltage
23.9

This is useful for the config server feature that must be enabled for this to be useful for Rover or Tracer charge controllers.

Closes #223

Additionally, the base image of the docker images is now Ubuntu 24.04 (Ubuntu Noble).

Renewable Energy - Photovoltaics and Solar Energy - Java
Published by retrodaredevil 4 months ago

solarthing - Java 17 Required, Java 21 for solarthing-server

This release is the 2025.1.0 release, as I want to be able to do patch version bumps in 2025 for 2025.1.X if necessary. This release has very few changes since v2023.4.1, other than the version bump. However, the fact that I have upgraded the required Java version means you should see if this update affects you:

Does this change affect me?

YES - If you are using a Raspberry Pi 1 or Raspberry Pi Zero
- These Raspberry Pi models are no longer supported because these use armv6 processors, and it has been difficult to get a modern Java version working on these processors for a long time
NO - If you are using a Docker Install
- The Java version upgrade is handled automatically, and no changes are necessary
YES - If you have a native install and do not currently have Java 17 installed
- You will need to install Java 17 or Java 21 (Java 21 is required if you are running SolarThing Server)
- Installing Java 17 may be difficult on some Linux distributions
- Installing Java 21 is likely to be very difficult on many Linux distributions including Debian 12 (Bookworm)
NO - If you have a native install with Java 21 installed on your system

"I'm on an old native install of SolarThing on a device that is now unsupported"

If this is the case, please note that calling git pull could break things in the future. This is unlikely, but one change that has been made to the repository itself is how java is invoked. You may receive warnings if you run git pull and continue to use SolarThing, but as of writing you should be OK for now.

If these changes affect you, please create an issue or comment in our discussion page.

Changes

SolarThing Server's home page automatically updates battery voltage (a319278a9161cd541a85618094645e8d53298b44)
Removed rpi-cpu-temp (this has been deprecated for a while in favor of cpu-temp)
SolarThing CouchDB Setup now puts a validation document in the database to prevent packets with incorrect dates from being uploaded (ccf75009d8e567e591b6ca8eaad5b20a4542a566)
Modifications to GraphQL queries for added functionality
- 01cf88446c885fe7def01f992cca2556647df225
- 0d425c13836bca6598b07011498bf901d9370907 (thanks @eidolon1138 )
Started on solarthing analyze. Its behavior is currently undocumented and breaking changes may occur. Documentation and stability will be added for this feature in the future.

Renewable Energy - Photovoltaics and Solar Energy - Java
Published by retrodaredevil 5 months ago

solarthing - Dependency updates

Drafting this release to keep up to date with the numerous tiny changes that have been made since the last release in July 2023. No notable changes, which is why this release is not tagged with 2024.1.0.

Most noteworthy changes are in 846725e8311ac46ba3b10395f1dc6d9507c90f83, which cleans up log messages for rover and tracer programs.

Renewable Energy - Photovoltaics and Solar Energy - Java
Published by retrodaredevil about 1 year ago

solarthing - Changes under the hood

No exciting changes in this release. Just lots of under the hood improvements.

Changes

No more Google Analytics. All logic for disabling analytics has been kept. I plan to add analytics in the future that does not rely on Google, so please keep your configuration to disable analytics if you do not want a future version of SolarThing to collect usage data.
.data directory is no longer created or used.

Breaking changes

Configurations must use action_config instead of actions. This is not documented, but neither is actually using actions

Technical changes

solarthing-server uses Spring Boot 3.0, which requires lots of changes
solarthing-server also undocumented ability to configure a database that replicates to a main instance

In other news, I am working on a different way to setup and configure SolarThing. I believe the current approach of making sure /opt/solarthing has correct permissions and making sure configuration files are gitignore'd is error prone. I'm always open to suggestions or critique as I would really like to get a better way set in stone before really focusing on improving the documentation.

Renewable Energy - Photovoltaics and Solar Energy - Java
Published by retrodaredevil almost 2 years ago

solarthing - Docker support, upgraded Java versions

This release does not have any exciting new features, but it is the first release to have docker support. With the ability to use docker to run SolarThing, I also decided that a minimum Java version bump was overdue. To run the client program (solarthing.jar), you must have Java 11. To run the server program (solarthing-graphql.jar), you must have Java 17. You are responsible for upgrading your Java version. In general, it should be very easy unless you are using a Raspberry Pi 1 or a Raspberry Pi Zero.

Docker support is available with packages published here: https://github.com/orgs/wildmountainfarms/packages?repo_name=solarthing. Documentation for using Docker is not yet complete, but example docker compose files will soon be available. Docker will likely not be the recommended way to run SolarThing client, but may be recommended for SolarThing server. The advantage of docker is that you won't have to manage your Java installation yourself. All you need is a docker installation!

New features:

Ability to provide interpolated values in select configuration files. This can make it easier to share configuration between programs running SolarThing while customizing options for each.
--validate option. If you are running solarthing directly, you can add the --validate option which will not run any code to upload data or to retrieve data, but will instead tell you if your configuration is valid or not. An exit code of 0 indicates a correctly formatted configuration.

Renewable Energy - Photovoltaics and Solar Energy - Java
Published by retrodaredevil about 2 years ago

solarthing - Testing docker support

Renewable Energy - Photovoltaics and Solar Energy - Java
Published by retrodaredevil about 2 years ago

solarthing - Adding doker support

This release marks the first release with docker support. Assuming this builds fine, v2023.2.2 will be released.

I plan to add support for older versions of SolarThing with docker in the future. I also plan to document this more in the future.

Renewable Energy - Photovoltaics and Solar Energy - Java
Published by retrodaredevil about 2 years ago

solarthing - SolarThing Server Fix

This release fixes a bug in the previous SolarThing Server jar (solarthing-graphql-2023.2.0.jar).
This release has also added the feature of automatically filtering out bad temperature data before uploading to PVOutput.

Announcements:

SolarThing will soon support running via docker. Packages will soon be available at: https://github.com/orgs/wildmountainfarms/packages?repo_name=solarthing. Documentation for using SolarThing in docker will likely remain sparse for the time being.

I plan to update the required Java version for SolarThing Server and SolarThing. I would like to upgrade SolarThing Server to use Java17+ and SolarThing to use Java 11. This may make it harder to run SolarThing on armv6 CPUs (like RPi1s), but it will still be possible by using zulu openjdk builds by azul (easy to install with SDKMAN). SolarThing will still support armv6, but it may require some additional setup.

Renewable Energy - Photovoltaics and Solar Energy - Java
Published by retrodaredevil about 2 years ago

solarthing - ActionLang and more PVOutput upload options

This release contains two main features: The addition of a second way to describe and code actions in SolarThing and options for how temperature and voltage are uploaded to PVOutput (#85).

Automation and request program

Actions should now be specified using the action_config property and the entries property inside that object. See: automation_eq_template.json
Actions being defined in this new way are, by default, assumed to be in NotationScript format. NotationScript is effectively shorthand for the old JSON format. Examples can be found here: actions-ns
- Note: While these are shorthand, you may notice that some types of actions have slightly different names in the NotationScript version. This is to maintain kebab case for nodes and snake_case for user defined identifiers.

PVOutput

voltage_identifier and temperature_identifier are deprecated. Use voltage_from and temperature_from instead.

Once again, the documentation on these new features is lacking. Hopefully I will get around to it, but if I don't feel free to bug me about it: https://github.com/wildmountainfarms/solarthing/issues

Renewable Energy - Photovoltaics and Solar Energy - Java
Published by retrodaredevil about 2 years ago

solarthing - Local actions fixes and rover and tracer modbus command change

Local actions

Bug fixes to make sure long running actions have an up to date reference to current data (e84a79f4ade791ec731043e4292449dd29e5af5f)

Rover and tracer (BREAKING CHANGE)

You can no longer attach a specific device to specific commands. You must use the rover-modbus or tracer-modbus actions to encapsulate your actions that send commands to the rover or tracer

Temperature

Added 16.0 to the list of "bad" temperature values

Mate

Detecting FlexMAX devices should have been fixed. If you were running SolarThing with an outdated MATE and a FLEXmax, SolarThing would crash (#81)

Renewable Energy - Photovoltaics and Solar Energy - Java
Published by retrodaredevil over 2 years ago

solarthing - Local actions revision

Bug fixes for https://github.com/wildmountainfarms/solarthing/releases/tag/v2022.4.0 release. Please see that release for notes.

Renewable Energy - Photovoltaics and Solar Energy - Java
Published by retrodaredevil over 2 years ago

solarthing - Local actions

This release adds local actions and removes the legacy rover program (migrate your rover program to the request format).

mate and request programs

Added actions field to configurations. Works the same way as in the automation program

request program

Deprecated usage of attaching a rover or tracer to commands. Use the rover-modbus or tracer-modbus actions to inject the correct environment into the actions you want to use to command your charge controller.

graphql

Added GraphQL Voyager page and Graphiql page to view schema and query schema.

Renewable Energy - Photovoltaics and Solar Energy - Java
Published by retrodaredevil over 2 years ago

solarthing - SolarThing Web Enhacements

SolarThing Web? What are you talking about? Well, conveniently attached to the SolarThing GraphQL program (AKA SolarThing Server), is a web interface. At the moment, it is very basic, but it now has some features worth talking about. Note that this is different than the Legacy solarthing-web project, but does include the "classic" view from that project.

SolarThing Web

Added a navigation bar
Added /classic endpoint
Added /authorized endpoint
- You can authorize and deauthorize senders

Release Process Changes

Moving forward, artifacts being attached to releases will be attached by GitHub actions. This will automate things and could even help sign jars in the future for extra security. Documentation PDFs and epubs will also be published, but it is recommended to go to https://solarthing.readthedocs.io for the latest documentation
EDIT: solarthing-2022.3.1.jar was not automatically updated, as I had to manually fix it ☹️

Renewable Energy - Photovoltaics and Solar Energy - Java
Published by retrodaredevil almost 3 years ago

solarthing - Small updates with minor breaking changes

This release has a bunch of small changes from the past few months.

Breaking changes

run subcommand is now required when running the jar file. No one should notice this change
Some of the old send commands are no longer supported such as sendcommand. You must now use sendopen.

GraphQL

Added a React frontend that is served on the root path. This is a work in progress, but for now it displays the battery voltage for the default source ID
It's worth mentioning that the GraphQL program is now more of a server program for SolarThing. Expect the name of this program to change in the future to something like "SolarThing Server"

SolarThing Check

The solarthing check command now has a --debug flag to spit out more information. This will help with issues like #55.

Other changes (part of the repo, not jars)

When compiling yourself, jar files will be put in one of two spots, which will help avoid writing over the jar file being used to run SolarThing when developing

Renewable Energy - Photovoltaics and Solar Energy - Java
Published by retrodaredevil almost 3 years ago

solarthing - Command receiving changes, removed legacy CouchDB view,

This release has many small changes

All

Packet IDs default to using a shorter variant

Modbus (rover and tracer)

Added configurable initial_timeout and end_timeout parameters

Commands

Command packet collections must only have 3 packets: LARGE_INTEGRITY, SOURCE, FRAGMENT_INDICATOR
Upon the receiving of a command, an accept or reject packet will be uploaded to the events database

GraphQL

Added battery record caches
Subsequent queries that are identical to currently processing queries will wait on the result of the query in progress

Automation

Deprecated sendcommand and sendrequestheartbeat
Scheduling commands now allows "and" to be present in relative duration requests
The alter manager action requires a fragment ID to be provided. This is a breaking change to configs if anyone was using this feature.

CouchDB

The setup program will now no longer create the millis view, which is used by old versions of SolarThing
The manager user will have permission to upload to solarthing_events.

Renewable Energy - Photovoltaics and Solar Energy - Java
Published by retrodaredevil about 3 years ago

solarthing - Tracer and Rover events, Better event reupload, GraphQL program logging

This release has a lot of small changes that will go unnoticed.

New documentation available on https://solarthing.readthedocs.io. A PDF of the documentation will also be attached to each release for preservation of the state of the documentation at a given time. However you should use https://solarthing.readthedocs.io for up to date documentation usually.

All

Fixed CouchDB uploading bug that caused one or two errors to be spit out every time a new document ID was generated (happens about once or twice every 2 minutes depending on what your unique is set to)

Rover

rover charging state change event
rover error mode change event

Tracer

Charging equipment status change event

GraphQL

Logs are now written to the logs directory. You should use less -R to view those logs, as they will contain color and do not look good when viewed with certain editors.

Automation

Added heartbeat command to chatbot
Internally added ResourceManager

Internal changes:

Got rid of InstantType.
Reuploading event packets is not reliant on new events being processed.
More debugging around mate packets being ignored for being stale or duplicated

Renewable Energy - Photovoltaics and Solar Energy - Java
Published by retrodaredevil over 3 years ago

solarthing - Better CLI Experience, Security Updates

The biggest change in this release is the addition of the solarthing check command. The command line experience is also more complete with the addition of solarthing version. SolarThing will also log the date that the jar file was last modified.

Updated to log4j version 2.17.0 and many other version bumps.

The solarthing check command can be used to scan for all types of devices.

Renewable Energy - Photovoltaics and Solar Energy - Java
Published by retrodaredevil over 3 years ago

solarthing - Security Fix, withlock action, flags, graphql alter query, rest command/run endpoint

Security Fix: This release has an important security fix described in #49. It is recommended everyone upgrade, although it is unlikely the vulnerability can be exploited for most SolarThing set ups.

All

millisNull view is (in automation program and in graphql program)
Actions
Added a withlock action, which is recommended whenever you are dealing with an action that should never parallel itself.
- As of right now, many actions that using locks in config_templates have bugs in them that cause them to unlock even when there's already a lock on them
log action can send to the summary log if desired
Flags are a new feature that can be set using an authorized client (currently only slack chat bots). Flags can be utilized in actions for checking if boolean configuration values are set/unset.
New heartbeat packets. This is a good way to make sure commands stay working. You can set up alerts with the message-sender action part of the automation program

GraphQL/REST Program

New GraphQL queries for alter database related stuff
/commend/run endpoint for executing actions. An API key is required. You can make your own API keys and put them in the configuration
- This feature is undocumented as of now. I hope to add documentation for it in the future.
- This feature sets CORs headers that allow it to be called from a browser.

Renewable Energy - Photovoltaics and Solar Energy - Java
Published by retrodaredevil over 3 years ago

solarthing - Alter Database, CouchDB Setup Fixes, Feedback Actions, GraphQL program at Java 11

Update 2021-12-11: This release (and previous releases) contains the CVE-2021-44228 vulnerability. See #49 for more info.

This release has a LOT of changes. Many will go unnoticed, and many new features will remain undocumented until I get around to well, documenting them.

These changes likely won't mean anything for most users of SolarThing, so updating likely will not fix any bugs or add any new featuers, however I always recommend updating so that if there is a problem, you can let me know!

If you aren't going to update, that's OK, however I do recommend that you run the CouchDB setup program again: instructions. If you have already ran CouchDB setup once before, give it the same usernames as before, and it will not prompt to create a new user. Running the CouchDB program again will make your database more secure from unauthorized changes.

Alter:

Added alter database
Scheduled commands now work

Automation

Added action to handle the alter database
Slack chatbot
- Can now request to schedule commands and cancel those commands

Commands:

The JSON of requesting commands has some additions. Notably, the execution reason, which will commonly contain a source from the open database
While a command is being executed, an action can now send feedback to solarthing_events to indicate that something has happened.
Clients that are requesting commands must be updated in order to work. The expected (root) dateMillis and encrypted dateMillis must now be the same in order for a command to be processed.
Even unauthorized commands are now only processed once, instead of being processed repeatedly during the 5 minutes they are queried.

GraphQL

Bug fix for CouchDB queries that affected solcast data queries

Internal Changes:

GraphQL program requires Java 11
Updated to gradle 7

Renewable Energy - Photovoltaics and Solar Energy - Java
Published by retrodaredevil over 3 years ago

solarthing - Slack chatbot, better GraphQL solcast, removed convenience fields

This release contains a bunch of stuff that will be left undocumented for a while probably.

This release adds a chatbot, which currently can only be used with slack. There is no documentation on how to set this up, but it is an action that you put in a config for solarthing-automation.

All

Option to shorten document ID. This helps a tiny bit to reduce the amount of storage CouchDB uses.
[Action] Added wait action, which takes an ISO duration rather than milliseconds
Added a way to start a server and send log messages to anyone netcatting the server. This functionality is off by default.

Mate:

FX and MX packets no longer contain convenience fields. This is to help reduce the amount of space CouchDB uses, as we don't actually need to store the name of the mode these devices are in.

GraphQL:

Solcast query now uses actual past data rather than an API call for past data.

Bug Fixes:

PVOutput identifier selection is no longer broken
Available commands packets no longer are added if there are no preceding packets

Renewable Energy - Photovoltaics and Solar Energy - Java
Published by retrodaredevil over 3 years ago

solarthing - Tracer release

SolarThing now supports the EPEver Tracer charge controller!

All:

Fixed bug when retrieving authorized users for commands
If you use the SNAPSHOT program and update while SolarThing is running, SolarThing may crash. If it does, it will automatically restart assuming the new systemd service is installed.

Request

Added tracer support

Mate:

The IO now automatically tries to reload if it fails. --This is mostly untested

CouchDB Setup

solarthing_cache database is automagically created

Rover

Added undocumented configuration option to create a server that can be connected to by a simple client such as netcat (nc)
- This is also part of the new tracer feature and will be documented in the future

Renewable Energy - Photovoltaics and Solar Energy - Java
Published by retrodaredevil almost 4 years ago

solarthing - Rover program changes to request

This release makes using the rover program obsolete. Although existing configurations will continue to work as before, it is recommended to eventually upgrade your rover program to use the request program instead. The rover quickstart now shows an up to date way on how to configure the request program to be identical to your old rover configuration.

These changes also make it possible to monitor multiple rovers in the same program. If this is useful to anyone, please make an issue on the issues page and I will update the documentation for it.

The rover-setup program still exists. If you want to use the "dummy" rover configuration, you now must make a "dummy" io configuration. A base template for that is provided in the config_templates/io directory.

Rover:

New way to configure using the request program

GraphQL

Undocumented /cache endpoint has been added, making the program more of a "RESTful" program. This along with solarthing_cache may by updated with documentation in the future

Message:

Mattermost is no longer supported. If anyone was actually using this, please let me know. It's pretty easy to add back.

I realize that documentation may be lacking for a few of the added features, so if you find anything in particular lacking, please make an issue about it!

Renewable Energy - Photovoltaics and Solar Energy - Java
Published by retrodaredevil almost 4 years ago

solarthing - Bug fix

CouchDB bug fix for last release. After some testing, this will be made the default version soon. Remember if you have socket_timeout in your couchdb config, you need to change it to call_timeout.

Renewable Energy - Photovoltaics and Solar Energy - Java
Published by retrodaredevil almost 4 years ago

solarthing - Internal improvements

Many internal improvements. This will not initially be a default release. You can use it by typing export SOLARTHING_VERSION_OVERRIDE="2021.4.0"

Databases:

Internal CouchDB improvements. socket_timeout must be renamed to call_timeout
CouchDB uses cookie auth

Renewable Energy - Photovoltaics and Solar Energy - Java
Published by retrodaredevil almost 4 years ago

solarthing - Many small bug fixes

This release contains a few bug fixes:

Rover:

When reloading the serial port, it will not re-read the configuration from the file system anymore.

PVOutput:

Fixed rover consumption not being uploaded

Request:

Hopefully fixed 25C bug for temperature sensing

Message (part of automation):

Generator unused alert also checks slave FXs for voltage being above voltage threshold

GraphQL:

Added some queries (that take forever) to see total kWh over the course of a month.
- This is not meant to be queried in graphql-datasource, just as a fun query to do with GraphQL Playground

Renewable Energy - Photovoltaics and Solar Energy - Java
Published by retrodaredevil about 4 years ago

solarthing - MQTT LWT, W1 temp fix, Solcast race condition fix

This is a release with very few changes:

MQTT database:

There is now a last will testament (LWT). This is published to solarthing/%source/%fragment/status for a topic format of solarthing/%source/%fragment/%identifier

GraphQL:

Fixed Solcast race condition for cache

Request:

W1 temperature request now ignores extreme temperatures that are obviously bad readings

Renewable Energy - Photovoltaics and Solar Energy - Java
Published by retrodaredevil about 4 years ago

solarthing - MQTT Support, Rover Scan, Pzem Shunt

This release adds beta MQTT support, a way to scan for the Rover's modbus address in rover-setup, and pzem shunt support. All these features are currently not documented

All

SolarThing will crash if your database config has unknown values in it (this will alert you to typos in your config)
mqtt is a supported database

Rover-setup

In the rover setup program, you can type something like scan 1 20 to check to see if the Rover's address is from 1 to 20. Note that it takes about 2 seconds per address to check, so a scan from 1 to 20 takes about 40 seconds.

Request

There is now working support for Pzem shunts.

Renewable Energy - Photovoltaics and Solar Energy - Java
Published by retrodaredevil about 4 years ago

solarthing - API Release

API Release. This is used with Jitpack for solarthing-android. Normaly users can ignore this release.

Renewable Energy - Photovoltaics and Solar Energy - Java
Published by retrodaredevil about 4 years ago

solarthing - Rover bug fix and pzem shunt

Rover

Bug fix: Some parameters were not being parsed correctly
- Anyone using the rover program is recommended to update. While these parameters aren't that important, you might thank yourself later if you get an updated version that correctly stores these parameters

Pzem

Added beta pzem shunt

GraphQL

Display name of your "rover" should change to reflect what it actually is. If you don't like it, use the new stripExtra query to get back to the original

This version is 2021.3.0 instead of 2021.2.1 because of the rover bug fix. This version also adds an additional field to rover status packets called packetVersion. Because of this, you will also have to update your GraphQL program if you update your rover program to this version.

Renewable Energy - Photovoltaics and Solar Energy - Java
Published by retrodaredevil about 4 years ago

solarthing - Better Renogy DCDC support and serial port reinitialize

Rover and GraphQL:

More fields are available to query in GraphQL (Some name changes too, possibly breaking changes)

Serial Port General:

If your serial port disconnects, or is unavailable upon startup, SolarThing will spew out errors and try to reinitialize the serial port every so often

Renewable Energy - Photovoltaics and Solar Energy - Java
Published by retrodaredevil about 4 years ago

solarthing - InfluxDB 2.0 support

General:

Added support for InfluxDB 2.0
- Note that I have no idea how to migrate from 1.X and the layout is likely going to be different when you start using SolarThing's 2.0 implementation, so I don't recommend even attempting to migrate.
- The main solarthing jar file is going to be slightly bigger in size because of the library being used for InfluxDB 2.0

Automation:

Fixed low battery and generator state message events
Some message event alert timestamps are prettier

Renewable Energy - Photovoltaics and Solar Energy - Java
Published by retrodaredevil about 4 years ago

solarthing - API Release

API Release. This is used with Jitpack for solarthing-android. Normaly users can ignore this release.

Renewable Energy - Photovoltaics and Solar Energy - Java
Published by retrodaredevil over 4 years ago

solarthing - Better debug, added acmodealert

General:

Removed some debug statements, made one common warn statement debug instead

Request

Fixed rare Raspberry Pi CPU temperature bug that caused program to crash

Automation

Added acmodealert event for message-sender action

Rover

Model of rover will be reported to analytics

Changes made that don't require a new jar file:

Installing the systemd service will now not log to /var/log

Renewable Energy - Photovoltaics and Solar Energy - Java
Published by retrodaredevil over 4 years ago

solarthing - Rover Elite fix, added "post" database

AKA 2020.5.2.

General

Added "post" database which allows a packet collection to be posted to a server acting as a REST API.

Rover

Fixed error that occurs on (most if not all) Rover Elite models.

Renewable Energy - Photovoltaics and Solar Energy - Java
Published by retrodaredevil over 4 years ago

solarthing - Uses IS0-8601 durations for config values, removed message program

All duration values in config now use the ISO-8601 duration format (ex: "PT5M" for 5 minutes). The message program has been removed.

Fixed bug where in the few places that required a the duration format, didn't work.

Renewable Energy - Photovoltaics and Solar Energy - Java
Published by retrodaredevil over 4 years ago

solarthing - More message sender events, HASS, Solcast, better CLI

General

Better command line interface
CouchDB setup program

Message program

Deprecated in favor of automation program using action message-sender

Automation program

Added home assistant and Solcast upload actions

GraphQL

Added Solcast queries

Renewable Energy - Photovoltaics and Solar Energy - Java
Published by retrodaredevil over 4 years ago

solarthing - Slack bot and other improvements

The solarthing message program can now send messages to a slack channel.

W1 temperature sensors are now more reliable and many of the log messages are now debug only.

Renewable Energy - Photovoltaics and Solar Energy - Java
Published by retrodaredevil over 4 years ago

solarthing - Bug fix when 'commands' not defined

This fixes a bug in the Mate and Rover programs where the commands attribute is not present in the json config.

Renewable Energy - Photovoltaics and Solar Energy - Java
Published by retrodaredevil over 4 years ago

solarthing - Small changes, automation program added

This release has a few changes:

PVOutput:

If the join_teams option is set to true, the SolarThing team will be joined. This currently defaults to false, but may default to true in a future version

Automation program:

This is a new program with very little documentation on how it can be used.
This can automatically send commands based on certain events

All:

The source ID is now validated. This prevents you from using crazy source IDs

Renewable Energy - Photovoltaics and Solar Energy - Java
Published by retrodaredevil over 4 years ago

solarthing - API Release

API Release to make DataIdentifier have equals and hashCode methods.

Renewable Energy - Photovoltaics and Solar Energy - Java
Published by retrodaredevil over 4 years ago

solarthing - API Release

Small changes so this remains compatible with Android SDK 19 without core library desugaring

Renewable Energy - Photovoltaics and Solar Energy - Java
Published by retrodaredevil over 4 years ago

solarthing - Commands for rover program, import/export PVOutput, GraphQL improvements

Many new features are included in this release:

Rover:

You can define commands similar to the mate program. These can turn on and off the load from the android application
Rover's isNewDay fixed (this fixes a bug that other code that relied on this such as GraphQL and the android application)

PVOutput:

Import/export values correspond to buy/sell values from FX

GraphQL:

FX Timers added
Daily kWh queries
Query all solar devices and charge controllers

Request:

Battery voltage only packet to be used with the Arduino program

Message

"lowbatteryvoltage" event now has "time" field to be used to only alert when voltage has been below for a number of seconds.

Some of these new features don't have great documentation yet. If you are interested in them but are unable to figure out how to use them, please create an issue.

Renewable Energy - Photovoltaics and Solar Energy - Java
Published by retrodaredevil almost 5 years ago

solarthing - API Release

Changes to FX Charging classes and other changes since the last API Release such as the meta database.

Renewable Energy - Photovoltaics and Solar Energy - Java
Published by retrodaredevil almost 5 years ago

solarthing - Bug fix

Small bug fix for 2020.3.3.

Renewable Energy - Photovoltaics and Solar Energy - Java
Published by retrodaredevil almost 5 years ago

solarthing - GraphQL Changes

This release mostly contains changes for the GraphQL Program.

GraphQL Changes:

Metadata can be used. (from "meta" document in "solarthing_closed" CouchDB database)
Source IDs are not required when fragment ID is required
Size of jar file slightly reduced

Message Changes:

Temperature event added
Log message sender added

PVOutput

Temperature can be uploaded

Rover

Identifier representation for Rover has been changed to "RoverIdentifier()". This may affect InfluxDB queries if you are using the identifier field.

Renewable Energy - Photovoltaics and Solar Energy - Java
Published by retrodaredevil almost 5 years ago

solarthing - Added 'request' option to mate and rover program

Added 'request' option to mate and rover program. This is a replacement for extra_option_flags and can be used to read DS18B20 temperature sensors without using the request program type.

Renewable Energy - Photovoltaics and Solar Energy - Java
Published by retrodaredevil almost 5 years ago

solarthing - Command and GraphQL changes

Fixed a small GraphQL bug and added auxstate action for Outback Mate commands. Also added an additional query to GraphQL.

Also the size of the main SolarThing download has decreased by about 4MB. We're always looking for ways to decrease download sizes!

Renewable Energy - Photovoltaics and Solar Energy - Java
Published by retrodaredevil almost 5 years ago

solarthing - Many Changes

This release introduces changes mostly for the "mate" program. (These changes are mostly technical changes)

All:

You can now configure the time zone
null fragment IDs are not allowed

Mate Changes:

MX Daily packets are deprecated
FX Daily packets don't store data on disk
New command structure (for use with future release of SolarThing Android)
- Available commands packet
Commands are sent over a period of 2 seconds to make sure they are received

Rover Changes:

User battery types renamed

PVOutput

Can now be configured to upload voltage

GraphQL, PVOutput, and Message

Unrecognized packets will allow the program to keep functioning

Renewable Energy - Photovoltaics and Solar Energy - Java
Published by retrodaredevil almost 5 years ago

solarthing - API Release

Added LargeIntegrityPacket and a utility to hash data.

Renewable Energy - Photovoltaics and Solar Energy - Java
Published by retrodaredevil almost 5 years ago

solarthing - API Release

API Release with TargetPacketGroup, many changes, and some removals.

Renewable Energy - Photovoltaics and Solar Energy - Java
Published by retrodaredevil almost 5 years ago

solarthing - Bug fix for rover user battery type

Bug fix for rover user battery type.

This release also adds the 'request' program. Documentation for this program will be added in the future.

Renewable Energy - Photovoltaics and Solar Energy - Java
Published by retrodaredevil almost 5 years ago

solarthing - Added purejavacomm serial implementation

You can now optionally use purejavacomm for your serial implementation.

Renewable Energy - Photovoltaics and Solar Energy - Java
Published by retrodaredevil almost 5 years ago

solarthing - message-sender program and more bug fixes

Added message-sender program which currently allows messages to be sent to a Mattermost server as a bot.

Fixes some rare bugs while running Rover program. (Like super duper rare).

Renewable Energy - Photovoltaics and Solar Energy - Java
Published by retrodaredevil almost 5 years ago

solarthing - Rover bug fix

This fixes a rare bug that happens when the device disconnects. This may also help prevent random disconnects in the future for serial devices.

Renewable Energy - Photovoltaics and Solar Energy - Java
Published by retrodaredevil almost 5 years ago

solarthing - Small improvements

Small improvements for debug logging. This will minimize the amount of time spent writing to the disk.

Renewable Energy - Photovoltaics and Solar Energy - Java
Published by retrodaredevil almost 5 years ago

solarthing - API Release

Made IdentifierFragment interface, removed Packet bound from daily stuff, rover identifier always equal. Identifier no longer implements Comparable.

Renewable Energy - Photovoltaics and Solar Energy - Java
Published by retrodaredevil almost 5 years ago

solarthing - API Release - New NotNull and Nullable annotations

New NotNull and Nullable annotations

Renewable Energy - Photovoltaics and Solar Energy - Java
Published by retrodaredevil almost 5 years ago

solarthing - Serial Port Updates

Serial Port Updates: Updates some serial port libraries to make serial ports more reliable.

Renewable Energy - Photovoltaics and Solar Energy - Java
Published by retrodaredevil almost 5 years ago

solarthing - SolarThing API Release

This is release 3.7.0 of the SolarThing API. This is the first release after the git history rewrite.

API releases will always have the "pre-release" because these are not meant for regular users.

Renewable Energy - Photovoltaics and Solar Energy - Java
Published by retrodaredevil almost 5 years ago

solarthing - First release with new structure!

First release with new structure!

Renewable Energy - Photovoltaics and Solar Energy - Java
Published by retrodaredevil almost 5 years ago

Recent Releases of solarthing

solarthing - Docker installs include netcat

solarthing - Java 17 Required, Java 21 for solarthing-server

solarthing - Dependency updates

solarthing - Changes under the hood

solarthing - Docker support, upgraded Java versions

solarthing - Testing docker support

solarthing - Adding doker support

solarthing - SolarThing Server Fix

solarthing - ActionLang and more PVOutput upload options

solarthing - Local actions fixes and rover and tracer modbus command change

solarthing - Local actions revision

solarthing - Local actions

solarthing - SolarThing Web Enhacements

solarthing - Small updates with minor breaking changes

solarthing - Command receiving changes, removed legacy CouchDB view,

solarthing - Tracer and Rover events, Better event reupload, GraphQL program logging

solarthing - Better CLI Experience, Security Updates

solarthing - Security Fix, withlock action, flags, graphql alter query, rest command/run endpoint

solarthing - Alter Database, CouchDB Setup Fixes, Feedback Actions, GraphQL program at Java 11

solarthing - Slack chatbot, better GraphQL solcast, removed convenience fields

solarthing - Tracer release

solarthing - Rover program changes to request

solarthing - Bug fix

solarthing - Internal improvements

solarthing - Many small bug fixes

solarthing - MQTT LWT, W1 temp fix, Solcast race condition fix

solarthing - MQTT Support, Rover Scan, Pzem Shunt

solarthing - API Release

solarthing - Rover bug fix and pzem shunt

solarthing - Better Renogy DCDC support and serial port reinitialize

solarthing - InfluxDB 2.0 support

solarthing - API Release

solarthing - Better debug, added acmodealert

solarthing - Rover Elite fix, added "post" database

solarthing - Uses IS0-8601 durations for config values, removed message program

solarthing - More message sender events, HASS, Solcast, better CLI

solarthing - Slack bot and other improvements

solarthing - Bug fix when 'commands' not defined

solarthing - Small changes, automation program added

solarthing - API Release

solarthing - API Release

solarthing - Commands for rover program, import/export PVOutput, GraphQL improvements

solarthing - API Release

solarthing - Bug fix

solarthing - GraphQL Changes

solarthing - Added 'request' option to mate and rover program

solarthing - Command and GraphQL changes

solarthing - Many Changes

solarthing - API Release

solarthing - API Release

solarthing - Bug fix for rover user battery type

solarthing - Added purejavacomm serial implementation

solarthing - message-sender program and more bug fixes

solarthing - Rover bug fix

solarthing - Small improvements

solarthing - API Release

solarthing - API Release - New NotNull and Nullable annotations

solarthing - Serial Port Updates

solarthing - SolarThing API Release

solarthing - First release with new structure!