surface_battery.c 22 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875
  1. // SPDX-License-Identifier: GPL-2.0+
  2. /*
  3. * Battery driver for 7th-generation Microsoft Surface devices via Surface
  4. * System Aggregator Module (SSAM).
  5. *
  6. * Copyright (C) 2019-2021 Maximilian Luz <[email protected]>
  7. */
  8. #include <asm/unaligned.h>
  9. #include <linux/jiffies.h>
  10. #include <linux/kernel.h>
  11. #include <linux/module.h>
  12. #include <linux/mutex.h>
  13. #include <linux/power_supply.h>
  14. #include <linux/sysfs.h>
  15. #include <linux/types.h>
  16. #include <linux/workqueue.h>
  17. #include <linux/surface_aggregator/device.h>
  18. /* -- SAM interface. -------------------------------------------------------- */
  19. enum sam_event_cid_bat {
  20. SAM_EVENT_CID_BAT_BIX = 0x15,
  21. SAM_EVENT_CID_BAT_BST = 0x16,
  22. SAM_EVENT_CID_BAT_ADP = 0x17,
  23. SAM_EVENT_CID_BAT_PROT = 0x18,
  24. SAM_EVENT_CID_BAT_DPTF = 0x53,
  25. };
  26. enum sam_battery_sta {
  27. SAM_BATTERY_STA_OK = 0x0f,
  28. SAM_BATTERY_STA_PRESENT = 0x10,
  29. };
  30. enum sam_battery_state {
  31. SAM_BATTERY_STATE_DISCHARGING = BIT(0),
  32. SAM_BATTERY_STATE_CHARGING = BIT(1),
  33. SAM_BATTERY_STATE_CRITICAL = BIT(2),
  34. };
  35. enum sam_battery_power_unit {
  36. SAM_BATTERY_POWER_UNIT_mW = 0,
  37. SAM_BATTERY_POWER_UNIT_mA = 1,
  38. };
  39. /* Equivalent to data returned in ACPI _BIX method, revision 0. */
  40. struct spwr_bix {
  41. u8 revision;
  42. __le32 power_unit;
  43. __le32 design_cap;
  44. __le32 last_full_charge_cap;
  45. __le32 technology;
  46. __le32 design_voltage;
  47. __le32 design_cap_warn;
  48. __le32 design_cap_low;
  49. __le32 cycle_count;
  50. __le32 measurement_accuracy;
  51. __le32 max_sampling_time;
  52. __le32 min_sampling_time;
  53. __le32 max_avg_interval;
  54. __le32 min_avg_interval;
  55. __le32 bat_cap_granularity_1;
  56. __le32 bat_cap_granularity_2;
  57. __u8 model[21];
  58. __u8 serial[11];
  59. __u8 type[5];
  60. __u8 oem_info[21];
  61. } __packed;
  62. static_assert(sizeof(struct spwr_bix) == 119);
  63. /* Equivalent to data returned in ACPI _BST method. */
  64. struct spwr_bst {
  65. __le32 state;
  66. __le32 present_rate;
  67. __le32 remaining_cap;
  68. __le32 present_voltage;
  69. } __packed;
  70. static_assert(sizeof(struct spwr_bst) == 16);
  71. #define SPWR_BIX_REVISION 0
  72. #define SPWR_BATTERY_VALUE_UNKNOWN 0xffffffff
  73. /* Get battery status (_STA) */
  74. SSAM_DEFINE_SYNC_REQUEST_CL_R(ssam_bat_get_sta, __le32, {
  75. .target_category = SSAM_SSH_TC_BAT,
  76. .command_id = 0x01,
  77. });
  78. /* Get battery static information (_BIX). */
  79. SSAM_DEFINE_SYNC_REQUEST_CL_R(ssam_bat_get_bix, struct spwr_bix, {
  80. .target_category = SSAM_SSH_TC_BAT,
  81. .command_id = 0x02,
  82. });
  83. /* Get battery dynamic information (_BST). */
  84. SSAM_DEFINE_SYNC_REQUEST_CL_R(ssam_bat_get_bst, struct spwr_bst, {
  85. .target_category = SSAM_SSH_TC_BAT,
  86. .command_id = 0x03,
  87. });
  88. /* Set battery trip point (_BTP). */
  89. SSAM_DEFINE_SYNC_REQUEST_CL_W(ssam_bat_set_btp, __le32, {
  90. .target_category = SSAM_SSH_TC_BAT,
  91. .command_id = 0x04,
  92. });
  93. /* -- Device structures. ---------------------------------------------------- */
  94. struct spwr_psy_properties {
  95. const char *name;
  96. struct ssam_event_registry registry;
  97. };
  98. struct spwr_battery_device {
  99. struct ssam_device *sdev;
  100. char name[32];
  101. struct power_supply *psy;
  102. struct power_supply_desc psy_desc;
  103. struct delayed_work update_work;
  104. struct ssam_event_notifier notif;
  105. struct mutex lock; /* Guards access to state data below. */
  106. unsigned long timestamp;
  107. __le32 sta;
  108. struct spwr_bix bix;
  109. struct spwr_bst bst;
  110. u32 alarm;
  111. };
  112. /* -- Module parameters. ---------------------------------------------------- */
  113. static unsigned int cache_time = 1000;
  114. module_param(cache_time, uint, 0644);
  115. MODULE_PARM_DESC(cache_time, "battery state caching time in milliseconds [default: 1000]");
  116. /* -- State management. ----------------------------------------------------- */
  117. /*
  118. * Delay for battery update quirk. See spwr_external_power_changed() below
  119. * for more details.
  120. */
  121. #define SPWR_AC_BAT_UPDATE_DELAY msecs_to_jiffies(5000)
  122. static bool spwr_battery_present(struct spwr_battery_device *bat)
  123. {
  124. lockdep_assert_held(&bat->lock);
  125. return le32_to_cpu(bat->sta) & SAM_BATTERY_STA_PRESENT;
  126. }
  127. static int spwr_battery_load_sta(struct spwr_battery_device *bat)
  128. {
  129. lockdep_assert_held(&bat->lock);
  130. return ssam_retry(ssam_bat_get_sta, bat->sdev, &bat->sta);
  131. }
  132. static int spwr_battery_load_bix(struct spwr_battery_device *bat)
  133. {
  134. int status;
  135. lockdep_assert_held(&bat->lock);
  136. if (!spwr_battery_present(bat))
  137. return 0;
  138. status = ssam_retry(ssam_bat_get_bix, bat->sdev, &bat->bix);
  139. /* Enforce NULL terminated strings in case anything goes wrong... */
  140. bat->bix.model[ARRAY_SIZE(bat->bix.model) - 1] = 0;
  141. bat->bix.serial[ARRAY_SIZE(bat->bix.serial) - 1] = 0;
  142. bat->bix.type[ARRAY_SIZE(bat->bix.type) - 1] = 0;
  143. bat->bix.oem_info[ARRAY_SIZE(bat->bix.oem_info) - 1] = 0;
  144. return status;
  145. }
  146. static int spwr_battery_load_bst(struct spwr_battery_device *bat)
  147. {
  148. lockdep_assert_held(&bat->lock);
  149. if (!spwr_battery_present(bat))
  150. return 0;
  151. return ssam_retry(ssam_bat_get_bst, bat->sdev, &bat->bst);
  152. }
  153. static int spwr_battery_set_alarm_unlocked(struct spwr_battery_device *bat, u32 value)
  154. {
  155. __le32 value_le = cpu_to_le32(value);
  156. lockdep_assert_held(&bat->lock);
  157. bat->alarm = value;
  158. return ssam_retry(ssam_bat_set_btp, bat->sdev, &value_le);
  159. }
  160. static int spwr_battery_update_bst_unlocked(struct spwr_battery_device *bat, bool cached)
  161. {
  162. unsigned long cache_deadline = bat->timestamp + msecs_to_jiffies(cache_time);
  163. int status;
  164. lockdep_assert_held(&bat->lock);
  165. if (cached && bat->timestamp && time_is_after_jiffies(cache_deadline))
  166. return 0;
  167. status = spwr_battery_load_sta(bat);
  168. if (status)
  169. return status;
  170. status = spwr_battery_load_bst(bat);
  171. if (status)
  172. return status;
  173. bat->timestamp = jiffies;
  174. return 0;
  175. }
  176. static int spwr_battery_update_bst(struct spwr_battery_device *bat, bool cached)
  177. {
  178. int status;
  179. mutex_lock(&bat->lock);
  180. status = spwr_battery_update_bst_unlocked(bat, cached);
  181. mutex_unlock(&bat->lock);
  182. return status;
  183. }
  184. static int spwr_battery_update_bix_unlocked(struct spwr_battery_device *bat)
  185. {
  186. int status;
  187. lockdep_assert_held(&bat->lock);
  188. status = spwr_battery_load_sta(bat);
  189. if (status)
  190. return status;
  191. status = spwr_battery_load_bix(bat);
  192. if (status)
  193. return status;
  194. status = spwr_battery_load_bst(bat);
  195. if (status)
  196. return status;
  197. if (bat->bix.revision != SPWR_BIX_REVISION)
  198. dev_warn(&bat->sdev->dev, "unsupported battery revision: %u\n", bat->bix.revision);
  199. bat->timestamp = jiffies;
  200. return 0;
  201. }
  202. static u32 sprw_battery_get_full_cap_safe(struct spwr_battery_device *bat)
  203. {
  204. u32 full_cap = get_unaligned_le32(&bat->bix.last_full_charge_cap);
  205. lockdep_assert_held(&bat->lock);
  206. if (full_cap == 0 || full_cap == SPWR_BATTERY_VALUE_UNKNOWN)
  207. full_cap = get_unaligned_le32(&bat->bix.design_cap);
  208. return full_cap;
  209. }
  210. static bool spwr_battery_is_full(struct spwr_battery_device *bat)
  211. {
  212. u32 state = get_unaligned_le32(&bat->bst.state);
  213. u32 full_cap = sprw_battery_get_full_cap_safe(bat);
  214. u32 remaining_cap = get_unaligned_le32(&bat->bst.remaining_cap);
  215. lockdep_assert_held(&bat->lock);
  216. return full_cap != SPWR_BATTERY_VALUE_UNKNOWN && full_cap != 0 &&
  217. remaining_cap != SPWR_BATTERY_VALUE_UNKNOWN &&
  218. remaining_cap >= full_cap &&
  219. state == 0;
  220. }
  221. static int spwr_battery_recheck_full(struct spwr_battery_device *bat)
  222. {
  223. bool present;
  224. u32 unit;
  225. int status;
  226. mutex_lock(&bat->lock);
  227. unit = get_unaligned_le32(&bat->bix.power_unit);
  228. present = spwr_battery_present(bat);
  229. status = spwr_battery_update_bix_unlocked(bat);
  230. if (status)
  231. goto out;
  232. /* If battery has been attached, (re-)initialize alarm. */
  233. if (!present && spwr_battery_present(bat)) {
  234. u32 cap_warn = get_unaligned_le32(&bat->bix.design_cap_warn);
  235. status = spwr_battery_set_alarm_unlocked(bat, cap_warn);
  236. if (status)
  237. goto out;
  238. }
  239. /*
  240. * Warn if the unit has changed. This is something we genuinely don't
  241. * expect to happen, so make this a big warning. If it does, we'll
  242. * need to add support for it.
  243. */
  244. WARN_ON(unit != get_unaligned_le32(&bat->bix.power_unit));
  245. out:
  246. mutex_unlock(&bat->lock);
  247. if (!status)
  248. power_supply_changed(bat->psy);
  249. return status;
  250. }
  251. static int spwr_battery_recheck_status(struct spwr_battery_device *bat)
  252. {
  253. int status;
  254. status = spwr_battery_update_bst(bat, false);
  255. if (!status)
  256. power_supply_changed(bat->psy);
  257. return status;
  258. }
  259. static u32 spwr_notify_bat(struct ssam_event_notifier *nf, const struct ssam_event *event)
  260. {
  261. struct spwr_battery_device *bat = container_of(nf, struct spwr_battery_device, notif);
  262. int status;
  263. /*
  264. * We cannot use strict matching when registering the notifier as the
  265. * EC expects us to register it against instance ID 0. Strict matching
  266. * would thus drop events, as those may have non-zero instance IDs in
  267. * this subsystem. So we need to check the instance ID of the event
  268. * here manually.
  269. */
  270. if (event->instance_id != bat->sdev->uid.instance)
  271. return 0;
  272. dev_dbg(&bat->sdev->dev, "power event (cid = %#04x, iid = %#04x, tid = %#04x)\n",
  273. event->command_id, event->instance_id, event->target_id);
  274. switch (event->command_id) {
  275. case SAM_EVENT_CID_BAT_BIX:
  276. status = spwr_battery_recheck_full(bat);
  277. break;
  278. case SAM_EVENT_CID_BAT_BST:
  279. status = spwr_battery_recheck_status(bat);
  280. break;
  281. case SAM_EVENT_CID_BAT_PROT:
  282. /*
  283. * TODO: Implement support for battery protection status change
  284. * event.
  285. */
  286. status = 0;
  287. break;
  288. case SAM_EVENT_CID_BAT_DPTF:
  289. /*
  290. * TODO: Implement support for DPTF event.
  291. */
  292. status = 0;
  293. break;
  294. default:
  295. return 0;
  296. }
  297. return ssam_notifier_from_errno(status) | SSAM_NOTIF_HANDLED;
  298. }
  299. static void spwr_battery_update_bst_workfn(struct work_struct *work)
  300. {
  301. struct delayed_work *dwork = to_delayed_work(work);
  302. struct spwr_battery_device *bat;
  303. int status;
  304. bat = container_of(dwork, struct spwr_battery_device, update_work);
  305. status = spwr_battery_update_bst(bat, false);
  306. if (status) {
  307. dev_err(&bat->sdev->dev, "failed to update battery state: %d\n", status);
  308. return;
  309. }
  310. power_supply_changed(bat->psy);
  311. }
  312. static void spwr_external_power_changed(struct power_supply *psy)
  313. {
  314. struct spwr_battery_device *bat = power_supply_get_drvdata(psy);
  315. /*
  316. * Handle battery update quirk: When the battery is fully charged (or
  317. * charged up to the limit imposed by the UEFI battery limit) and the
  318. * adapter is plugged in or removed, the EC does not send a separate
  319. * event for the state (charging/discharging) change. Furthermore it
  320. * may take some time until the state is updated on the battery.
  321. * Schedule an update to solve this.
  322. */
  323. schedule_delayed_work(&bat->update_work, SPWR_AC_BAT_UPDATE_DELAY);
  324. }
  325. /* -- Properties. ----------------------------------------------------------- */
  326. static const enum power_supply_property spwr_battery_props_chg[] = {
  327. POWER_SUPPLY_PROP_STATUS,
  328. POWER_SUPPLY_PROP_PRESENT,
  329. POWER_SUPPLY_PROP_TECHNOLOGY,
  330. POWER_SUPPLY_PROP_CYCLE_COUNT,
  331. POWER_SUPPLY_PROP_VOLTAGE_MIN_DESIGN,
  332. POWER_SUPPLY_PROP_VOLTAGE_NOW,
  333. POWER_SUPPLY_PROP_CURRENT_NOW,
  334. POWER_SUPPLY_PROP_CHARGE_FULL_DESIGN,
  335. POWER_SUPPLY_PROP_CHARGE_FULL,
  336. POWER_SUPPLY_PROP_CHARGE_NOW,
  337. POWER_SUPPLY_PROP_CAPACITY,
  338. POWER_SUPPLY_PROP_CAPACITY_LEVEL,
  339. POWER_SUPPLY_PROP_MODEL_NAME,
  340. POWER_SUPPLY_PROP_MANUFACTURER,
  341. POWER_SUPPLY_PROP_SERIAL_NUMBER,
  342. };
  343. static const enum power_supply_property spwr_battery_props_eng[] = {
  344. POWER_SUPPLY_PROP_STATUS,
  345. POWER_SUPPLY_PROP_PRESENT,
  346. POWER_SUPPLY_PROP_TECHNOLOGY,
  347. POWER_SUPPLY_PROP_CYCLE_COUNT,
  348. POWER_SUPPLY_PROP_VOLTAGE_MIN_DESIGN,
  349. POWER_SUPPLY_PROP_VOLTAGE_NOW,
  350. POWER_SUPPLY_PROP_POWER_NOW,
  351. POWER_SUPPLY_PROP_ENERGY_FULL_DESIGN,
  352. POWER_SUPPLY_PROP_ENERGY_FULL,
  353. POWER_SUPPLY_PROP_ENERGY_NOW,
  354. POWER_SUPPLY_PROP_CAPACITY,
  355. POWER_SUPPLY_PROP_CAPACITY_LEVEL,
  356. POWER_SUPPLY_PROP_MODEL_NAME,
  357. POWER_SUPPLY_PROP_MANUFACTURER,
  358. POWER_SUPPLY_PROP_SERIAL_NUMBER,
  359. };
  360. static int spwr_battery_prop_status(struct spwr_battery_device *bat)
  361. {
  362. u32 state = get_unaligned_le32(&bat->bst.state);
  363. u32 present_rate = get_unaligned_le32(&bat->bst.present_rate);
  364. lockdep_assert_held(&bat->lock);
  365. if (state & SAM_BATTERY_STATE_DISCHARGING)
  366. return POWER_SUPPLY_STATUS_DISCHARGING;
  367. if (state & SAM_BATTERY_STATE_CHARGING)
  368. return POWER_SUPPLY_STATUS_CHARGING;
  369. if (spwr_battery_is_full(bat))
  370. return POWER_SUPPLY_STATUS_FULL;
  371. if (present_rate == 0)
  372. return POWER_SUPPLY_STATUS_NOT_CHARGING;
  373. return POWER_SUPPLY_STATUS_UNKNOWN;
  374. }
  375. static int spwr_battery_prop_technology(struct spwr_battery_device *bat)
  376. {
  377. lockdep_assert_held(&bat->lock);
  378. if (!strcasecmp("NiCd", bat->bix.type))
  379. return POWER_SUPPLY_TECHNOLOGY_NiCd;
  380. if (!strcasecmp("NiMH", bat->bix.type))
  381. return POWER_SUPPLY_TECHNOLOGY_NiMH;
  382. if (!strcasecmp("LION", bat->bix.type))
  383. return POWER_SUPPLY_TECHNOLOGY_LION;
  384. if (!strncasecmp("LI-ION", bat->bix.type, 6))
  385. return POWER_SUPPLY_TECHNOLOGY_LION;
  386. if (!strcasecmp("LiP", bat->bix.type))
  387. return POWER_SUPPLY_TECHNOLOGY_LIPO;
  388. return POWER_SUPPLY_TECHNOLOGY_UNKNOWN;
  389. }
  390. static int spwr_battery_prop_capacity(struct spwr_battery_device *bat)
  391. {
  392. u32 full_cap = sprw_battery_get_full_cap_safe(bat);
  393. u32 remaining_cap = get_unaligned_le32(&bat->bst.remaining_cap);
  394. lockdep_assert_held(&bat->lock);
  395. if (full_cap == 0 || full_cap == SPWR_BATTERY_VALUE_UNKNOWN)
  396. return -ENODATA;
  397. if (remaining_cap == SPWR_BATTERY_VALUE_UNKNOWN)
  398. return -ENODATA;
  399. return remaining_cap * 100 / full_cap;
  400. }
  401. static int spwr_battery_prop_capacity_level(struct spwr_battery_device *bat)
  402. {
  403. u32 state = get_unaligned_le32(&bat->bst.state);
  404. u32 remaining_cap = get_unaligned_le32(&bat->bst.remaining_cap);
  405. lockdep_assert_held(&bat->lock);
  406. if (state & SAM_BATTERY_STATE_CRITICAL)
  407. return POWER_SUPPLY_CAPACITY_LEVEL_CRITICAL;
  408. if (spwr_battery_is_full(bat))
  409. return POWER_SUPPLY_CAPACITY_LEVEL_FULL;
  410. if (remaining_cap <= bat->alarm)
  411. return POWER_SUPPLY_CAPACITY_LEVEL_LOW;
  412. return POWER_SUPPLY_CAPACITY_LEVEL_NORMAL;
  413. }
  414. static int spwr_battery_get_property(struct power_supply *psy, enum power_supply_property psp,
  415. union power_supply_propval *val)
  416. {
  417. struct spwr_battery_device *bat = power_supply_get_drvdata(psy);
  418. u32 value;
  419. int status;
  420. mutex_lock(&bat->lock);
  421. status = spwr_battery_update_bst_unlocked(bat, true);
  422. if (status)
  423. goto out;
  424. /* Abort if battery is not present. */
  425. if (!spwr_battery_present(bat) && psp != POWER_SUPPLY_PROP_PRESENT) {
  426. status = -ENODEV;
  427. goto out;
  428. }
  429. switch (psp) {
  430. case POWER_SUPPLY_PROP_STATUS:
  431. val->intval = spwr_battery_prop_status(bat);
  432. break;
  433. case POWER_SUPPLY_PROP_PRESENT:
  434. val->intval = spwr_battery_present(bat);
  435. break;
  436. case POWER_SUPPLY_PROP_TECHNOLOGY:
  437. val->intval = spwr_battery_prop_technology(bat);
  438. break;
  439. case POWER_SUPPLY_PROP_CYCLE_COUNT:
  440. value = get_unaligned_le32(&bat->bix.cycle_count);
  441. if (value != SPWR_BATTERY_VALUE_UNKNOWN)
  442. val->intval = value;
  443. else
  444. status = -ENODATA;
  445. break;
  446. case POWER_SUPPLY_PROP_VOLTAGE_MIN_DESIGN:
  447. value = get_unaligned_le32(&bat->bix.design_voltage);
  448. if (value != SPWR_BATTERY_VALUE_UNKNOWN)
  449. val->intval = value * 1000;
  450. else
  451. status = -ENODATA;
  452. break;
  453. case POWER_SUPPLY_PROP_VOLTAGE_NOW:
  454. value = get_unaligned_le32(&bat->bst.present_voltage);
  455. if (value != SPWR_BATTERY_VALUE_UNKNOWN)
  456. val->intval = value * 1000;
  457. else
  458. status = -ENODATA;
  459. break;
  460. case POWER_SUPPLY_PROP_CURRENT_NOW:
  461. case POWER_SUPPLY_PROP_POWER_NOW:
  462. value = get_unaligned_le32(&bat->bst.present_rate);
  463. if (value != SPWR_BATTERY_VALUE_UNKNOWN)
  464. val->intval = value * 1000;
  465. else
  466. status = -ENODATA;
  467. break;
  468. case POWER_SUPPLY_PROP_CHARGE_FULL_DESIGN:
  469. case POWER_SUPPLY_PROP_ENERGY_FULL_DESIGN:
  470. value = get_unaligned_le32(&bat->bix.design_cap);
  471. if (value != SPWR_BATTERY_VALUE_UNKNOWN)
  472. val->intval = value * 1000;
  473. else
  474. status = -ENODATA;
  475. break;
  476. case POWER_SUPPLY_PROP_CHARGE_FULL:
  477. case POWER_SUPPLY_PROP_ENERGY_FULL:
  478. value = get_unaligned_le32(&bat->bix.last_full_charge_cap);
  479. if (value != SPWR_BATTERY_VALUE_UNKNOWN)
  480. val->intval = value * 1000;
  481. else
  482. status = -ENODATA;
  483. break;
  484. case POWER_SUPPLY_PROP_CHARGE_NOW:
  485. case POWER_SUPPLY_PROP_ENERGY_NOW:
  486. value = get_unaligned_le32(&bat->bst.remaining_cap);
  487. if (value != SPWR_BATTERY_VALUE_UNKNOWN)
  488. val->intval = value * 1000;
  489. else
  490. status = -ENODATA;
  491. break;
  492. case POWER_SUPPLY_PROP_CAPACITY:
  493. val->intval = spwr_battery_prop_capacity(bat);
  494. break;
  495. case POWER_SUPPLY_PROP_CAPACITY_LEVEL:
  496. val->intval = spwr_battery_prop_capacity_level(bat);
  497. break;
  498. case POWER_SUPPLY_PROP_MODEL_NAME:
  499. val->strval = bat->bix.model;
  500. break;
  501. case POWER_SUPPLY_PROP_MANUFACTURER:
  502. val->strval = bat->bix.oem_info;
  503. break;
  504. case POWER_SUPPLY_PROP_SERIAL_NUMBER:
  505. val->strval = bat->bix.serial;
  506. break;
  507. default:
  508. status = -EINVAL;
  509. break;
  510. }
  511. out:
  512. mutex_unlock(&bat->lock);
  513. return status;
  514. }
  515. /* -- Alarm attribute. ------------------------------------------------------ */
  516. static ssize_t alarm_show(struct device *dev, struct device_attribute *attr, char *buf)
  517. {
  518. struct power_supply *psy = dev_get_drvdata(dev);
  519. struct spwr_battery_device *bat = power_supply_get_drvdata(psy);
  520. int status;
  521. mutex_lock(&bat->lock);
  522. status = sysfs_emit(buf, "%d\n", bat->alarm * 1000);
  523. mutex_unlock(&bat->lock);
  524. return status;
  525. }
  526. static ssize_t alarm_store(struct device *dev, struct device_attribute *attr, const char *buf,
  527. size_t count)
  528. {
  529. struct power_supply *psy = dev_get_drvdata(dev);
  530. struct spwr_battery_device *bat = power_supply_get_drvdata(psy);
  531. unsigned long value;
  532. int status;
  533. status = kstrtoul(buf, 0, &value);
  534. if (status)
  535. return status;
  536. mutex_lock(&bat->lock);
  537. if (!spwr_battery_present(bat)) {
  538. mutex_unlock(&bat->lock);
  539. return -ENODEV;
  540. }
  541. status = spwr_battery_set_alarm_unlocked(bat, value / 1000);
  542. if (status) {
  543. mutex_unlock(&bat->lock);
  544. return status;
  545. }
  546. mutex_unlock(&bat->lock);
  547. return count;
  548. }
  549. static DEVICE_ATTR_RW(alarm);
  550. static struct attribute *spwr_battery_attrs[] = {
  551. &dev_attr_alarm.attr,
  552. NULL,
  553. };
  554. ATTRIBUTE_GROUPS(spwr_battery);
  555. /* -- Device setup. --------------------------------------------------------- */
  556. static void spwr_battery_init(struct spwr_battery_device *bat, struct ssam_device *sdev,
  557. struct ssam_event_registry registry, const char *name)
  558. {
  559. mutex_init(&bat->lock);
  560. strncpy(bat->name, name, ARRAY_SIZE(bat->name) - 1);
  561. bat->sdev = sdev;
  562. bat->notif.base.priority = 1;
  563. bat->notif.base.fn = spwr_notify_bat;
  564. bat->notif.event.reg = registry;
  565. bat->notif.event.id.target_category = sdev->uid.category;
  566. bat->notif.event.id.instance = 0; /* need to register with instance 0 */
  567. bat->notif.event.mask = SSAM_EVENT_MASK_TARGET;
  568. bat->notif.event.flags = SSAM_EVENT_SEQUENCED;
  569. bat->psy_desc.name = bat->name;
  570. bat->psy_desc.type = POWER_SUPPLY_TYPE_BATTERY;
  571. bat->psy_desc.get_property = spwr_battery_get_property;
  572. INIT_DELAYED_WORK(&bat->update_work, spwr_battery_update_bst_workfn);
  573. }
  574. static int spwr_battery_register(struct spwr_battery_device *bat)
  575. {
  576. struct power_supply_config psy_cfg = {};
  577. __le32 sta;
  578. int status;
  579. /* Make sure the device is there and functioning properly. */
  580. status = ssam_retry(ssam_bat_get_sta, bat->sdev, &sta);
  581. if (status)
  582. return status;
  583. if ((le32_to_cpu(sta) & SAM_BATTERY_STA_OK) != SAM_BATTERY_STA_OK)
  584. return -ENODEV;
  585. /* Satisfy lockdep although we are in an exclusive context here. */
  586. mutex_lock(&bat->lock);
  587. status = spwr_battery_update_bix_unlocked(bat);
  588. if (status) {
  589. mutex_unlock(&bat->lock);
  590. return status;
  591. }
  592. if (spwr_battery_present(bat)) {
  593. u32 cap_warn = get_unaligned_le32(&bat->bix.design_cap_warn);
  594. status = spwr_battery_set_alarm_unlocked(bat, cap_warn);
  595. if (status) {
  596. mutex_unlock(&bat->lock);
  597. return status;
  598. }
  599. }
  600. mutex_unlock(&bat->lock);
  601. bat->psy_desc.external_power_changed = spwr_external_power_changed;
  602. switch (get_unaligned_le32(&bat->bix.power_unit)) {
  603. case SAM_BATTERY_POWER_UNIT_mW:
  604. bat->psy_desc.properties = spwr_battery_props_eng;
  605. bat->psy_desc.num_properties = ARRAY_SIZE(spwr_battery_props_eng);
  606. break;
  607. case SAM_BATTERY_POWER_UNIT_mA:
  608. bat->psy_desc.properties = spwr_battery_props_chg;
  609. bat->psy_desc.num_properties = ARRAY_SIZE(spwr_battery_props_chg);
  610. break;
  611. default:
  612. dev_err(&bat->sdev->dev, "unsupported battery power unit: %u\n",
  613. get_unaligned_le32(&bat->bix.power_unit));
  614. return -EINVAL;
  615. }
  616. psy_cfg.drv_data = bat;
  617. psy_cfg.attr_grp = spwr_battery_groups;
  618. bat->psy = devm_power_supply_register(&bat->sdev->dev, &bat->psy_desc, &psy_cfg);
  619. if (IS_ERR(bat->psy))
  620. return PTR_ERR(bat->psy);
  621. return ssam_device_notifier_register(bat->sdev, &bat->notif);
  622. }
  623. /* -- Driver setup. --------------------------------------------------------- */
  624. static int __maybe_unused surface_battery_resume(struct device *dev)
  625. {
  626. return spwr_battery_recheck_full(dev_get_drvdata(dev));
  627. }
  628. static SIMPLE_DEV_PM_OPS(surface_battery_pm_ops, NULL, surface_battery_resume);
  629. static int surface_battery_probe(struct ssam_device *sdev)
  630. {
  631. const struct spwr_psy_properties *p;
  632. struct spwr_battery_device *bat;
  633. p = ssam_device_get_match_data(sdev);
  634. if (!p)
  635. return -ENODEV;
  636. bat = devm_kzalloc(&sdev->dev, sizeof(*bat), GFP_KERNEL);
  637. if (!bat)
  638. return -ENOMEM;
  639. spwr_battery_init(bat, sdev, p->registry, p->name);
  640. ssam_device_set_drvdata(sdev, bat);
  641. return spwr_battery_register(bat);
  642. }
  643. static void surface_battery_remove(struct ssam_device *sdev)
  644. {
  645. struct spwr_battery_device *bat = ssam_device_get_drvdata(sdev);
  646. ssam_device_notifier_unregister(sdev, &bat->notif);
  647. cancel_delayed_work_sync(&bat->update_work);
  648. }
  649. static const struct spwr_psy_properties spwr_psy_props_bat1 = {
  650. .name = "BAT1",
  651. .registry = SSAM_EVENT_REGISTRY_SAM,
  652. };
  653. static const struct spwr_psy_properties spwr_psy_props_bat2_sb3 = {
  654. .name = "BAT2",
  655. .registry = SSAM_EVENT_REGISTRY_KIP,
  656. };
  657. static const struct ssam_device_id surface_battery_match[] = {
  658. { SSAM_SDEV(BAT, 0x01, 0x01, 0x00), (unsigned long)&spwr_psy_props_bat1 },
  659. { SSAM_SDEV(BAT, 0x02, 0x01, 0x00), (unsigned long)&spwr_psy_props_bat2_sb3 },
  660. { },
  661. };
  662. MODULE_DEVICE_TABLE(ssam, surface_battery_match);
  663. static struct ssam_device_driver surface_battery_driver = {
  664. .probe = surface_battery_probe,
  665. .remove = surface_battery_remove,
  666. .match_table = surface_battery_match,
  667. .driver = {
  668. .name = "surface_battery",
  669. .pm = &surface_battery_pm_ops,
  670. .probe_type = PROBE_PREFER_ASYNCHRONOUS,
  671. },
  672. };
  673. module_ssam_device_driver(surface_battery_driver);
  674. MODULE_AUTHOR("Maximilian Luz <[email protected]>");
  675. MODULE_DESCRIPTION("Battery driver for Surface System Aggregator Module");
  676. MODULE_LICENSE("GPL");