[svn-commits] tzafrir: branch linux/tzafrir/sysfs r7728 - /linux/team/tzafrir/sysfs/README

Thu Dec 24 04:30:13 CST 2009

Author: tzafrir
Date: Thu Dec 24 04:30:12 2009
New Revision: 7728

URL: http://svnview.digium.com/svn/dahdi?view=rev&rev=7728
Log:
update the README in the sysfs branch.

Modified:
    linux/team/tzafrir/sysfs/README

Modified: linux/team/tzafrir/sysfs/README
URL: http://svnview.digium.com/svn/dahdi/linux/team/tzafrir/sysfs/README?view=diff&rev=7728&r1=7727&r2=7728
==============================================================================

--- linux/team/tzafrir/sysfs/README (original)
+++ linux/team/tzafrir/sysfs/README Thu Dec 24 04:30:12 2009
@@ -502,8 +502,9 @@
 the span is ready. Likewise are 'offline' and 'remove'.
 
 Thus when 'online' is sent, the span is ready for configuration.
-The file drivers/dahdi/span_hook.sample demonstrates how to use it to 
-get a more dynamic DAHDI configuration:
+The file span_hook.sample in dahdi-tools (currently only in the sysfs 
+branch - http://svn.asterisk.org/svn/dahdi/tools/team/tzafrir/sysfs/span_hook.sample ) 
+demonstrates how to use it to  get a more dynamic DAHDI configuration:
 
 It will run dahdi_cfg if it finds /etc/dahdi/sysetm.conf .
 Otherwise it will try:
@@ -628,11 +629,32 @@
 span 3). Spans may also have some span-specific attributes. Its 
 attributes include:
 
+===== /sys/class/dahdi_span/span-NNN/alarms
+(Hex) integer. A bitmask that represents the alarms this span has.
+
+* 1: Recovering from alarm
+* 2: In loopback
+* 4: Yellow Alarm
+* 8: Red Alarm
+* 16: Blue Alarm
+* 32: NOTOPEN (device not present).
+
+FIXME: textual representation? Values are defined in dahdi/user.h .
+
 ===== /sys/class/dahdi_span/span-NNN/desc
 String. The span description.
 
+===== /sys/class/dahdi_span/span-NNN/name
+String. The name of the span. More terse than the desc above.
+
 ===== /sys/class/dahdi_span/span-NNN/devicetype
 String. The span's device's "device type".
+
+===== /sys/class/dahdi_span/span-NNN/irq
+String. The span's device IRQ line.
+
+===== /sys/class/dahdi_span/span-NNN/irqmisses
+Integer. Counter for The span's device IRQ misses.
 
 ===== /sys/class/dahdi_span/span-NNN/location
 String. The span's device's location in the system. On most PCI devices
@@ -642,19 +664,27 @@
 ===== /sys/class/dahdi_span/span-NNN/manufacturer
 String. The span's device's manufacturer.
 
-===== /sys/class/dahdi_span/span-NNN/name
-String. The name of the span. More terse than the desc above.
-
 ===== /sys/class/dahdi_span/span-NNN/spantype
 String. The type of the span. May be '<NULL>' for some analog spans.
-
-===== /sys/class/dahdi_span/span-NNN/battery
-===== /sys/class/dahdi_span/span-NNN/offhook
-Those are two example fields that are specific to the driver wcfxo.
 
 ===== /sys/class/dahdi_span/span-NNN/is_digital
 1 if this span is capable of transporting digital calls. 0 otherwise.
 (0 is for analogs and also for dahdi_dummy).
+
+===== /sys/class/dahdi_span/span-NNN/is_sync_master
+1 if this span is the one providing ticks to userspace (to DAHDI timers,
+pseudo channels, and such). 0 otherwise.
+
+===== /sys/class/dahdi_span/span-NNN/lbo
+Integer. The LBO (Line Build Out) parameter as configured for the span in
+system.conf. Only applies to digital spans. A number of devices blantly
+ignore that.
+
+===== /sys/class/dahdi_span/span-NNN/syncsrc
+Integer. The syncsrc parameter as configured for the span in
+system.conf. Only applies to digital spans. Used to set the sync source
+priority among different ports in the same device (only this meaning was
+overloaded for the xpp drvers. See README.Astribank).
 
 /sys/class/dahdi_span/span-NNN/NNN:MM
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
@@ -673,18 +703,14 @@
 ===== /sys/class/dahdi_span/span-NNN/NNN:MM/chan_alarms
 The current channel alarm this channel has.
 
+Values are the same as the ones of span alarms.
+
+===== /sys/class/dahdi_span/span-NNN/NNN:MM/chanmute
+1 if this channel is not passing audio due to the CHANMUTE code.
+0 otherwise. Only present if OPTIMIZE_CHANMUTE was enabled in dahdi_config.h .
+
 ===== /sys/class/dahdi_span/span-NNN/NNN:MM/channo
 MM from above. The global numbering of this DAHDI channel.
-
-===== /sys/class/dahdi_span/span-NNN/NNN:MM/chanpos
-The number of this channel in the span. E.g. for a system with two 
-8-channel spans, the third channel in the second span will have channo 
-11 (8+3) and chanpos 3.
-
-===== /sys/class/dahdi_span/span-NNN/NNN:MM/echocancel
-0 is the channel has no active echo canceller and 1 if the channel
-has an active echo canceller (that is: in the middle of a call and the 
-echo canceller is enabled).
 
 ===== /sys/class/dahdi_span/span-NNN/NNN:MM/name
 The name of the channel.
@@ -695,9 +721,6 @@
 ===== /sys/class/dahdi_span/span-NNN/NNN:MM/sigcap
 The signalling capability mask of the channel: all the possible 
 signalling bits the channel can used are set here.
-
-===== /sys/class/dahdi_span/span-NNN/NNN:MM/tonezone
-The tonezone this number has (number. Is it meaningful?)
 
 
 User-space Interface


