Home Explore Help
Sign In
mbuesch
/
simplepwm
Watch 1
Star 0
Fork 0
Files
Branch: rgb
Branches Tags
simplepwm
/
README.rst

README.rst 2.4 KB
Permalink History Raw

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192 
  1. Simple PWM controller
    2. 

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

  3. 

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

  5. 

  6. Simplepwm is a small PWM brightness controller for LED lamps.
    7. 

  7. 

  8. 

  9. Microcontroller
    10. 

  10. ===============
    11. 

  11. 

  12. Simplepwm supports these microcontrollers:
    13. 

  13. 

  14. Atmel/Microchip ATTiny 25/45/85:
    15. 

  15. 

  16. * Full feature set.
    17. 

  17. 

  18. Atmel/Microchip ATTiny 13:
    19. 

  19. 

  20. * Reduced feature set.
    21. 

  21. * No battery power saving.
    22. 

  22. * No battery voltage monitoring.
    23. 

  23. 

  24. 

  25. Hardware schematics
    26. 

  26. ===================
    27. 

  27. 

  28. See `schematics/simplepwm.pdf <schematics/simplepwm.pdf>`_
    29. 

  29. 

  30. 

  31. Prebuilt firmware images
    32. 

  32. ========================
    33. 

  33. 

  34. The release archives of simplepwm 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).
    35. 

  35. 

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

  37. 

  38. 

  39. Building the firmware
    40. 

  40. =====================
    41. 

  41. 

  42. The firmware build needs the following tool chain:
    43. 

  43. 

  44. * Unix-like operating system
    45. 

  45. * GNU make
    46. 

  46. * AVR GCC
    47. 

  47. * AVR Binutils
    48. 

  48. * avrdude
    49. 

  49. 

  50. Run the following commands to build the firmware:
    51. 

  51. 

  52. .. code:: sh
    53. 

  53. 

  54. 	cd firmware
    55. 

  55. 	make DEV=t85
    56. 

  56. 

  57. Please specify the target microcontroller using the DEV variable as shown above.
    58. 

  58. 

  59. Valid values are:
    60. 

  60. 

  61. * ATTiny 13: `DEV=t13`
    62. 

  62. * ATTiny 25: `DEV=t25`
    63. 

  63. * ATTiny 45: `DEV=t45`
    64. 

  64. * ATTiny 85: `DEV=t85`
    65. 

  65. 

  66. 

  67. Flashing the firmware after build
    68. 

  68. =================================
    69. 

  69. 

  70. Run the following commands to flash the firmware to the target microcontroller:
    71. 

  71. 

  72. .. code:: sh
    73. 

  73. 

  74. 	cd firmware
    75. 

  75. 	make DEV=t85 print_fuses
    76. 

  76. 	make DEV=t85 write_fuses
    77. 

  77. 	make DEV=t85 write_mem
    78. 

  78. 

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

  80. 

  81. 

  82. License
    83. 

  83. =======
    84. 

  84. 

  85. Copyright (c) 2018-2020 Michael Buesch <m@bues.ch>
    86. 

  86. 

  87. 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.
    88. 

  88. 

  89. 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.
    90. 

  90. 

  91. 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.
    92. 

  92.