Editing Alpha Clock Firmware v2

Jump to: navigation, search

Warning: You are not logged in. Your IP address will be publicly visible if you make any edits. If you log in or create an account, your edits will be attributed to your username, along with other benefits.

The edit can be undone. Please check the comparison below to verify that this is what you want to do, and then save the changes below to finish undoing the edit.
Latest revision Your text
Line 1: Line 1:
−
The [[Alpha Clock Five]] is an alarm clock and alphanumeric LED data display device based on the ATmega644A AVR microcontroller.   While most users will not need to reprogram Alpha Clock Five, we are making this page of documentation available for those who would like to modify the programming or simply would like to update an existing unit to firmware version 2.x.
+
The [[Alpha Clock Five]] is an alarm clock and alphanumeric LED display development platform based on the ATmega644A AVR microcontroller. It can be programmed through an AVR ISP programmer, using standard AVR-GCC techniques, or through an FTDI USB-TTL interface, using a modified version of the Arduino development environment.
  
−
Alpha Clock Five can be programmed  through an FTDI USB-TTL interface, using a modified version of the Arduino development environment, or through an AVR ISP programmer using standard AVR programming techniques.  The default firmware is designed to under the modified Arduino environment, which is described below in the section titled "Bootloader (Arduino style) programming."
 
  
 +
'''Alpha Clock Five firmware version 2.0:'''  ''coming week of Oct. 29, 2012''
  
 +
Please [http://wiki.evilmadscience.com/Alpha_Clock_Firmware go here] for information about firmware version 1.0.
  
−
== Standard Firmware for Alpha Clock Five ==
 
  
 +
== Bootloader (Arduino style) programming ==
 +
 +
The microcontroller in Alpha Clock Five kit comes preprogrammed with the [http://sanguino.cc/ Sanguino] Bootloader.  Because of this, Alpha Clock Five can be reprogrammed right in the Arduino environment, through a USB-TTL interface such as the [http://evilmadscience.com/productsmenu/partsmenu/130-usbttl FTDI USB-TTL cable] or the http://evilmadscience.com/productsmenu/accessories/210 Adafruit FTDI Friend].
 +
 +
The bootloader itself can only be written (or rewritten) with an AVR ISP programmer, such as the [http://evilmadscience.com/productsmenu/tinykitlist/106-usbtiny USBtinyISP].  While most users will not ever need to do this, see below (under [http://wiki.evilmadscience.com/index.php?title=Alpha_Clock_Firmware#AVR_ISP_Programming AVR ISP Programming]) if you should need to do so.
 +
 +
 +
=== Setting up the environment ===
  
−
=== Alpha Clock Five firmware version 2.0 ===
+
Alpha Clock Five requires a rather specialized programming environment, that uses some older software versions and will be updated in the near future.
  
−
The latest version of the Alpha Clock Five Firmware, (currently v. 2.2) is hosted [https://github.com/oskay/AlphaClock at our github repository].  Download the .zip archive of the repository there, or follow [https://github.com/oskay/AlphaClock/archive/master.zip this direct link] to download and save it to your computer.  This .zip archive contains the Alpha Clock Five library for Arduino, for which the standard firmware is included as one of the example files.    The necessary setup to install that library and upload the firmware is discussed in the sections that follow on this page.
 
  
−
   
+
Required software:
−
(The previous major firmware version, v. 1.0 of the Alpha Clock Five firmware is discussed [http://wiki.evilmadscience.com/Alpha_Clock_Firmware_v1 here].)
+
* Arduino 1.0.1 (available [http://arduino.cc/en/Main/Software here]).
 +
*  Sanguino version 1.0.1 [http://code.google.com/p/sanguino/downloads/list from here]. 
 +
*  Arduino Time library, available [http://www.arduino.cc/playground/Code/Time here].
 +
 
 +
First, install the Arduino program on your computer.
 +
 
 +
Secondly, install the Time library in your Arduino libraries folder.  The exact location of this libraries folder depends a bit on your operating system.  For example, on Mac OSX, the directory would be ~/Documents/Arduino/libraries/. On Windows, it would be My Documents\Arduino\libraries\ .  If your library is installed correctly, it will show up in the '''Sketch | Import Library''' menu in the Arduino program when you restart it.
  
 +
Finally, the Sanguino extensions need to be installed separately, and the method for that depends, very slightly, on your operating system:
  
 +
==== Installing Sanguino: Mac ====
  
−
== Bootloader (Arduino style) programming ==
+
First unzip the Sanguino .zip file, which reveals a folder called "Sanguino."  Then, find the location where you need to install it.
  
−
The microcontroller in Alpha Clock Five kit comes preprogrammed with the "Sanguino" Bootloader-- an Arduino bootloader designed to run on the ATmega644 processor. Because of this, Alpha Clock Five can be reprogrammed right in the Arduino environment, through a USB-TTL interface such as the [http://shop.evilmadscientist.com/productsmenu/partsmenu/130-usbttl FTDI USB-TTL cable] or the [http://shop.evilmadscientist.com/productsmenu/accessories/210 Adafruit FTDI Friend], and doing so is our recommended procedure.
 
  
−
The bootloader itself can only be written (or rewritten) with an AVR ISP programmer, such as the [http://shop.evilmadscientist.com/productsmenu/tinykitlist/106-usbtiny USBtinyISP].  While most users will not ever need to do this, see below (under [http://wiki.evilmadscientist.com/index.php?title=Alpha_Clock_Firmware#AVR_ISP_Programming AVR ISP Programming]) if you should need to do so.
+
* Locate your Arduino.app file, version 1.0.1 (which you may have just installed). 
 +
* Ctrl-click the file to show the contextual pop-up menu.   
 +
* From that menu, select  "Show Package Contents."
 +
* Within the resulting directory (Arduino.app), navigate to the folder Contents/Resources/Java/hardware
 +
* Inside "hardware" there several folders, including one called "arduino."  Copy the whole "Sanguino" folder, which you unzipped earlier into the hardware folder, next to "arduino."
 +
* Restart Arduino.
  
 +
If the Sanguino software is installed correctly, you will see Sanguino options in your Tools>Board menu. 
  
−
=== Setting up the environment ===
 
  
−
Alpha Clock Five requires a rather specialized programming environment:
+
==== Installing Sanguino: Windows ====
  
 +
First unzip the Sanguino .zip file, which reveals a folder called "Sanguino."  Then, copy that to within your Arduino application.
  
−
Required software:
+
* Locate your Arduino application, version 1.0.1 (which you may have just installed).  
−
* Arduino 1.8.10 (available [http://arduino.cc/en/Main/Software here]).  
+
* Copy the Sanguino directory to arduino\hardware/  
−
* Arduino Time library, available [https://github.com/PaulStoffregen/Time here].
+
* You should end up with arduino\hardware\Sanguino\
−
* Arduino DS1307 library, available [https://github.com/PaulStoffregen/DS1307RTC here].
+
* Restart Arduino.
−
*  Alpha Clock Five library, as discussed above.
 
−
* The MightyCore extensions to Arduino, which include the Sanguino configuration files.
 
  
−
First, install the Arduino program on your computer.  Open Arduino to ensure that it runs correctly, and then quit.  (Please do not skip this step!)
+
If the Sanguino software is installed correctly, you will see Sanguino options in your Tools>Board menu.   
  
−
Secondly, install the Time and DS1307 libraries in your Arduino libraries folder.  The exact location of this libraries folder depends a bit on your operating system.  For example, on Mac OSX, the directory would be ~/Documents/Arduino/libraries/. On Windows, it would be My Documents\Arduino\libraries\ .  Copy the Time folder (the one with the time.h file, not the top-level Time folder) to your libraries folder.  If your library is installed correctly, it will show up in (and be importable from) the '''Sketch > Import Library''' menu in the Arduino program when you restart it. 
 
  
−
Third, install the Alpha Clock Five library.  When you download [https://github.com/oskay/AlphaClock/archive/master.zip the .zip file] from github, it will show up on your computer as "AlphaClock-master.zip".  Unzip that file, and open that folder to find the file within called just "alphafive".  Place this "alphafive" folder in your Arduino libraries folder, just as you did with the Time library.    If your library is installed correctly, it will show up in the '''Sketch > Import Library''' menu in the Arduino program when you restart it.
+
==== Installing Sanguino: Linux ====
 
   
 
   
−
Finally, the MightyCore additions need to be installed. This can be done from directly inside the Arduino application, following the [https://github.com/MCUdude/MightyCore#how-to-install directions here]. Once added, you can select the following from your Tools menu in Arduino to configure the device:
+
First unzip the Sanguino .zip file, which reveals a folder called "Sanguino."  Then, copy that to within your Arduino application.
 +
 
 +
* Locate your Arduino application, version 1.0.1 (which you may have just installed). 
 +
* Copy ~/Sanguino to arduino/hardware/  
 +
* You should end up with arduino/hardware/Sanguino/
 +
 
 +
* Restart Arduino.
 +
 
 +
If the Sanguino software is installed correctly, you will see Sanguino options in your Tools>Board menu. 
  
−
*  Board> MightyCore: ATmega644
 
−
*  Clock: External 16 MHz
 
−
*  BOD: 2.7V
 
−
*  Variant: 644P (See technical note about device signature below, if you're curious.)
 
−
*  Bootloader: Yes, UART 0
 
−
*  Pinout: Sanguino pinout
 
−
*  Port: Select the FTDI adapter that you have connected to your computer by USB
 
  
−
==== Setting the upload baud rate ====
+
=== Uploading firmware ===
  
−
For historical reasons related to the original "Sanguino" core, the speed that the Arduino application uses to upload firmware to Alpha Clock Five needs to be set to 57600 baud. (Some kits that shipped in 2012 or earlier, prior to the release of [https://www.evilmadscientist.com/2012/alpha-clock-five-v2/ firmware 2.0], require a baud rate of 38400.) The upload speed can only be changed by rewriting the microcontroller's bootloader, with an AVR ISP programmer.  
+
Connect your FTDI interface (e.g., USB-TTL cable) to location J2 on the circuit board (the 6-pin SIL right-angle header also labeled "LOGIC-LEVEL (TTL) SERIAL"), watching the polarity. For one of the cables with rainbow-wires on the end, black goes down, green goes up.
  
−
If you happen to have an AVR ISP programmer, you are welcome to write a fresh bootloader to the Alpha Clock Five (once the environment above is set up), which will set the upload speed to the modern default of 115200 baud. Otherwise, you will need to modify the upload speed.  If you choose to do neither, programming will not work, and you will get an error. (Likely error: "avrdude: stk500_getsync(): not in sync: resp=0x00".)
+
Make sure that the correct serial port is selected in the Tools>Serial Port menu.
  
−
When you try to upload, you will get a message that indicates (in part) where the configuration files are stored. Something like:
+
Select "Sanguino W/ ATmega644P" from your Tools>Board menu
−
<code>System wide configuration file is "/Users/oskay/Library/Arduino15/packages/MightyCore/hardware/avr/2.0.3/avrdude.conf"</code>. (The exact location will depend upon your operating system and configuration.) Open the folder that contains that file on your computer, and locate the "boards.txt" file from within that same directory.  For example, one might be located at
 
  
−
<code>/Users/oskay/Library/Arduino15/packages/MightyCore/hardware/avr/2.0.3/boards.txt</code>
+
Make sure that Alpha Clock Five is powered on.
  
−
Open that boards.txt file with a text editor, and locate the <code>644.menu.clock.16MHz_external.upload.speed</code> parameter. Change it to read:
+
Click the "Upload" button in your Arduino window to upload a sketch.  
−
<code>644.menu.clock.16MHz_external.upload.speed=57600</code> 
 
  
−
Then, save the file and restart Arduino.
 
  
−
=== Uploading firmware ===
 
  
−
1. Connect your FTDI interface (e.g., USB-TTL cable) to location J2 on the circuit board (the 6-pin SIL right-angle header also labeled "LOGIC-LEVEL (TTL) SERIAL"), watching the polarity.  For the cables with rainbow-wires on the end, black goes down, green goes up.
+
=== Change in baud rate from firmware version 1.0 ===
 +
 
 +
The bootloader baud rate is the interface speed at which your computer talks to the Alpha Clock Five hardware when writing new firmware.  The baud rate supported by the Arduino/Sanguino development environment has changed since firmware version 1.0, as follows:
  
−
2. Make sure that the correct serial port is selected in the Tools>Serial Port menu. (Hint: you might need to install the FTDI USB drivers from here: http://www.ftdichip.com/Drivers/VCP.htm)
+
* Alpha Clock Five firmware version 1.0 is based on Sanguino version 0023r2, which has a default a bootloader speed of 38400 baud.
 +
* Alpha Clock Five firmware version 2.0 is based on Sanguino version 1.0.1, which has a default bootloader speed of 57600 baud.
  
−
3. Select "Sanguino W/ ATmega644P" from your Tools>Board menu
 
  
−
4. Make sure that Alpha Clock Five is powered on.
+
''Therefore,''
  
−
5. Open up the "sketch" file for the standard firmware.  You can find it in your menu under File > Examples > alphafive > AlphaClock.
+
* Alpha Clock Five kits that originally shipped with firmware version 1.0 need to be programmed at 38400 baud. 
 +
* Alpha Clock Five kits that originally shipped with firmware version 2.0 need to be programmed at 57600 baud.   
  
−
6. Then, click the "Upload" button in your Arduino window to upload the sketch. (If you get a "not in sync" error, check the note above about upload baud rate.)
 
  
 +
As this baud rate is programmed into the bootloader section of the microcontroller's firmware, it can only be changed by rewriting the microcontroller's bootloader, with an AVR ISP programmer.    So, to upgrade an Alpha Clock Five kit from firmware version 1.0 to version 2.0, you have two choices: Either (A) Reprogram the bootloader with an AVR-ISP programmer or (B) Modify the development environment so that it uses a bootloader speed of 38400 baud.  If you choose to do neither, programming will not work, and you will get an error. (Likely error: "avrdude: stk500_getsync(): not in sync: resp=0x00")
 +
  
−
There are additional example files included with the library to demonstrate simpler applications of the Alpha Clock Five library, as well as processing sketches that can send serial data to the Alpha Clock Five.  See [[Alpha_Clock_Serial_v2| Alpha Clock Serial]] for more information.
+
To modify the Arduino/Sanguino development environment to work at 38400 baud, you will need to locate and edit the "boards.txt" file within your Sanguino installation. This file is located ''inside the Sanguino folder'' that you installed earlier.  (If you cannot locate it, refer to the instructions above about where your Sanguino folder was installed.) In that file, locate the line that reads "atmega644.upload.speed=57600", change it to read "atmega644.upload.speed=34800", and save the file.  
  
  
Line 91: Line 109:
 
Most users will not need to reprogram the bootloader at any point.
 
Most users will not need to reprogram the bootloader at any point.
  
−
If you choose to do so, you will need an AVR ISP programmer, and can burn the bootloader from within Arduino by selecting your programmer type and using Tools>Burn Bootloader.
+
Programming the bootloader onto a new ATmega644A requires an AVR ISP programmer (see more about that below).  This can be done directly from within the Arduino environment (using the Tools>Burn bootloader option), but is complicated by the fact that we are using an ATmega644A rather than the ATmega644P normally expected by Sanguino.
 +
 
 +
First, download [http://evilmadscientist.s3.amazonaws.com/source/alphafive/boards.txt-644A.zip this alternate boards.txt file] (1 kB .zip file), which includes a definition of the 644A for purposes of using the bootloader.
 +
 
 +
Then, to install the bootloader:
 +
* Select as your board type (from Tools>Board), "Sanguino W/ ATmega644/644A"
 +
* From Tools>Burn Bootloader, select your AVR ISP programmer type, to actually burn the bootloader
 +
 
 +
After installing the bootloader, select board type "Sanguino W/ ATmega644P" when you wish to reprogram the board through the bootloader, as the "software" device signatures returned by the bootloader are those for the '644P.  If you reprogram the board through an ISP programmer (including reburning of the bootloader), you will still need to select ATmega644A as the device type.  
 +
 
  
  
Line 103: Line 130:
 
== AVR ISP Programming ==
 
== AVR ISP Programming ==
  
−
The Alpha Clock Five PCB features a 6-pin AVR ISP connector (J4), which can be used to program the microcontroller through any suitable AVR ISP programmer.  We recommend the Adafruit [http://shop.evilmadscientist.com/productsmenu/tinykitlist/106-usbtiny USBtinyISP] programmer for most purposes.  The Alpha Clock Five should be powered separately through its regular power supply while programming, not through the ISP programmer.
+
The Alpha Clock Five PCB features a 6-pin AVR ISP connector (J4), which can be used to program the microcontroller through any suitable AVR ISP programmer.  We recommend the Adafruit [http://evilmadscience.com/productsmenu/tinykitlist/106-usbtiny USBtinyISP] programmer for most purposes.  The Alpha Clock Five should be powered separately from 5 V while programming; Alpha Clock Five requires more power than can usually be safely provided by USB.
  
 
The circuit can be programmed through AVR-GCC or any other AVR software environment, including AVR Studio.  If using AVR-GCC, you may find it helpful to target (set the MCU type as) the ATmega644P rather than the ATmega644A, as it is better supported.
 
The circuit can be programmed through AVR-GCC or any other AVR software environment, including AVR Studio.  If using AVR-GCC, you may find it helpful to target (set the MCU type as) the ATmega644P rather than the ATmega644A, as it is better supported.
  
−
Please refer to the electrical schematics for pinouts and other hardware features of the Alpha Clock Five.
+
Please refer to the [http://evilmadscientist.s3.amazonaws.com/source/alphafive/fiveletter.pdf schematics] (PDF) for pinouts and electrical features of the Alpha Clock Five.   
 +
 
 +
 
 +
== Standard Firmware ==
 +
 
 +
 
 +
=== Version 1.0 ===
 +
 
 +
Version 1.0 of the Alpha Clock Five firmware is discussed [http://wiki.evilmadscience.com/Alpha_Clock_Firmware here].
 +
 
 +
 
 +
=== Version 2.0 ===
 +
 
 +
'''Currently under development.'''
 +
 
 +
 
 +
Besides the Arduino 1.01/Sanguino environment described earlier, this code requires that you install the "new" Time library, available [http://www.arduino.cc/playground/Code/Time here].  This should be installed like regular Arduino library, within the "libraries" directory of your sketch folder.
 +
 
 +
 
 +
=== Planned future versions ===
 +
 
 +
Planned future features include:
 +
* Additional display modes
 +
* Expanded serial communication, with additional commands
 +
 
 +
If you would like to suggest additional features, please use the [http://wiki.evilmadscience.com/Talk:Alpha_Clock_Firmware talk page] or the [http://www.evilmadscientist.com/forum/index.php?forum=15 Evil Mad Scientist Forums].
 +
 
 +
Code contributions and are welcome, of course, and we will be setting up a formal repository in the near future.  In the mean time, please [http://www.evilmadscientist.com/staticpages/index.php/contact contact Evil Mad Scientist Laboratories] if you are interested in contributing.

Please note that all contributions to Evil Mad Scientist Wiki are considered to be released under the GNU Free Documentation License 1.3 (see Evil Mad Scientist Wiki:Copyrights for details). If you do not want your writing to be edited mercilessly and redistributed at will, then do not submit it here.
You are also promising us that you wrote this yourself, or copied it from a public domain or similar free resource. Do not submit copyrighted work without permission!

To edit this page, please answer the question that appears below (more info):

Cancel | Editing help (opens in new window)
Retrieved from "https://wiki.evilmadscientist.com/Alpha_Clock_Firmware_v2"