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
	
	 Fredrik Öhrström
						Fredrik Öhrström