aboutsummaryrefslogtreecommitdiff
path: root/README
diff options
context:
space:
mode:
Diffstat (limited to '')
-rw-r--r--README79
1 files changed, 79 insertions, 0 deletions
diff --git a/README b/README
new file mode 100644
index 0000000..b5280c5
--- /dev/null
+++ b/README
@@ -0,0 +1,79 @@
+ToyKeeper's flashlight firmware repository
+==========================================
+
+This is a collection of firmware for flashlights or torches, mostly
+collected from BLF (http://budgetlightforum.com/). It's collected
+here mostly for convenience, and to provide bug tracking and revision
+control services for the code.
+
+
+Getting Started
+===============
+
+A general overview of what you need to get going is here:
+
+ http://flashlightwiki.com/AVR_Drivers
+
+To set up an attiny dev environment on Ubuntu (13.10):
+
+ sudo apt-get install flex byacc bison gcc libusb-dev libc6-dev
+ sudo apt-get install gcc-avr avr-libc binutils-avr
+ sudo apt-get install avrdude avrdude-doc
+
+Installing attiny dev tools on UNIX systems in general:
+
+ http://www.ladyada.net/learn/avr/setup-unix.html
+
+To build a .hex file from a .c file, in Windows:
+
+ http://budgetlightforum.com/node/29081
+
+After wiring everything up, this tests the connection to the ATTINY13A chip:
+
+ avrdude -p t13 -c usbasp -n
+ (you may need to put 'sudo' in front, on UNIX systems)
+
+To flash NLITE, which is a good second test... (this is the output from my
+terminal, which may or may not be quite correct... not sure what the sck
+period error is about, and the verify fails, but it otherwise works)
+
+ ~/src/torches/DrJones/NLITE/> sudo avrdude -p t13 -c usbasp -u -Uflash:w:nlite.hex:a -Ulfuse:w:0x75:m -Uhfuse:w:0xFF:m
+
+ avrdude: warning: cannot set sck period. please check for usbasp firmware update.
+ avrdude: AVR device initialized and ready to accept instructions
+
+ Reading | ################################################## | 100% 0.00s
+
+ avrdude: Device signature = 0x1e9007
+ avrdude: NOTE: FLASH memory has been specified, an erase cycle will be performed
+ To disable this feature, specify the -D option.
+ avrdude: current erase-rewrite cycle count is -268439553 (if being tracked)
+ avrdude: erasing chip
+ avrdude: warning: cannot set sck period. please check for usbasp firmware update.
+ avrdude: reading input file "nlite.hex"
+ avrdude: input file nlite.hex auto detected as Intel Hex
+ avrdude: writing flash (524 bytes):
+
+ Writing | ################################################## | 100% 0.44s
+
+
+
+ avrdude: 524 bytes of flash written
+ avrdude: verifying flash memory against nlite.hex:
+ avrdude: load data flash data from input file nlite.hex:
+ avrdude: input file nlite.hex auto detected as Intel Hex
+ avrdude: input file nlite.hex contains 524 bytes
+ avrdude: reading on-chip flash data:
+
+ Reading | ################################################## | 100% 0.30s
+
+
+
+ avrdude: verifying ...
+ avrdude: verification error, first mismatch at byte 0x0004
+ 0x37 != 0x13
+ avrdude: verification error; content mismatch
+
+ avrdude done. Thank you.
+
+ [1] 21327 exit 1 sudo avrdude -p t13 -c usbasp -u -Uflash:w:nlite.hex:a -Ulfuse:w:0x75:m