added basic tp_smapi battery widget for thinkpads with hover-expandable status

diff --git a/widgets/contrib/tpbat/init.lua b/widgets/contrib/tpbat/init.lua
new file mode 100644 (file)
index 0000000..673b66c
--- /dev/null
+++ b/widgets/contrib/tpbat/init.lua
@@ -0,0 +1,152 @@
+--[[
+     tpbat.lua
+     Battery status widget for ThinkPad laptops that use SMAPI
+     lain.widgets.contrib.tpbat
+
+     More on tp_smapi: http://www.thinkwiki.org/wiki/Tp_smapi
+
+     Licensed under GNU General Public License v2 
+      * (c) 2013,      Conor Heine
+      * (c) 2013,      Luke Bonham                
+      * (c) 2010-2012, Peter Hofmann              
+                                                  
+--]]
+
+local newtimer     = require("lain.helpers").newtimer
+local first_line   = require("lain.helpers").first_line
+local beautiful    = require("beautiful")
+local naughty      = require("naughty")
+local wibox        = require("wibox")
+local smapi        = require("lain.widgets.contrib.tpbat.smapi") -- Ugly :(
+
+local string       = { format = string.format }
+local math         = { floor = math.floor }
+local tostring     = tostring
+local setmetatable = setmetatable
+
+-- ThinkPad SMAPI-enabled battery info widget
+local tpbat = { }
+
+local tpbat_notification = nil
+
+function tpbat:hide()
+    if tpbat_notification ~= nil then
+        naughty.destroy(tpbat_notification)
+        tpbat_notification = nil
+    end
+end
+
+function tpbat:show(t_out)
+    tpbat:hide()
+    
+    local bat = self.bat
+    if bat == nil or not bat:installed() then return end
+
+    local mfgr   = bat:get('manufacturer') or "no_mfgr"
+    local model  = bat:get('model') or "no_model"
+    local chem   = bat:get('chemistry') or "no_chem"
+    local status = bat:get('state') or "nil"
+    local time   = bat:remaining_time()
+    local msg    = "\t"
+
+    if status ~= "idle" and status ~= "nil" then
+        if time == "N/A" then
+            msg = "...Calculating time remaining..."
+        else
+            msg = time .. (status == "charging" and " until charged" or " remaining")
+        end
+    else
+        msg = "On AC Power"
+    end
+
+    local str = string.format("%s : %s %s (%s)\n", bat.name, mfgr, model, chem)
+    str = str .. string.format("\n%s \t\t\t %s", status:upper(), msg)
+
+    tpbat_notification = naughty.notify({
+        preset = { fg = beautiful.fg_normal },
+        text = str,
+       timeout = t_out
+    })
+end
+
+function tpbat.register(args)
+    local args = args or {}
+    local timeout = args.timeout or 30
+    local battery = args.battery or "BAT0"
+    local settings = args.settings or function() end
+
+    tpbat.bat = smapi:battery(battery) -- Create a new battery
+    local bat = tpbat.bat
+    
+    tpbat.widget = wibox.widget.textbox('')
+
+       if bat:get('state') == nil then
+               local n = naughty.notify({
+                       title = "SMAPI Battery Warning: Unable to read battery state!",
+                       text = "This widget is intended for ThinkPads. Is tp_smapi installed? Check your configs & paths.",
+                       position = "top_right",
+                       timeout = 15,
+                       fg="#202020",
+                       bg="#cdcdcd",
+                       ontop = true
+               })
+       end
+
+    function update()
+        bat_now = {
+            status = "Not present",
+            perc   = "N/A",
+            time   = "N/A",
+            watt   = "N/A"
+        }
+
+        if bat:installed()
+        then
+            bat_now.status = bat:status()
+            bat_now.perc   = bat:percent()
+            bat_now.time   = bat:remaining_time()
+            -- bat_now.watt = string.format("%.2fW", (VOLTS * AMPS) / 1e12)
+
+            -- notifications for low and critical states
+            if bat_now.perc <= 5
+            then
+                tpbat.id = naughty.notify({
+                    text = "shutdown imminent",
+                    title = "battery nearly exhausted",
+                    position = "top_right",
+                    timeout = 15,
+                    fg="#000000",
+                    bg="#ffffff",
+                    ontop = true,
+                    replaces_id = tpbat.id
+                }).id
+            elseif bat_now.perc <= 15
+            then
+                tpbat.id = naughty.notify({
+                    text = "plug the cable",
+                    title = "battery low",
+                    position = "top_right",
+                    timeout = 15,
+                    fg="#202020",
+                    bg="#cdcdcd",
+                    ontop = true,
+                    replaces_id = tpbat.id
+                }).id
+            end
+
+            bat_now.perc = tostring(bat_now.perc)
+        end
+
+        widget = tpbat.widget -- 'widget' needed in rc.lua (following convention)
+        settings()
+    end
+
+    newtimer("tpbat", timeout, update)
+
+    widget:connect_signal('mouse::enter', function () tpbat:show(0) end)
+    widget:connect_signal('mouse::leave', function () tpbat:hide() end)
+
+    return tpbat.widget
+end
+
+return setmetatable(tpbat, { __call = function(_, ...) return tpbat.register(...) end })

diff --git a/widgets/contrib/tpbat/smapi.lua b/widgets/contrib/tpbat/smapi.lua
new file mode 100644 (file)
index 0000000..6024fa9
--- /dev/null
+++ b/widgets/contrib/tpbat/smapi.lua
@@ -0,0 +1,99 @@
+--[[
+     smapi.lua
+     Interface with thinkpad battery information
+
+     Licensed under GNU General Public License v2 
+      * (c) 2013,      Conor Heine           
+                                                  
+--]]
+
+local first_line   = require("lain.helpers").first_line
+
+local string       = { format = string.format }
+local tonumber     = tonumber
+local setmetatable = setmetatable
+
+local smapi = {}
+
+local apipath = "/sys/devices/platform/smapi"
+
+-- Most are readable values, but some can be written to (not implemented, yet?)
+local readable = {
+       barcoding = true,
+       charging_max_current = true,
+       charging_max_voltage = true,
+       chemistry = true,
+       current_avg = true,
+       current_now = true,
+       cycle_count = true,
+       design_capacity = true,
+       design_voltage = true,
+       dump = true,
+       first_use_date = true,
+       force_discharge = false,
+       group0_voltage = true,
+       group1_voltage = true,
+       group2_voltage = true,
+       group3_voltage = true,
+       inhibit_charge_minutes = false,
+       installed = true,
+       last_full_capacity = true,
+       manufacture_date = true,
+       manufacturer = true,
+       model = true,
+       power_avg = true,
+       power_now = true,
+       remaining_capacity = true,
+       remaining_charging_time = true,
+       remaining_percent = true,
+       remaining_percent_error = true,
+       remaining_running_time = true,
+       remaining_running_time_now = true,
+       serial = true,
+       start_charge_thresh = false,
+       state = true,
+       stop_charge_thresh = false,
+       temperature = true,
+       voltage = true,
+}
+
+function smapi:battery(name)
+       local bat = {}
+
+       bat.name = name
+       bat.path = apipath .. "/" .. name
+       
+       function bat:get(item)
+               return self.path ~= nil and readable[item] and first_line(self.path .. "/" .. item) or nil
+       end
+
+       function bat:installed()
+               return self:get("installed") == "1"
+       end
+
+       function bat:status()
+               return self:get('state')
+       end
+
+       -- Remaining time can either be time until battery dies or time until charging completes
+       function bat:remaining_time()
+               local time_val = bat_now.status == 'discharging' and 'remaining_running_time' or 'remaining_charging_time'
+               local mins_left = self:get(time_val)
+
+               if mins_left:find("^%d+") == nil then
+                       return "N/A"
+               end
+               
+               local hrs = mins_left / 60
+               local min = mins_left % 60
+               return string.format("%02d:%02d", hrs, min)
+       end
+
+       function bat:percent()
+               return tonumber(self:get("remaining_percent"))
+       end
+
+       return setmetatable(bat, {__metatable = false, __newindex = false})
+end
+
+return smapi
\ No newline at end of file