Merge xpp r4372:

* Update to zaptel-1.2.18 and zaptel-1.4.3 (r4308 onward)
* Fix a critical race with zaptel synchronization (r4362)
* Added a /proc/xpp/cmds for statistics about command timing (r4360)
* Fix a digit mapping bug with hardware dtmf detection (r4357)
* In xpp/utils/Makefile add perl syntax checks to our scripts (r4337)
* Better USB data error checking (r4336)
* udev rules (xpp.rules) avoid false calls from wrong nodes (r4331)
* Improve hardware detection and reporting in lszaptel,
  zaptel_hardware. zapconf is basically functional.
* Leds are blinked synchronously on all Astribanks now (r4262)
* Fix a BRI bug if OPTIMIZE_CHANMUTE was compiled into zaptel (r4258)
  (This feature was not yet accepted into official zaptel)
* Removed compile warning about HZ != 1000 (r4218)
* Firmware updates.
* fpga_load now supports USB pathes without zeros (r4211)
* XPD numbers have changed to '<Unit><Subunit>' (r4196)
* Proper support for ZT_VMWI ioctl, if used in zaptel (r4092)
* Fix FXO power denial detection (r4054)
* FXO could accidentally go off-hook with some compilers (r4048)

(From branches/1.2 r2732, r2735 - branches/1.4 2736)



git-svn-id: http://svn.digium.com/svn/zaptel/trunk@2813 5390a7c7-147a-4af0-8ec9-7488f05a26cb

1 files changed, 50 insertions, 0 deletions

diff --git a/xpp/README.metering b/xpp/README.metering
new file mode 100644
index 0000000..4736b81
--- /dev/null
+++ b/xpp/README.metering
@@ -0,0 +1,50 @@
+Astribank Metering Interface
+""""""""""""""""""""""""""""
+
+In analog phone lines, some PBX'es can generate/detect special tones
+used for billing the call (phone metering).
+
+Astribank FXS and FXO drivers now support these features if compiled
+with -DWITH_METERING
+
+Software interface:
+  FXS - To generate a metering pulse, write the channel number (0-7) into
+        the file:
+
+		/proc/xpp/XBUS-nn/XPD-mm/metering_gen
+
+	Where:
+		nn = XBUS number
+		mm = XPD number
+
+	Writing channel number 31 signifies a broadcast  -- i.e: generate
+	metering pulse on all channels.
+
+	Example:
+
+		echo 31 > /proc/xpp/XBUS-00/XPD-00/metering_gen
+
+  FXO - To read current metering counters from an FXO, simply read:
+
+		/proc/xpp/XBUS-nn/XPD-mm/metering_read
+
+	The format is self documenting:
+
+		# Chan  Meter (since last read)
+		0       5
+		1       0
+		2       12
+		...
+
+	Reading this file reset the counters. So the numbers always show
+	the meters since last read.
+
+	The metering register should be sampled at a rate which is double
+	than the highest expected metering pulses. This rate is adjustable
+	via a module parameter "poll_metering_interval". The current default
+	is 500ms which is good if the metering pulses are sent not more
+	often than once per second.
+
+Remark: The FXS hardware can generate maximum 0.85 volt RMS, while the FXO
+        needs a minimum of 1.1 vold RMS for detection. Therefore, this
+	feature cannot be tested in a loopback (Astribank-FXS to Astribank-FXO).