1 /**
2 * collectd - src/wireless.c
3 * Copyright (C) 2006,2007 Florian octo Forster
4 *
5 * Permission is hereby granted, free of charge, to any person obtaining a
6 * copy of this software and associated documentation files (the "Software"),
7 * to deal in the Software without restriction, including without limitation
8 * the rights to use, copy, modify, merge, publish, distribute, sublicense,
9 * and/or sell copies of the Software, and to permit persons to whom the
10 * Software is furnished to do so, subject to the following conditions:
11 *
12 * The above copyright notice and this permission notice shall be included in
13 * all copies or substantial portions of the Software.
14 *
15 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18 * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
20 * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
21 * DEALINGS IN THE SOFTWARE.
22 *
23 * Authors:
24 * Florian octo Forster <octo at collectd.org>
25 **/
27 #include "collectd.h"
29 #include "common.h"
30 #include "plugin.h"
32 #if !KERNEL_LINUX
33 # error "No applicable input method."
34 #endif
36 #define WIRELESS_PROC_FILE "/proc/net/wireless"
38 #if 0
39 static double wireless_dbm_to_watt (double dbm)
40 {
41 double watt;
43 /*
44 * dbm = 10 * log_{10} (1000 * power / W)
45 * power = 10^(dbm/10) * W/1000
46 */
48 watt = pow (10.0, (dbm / 10.0)) / 1000.0;
50 return (watt);
51 }
52 #endif
54 static void wireless_submit (const char *plugin_instance, const char *type,
55 double value)
56 {
57 value_t values[1];
58 value_list_t vl = VALUE_LIST_INIT;
60 values[0].gauge = value;
62 vl.values = values;
63 vl.values_len = 1;
64 sstrncpy (vl.host, hostname_g, sizeof (vl.host));
65 sstrncpy (vl.plugin, "wireless", sizeof (vl.plugin));
66 sstrncpy (vl.plugin_instance, plugin_instance,
67 sizeof (vl.plugin_instance));
68 sstrncpy (vl.type, type, sizeof (vl.type));
70 plugin_dispatch_values (&vl);
71 } /* void wireless_submit */
73 #define POWER_MIN -90.0
74 #define POWER_MAX -50.0
75 static double wireless_percent_to_power (double quality)
76 {
77 assert ((quality >= 0.0) && (quality <= 100.0));
79 return ((quality * (POWER_MAX - POWER_MIN)) + POWER_MIN);
80 } /* double wireless_percent_to_power */
82 static int wireless_read (void)
83 {
84 #ifdef KERNEL_LINUX
85 FILE *fh;
86 char buffer[1024];
88 char *device;
89 double quality;
90 double power;
91 double noise;
93 char *fields[8];
94 int numfields;
96 int devices_found;
97 int len;
99 /* there are a variety of names for the wireless device */
100 if ((fh = fopen (WIRELESS_PROC_FILE, "r")) == NULL)
101 {
102 char errbuf[1024];
103 WARNING ("wireless: fopen: %s",
104 sstrerror (errno, errbuf, sizeof (errbuf)));
105 return (-1);
106 }
108 devices_found = 0;
109 while (fgets (buffer, sizeof (buffer), fh) != NULL)
110 {
111 char *endptr;
113 numfields = strsplit (buffer, fields, 8);
115 if (numfields < 5)
116 continue;
118 len = strlen (fields[0]) - 1;
119 if (len < 1)
120 continue;
121 if (fields[0][len] != ':')
122 continue;
123 fields[0][len] = '\0';
125 device = fields[0];
127 quality = strtod (fields[2], &endptr);
128 if (fields[2] == endptr)
129 quality = -1.0; /* invalid */
131 /* power [dBm] < 0.0 */
132 power = strtod (fields[3], &endptr);
133 if (fields[3] == endptr)
134 power = 1.0; /* invalid */
135 else if ((power >= 0.0) && (power <= 100.0))
136 power = wireless_percent_to_power (power);
137 else if ((power > 100.0) && (power <= 256.0))
138 power = power - 256.0;
139 else if (power > 0.0)
140 power = 1.0; /* invalid */
142 /* noise [dBm] < 0.0 */
143 noise = strtod (fields[4], &endptr);
144 if (fields[4] == endptr)
145 noise = 1.0; /* invalid */
146 else if ((noise >= 0.0) && (noise <= 100.0))
147 noise = wireless_percent_to_power (noise);
148 else if ((noise > 100.0) && (noise <= 256.0))
149 noise = noise - 256.0;
150 else if (noise > 0.0)
151 noise = 1.0; /* invalid */
153 wireless_submit (device, "signal_quality", quality);
154 wireless_submit (device, "signal_power", power);
155 wireless_submit (device, "signal_noise", noise);
157 devices_found++;
158 }
160 fclose (fh);
162 /* If no wireless devices are present return an error, so the plugin
163 * code delays our read function. */
164 if (devices_found == 0)
165 return (-1);
166 #endif /* KERNEL_LINUX */
168 return (0);
169 } /* int wireless_read */
171 void module_register (void)
172 {
173 plugin_register_read ("wireless", wireless_read);
174 } /* void module_register */