Home Explore Help
Sign In
mbuesch
/
pbwake
Watch 1
Star 0
Fork 0
Files Issues 0 Pull Requests 0 Wiki
Branch: master
Branches Tags
pbwake
/
README.rst

README.rst 3.9 KB
Permalink History Raw

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127 
  1. Power bank keep alive device
    2. 

  2. ============================
    3. 

  3. 

  4. `https://bues.ch/cgit/pbwake.git/ <https://bues.ch/cgit/pbwake.git/>`_
    5. 

  5. 

  6. Pbwake is a small USB stick to prevent power banks from shutting off the outputs and falling into deep sleep mode.
    7. 

  7. 

  8. Pbwake uses tiny load pulses to simulate a real load on the power bank outputs. The lengths of the load pulse active (high) and inactive (low) phases are pseudo random within configurable bounds.
    9. 

  9. 

  10. Pbwake is in a low power state during the inactive (low) phases. Therefore it doesn't waste too much power and guarantees high battery life of the power bank.
    11. 

  11. 

  12. 

  13. Tested power banks
    14. 

  14. ==================
    15. 

  15. 

  16. Power banks this has been tested with are:
    17. 

  17. 

  18. * Anker PowerCore 20100 model A1271.
    19. 

  19. * No-name power bank 2200 mAh / 11 Wh with integrated flashlight LED.
    20. 

  20. 

  21. 

  22. Microcontroller
    23. 

  23. ===============
    24. 

  24. 

  25. Pbwake supports the following microcontrollers:
    26. 

  26. 

  27. * ATTiny-13
    28. 

  28. * ATTiny-25
    29. 

  29. * ATTiny-45
    30. 

  30. * ATTiny-85
    31. 

  31. * ATMega-328P
    32. 

  32. 

  33. 

  34. Hardware schematics
    35. 

  35. ===================
    36. 

  36. 

  37. Schematics: `schematics/pbwake-attiny/pbwake.pdf <schematics/pbwake-attiny/pbwake.pdf>`_
    38. 

  38. 

  39. The hardware may be built manually on a simple prototype board.
    40. 

  40. 

  41. Board front side:
    42. 

  42. 

  43. .. image:: doc/pbwake_front.jpg
    44. 

  44. 

  45. Board back side:
    46. 

  46. 

  47. .. image:: doc/pbwake_back.jpg
    48. 

  48. 

  49. 

  50. Prebuilt firmware images
    51. 

  51. ========================
    52. 

  52. 

  53. The release archives of pbwake contain prebuilt `.hex` files for all supported microcontrollers in the `hex` directory. These hex files can be flashed directly to the microcontroller with a any tool of your choice (e.g. Atmel Studio or avrdude).
    54. 

  54. 

  55. The corresponding fuse settings can be found in the file `fuses.txt` in the same directory.
    56. 

  56. 

  57. 

  58. Building the firmware
    59. 

  59. =====================
    60. 

  60. 

  61. The firmware build needs the following tool chain:
    62. 

  62. 

  63. * Unix-like operating system
    64. 

  64. * GNU make
    65. 

  65. * AVR GCC
    66. 

  66. * AVR Binutils
    67. 

  67. * avrdude
    68. 

  68. 

  69. Run the following commands to build the firmware:
    70. 

  70. 

  71. .. code:: sh
    72. 

  72. 

  73. 	cd firmware
    74. 

  74. 	make DEV=t85
    75. 

  75. 

  76. Please specify the target microcontroller using the DEV variable as shown above.
    77. 

  77. 

  78. Valid values are:
    79. 

  79. 

  80. ===============  ===========
    81. 

  81. Microcontroller  make option
    82. 

  82. ===============  ===========
    83. 

  83. ATTiny 13        `DEV=t13`
    84. 

  84. ATTiny 25        `DEV=t25`
    85. 

  85. ATTiny 45        `DEV=t45`
    86. 

  86. ATTiny 85        `DEV=t85`
    87. 

  87. ATMega 328P      `DEV=m328p`
    88. 

  88. ===============  ===========
    89. 

  89. 

  90. Additional build options that can be passed to `make`:
    91. 

  91. 

  92. ================  =======  ================================================================
    93. 

  93. make option       default  description
    94. 

  94. ================  =======  ================================================================
    95. 

  95. CONF_HIGH_MIN_MS  4        Minimum length of high-phase (in milliseconds).
    96. 

  96. CONF_HIGH_MAX_MS  6        Maximum length of high-phase (in milliseconds).
    97. 

  97. CONF_LOW_MIN_MS   40000    Minimum length of low-phase (in milliseconds).
    98. 

  98. CONF_LOW_MAX_MS   55000    Maximum length of low-phase (in milliseconds).
    99. 

  99. ================  =======  ================================================================
    100. 

  100. 

  101. 

  102. Flashing the firmware after build
    103. 

  103. =================================
    104. 

  104. 

  105. Run the following commands to flash the firmware to the target microcontroller:
    106. 

  106. 

  107. .. code:: sh
    108. 

  108. 

  109. 	cd firmware
    110. 

  110. 	make DEV=t85 print_fuses
    111. 

  111. 	make DEV=t85 write_fuses
    112. 

  112. 	make DEV=t85 write_mem
    113. 

  113. 

  114. Or alternatively use any other of the available AVR flashing tools to program the .hex file and fuses.
    115. 

  115. 

  116. 

  117. License
    118. 

  118. =======
    119. 

  119. 

  120. Copyright (c) 2020 Michael Buesch <m@bues.ch>
    121. 

  121. 

  122. This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.
    123. 

  123. 

  124. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for more details.
    125. 

  125. 

  126. You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
    127. 

  127.