kopia lustrzana https://github.com/weetmuts/wmbusmeters
				
				
				
			Improve README.
							rodzic
							
								
									d18ffeed28
								
							
						
					
					
						commit
						04a80c5055
					
				
							
								
								
									
										35
									
								
								README.md
								
								
								
								
							
							
						
						
									
										35
									
								
								README.md
								
								
								
								
							| 
						 | 
				
			
			@ -33,6 +33,41 @@ or into json:
 | 
			
		|||
Wmbusmeters can collect telegrams from radio using hardware dongles or rtl-sdr software radio dongles,
 | 
			
		||||
or from m-bus meters using serial ports, or from files/pipes.
 | 
			
		||||
 | 
			
		||||
# You can now write new meter drivers without recompiling wmbusmeters!
 | 
			
		||||
 | 
			
		||||
What is a driver and why is it needed?
 | 
			
		||||
 | 
			
		||||
The (w)mbus meters can be very complicated. Even though
 | 
			
		||||
the protocol is self-describing and you can automatically
 | 
			
		||||
decode a 32 bit signed binary word representing a volume in m3
 | 
			
		||||
stored in storage slot 1.
 | 
			
		||||
 | 
			
		||||
What does this measurement mean? Is it last months final measurement
 | 
			
		||||
that will be used for water billing? Is it the amount of gas
 | 
			
		||||
delivered last year?
 | 
			
		||||
 | 
			
		||||
The driver creates mapping rules from Type,Unit,StorageNr,SubUnitNr,TariffNr
 | 
			
		||||
into for example `heat_consumption_at_set_date_kwh`.
 | 
			
		||||
 | 
			
		||||
For example:
 | 
			
		||||
```
 | 
			
		||||
field {
 | 
			
		||||
    name = target
 | 
			
		||||
    info = 'Water consumption at the end of last month.'
 | 
			
		||||
    quantity = Volume
 | 
			
		||||
    match {
 | 
			
		||||
        measurement_type = Instantaneous
 | 
			
		||||
        vif_range = Volume
 | 
			
		||||
        storage_nr = 20
 | 
			
		||||
    }
 | 
			
		||||
}
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
Will create a mapping rule that looks for a Instantaneous,Volume,20,0,0 value
 | 
			
		||||
and, if found, then generate `"target_m3": 1234` json key-value in the decoded output.
 | 
			
		||||
 | 
			
		||||
[Drivers](https://github.com/wmbusmeters/wmbusmeters/tree/master/drivers/src)
 | 
			
		||||
 | 
			
		||||
[FAQ/WIKI/MANUAL pages](https://wmbusmeters.github.io/wmbusmeters-wiki/)
 | 
			
		||||
 | 
			
		||||
The program runs on GNU/Linux, MacOSX, FreeBSD, and Raspberry Pi.
 | 
			
		||||
| 
						 | 
				
			
			
 | 
			
		|||
		Ładowanie…
	
		Reference in New Issue