-
-
Notifications
You must be signed in to change notification settings - Fork 109
/
strings.sh
542 lines (398 loc) · 14.8 KB
/
strings.sh
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
# English (en)
print_already_running() {
echo "accd is already running"
}
print_started() {
echo "accd started"
}
print_stopped() {
echo "accd stopped"
}
print_not_running() {
echo "accd is not running"
}
print_restarted() {
echo "accd restarted"
}
print_is_running() {
echo "accd $1 is running $2"
}
print_config_reset() {
echo "Config reset"
}
print_invalid_switch() {
echo "Invalid charging switch, [${chargingSwitch[@]-}]"
}
print_charging_disabled_until() {
echo "Charging disabled until battery $([ ${2:-.} = v ] && echo "voltage" || echo "capacity") <= $1"
}
print_charging_disabled_for() {
echo "Charging disabled for $1"
}
print_charging_disabled() {
echo "Charging disabled"
}
print_charging_enabled_until() {
echo "Charging enabled until battery $([ ${2:-.} = v ] && echo "voltage" || echo "capacity") >= $1"
}
print_charging_enabled_for() {
echo "Charging enabled for $1"
}
print_charging_enabled() {
echo "Charging enabled"
}
print_unplugged() {
echo "Ensure the charger is plugged 🔌"
}
print_switch_works() {
echo " Switch works ✅"
}
print_switch_fails() {
echo " Switch doesn't work ❌"
}
print_no_ctrl_file() {
[ .${1-} = .v ] && echo "No voltage control file found" \
|| echo "No current control file found; try the temp_level feature"
}
print_not_found() {
echo "$1 not found"
}
print_help() {
cat << EOF
Usage
acc Wizard
accd Start/restart accd
accd. Stop acc/daemon
accd, Print acc/daemon status (running or not)
acc [pause_capacity/millivolts [resume_capacity/millivolts, default: pause_capacity/millivolts - 5%/50mV]]
e.g.,
acc 75 70
acc 80 (resume_capacity defaults to 80% - 5)
acc 3900 (same as acc 3900 3870, great idle mode alternative)
acc [options] [args] Refer to the list of options below
acca [options] [args] acc optimized for front-ends
acc[d] -x [options] [args] Sets log=/sdcard/Download/acc[d]-\${device}.log; useful for debugging unwanted reboots
A custom config path can be specified as first parameter (second if -x is used).
If the file doesn't exist, the current config is cloned.
e.g.,
acc /data/acc-night-config.txt --set pause_capacity=45 resume_capacity=43
acc /data/acc-night-config.txt --set --current 500
accd /data/acc-night-config.txt --init
Notes regarding accd:
- The order of "--init|-i" does not matter.
- The config path string shall not contain "--init|-i".
Options
-b|--rollback [nv] Restore previous installation; with "n" flag, the config is not restored; with "v" flag, nothing is done other than printing the version that would have been restored
-c|--config [[editor] [editor_opts] | g for GUI] Edit config (default editor: nano/vim/vi)
e.g.,
acc -c (edit w/ nano/vim/vi)
acc -c less
acc -c cat
-c|--config a|d string|regex Append (a) or delete (d) string/pattern to/from config
e.g.,
acc -c a : sleep profile, at 22:00 acc -s pc=50 mcc=500 mcv=3900, acc -n switched to sleep profile (append a schedule)
acc -c d sleep (remove all lines matching "sleep")
-c|--config h string Print config help text associated with "string" (config variable)
e.g., acc -c h rt (or resume_temp)
-d|--disable [#%, #s, #m, #h or #mv (optional)] Disable charging
e.g.,
acc -d 70% (do not recharge until capacity <= 70%)
acc -d 1h (do not recharge until 1 hour has passed)
acc -d 4000mv (do not recharge until battery voltage <= 4000mV)
-D|--daemon Print daemon status, (and if running) version and PID
e.g., acc -D (alias: "accd,")
-D|--daemon [start|stop|restart] Manage daemon
e.g.,
acc -D start (alias: accd)
acc -D restart (alias: accd)
accd -D stop (alias: "accd.")
-e|--enable [#%, #s, #m, #h or #mv (optional)] Enable charging
e.g.,
acc -e 75% (recharge to 75%)
acc -e 30m (recharge for 30 minutes)
acc -e 4000mv (recharge to 4000mV)
-f|--force|--full [capacity] [additional opts/args] Charge once to a given capacity (default: 100%), without restrictions
e.g.,
acc -f 95 (charge to 95%)
acc -f (charge to 100%)
acc -f -s mcc=500 (charge to 100% with a 500 mA limit)
-F|--flash ["zip_file"] Flash any zip files whose update-binary is a shell script
e.g.,
acc -F (lauches a zip flashing wizard)
acc -F "file1" "file2" "fileN" ... (install multiple zips)
acc -F "/sdcard/Download/Magisk-v20.0(20000).zip"
-h|--help [[editor] [editor_opts] | g for GUI] Print this help text, plus the config
-H|--health <mAh> Print estimated battery health
-i|--info [case insensitive egrep regex (default: ".")] Show battery info
e.g.,
acc -i
acc -i volt
acc -i volt,curr (multiple patterns)
-l|--log [-a|--acc] [[editor] [editor_opts] | g for GUI] Print/edit accd log (default) or acc log (-a|--acc)
e.g.,
acc -l (same as acc -l less)
acc -l rm
acc -l -a cat
acc -l grep ': ' (show explicit errors only)
-la Same as -l -a
-l|--log -e|--export Export all logs to /sdcard/Download/acc-logs-\$deviceName.tgz
e.g., acc -l -e
-le Same as -l -e
-n|--notif [["STRING" (default: ":)")] [USER ID (default: 2000 (shell))]] Post Android notification; may not work on all systems
e.g., acc -n "Hello, World!"
-p|--parse [<base file> <file to parse>] | <file to parse>] Helps find potential charging switches quickly, for any device
e.g.,
acc -p Parse $dataDir/logs/power_supply-\*.log and print potential charging switches not present in $TMPDIR/ch-switches
acc -p /sdcard/power_supply-harpia.log Parse the given file and print potential charging switches that are not already in $TMPDIR/ch-switches
acc -p /sdcard/charging-switches.txt /sdcard/power_supply-harpia.log Parse /sdcard/power_supply-harpia.log and print potential charging switches absent from /sdcard/charging-switches.txt
-r|--readme [g for GUI]] Open the manual
-R|--resetbs Reset battery stats
e.g., acc -R
-s|--set Print current config
e.g., acc -s
-s|--set file Get config from file (in "acc -s" format); the file's path must be absolute; partial config is supported
e.g., acc -s /data/config
-s|--set prop1=value "prop2=value1 value2" Set [multiple] properties
e.g.,
acc -s charging_switch=
acc -s pause_capacity=60 resume_capacity=55 (shortcuts: acc -s pc=60 rc=55, acc 60 55)
acc -s "charging_switch=battery/charging_enabled 1 0" resume_capacity=55 pause_capacity=60
Note: all properties have short aliases for faster typing; run "acc -c cat" to see them
-s|--set c|--current [milliamps|-] Set/print/restore_default max charging current (range: 0-9999$(print_mA))
e.g.,
acc -s c (print current limit)
acc -s c 500 (set)
acc -s c - (restore default)
-sc [milliamps|-] Same as above
-s|--set l|--lang Change language
e.g., acc -s l
-sl Same as above
-s|--set d|--print-default [egrep regex (default: ".")] Print default config without blank lines
e.g.,
acc -s d (print entire defaul config)
acc -s d cap (print only entries matching "cap")
acc -s cap,temp (multiple patterns)
-sd [egrep regex (default: ".")] Same as above
-s|--set p|--print [egrep regex (default: ".")] Print current config without blank lines (refer to previous examples)
-sp [egrep regex (default: ".")] Same as above
-s|--set r|--reset [a] Restore default config ("a" is for "all": config and control file blacklists, essentially a hard reset)
e.g.,
acc -s r
-sr [a] Same as above
-s|--set s|charging_switch Enforce a specific charging switch
e.g., acc -s s
-ss Same as above
-s|--set s:|chargingSwitch: List known charging switches
e.g., acc -s s:
-ss: Same as above
-s|--set s::|chargingSwitch:: List working charging switches and mcc, mcv & tl support status
e.g., acc -s s::
-ss:: Same as above
-s|--set v|--voltage [millivolts|-] [--exit] Set/print/restore_default max charging voltage (range: 3700-4300$(print_mV))
e.g.,
acc -s v (print)
acc -s v 3900 (set)
acc -s v - (restore default)
acc -s v 3900 --exit (stop the daemon after applying settings)
-sv [millivolts|-] [--exit] Same as above
-t|--test [ctrl_file1 on off [ctrl_file2 on off]] Test custom charging switches
e.g.,
acc -t battery/charging_enabled 1 0
acc -t /proc/mtk_battery_cmd/current_cmd 0::0 0::1 /proc/mtk_battery_cmd/en_power_path 1 0 ("::" is a placeholder for " " - MTK only)
-t|--test [file] Test charging switches from a file (default: $TMPDIR/ch-switches)
e.g.,
acc -t (test known switches)
acc -t /sdcard/experimental_switches.txt (test custom/foreign switches)
-t|--test [p|parse] Parse potential charging switches from the power supply log (as "acc -p"), test them all, and add the working ones to the list of known switches
Implies -x, as acc -x -t p
e.g., acc -t p
-T|--logtail Monitor accd log (tail -F)
e.g., acc -T
-u|--upgrade [-c|--changelog] [-f|--force] [-n|--non-interactive] Online upgrade/downgrade
e.g.,
acc -u dev (upgrade to the latest dev version)
acc -u (latest version from the current branch)
acc -u master^1 -f (previous stable release)
acc -u -f dev^2 (two dev versions below the latest dev)
acc -u v2020.4.8-beta --force (force upgrade/downgrade to v2020.4.8-beta)
acc -u -c -n (if update is available, prints version code (integer) and changelog)
acc -u -c (same as above, but with install prompt)
-U|--uninstall Completely remove acc and AccA
e.g., acc -U
-v|--version Print acc version and version code
e.g., acc -v
-w[#]|--watch[#] [pattern1,pattern2,...] Monitor battery uevent
e.g.,
acc -w (update info every second)
acc -w0.5 (update info every half a second)
acc -w0 (no extra delay)
acc -w curr,volt
Exit Codes
0. True/success
1. False or general failure
2. Incorrect command syntax
3. Missing busybox binary
4. Not running as root
5. Update available ("--upgrade")
6. No update available ("--upgrade")
7. Failed to disable charging
8. Daemon already running ("--daemon start")
9. Daemon not running ("--daemon" and "--daemon stop")
10. All charging switches fail (--test)
11. Current (mA) out of 0-9999 range
12. Initialization failed
13. Failed to lock $TMPDIR/acc.lock
14. ACC won't initialize, because the Magisk module disable flag is set
15. Idle mode is supported (--test)
16. Failed to enable charging (--test)
Logs are exported automatically ("--log --export") on exit codes 1, 2 and 7.
Tips
Commands can be chained for extended functionality.
e.g., charge for 30 minutes, pause charging for 6 hours, charge to 85% and restart the daemon
acc -e 30m && acc -d 6h && acc -e 85 && accd
One can take advantage of one-line scripts and the built-in "at" function to schedule profiles (refer back to -c|--config).
Sample profile
acc -s pc=60 mcc=500 mcv=3900
This keeps battery capacity between 55-60%, limits charging current to 500 mA and voltage to 3900 millivolts.
It's great for nighttime and "forever-plugged".
Refer to acc -r (or --readme) for the full documentation (recommended)
EOF
}
print_exit() {
echo "Exit"
}
print_choice_prompt() {
echo "(?) Choice, [enter]: "
}
print_auto() {
echo "Automatic"
}
print_default() {
echo "Default"
}
print_curr_restored() {
echo "Default max charging current restored"
}
print_volt_restored() {
echo "Default max charging voltage restored"
}
print_read_curr() {
echo "Need to read default max charging current value(s) first"
}
print_curr_set() {
echo "Max charging current set to $1$(print_mA)"
}
print_volt_set() {
echo "Max charging voltage set to $1$(print_mV)"
}
print_wip() {
echo "Invalid option"
echo "- Run acc -h or -r for help "
}
print_press_key() {
printf "Press any key to continue..."
}
print_lang() {
echo "Language 🌐"
}
print_doc() {
echo "Documentation 📘"
}
print_cmds() {
echo "All commands"
}
print_re_start_daemon() {
echo "Start/restart daemon ▶️ 🔁"
}
print_stop_daemon() {
echo "Stop daemon ⏹️"
}
print_export_logs() {
echo "Export logs"
}
print_1shot() {
echo "Charge once to a given level (default: 100%), without restrictions; you can append -s ... for other settings"
}
print_charge_once() {
echo "Charge once to #%"
}
print_mA() {
echo " mA"
}
print_mV() {
echo " mV"
}
print_uninstall() {
echo "Uninstall"
}
print_edit() {
echo "Edit $1"
}
print_flash_zips() {
echo "Flash zips"
}
print_reset_bs() {
echo "Reset battery stats"
}
print_test_cs() {
echo "Test charging switches"
}
print_update() {
echo "Check for update 🔃"
}
print_available() {
echo "$@ is available"
}
print_install_prompt() {
printf "- Download and install? ([enter]: yes, CTRL-C: no) "
}
print_no_update() {
echo "No update available"
}
print_only() {
echo "only"
}
print_wait() {
echo "This may take a while... ⏳"
}
print_as_warning() {
echo "⚠️ WARNING: I'll shutdown the system at ${1}% battery if you don't plug the charger!"
}
print_i() {
echo "Battery info"
}
print_undo() {
echo "Undo upgrade"
}
print_blacklisted() {
echo " Switch is blacklisted; won't be tested 🚫"
}
print_acct_info() {
echo "
💡Notes/Tips:
Some switches -- notably those that control current and voltage -- are prone to inconsistencies. If a switch works at least twice, assume it's functional.
Results may vary with different power supplies and conditions, as stated in \"readme > troubleshooting > charging switch\".
Want to test all potential switches? \"acc -t p\" parses them from the power supply log (as \"acc -p\"), tests all, and adds the working ones to the list of known switches.
To set charging switches, run acc -ss (wizard) or acc -s s=\"switches go here --\".
battIdleMode: whether the device can run directly off the charger.
If it's not supported, you still have options. Refer to \"README > FAQ > What's idle mode, and how do I set it up?\"
The output of this command is saved to ${logF}."
}
print_panic() {
printf "\nWARNING: experimental feature, dragons ahead!
Potentially problematic control files are excluded based on known patterns.
Some control files that trigger a reboot are automatically blacklisted.
Do you want to see/edit the list of potential switches before testing?
a: abort operation | n: no | y: yes (default) "
}
print_resume() {
echo " ##########
Waiting for charging to resume...
If it doesn't happen after a few seconds, try re-plugging the charger.
If it's taking too long, unplug the charger, stop the test with CTRL-C, run accd -i, wait a few seconds, and retest.
In extreme cases, one shall comment out (blacklist) this switch in $dataDir/logs/write.log, reboot (to enable charging), and re-run the test.
##########"
}
print_hang() {
echo "Hang on..."
}