->VERSION()} im FHEMWEB kann Modulversion abgefragt werden
@@ -8794,13 +8816,10 @@ return;
For the connection to the database a configuration file is used.
- The configuration is stored in a separate file to avoid storing the password in the main configuration file and to have it
- visible in the output of the list command.
+ The configuration file is copied e.g. to /opt/fhem and has the structure shown below.
+ The specifications are to be adapted according to the used environment (uncomment and change corresponding lines):
- The configuration file should be copied e.g. to /opt/fhem and has the following structure you have to customize
- suitable to your conditions (decomment the appropriate raws and adjust it):
-
####################################################################################
# database configuration file
@@ -8814,6 +8833,8 @@ return;
####################################################################################
#%dbconfig= (
# connection => "mysql:database=fhem;host=<database host>;port=3306",
+ # # if want communication over socket-file instead of TCP/IP transport, use:
+ # # connection => "mysql:database=fhem;mysql_socket=</patch/socket-file>",
# user => "fhemuser",
# password => "fhempassword",
# # optional enable(1) / disable(0) UTF-8 support
@@ -9464,17 +9485,21 @@ return;
- get <name> <in> <out> <from> <to> <column_spec>
- Read data from the Database used by frontends to plot data without direct
- access to the Database.
+ Read data from the Database used by frontends to plot data without direct access to the Database.
- <in>
- A dummy parameter for FileLog compatibility. Sessing by defaultto -
+ A parameter to establish compatibility with Filelog.
+ In the definition of an SVG device this parameter corresponds to the specification of :<logfile> at the end of the definition.
+ The following characteristics are allowed:
- - current: reading actual readings from table "current"
- - history: reading history readings from table "history"
- - -: identical to "history"
+ - current: the values are read from the "current" table.
+ - history: the values are read from the "history" table.
+ - table_<table>: the values are read from the specified alternative table. The table (name)
+ must be created in the database with lowercase letters.
+ (example: table_energy, "energy" is the alternative table created in the database)
+ - -: identical as "history
@@ -9884,11 +9909,11 @@ return;
- colEvent <n>
- The field length of database field EVENT will be adjusted. By this attribute the default value in the DbLog-device can be
- adjusted if the field length in the databse was changed nanually. If colEvent=0 is set, the database field
- EVENT won't be filled .
+ The field length of database field EVENT is adapted user-specifically. The attribute can be used to change the
+ default value in the module if the field length in the database was changed manually.
+ With colEvent=0 the database field EVENT is not filled.
Note:
- If the attribute is set, all of the field length limits are valid also for SQLite databases as noticed in Internal COLUMNS !
+ With set attribute all field length limits are also valid for SQLite DB as shown in Internal COLUMNS!
@@ -9899,11 +9924,26 @@ return;
- colReading <n>
- The field length of database field READING will be adjusted. By this attribute the default value in the DbLog-device can be
- adjusted if the field length in the databse was changed nanually. If colReading=0 is set, the database field
- READING won't be filled .
+ The field length of database field READING is adapted user-specifically. BThe attribute can be used to change the
+ default value in the module if the field length in the database was changed manually.
+ With colReading=0 the database field READING is not filled.
Note:
- If the attribute is set, all of the field length limits are valid also for SQLite databases as noticed in Internal COLUMNS !
+ With set attribute all field length limits are also valid for SQLite DB as shown in Internal COLUMNS!
+
+
+
+
+
+
+
+ - colType <n>
+
+
+ The field length for the database field TYPE is adapted user-specifically. The attribute can be used to change the
+ default value in the module if the field length in the database was changed manually.
+ With colType=0 the database field TYPE is not filled.
+ Note:
+ With set attribute all field length limits are also valid for SQLite DB as shown in Internal COLUMNS!
@@ -9914,11 +9954,11 @@ return;
colValue <n>
- The field length of database field VALUE will be adjusted. By this attribute the default value in the DbLog-device can be
- adjusted if the field length in the databse was changed nanually. If colEvent=0 is set, the database field
- VALUE won't be filled .
+ The field length of database field VALUE is adapted user-specifically. The attribute can be used to change the
+ default value in the module if the field length in the database was changed manually.
+ With colValue=0 the database field VALUE is not filled.
Note:
- If the attribute is set, all of the field length limits are valid also for SQLite databases as noticed in Internal COLUMNS !
+ With set attribute all field length limits are also valid for SQLite DB as shown in Internal COLUMNS!
@@ -10650,14 +10690,10 @@ attr SMA_Energymeter DbLogValueFn
enthalten.
Für die Verbindung zur Datenbank wird eine Konfigurationsdatei verwendet.
- Die Konfiguration ist in einer sparaten Datei abgelegt um das Datenbankpasswort nicht in Klartext in der
- FHEM-Haupt-Konfigurationsdatei speichern zu müssen.
- Ansonsten wäre es mittels des list Befehls einfach auslesbar.
+ Die Konfigurationsdatei wird z.B. nach /opt/fhem kopiert und hat den nachfolgend dargestellten Aufbau.
+ Die Angaben sind entsprechend der verwendeten Umgebung anzupassen (entsprechende Zeilen entkommentieren und ändern):
- Die Konfigurationsdatei wird z.B. nach /opt/fhem kopiert und hat folgenden Aufbau, den man an seine Umgebung
- anpassen muß (entsprechende Zeilen entkommentieren und anpassen):
-
####################################################################################
# database configuration file
@@ -10671,6 +10707,8 @@ attr SMA_Energymeter DbLogValueFn
####################################################################################
#%dbconfig= (
# connection => "mysql:database=fhem;host=<database host>;port=3306",
+ # # if want communication over socket-file instead of TCP/IP transport, use:
+ # # connection => "mysql:database=fhem;mysql_socket=</patch/socket-file>",
# user => "fhemuser",
# password => "fhempassword",
# # optional enable(1) / disable(0) UTF-8 support
@@ -11352,13 +11390,16 @@ attr SMA_Energymeter DbLogValueFn
- <in>
- Ein Parameter um eine Kompatibilität zum Filelog herzustellen.
- Dieser Parameter ist per default immer auf - zu setzen.
+ Ein Parameter um eine Kompatibilität zu Filelog herzustellen.
+ In der Definition eines SVG Devices entspricht dieser Paramter der Angabe von :<logfile> am Ende der Definition.
Folgende Ausprägungen sind zugelassen:
- - current: die aktuellen Werte aus der Tabelle "current" werden gelesen.
- - history: die historischen Werte aus der Tabelle "history" werden gelesen.
- - -: identisch wie "history"
+ - current: die Werte werden aus der Tabelle "current" gelesen.
+ - history: die Werte werden aus der Tabelle "history" gelesen.
+ - table_<Tabelle>: die Werte werden aus der angegeben alternativen Tabelle gelesen. Die Tabelle (Name)
+ ist in der Datenbank mit Kleinbuchstaben anzulegen.
+ (Beispiel: table_energy, "energy" ist die in der Datenbank angelegte Alternativtabelle)
+ - -: identisch wie "history"
@@ -11760,10 +11801,10 @@ attr SMA_Energymeter DbLogValueFn
Die Feldlänge für das DB-Feld EVENT wird userspezifisch angepasst. Mit dem Attribut kann der Default-Wert im Modul
- verändert werden wenn die Feldlänge in der Datenbank manuell geändert wurde. Mit colEvent=0 wird das Datenbankfeld
- EVENT nicht gefüllt.
+ verändert werden wenn die Feldlänge in der Datenbank manuell geändert wurde.
+ Mit colEvent=0 wird das Datenbankfeld EVENT nicht gefüllt.
Hinweis:
- Mit gesetztem Attribut gelten alle Feldlängenbegrenzungen auch für SQLite DB wie im Internal COLUMNS angezeigt !
+ Mit gesetztem Attribut gelten alle Feldlängenbegrenzungen auch für SQLite DB wie im Internal COLUMNS angezeigt!
@@ -11775,10 +11816,25 @@ attr SMA_Energymeter DbLogValueFn
Die Feldlänge für das DB-Feld READING wird userspezifisch angepasst. Mit dem Attribut kann der Default-Wert im Modul
- verändert werden wenn die Feldlänge in der Datenbank manuell geändert wurde. Mit colReading=0 wird das Datenbankfeld
- READING nicht gefüllt.
+ verändert werden wenn die Feldlänge in der Datenbank manuell geändert wurde.
+ Mit colReading=0 wird das Datenbankfeld READING nicht gefüllt.
Hinweis:
- Mit gesetztem Attribut gelten alle Feldlängenbegrenzungen auch für SQLite DB wie im Internal COLUMNS angezeigt !
+ Mit gesetztem Attribut gelten alle Feldlängenbegrenzungen auch für SQLite DB wie im Internal COLUMNS angezeigt!
+
+
+
+
+
+
+
+ - colType <n>
+
+
+ Die Feldlänge für das DB-Feld TYPE wird userspezifisch angepasst. Mit dem Attribut kann der Default-Wert im Modul
+ verändert werden wenn die Feldlänge in der Datenbank manuell geändert wurde.
+ Mit colType=0 wird das Datenbankfeld TYPE nicht gefüllt.
+ Hinweis:
+ Mit gesetztem Attribut gelten alle Feldlängenbegrenzungen auch für SQLite DB wie im Internal COLUMNS angezeigt!
@@ -11790,10 +11846,10 @@ attr SMA_Energymeter DbLogValueFn
Die Feldlänge für das DB-Feld VALUE wird userspezifisch angepasst. Mit dem Attribut kann der Default-Wert im Modul
- verändert werden wenn die Feldlänge in der Datenbank manuell geändert wurde. Mit colValue=0 wird das Datenbankfeld
- VALUE nicht gefüllt.
+ verändert werden wenn die Feldlänge in der Datenbank manuell geändert wurde.
+ Mit colValue=0 wird das Datenbankfeld VALUE nicht gefüllt.
Hinweis:
- Mit gesetztem Attribut gelten alle Feldlängenbegrenzungen auch für SQLite DB wie im Internal COLUMNS angezeigt !
+ Mit gesetztem Attribut gelten alle Feldlängenbegrenzungen auch für SQLite DB wie im Internal COLUMNS angezeigt!