ioBroker.echarts is an ioBroker adapter designed for building and displaying useful charts within the ioBroker smart home ecosystem. It leverages the powerful Apache ECharts library to render various chart types like line, bar, and radar charts. Currently at version 3.1.0, the adapter receives updates with moderate frequency, often including bug fixes, dependency updates, and minor feature enhancements. Key differentiators include its tight integration with ioBroker states, allowing data from various devices and services to be easily visualized. It supports data input from custom JSON states and offers server-side rendering capabilities to generate static chart images (SVG, PNG, JPG, PDF) for use in other applications or storage. The adapter also provides dedicated widgets for ioBroker Vis for easy chart embedding.
npm install iobroker.echartsVerified import paths — ran on the pinned version, not inferred.
Demonstrates how to programmatically request server-side chart rendering and how to update a chart by writing to an ioBroker JSON state.
Ensure your ioBroker host system is running Node.js version 20 or newer. Update Node.js if necessary using recommended ioBroker upgrade procedures.
Refer to the Sentry-Plugin Documentation (linked in the adapter's README) for instructions on how to disable this error reporting feature if desired.
Pre-process your data to include desired aggregations or specific time ranges before formatting it as JSON and writing it to the ioBroker state. Ensure 'ts', 'time', 't', or 'date' are used for timestamps and 'val', 'value', 'v', 'data', or 'y' for values in the JSON objects.
For touch devices, consider disabling zoom if legend interaction is critical, or provide alternative controls for data visibility outside the chart legend.
Ensure your ioBroker `js-controller` is updated to at least version 6.0.11 and the Admin adapter to at least 7.6.20. Update your `io-package.json` and `package.json` dependencies if you are developing or contributing to the adapter itself.
Check your Node.js version (`node -v`) and ensure it's `>=20`. Run `iobroker fix` to correct permissions. Verify network connectivity to npm registries. Try `npm cache clean --force` and then retry installation.
Review your chart preset configuration in the ioBroker admin interface. Validate your JSON data structure, ensuring it contains valid `ts`/`time`/`t`/`date` for timestamps and `val`/`value`/`v`/`data`/`y` for values. Use a JSON validator to check syntax.
This often points to missing system-level dependencies for `node-canvas` or `jsdom`. Install required build tools and libraries for your OS (e.g., `sudo apt-get install build-essential libcairo2-dev libpango1.0-dev libjpeg-dev libgif-dev librsvg2-dev` on Debian/Ubuntu). Then, try reinstalling the adapter or running `npm rebuild` within the adapter's directory.
Verify that the `echarts.0` adapter instance is running in the ioBroker admin interface. Double-check the `preset` ID in your `sendTo` call against your configured presets. Review the ioBroker logs for the `echarts.0` instance for more specific error messages related to the rendering request. Ensure all parameters in the `sendTo` payload are correct and valid.
No dependency data recorded yet.