AT89LP Developer Studio User Guide
Contents
1. SimpleLeds rel SimpleLeds rst SimpleLeds sym amp SimpleLeds dsm WA Files 5 2 View The I O View is one of the most valuable resources for debug sessions The I O View presents a com plete view of the Special Function Registers SFR displaying the state of the microcontroller An example of the I O View is seen in Figure 5 2 on the left hand side AT89LP Developer Studio User Guide 5 1 3711B MICRO 04 10 Views and Windows The values of the SFR registers can be inspected in the I O View to verify that the code executes as intended In the expanded Processor I O view the user can view the cycle accurate counter when simulating the device CYC LP is the number of cycles that have elapsed using the AT89LP single cycle core CYC C51 is the number of cycles that have elapsed using the classic 8051 6 12 cycle core This gives the user an easy way to see the performance gain of the AT89LP single cycle core versus a classic 8051 core An example of the cycle counter in the I O View is seen in Figure 5 2 on the right hand side Figure 5 2 The View Solution Value Addre g Register 0 7 m Processor csi B sP E E DPOH B DP iL B DP 1H E PAGE E AUXR MEMCON B sPx E pcr 00 00 00 0 01 00 0 02 00 0x03 00 0 04 00 0x05 00 06 00 0x2. AA ia 4 2 4D Coadino Me Wa 4 2 Taeng tne SI WW 4 3 4 7 Assemble the Program M 4 3 4 8 Entering Debug Session ccccccceseccceeeeceeeecceeseceesecseuseecsausecseeeeeeuseessaeeessaeseesaneeeseas 4 3 4 8 1 Inspect the Internal State of the 4 3 4 8 2 Issue Debug 4 3 4 8 3 Monitor the Target 4 3 Go SUNG BIGSKDOHIIS KA 4 3 4 8 5 Execute the Code and on 4 4 4S6 IPS AA 4 4 BOW EXCCUISHNE AAA 4 4 AT89LP Developer Studio User Guide i 37 11B MICRO 04 10 Table of Contents Continued li 3711B MICRO 04 10 4 8 8 Exit Debug 4 4 Section 5 FIC WCW E 5 1 Ie WO VIEW 5 1 So E E E M 5 2 54 Project Configuration 5 3 oo BUVI OW eee eee eee ee eee ee ee ee 5 3 0 0 IR AA 5 4 VAS VICE AAA 5 4 5 8 Static Memory VIEW E 5 5 S MEE
3. Ia 7 6 AT89LP Developer Studio User Guide Table of Contents Continued Section 8 Ol POR and IAA 8 1 92 Programming FUSCS IA 8 2 83 Programming Flash _ 8 3 8 4 Programming the 5 nennen eene enne nennen nnne nnn nnne nnns 8 3 Section 9 91 WRG VISION ASL RR RR m Umm 9 1 AMEL AT89LP Developer Studio User Guide ay O lii 3711B MICRO 04 10 Section 1 Introduction 1 1 About AT89LP Developer Studio Welcome to AT89LP Developer Studio from Atmel Corporation The AT89LP Developer Studio LP Studio is an Integrated Development Environment IDE for Atmel s innovative family of LP Low Power single cycle 8051 microcontrollers LP Studio is designed for Microsoft Windows 2000 Micro soft Windows XP Microsoft Windows Vista LP Studio IDE allows project management code entry text editing cycle accurate simulation In Circuit Emulation and On Chip Debug LP Studio allows for developing application code either in Assembly Code or C Programming languages The advanced cycle accurate LP Studio simulator enables designers to minimize the system frequency while still meeting the throughput requirements of the application This is especially beneficial for design ing low power battery operated systems LP Studio is a powerful development tool for LP applications It can be downloaded
4. My First Project LP File Bro Project Location wser C Documents Settingsstnakoensut Mvy Project Name name of the project is specified in the text field labeled Project Project Location The project location is specified by opening the file browser Project Wizard creates a subfolder to store the project files The subfolder name will be the same name as the project Project Template The project type is specified to be either Assembly or C Once the information has been entered click Next and go to page 3 to specify the target LP device for the project Figure 3 4 Selecting your target device in the LP Studio project wizard AT89LP Developer Studio AT89LP Developer Studio Device Device Library Highlights Enhanced Single Cycle 8057 Architecture Bytes of In System Programmable Flash Program Bytes of Flash Data Memory On chip 2 cycle Hardware Multiplier 16516 Multiply Accurlate LU rit 25685 Internal 409659 Internal Extra Dual Data Pointers 4 level Interrupt Pricrity Summary of features Load lt lt Back All the LP devices supported by LP Studio will be displayed on page 3 see Figure 3 4 As each device is clicked and highlighted a short summary of the device specification will display in the Features win dow at the right Select a target device and then clic
5. 00 RS 0 00 mow c addc a couNT 16 mow ACC H a R6 ES ajmp sqrthioo 220001 saqrtbi 01 I c clr Re amp Z x z a COUNT H Re a 4 0x00 a COUNT 1 R3 a 5 12 Breakpoints Breakpoints provide a powerful tool when debugging code A breakpoint tells the microcontroller to halt execution at a specified address in program memory This is useful for inspecting the state of the micro controller at a certain address in the code 5 12 1 Types of Breakpoints Atmel s LP microcontrollers offer 3 types of breakpoints Program Address Range and Data break points m Program address breakpoints m Range breakpoints m Data breakpoints Program Address Breakpoints break on a given address Range and Data breakpoints require a more detailed description see next AMEL 5 8 aay O AT89LP Developer Studio User Guide 3711B MICRO 04 10 Views and Windows 5 12 2 Range Breakpoints Range breakpoints are set using a base Program Address and an address mask value The microcontroller masks the supplied base Program Address with the mask value and breaks when ever the Program Address matches the masked base Program Address The masking operation is similar to the UART automatic address recognition mask m 1 in the mask base address Care bit m 0 in the mask base address Don t Care bit So for example if the base address in binary is 110
6. 00001040 FF 00001050 FF 00010 0 FF 0001070 FF 0001080 00001090 FF 0 FF ERER 5 9 Editor Window LP Studio implements a basic editor for code entry Its functionality is similar to NotePad in Windows 5 10 Calculator Window LP Studio has an interactive Calculator Tool which automatically generates the initialization values for the baud rate generator pulse width modulator and timeout calculator The Calculator window shows the three different types of peripheral calulators baud rate Figure 5 9 pulse width modulator Figure 5 10 and timeout Figure 5 11 The user inputs the requires criteria i e frequency clock divider duty cycle then clicks the Calculate button The calculator generates the cor rect initialization values for use in the source code AMEL AT89LP Developer Studio User Guide ay O 5 5 3711B MICRO 04 10 Views and Windows 5 6 Figure 5 9 Timer Calculators Input Device LP51 Frequency 11 059 MHz Clock Divider 1 Requested Baud Rate Max Baud 691187 500000 Min Baud 5 273342 Use Prescaler yo Prescaler 0 f 1 19200 The Baud Rate Calculator OxFFEE 19199 652778 0 001808 691187 500000 5 273342 0 0 19199 652778 0 001808 691187 500000 1349 975586 0 OxFFDC 19199 652778 0 001808 691187 500000 Note The Timer Prescaler TPS if available can increase the range of the timer based b
7. specify the project type as Assembly or C AT89LP Developer Studio User Guide 6 1 3711B MICRO 04 10 7 1 7 2 AT89LP Developer Menu Figure 7 1 AT89LP Developer Studio Menu File Edit Chip Debu Tools View Window File Menu Figure 7 2 Expanded File Menu in LP Studio Mew d Open d Close Save Save 5 Save Open Solution Close Solution print Print Preview Print Setup Recent Files Recent Projects Table 7 1 File Menu in LP Studio Section 7 Menus and Toolbars Name Description Create new text file or project Open existing text file or project Close the active file Save Save file current text file Save As Save file current text file as Save All Save all text files Open Solution Open project AT89LP Developer Studio User Guide 7 1 3711B MICRO 04 10 Menus and Toolbars Table 7 1 Expanded File Menu in LP Studio Name Description Close Solution Close project Print Print current text file Print Preview Preview current text file Print Setup Setup printer Recent Files Open text file from most recently used list Recent Projects Open project from most recently used list Exit Exit LP Studio 7 3 Edit Menu Figure 7 3 Expanded Edit Menu in LP Studio Select All Replace Table 7 2 Expanded Edit M
8. Development Board m POMO and POM are registers used to configure port PO Locate these registers in the tab of the Solution View m view R4 expand the nodes Register 0 7 m view ACC look under Processor node m view the port registers look under AT89LP6440 Port 0 4 8 2 Issue Debug commands With the device in debug mode and the registers available for inspection the next step is to issue debug commands Start by issuing Step Over commands and inspect the target registers after the execution of each instruction 4 8 3 Monitor the Target Registers We are especially interested in observing the values written to PO since this pattern is used to drive the LEDs on the Hardware Development Board 4 8 4 Setting Breakpoints The bit pattern in is written to the port PO the instruction at address 0 0014 AT89LP Developer Studio User Guide AIMEL 4 3 37 11B MICRO 04 10 Debugging Your First LP Application 4 8 5 4 8 6 4 8 7 4 8 8 4 4 Set a Program Address Breakpoint at this address Place the mouse cursor on this line in the dsm dis play and toggle a breakpoint by typing key F10 Execute the Code and Halt on Breakpoint Put the device in execution mode by typing key F5 The device runs to address 0x0014 and then halts at the breakpoint and returns to debug mode Single Step Issue a Step Over single step command over the next instruction and observe the value in R
9. H E MetDDE Lj Metsh D amp rzL5CL ComputeriHKEY LOCAL MACHIMETSOFTWAREtMicrosaFFIWET Framework SetupyNDP 2 2 2 Java Runtime Environment 2 2 3711B MICRO 04 10 Java Runtime Environment JRE must be installed on the computer in order to run the LP simulator plat form in LP Studio The minimum JRE version requirement is 1 6 0 To download the latest version of Java Runtime Environment go to hitp www java com en down load manual jsp To check the current version of JRE installed on the computer open the registry editor Start Run type regedit and press OK browse to the folder HKEY LOCAL MACHINENSOFTWAREMava Soft Java Runtime Environment and check if the version is 1 6 0 or later Upon startup LP Studio automatically runs a sequence of checks on the Java installation If LP Studio encounters any problems with the Java installation it will report error messages in the Project Configu ration tab of the Output View see section 3 2 2 There are two modes in LP Studio simulate and AMEL AT89LP Developer Studio User Guide Installation device debug mode If Java is improperly installed device debug mode will still be able to excecute but simulate mode will be disabled The Java Installation error messages are as follows 1 Unable to load Java Virtual Machine Simulate mode is now disabled LP Studio detected an old version of JRE Download the latest JRE version at http
10. WIRON IA 5 5 Calculator WIN IA 5 5 5 11 Disassembly 5 8 IA PEU Em 5 8 5121 AI III 5 8 5 12 2 eae ssennsetentioniancenetiew 5 9 51423 Data 5 9 SPI NB AA 5 9 5 12 5 Setting Breakpoints in the LP Studio User 5 9 5 126 Adding 2 5 10 5 12 7 Removing 5 10 5 12 8 Debugging with Breakpoints and Advanced Breakpoints 5 11 Section 6 ox NEN MBISHI NE COMI NU E 6 1 Section 7 7 1 AT89LP Developer ae cs sumi ba Unis munt cou cau 7 1 2 E 7 1 ONE IO 0 7 2 TA mm 7 9 FE EE AUR Emm 7 3 fs ume 9 AA AAA AAA AA AAA 7 4 VOW NGM cr c m 7 4 PO WANI WM ia AAA 7 5 Ia 7 5 710 Standard S Umm 7 6 PW t 7 6 6 1 emt 6 T13 Fow Control
11. multiple system files load device drivers and start a Java VM for the simulator If any one of these operations fails LP Studio gives notification by printing error messages in this window Figure 5 4 Project Configuration View s 4 b M Project configuration Build 5 5 Build View The Build View is where LP Studio logs output from the assembler and compiler The Build View is shown in Figure 5 5 The build tool reports possible errors and warnings in this window Figure 5 5 Build View Project configuration AT89LP Developer Studio User Guide ay O 5 3 3711B MICRO 04 10 Views and Windows 5 6 Debug View The Debug View is where LP Studio displays debug actions performed during debug The Debug View is shown in Figure 5 6 Debug actions are flow control commands such as Single step Break and Reset Breakpoint insertion and removal are also logged here Figure 5 6 Debug View 4 M roject configuration Build Debug 5 7 Watch List The view does not always provide the best solution for observing register values If the registers to be monitored are in different nodes of the register tree the user may have to constantly navigate the tree to view the values Monitoring a handful of registers can be tedious especially if it requires the expand ing and collapsing of tree nodes The Watch List simplifies the monitoring of regist
12. www java com en download manual jsp to resolve the problem 2 3 Contact Information Please report all problems or bugs to mcu 9 atmel com Please include the LP Studio version number a description of the problem and how it was triggered and a test case if possible For LP Studio help please call the microcontroller hotline at 408 487 2560 We also encourage the user to submit ideas for improving the LP Studio so we can enhance the user s overall experience when using the tool 37 11B MICRO 04 10 AT89LP Developer Studio User Guide Section 3 Getting To Know the AT89LP Devloper Studio IDE Experienced users of microcontrollers and Integrated Development Environments may skip this section LP Studio is an Integrated Development Environment IDE for developing applications targeting Atmel s innovative LP Low Power single cycle family of microcontrollers 3 1 General Information IDE environments provide source code editing build automation and debug support The goal of bun dling these elements together into one application is to increase developer productivity This makes the IDE a complex tool As a result there is a steep learning curve which must be followed in order for the developer to gain maximum benefit from the tool 3 2 Main Elements of LP Studio This section will familiarize the user with the main elements of LP Studio and the function that each ele ment provides Users familiar with IDEs for either comput
13. 0 1010 And the mask in binary is 1111 1000 Then the resulting breakpoint addresses in binary are 1100 1xxx same as the base address with the exception that any O bit in the mask becomes a Don t Care in the breakpoint address 5 12 3 Data Breakpoints A Data breakpoint is generated whenever the microcontroller accesses external memory with a MOVX instruction at the external address specified by the user The break condition can be specified for a read access write access or both 5 12 4 Link Breakpoints A Link breakpoint is managed on the Hardware Development Board external to the LP device in use The difference between Hardware and Link breakpoints is performance A Link breakpoint slows down execution when using Run debug commands This is due to the additional overhead by the Link as it takes control over the device and checks the address of every instruction executed to see if it matches the address of the Link breakpoints 5 12 5 Setting Breakpoints in the LP Studio User Interface For both Simulator and Device debug platforms Program Address breakpoints can be toggled on or off by pressing the Toggle Breakpoint button on the debug toolbar The shortcut key F9 can also be used to perform the same operation Advanced breakpoints are set enabled and disabled using the LP Studio Breakpoint Configuration manager Figure 5 13 shows the breakpoint configuration manager for the Device debug p
14. 07 ATSSLP 440 E gt ANALOG COMPARATOR amp Eder Interrupt 58 Port n 58 part 2 52 Port 3 52 Port 4 B Psw acc B DSPR B FIRD XOUOO OH File View 5 3 Info View 5 2 3711B MICRO 04 10 The Info View provides frequently accessed device specific information of the microcontroller targeted by the current project The Info View is shown in Figure 5 3 This includes a table of interrupt vectors pin configurations and a complete list of the Special Function Registers of the LP device AMEL AT89LP Developer Studio User Guide Views and Windows Figure 5 3 The Info View Interrupt vectors System Reset External Interrupt 0 Timer 0 Overflow External Interrupt 1 Timer 1 Overflow Serial Port Interrupt Timer 2 Interrupt Analog Comparator Inter General Purpose Interrupt Compare Capture Array I Serial Peripheral Interfac ADC Interrupt Two wire Interface Interr Package SFR Registers File View 5 5 4 Project Configuration View The Project Configuration View displays information regarding the loading of the project and its depen dencies The status of a successfully loaded project is shown in Figure 5 4 In order to open a project successfully LP Studio must parse
15. 4 being copied to PO Execute the Code Issue a Run command to put the device back into execution mode Observe once again that it returns to debug mode at the instruction where we inserted our breakpoint Repeat this a few times and observe the bit patterns in R4 and PO emulating a progress bar Exit Debug After convincing yourself that the program works exit the debug session by clicking the Stop Debug button in the debug toolbar AMEL AT89LP Developer Studio User Guide 3711B MICRO 04 10 Section 5 Views and Windows This section describes the views and windows that make up LP Studio They form an Integrated Devel opment Environment providing project management project development and microcontroller debug control 5 1 File View Contained in the File View are all the files that make up the project This includes Source Header and Output Files The File View is shown in Figure 5 1 Code is entered in either the asm or in the c source file depending on the project type Declaration of constants and array are entered in the header file h Assembler and compiler output files are placed under Output Files Figure 5 1 The File View ae x Workspace SimpleLeds ncp 1 project s 4 SimpleLeds ncp Files 344 Source Files SimpleLeds c Header Files SimpleLeds h Output Files SimpleLeds asm 2 SimpleLeds ihx 2 SimpleLeds Ist Eal SimpleLeds map
16. AT89LP Developer Studio User Guide 3711B MICRO 04 10 AMEL Table of Contents Section 1 1 1 About AT89LP Developer Studio w w mmmwmmmmanwanuwwamunannanunanunanunununa nanunua nawaza 1 1 Section 2 2 1 Installing AT89LP Developer Studio sese 2 1 2 1 1 System Requirements usc eere pax ER EY RE ra proc Enea Cw 2 1 2 1 2 Software Installation 1 seesseseseeesssesssseeeeeee 2 1 2 2 ISSUES and Special CONSICGELALIONS cccccsecccceececeeeeeeeecceeeeseueeceueeceueeesueeesaeeeseeeeseeesees 2 2 c EN 2 2 2 2 2 Java Runtime EnvirOnMe n cccccccccseccsececeeeceeeceeeeceeeseueceeeeseeeeeeeseeeseeesseeenes 2 2 2 9 aa AA AAA Ma 2 3 Section 3 31 General ISMANI ia IA AA aaa 3 1 3 2 Main Elements of LP Studio eeeeseessssesseseeeeeee nennen nennen nenne nnne rnnt nnns 3 1 IUE 3 2 WIG WY 3 2 WA 3 2 3 3 Launching LP Studio and using the Project namimi 3 3 3 3 1 Open Existing PIOIGGIS Aa 3 3 3 3 2 Creating New Projects TET 3 3 Section 4 MEME KI yaa Ya Yai IO ta VWAWA E AAA AA AA AAA 4 1 42 Se quie INS AA DOT Tm 4 1 i r 1 Rm 4 1
17. Device Buffer Table 7 4 Expanded Chip Menu in LP Studio Name Description Port Configuration Select port and configure hardware communication Fuse Configuration Configure device User Fuses Lock Protection Mode Configure Lock Bits Flash protection mode Signature Configure device User Signature Breakpoint Configuration Open the Breakpoint Configuration Manager Open Device Buffer Open static memory view 7 7 View Menu Figure 7 7 Expanded View Menu in LP Studio Toolbar Status Bar Table 7 5 Expanded View Menu in LP Studio Name Description Toolbar Show hide Toolbar Status Bar Show hide Status bar AMEL 7 4 aay O AT89LP Developer Studio User Guide 3711B MICRO 04 10 Menus and Toolbars 7 8 Window Menu Figure 7 8 Expanded Window Menu in LP Studio Window Cascade Tile Arrange Icons 1 ATSSLP6440 Code Buffer 64k x 8 FLASH Code 2 ATSSLP6440 Data Buffer Bk x 8 FLASH Data Table 7 6 Expanded Window Menu in LP Studio Name Description New Window New Window Cascade Cascade the open windows Title Tile the open windows Arrange Icons Arrange icons Select Select active window 7 9 Help Menu Figure 7 9 Expanded Help Menu in LP Studio ATS9LP Developer Studio User Manual ATESLF Instruction Set ATSSLP C5145M User Manual About Developer Studio Contact Table 7 7 Expanded Help Menu in LP Stu
18. Europe Le Krebs 8 Rue Jean Pierre Timbaud BP 309 78054 Saint Guentin en Yvelines France Tel 33 1 30 60 70 00 Fax 83 1 30 60 71 11 Technical Support mcu Q atmel com Atmel Japan 9F Tonetsu Shinkawa Bldg 1 24 8 Shinkawa Chuo ku Tokyo 104 0033 Japan Tel 81 3 3523 3551 Fax 81 3 3523 7581 Sales Contact www atmel com contacts Literature Requests www atmel com literature Disclaimer The information in this document is provided in connection with Atmel products No license express or implied by estoppel or otherwise to any intellectual property right is granted by this document or in connection with the sale of Atmel products EXCEPT AS SET FORTH IN ATMEL S TERMS AND CONDI TIONS OF SALE LOCATED ON ATMELS WEB SITE ATMEL ASSUMES NO LIABILITY WHATSOEVER AND DISCLAIMS ANY EXPRESS IMPLIED OR STATUTORY WARRANTY RELATING TO ITS PRODUCTS INCLUDING BUT NOT LIMITED TO THE IMPLIED WARRANTY OF MERCHANTABILITY FITNESS FOR A PARTICULAR PURPOSE OR NON INFRINGEMENT IN NO EVENT SHALL ATMEL BE LIABLE FOR ANY DIRECT INDIRECT CONSEQUENTIAL PUNITIVE SPECIAL OR INCIDEN TAL DAMAGES INCLUDING WITHOUT LIMITATION DAMAGES FOR LOSS OF PROFITS BUSINESS INTERRUPTION OR LOSS OF INFORMATION ARISING OUT OF THE USE OR INABILITY TO USE THIS DOCUMENT EVEN IF ATMEL HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES Atmel makes no representations or warranties with respect to the accuracy or completeness of the content
19. T89LP Developer Studio User Guide 2 1 3711B MICRO 04 10 Installation 2 2 Issues and Special Considerations 2 2 1 NET Microsoft Net Framework must be installed on the computer in order to successfully install LP Studio The minimum requirement is version 2 0 The easiest way to check the version of the Net Framework installed on the computer is to query the User Agent String of Internet Explorer web browser Copy and paste javascript alert navigator user Agent into the address field of IE A message box similar to the one shown in Figure 2 1 will appear showing the NET version Figure 2 1 Checking the version of Microsoft Net Framework in IE Windows Internet Explorer PN Mazilla 4 0 compatible MSIE 7 0 Windows NT 5 1 CLR 1 1 4322 CLR 2 0 50727 CLR 3 0 04506 30 InFaPath 1 MET CLR 3 0 04506 548 MS RTC LM 8 Another way to check the version of the Net Framework installed on your computer is to open the regis try editor Start Run type regedit and press OK browse to the folder HKEY LOCAL MACHINENSOFTWAREMIicrosoftNET Framework Setup NDP and see if the version of the installed Net Framework is 2 0 or later The display should be similar to the one shown in Figure 2 2 Figure 2 2 Checking the version of Microsoft Net Framework in the registry editor Registry Editor Edit View Favorites Help ay 1 1 43272 Gi v2 0 50727 v3 0
20. aud rate generation However TPS may affect other parts of the system in addition to the selected timer r Input Device LP51 Frequency 12 000 x Clock Divider seat ST Duty Use Prescaler 0 1 46875 000000 183 105469 0 46875 000000 17 187500 0x0080 50 000000 0 000000 6000000 000000 23437 500000 0x006A 0 40000 000000 0 000000 0 006 0 006 50 000000 0 000000 46875 000000 46875 000000 Note The Timer Prescaler TPS if available can increase the range of the PWM However TPS may affect other parts of the system in addition to the selected timer Note Timer 0 1 Mode 2 or Timer 2 Clock Out will generate a 5096 duty cycle at the specified reload value Use the specified duty cycle pair as alternating reload values to define the high low portions of the output to achieve the requested duty cyde at the specified frequency AT89LP Developer Studio User Guide 3711B MICRO 04 10 Figure 5 11 The Timeout Calculator Timer Calculators Input Device LP51 Frequency 12 000 vez ae lj fes El Long Timeout Equaly sized periods Use Prescaler No gt Prescaler 0 f 1 M Note Two methods are supported for timeouts longer than the maximum period of a single timeout In Equally sized periods the same reload value is used for all of the specified overflows In Full periods remain
21. der the final overflow uses the specified reload but the previous overflows should use the full time period generally reload 0 For modes without automatic reload Timer 0 1 Modes 0 and 3 the actual timeout will vary depending on how fast the overflow is 682 666667 us 83 333333 ns 0x4410 2 0 1 000000 ms 0 000005 5 461333 ms 83 333333 5 OxD 120 1 0 1 000000 ms 0 000005 21 333333 us 83 333333 ns 0 0001 47 0 998 750000 us Note The Timer Prescaler TPS if available can increase the range of the timeout detected and the timer can be serviced The count may need to be reduced slightly to account for this extra latency AMEL AT89LP Developer Studio User Guide ET O Views and Windows 5 7 37118 04 10 Views and Windows 5 11 Disassembly View Derived from the Editor Window the Disassembly View is where code is debugged The Disassembly View is shown in Figure 5 12 As the name implies this view displays the disassembled dsm file show ing the instructions that make up the program and the addresses of each instruction LP Studio paints the line of the next instruction to be executed in yellow Figure 5 12 The Disassembly View 64405 guares dsm E4405 quares asm mow a COUNT addc 0 0x9C mow COUNT 220000 0008 220000 R5 c R7 xF RZ 0 01 a COUNT 1 0 00 Acc L a R4 0
22. dio Name Description AT89LP Developer Studio LP Studio s user manual is here User Manual AT89 Instruction Set Instruction set is displayed here AT89 C51ASM User Manual C51ASM user manual is here About AT89LP Developer Displays the About dialog about LP Studio Studo Version information is displayed here Contact Us Displays the Contact Information AMEL AT89LP Developer Studio User Guide ay O 7 5 3711B MICRO 04 10 Menus and Toolbars 7 10 Standard Toolbar Figure 7 10 Standard Toolbar in LP Studio SS RRR RR AA AA AA 7 11 Edit Toolbar Figure 7 11 Standard Edit in LP Studio wa wa da aa la aa la uaa alaala ala alaala aa ual noua l 7 12 Debug Toolbar Figure 7 12 Debug Toolbar in LP Studio dE DES Simulate P 7 13 Flow Control Toolbar Figure 7 13 Flow Control Toolbar in LP Studio ma am ma mm mn m m a 7 6 3711B MICRO 04 10 AMEL AT89LP Developer Studio User Guide Section 8 Programming Dialogs 8 1 Port and Link Configuration Before starting a debug session on a device connect the PC to the AT89LP OCD Board using a serial port If the PC does not have a serial port then a USB to serial adapter is needed Setup and configure the PC to hardware connection in the LP Studio using Configure Chip Communica tion dialog In t
23. e Breakpoints can be configured to halt the microcon troller prior to execution of specific instructions This allows the microcontroller to be placed into Debug Mode from Execution Mode at any desired place in the code There are two types of Breakpoints 1 Program Address breakpoints are simple breakpoints that halt execution at a specified address 2 Advanced breakpoints halt execution for a range of addresses as well as for data See section Views and Windows for more details on Advanced Breakpoints AT89LP Developer Studio User Guide 4 1 3711B MICRO 04 10 Debugging Your First LP Application 44 Debug Example With a basic understanding of flow control and program address breakpoint we are ready to debug a program The program will use the ProgressBar program located at My Documents MAT89LP Developer Stu dio ProgressBar This program performs left shifts on a byte value and inserts 1 s in the vacated bit position It emulates the look of a Windows progress bar Before proceeding please familiarize yourself with the source code in order to understand how the program is intended to work 4 5 Loading the Project 4 2 3711B MICRO 04 10 4 Launch LP Studio Page 1 of the Project Wizard will appear Search the MRU list for ProjectBar If it exists left click to highlight the file Next click the Load but ton at the bottom of the wizard to open the project If ProgressBar is not listed in th
24. e MRU list open the folder browser and navigate to the directory ProgressBar in your LP Studio default directory Click to highlight the file named ProgressBar ncp and press Open in the folder browser The file path to ProgressBar ncp will display in the Project Wizard Next click the Load button at the bottom of the wizard to open the project The LP Studio IDE will look like Figure 4 1 Figure 4 1 Debugging the LP application ATB9LP Developer Studio BinarySearch c File Edit Chip Debug View Window Help 18 x 0 MES ERE EN ci zi AT8SLPB440 Code Buffer 5 Buffer Bk x 8 FLASH Data BinarySearch h BinarySearch c include lt BinarySearch h gt include lt At89LP6440 h gt include lt stdlib h gt include lt time h gt Workspace BinarySearch ncp 1 project s BinarySearch ncp Files 3 Source Files BinarySearch c 3 Header Files BinarySearch h 1 43 Output Files void main void short nSize rray 0 while nSize rray lt max size array short nNumber GetRandomNumber 1 short nLocation SearchinNumber nSizeirray 4 BinarySearch sym BinarySearch dsm if nLocation lt 0 short ninsertat nLocation 1 nSizeirray Insert nNumber niInsertat nSize irray 77 returns random 16 bit signed integer short GetRandomNumber short nRandonN
25. ed to open existing LP Studio projects or to create new projects The wizard displays automatically whenever LP Studio launches Project Wizard is comprised of three pages The first page is used to open existing projects The sec ond and third pages are used to create new projects 3 3 1 Open Existing Projects To open an existing project on the first page of the Project Wizard choose an existing project from the list of Recent Projects MRU or alternately navigate to an existing project using the File Browser see Figure 3 2 Select the project and then click the Load button Figure 3 2 Opening a project using the LP Studio Project Wizard 3 AT89LP Developer Studio Open Project f RjBmaySeach NN SimpleL eds ProgressBar JAN First ASM file MRU List Open File Browser 3 3 2 Creating New Projects To create a new project click the button labeled Next on the first page of the Project Wizard and ceed to the second page On the second page specify the name of the project the folder in which to create the project and the type of project to be created see Figure 3 3 AT89LP Developer Studio User Guide AIMEL 3 3 3711B MICRO 04 10 Getting To Know the AT89LP Devloper Studio IDE 3 4 3711B MICRO 04 10 Figure 3 3 Creating a new project in the LP Studio project wizard AT89LP Developer Studio Enter and Location of the Project Project M ame
26. enu in LP Studio Name Description Undo last editor action Cut Cut and copy selected text from editor Copy Copy selected text from editor Paste Paste text from clipboard to the editor Select All Select all text from editor Find Open a dialog to search through the current file Find Next Jump to next search item specified in Find Replace Open a dialog to replace text in the current file AMEL 7 2 aay O AT89LP Developer Studio User Guide 3711B MICRO 04 10 7 4 Debug Menu Menus and Toolbars Figure 7 4 gt Expanded Debug Menu in LP Studio B Stop Debug Reset Step Over dh Toggle Breakpoint Ctrl 5hift F5 Shift F5 Fi0 F9 Table 7 3 Expanded Debug Menu in LP Studio Name Description Build Solution Assemble or compile project Clean Solution Delete output files from project Start Debug Start a new debug session Stop Debug End the current debug session Run the target Halt target in run mode Step Over Reset and Break the target on first instruction Step over current instruction Single step Toggle Breakpoint 7 5 Tools Menu Toggle Program Address breakpoint Figure 7 5 Expanded Tool Menu in LP Studio Calculators AT89LP Developer Studio User Guide AMEL 7 3 37118 04 10 Menus and Toolbars 7 6 Chip Menu Figure 7 6 Expanded Chip Menu in LP Studio Port Configuration Open
27. er or microcontroller applications will recognize many of the elements in the user interface Even though LP Studio offers complex chip configuration options once the basic elements of the front end user interface are learned it is easy to begin running basic simulations and debugging the code Figure 3 1 Basic components in the LP Studio User Interface AT89LP Developer Studio User Guide 3 1 3711B MICRO 04 10 Getting To Know the AT89LP Devloper Studio IDE AT89LP Developer Studio SimpleLeds dsm 0000 02 00 08 LJMP 0 0008 LCALL 000c SJMP 0 0006 75 81 Ob MOV Ox81 0 000e e5 82 MON A 0x82 0010 60 03 220000 0012 02 00 03 LJMP 0x0003 0015 79 00 220000 MOV R1 0 00 0017 e9 MOV A R1 7 Solution View 001a 60 1b JZ 220003 001 7a 00 MOV R2 0 00 001e 90 00 a4 MOV 0x00A4 0021 78 00 MOV RO 0x00 0023 75 0 00 MOV OxAO 0 00 0026 e4 220001 0027 93 MOVC A DPTR The WatchList 0028 2 MOVX GRO A aa 5505 The main LP Studio elements are identified in Figure 3 1 Left is The Solution View bottom left is The Output View and bottom right is The Watch List 3 2 1 Solution View The Solution View contains three tabbed windows m File View Contains a list of all the source files that make up the project m IO View shown Contains a list of all the registers of the specific LP microcontroller targeted by the d
28. ers by allowing the user to add frequently monitored registers to the Watch List display see Figure 5 7 Figure 5 7 The Watch List r Data 0 00 50 81 0x81 IData 0x80 0x0 Add Watch IData 0x81 0 81 Delete Watch FData 0x1000 0 1000 patafox1000 01000 w Hexadecimal Display a wa 11 In addition unlike the View the Watch List provides read and write access to the registers This gives the user full control of the state of the chip Registers can be arranged in any order in the Watch List Another benefit of the Watch List is that memory locations can also be observed in addition to the SFR registers The two ways to add entries to the Watch List are by name or by array Memory locations general pur pose registers and Special Function Registers can be added by name Memory locations can also be added array style with the name of the memory and its address in brackets AMEL 5 4 aay O AT89LP Developer Studio User Guide 3711B MICRO 04 10 Views and Windows 5 8 Static Memory View The Static Memory View provides a view of the microcontroller s code and data memory The Static Memory View is shown in Figure 5 8 This is a static view and reflects the state of the memories right after the part has been programmed Figure 5 8 Static Memory View EP ATB9LP6440 Code Buffer 64k x FLASH Code 00001000 FF 00001010 FF 00001020 FF 00001030 FF
29. esign m Info View Contains useful information needed often about the targeted microcontroller 3 2 2 Output View The Output View contains three tabbed windows m Project Configuration View provides information about the project and the debug environment The window shows the status of device drivers and the simulator m Build View shown shows the build status of the project It displays source code warnings and errors when the code is assembled or compiled It also reports the amount of LP target device memory occupied by the application once the source code builds without error m Debug View records the debug actions performed on the target For example Run Reset and Step actions are logged in this window 3 2 3 Watch List The Watch List provides functionality similar to the View Registers and memory locations can be added to the Watch List and monitored This eliminates the need to constantly navigate through the IO View to check the status of registers and memory locations of particular interest AMEL 3 2 EEEF O AT89LP Developer Studio User Guide 3711B MICRO 04 10 Getting To Know the AT89LP Devloper Studio IDE The Watch List also provides the additional capability of allowing write access to registers and memo ries in the list This allows full control over the state of the microcontroller 3 3 Launching LP Studio and using the Project Wizard The Project Wizard is us
30. for free by visiting Atmel s website at www atmel com Thank you for choosing Atmel AT89LP AT89LP Developer Studio User Guide 1 1 3711B MICRO 04 10 Section 2 Installation AT89LP Developer Studio supports all LP devices m AT89LP213 214 216 m AI89LP428 828 m AT89LP6440 2 1 Installing AT89LP Developer Studio 2 1 1 System Requirements The minimum hardware and software requirements are 486 processor Pentium is recommended m 16MB RAM m 12 free hard disk space m Windows 2000 XP Vista m Administrator privileges in your account m 115200 Baud RS 232 port COM port m 9 15V power supply 500 mA minimum Java Runtime Environment JRE version 1 6 0 or later Microsoft Net Framework version 2 0 or later 2 1 2 Software Installation Download LP Studio from the Atmel website at www atmel com Start the installation process by double clicking on the installation file AT89LP Developer Studio msi The installation process will query a target folder The default location for the folder is C Program Files Atmel AT89LP Developer Studio It is recommended to use the default location The installation procedure will create an application shortcut on the Desktop and also under the Start menu in Programs gt Atmel gt AT89LP Developer Studio The LP Studio installer will create a default project folder under My Documents AT89LP Developer Stu dioV with a set of sample projects A
31. his dialog specify and configure the serial port being used to connect to the hardware board It is recommended that new users of LP Studio keep the default port and link configuration values The Port Select window is shown in Figure 8 1 Figure 8 1 Selecting serial port for chip communication Configure Chip Communication Select Fort Port Select Link Configuration Select Select the serial port and baud rate for the speed of the serial port transmission To connect to a serial port click and highlight the port to be used and press Select The default baud rate is 9600 It is recommended for new users to use the default baud rate Figure 8 1 shows the selected serial port named COM1 The Link Configuration window is shown in Figure 8 2 Advanced users may want to specify the baud rate at which the link transmits data between the chip and the PC This is done in the Link Configuration window by adjusting the parameters Target Frequency and Maximum Clock Divide to obtain the desired link baud rate AT89LP Developer Studio User Guide 8 1 3711B MICRO 04 10 Programming Dialogs Figure 8 2 Specifying link baud rate Configure Chip Communication Port Configuration mm Port Select Target Freguency EZ Link Configuration Maximum Clock Divide Link Baud Value 8 2 Programming Fuses The Fuse Bits window allows configuration of the fuses on the LP device In th
32. how the device ID for AT89LP6440 namely Ox1E 0x64 OxFF AMEL AT89LP Developer Studio User Guide ay O 8 3 3711B MICRO 04 10 Programming Dialogs Figure 8 5 Signature Window Configure Chip zi Target Signature Fuse Bits Lock Bits Signature User Signature i i i i i i i i i i i i i Atmel Signature AMEL 8 4 ET O AT89LP Developer Studio User Guide 3711B MICRO 04 10 9 1 Revision History Revision No Section 9 Revision History History Revision A Aug 2009 Initial Preliminary Release Revision April 2010 AT89LP Developer Studio User Guide Remove 2 2 2 jvm dll installation description page 2 2 Added Processor I O view Figure 5 2 on page 5 2 Added baud rate caluculator view Figure 5 9 on page 5 6 Added pulse width modulation calculator view Figure 5 10 on page 5 6 Added timeout calculator view Figure 5 11 on page 5 7 Added Tools to menu toolbar Figure 7 1 on page 7 1 Added Calculator view Figure 7 5 on page 7 3 9 1 3711B MICRO 04 10 AMEL T Headquarters Atmel Corporation 2325 Orchard Parkway San Jose CA 95131 USA Tel 1 408 441 0311 Fax 1 408 487 2600 International Atmel Asia Unit 1 5 amp 16 19 F BEA Tower Millennium City 5 418 Kwun Tong Road Kwun Tong Kowloon Hong Kong Tel 852 2245 6100 Fax 852 2722 1369 Product Contact Web Site www atmel com Atmel
33. is window the fuses on the LP microcontroller can be read and written The Fuse Bits window is shown in Figure 8 3 Figure 8 3 Fuse Bit window Configure Chip Bleee ee al Clock Source Internal RC Oscillator IRC Start up Time Reset Pin Enable RST pin functions as reset 7 Brown out Detector Enable Brown aut Detector Enabled On chip Debug Enable ISP Enable In System Programming Disabled Enabled at PO User Signature Programming Programming of User Signature Disabled r Tristate Ports Interface Select In Application Programming In amp pplication Programming Disabled Extra 115 puse qucd Cancel Available fuse settings are presented in drop down lists Be careful when writing the fuses as some figurations options may prevent LP Studio from further communication with the device A warning is given if the selected fuse setting may leave the LP device in an unintended state It is strongly recom mended to refer to the data sheet before configuring fuses AMEL 8 2 ET O AT89LP Developer Studio User Guide 3711B MICRO 04 10 Programming Dialogs 8 3 Programming Flash Security Lock The Lock Bits window shown in Figure 8 4 sets the lock bits for the targeted LP microcontroller Figure 8 4 Lock Bits Window Configure Chip Lock Bits Fuse Bits Lock Bit Protection Made No Program Lock Features EGGS BIR Write a
34. k the Load button The Project Wizard will close and your new LP Studio project will open AMEL AT89LP Developer Studio User Guide Section 4 Debugging Your First LP Application This section demonstrates the debug features available in LP Studio The debug controls are Run Break Step Over and Reset In addition Breakpoints can be specified With these the LP Studio environment allows full program flow control during a debug session These capabilities will be demonstrated by debugging one of the sample programs that comes with LP Studio 4 1 Terminology Execution mode and Debug mode are the terms describing the state of the microcontroller m Execution Mode The state of the microcontroller when it is running freely and executing instructions without interruption m Debug Mode The state of the microcontroller when it is halted and instruction flow is controlled by debug commands 4 2 Control Signals m Run places the microcontroller into Execution Mode m Break places the microcontroller into Debug Mode and is the only command available when the microcontroller is in Execution Mode m Step Over In Debug Mode allows the microcontroller to execute the next instruction and then halt single step m Reset resets the application and halts the microcontroller at the first instruction of the instruction code 4 3 Breakpoints Breakpoints are powerful tools for debugging cod
35. latform AMEL AT89LP Developer Studio User Guide ay O 5 9 3711B MICRO 04 10 Views and Windows Figure 5 13 Breakpoint manager for the Device debug platform Breakpoint Manager 0 0026 Program Address 0 0022 Program Address Mask 0 0015 0 0015 Program Address Mask 0 0011 0 0011 Program Address Configure Breakpoint Select target Select type Address Use mask Hardware Program Address ink BBA r OK Cancel 5 12 6 Adding Breakpoints 1 Enter Debug mode by clicking Debug gt Start Debug 2 Open the Breakpoint Configuration Manager by clicking Chip gt Breakpoint Configuration 3 Select the target for the breakpoint chip or link Note Not recommended to use breakpoints on link 4 Select the breakpoint type Program Address Range or Data 5 Specify the Program Address of the breakpoint and if desired configure it as a Range breakpoint by providing the mask value 6 Enable and disable breakpoints by clicking the respective checkboxes on the left of the breakpoint 5 12 7 Removing Breakpoints 1 In the Breakpoint Configuration Manger left click and highlight the Breakpoint number 2 Click the Remove Button The Breakpoint Configuration Manager is shown in Figure 5 14 AMEL 5 10 aay O AT89LP Developer Studio User Guide 3711B MICRO 04 10 Views and Windows Figure 5 14 Breakpoint manager for the simulator debug platf
36. nd Read af Flash is disabled is disabled signature Further programming of the Flash is disabled Mo Program Lock Features Cancel Configuring the Lock Bits sets the protection mode for Code and Data flash memories They determine the memory Write and Read access privileges For example with the current setting in Figure 8 4 the device has no lock features enabled Write and Read access can be disabled Please note that setting a Lock on the device will prevent LP Studio from further communication with the device A warning will be displayed if an attempt is made to set a Lock on the device 8 4 Programming the Signature All LP microcontrollers have User Signature and Atmel Signature memory features The User Signature is programmable flash memory that can be used by the user to store serial numbers revision information date codes or other user parameters lt also contains analog configuration data for the device The analog configuration values occupy the second half of the User Signature space Care should be taken so that these values are not modified when writing the first half of the User Signa ture space The Atmel Signature contains the device ID of the targeted LP microcontroller It also contains a copy of the analog configuration values found in the second half of the User Signature The AT89LP6440 Signature window is shown in Figure 8 5 The first three bytes of the Atmel signature s
37. orm Breakpoint Manager D Ox000d Program Address 0 0017 Program Address 0 0019 Program Address 0 0024 Program Address 0 0028 Program Address Select type Address Program Address 27 OK Cancel 5 12 8 Debugging with Breakpoints and Advanced Breakpoints When debugging in LP Studio the type of breakpoints available depends on the debug platform and the target device The debug platform is either the Simulator or the actual Device on the Hardware Development Board When debugging on the Simulator there are different restrictions on the number of breakpoints that can be set The Simulator allows an unlimited number of Program Address breakpoints However Range and Data breakpoints are not available Program Address Range and Data breakpoints can all be used when debugging on the Device The number of breakpoints available on the Device depends on the targeted LP microcontroller Some LP microcontrollers implement 4 Program Address breakpoints others offer 4 additional Advanced breakpoints Advanced breakpoints can be configured as Program Address Range or Data breakpoints Additionally up to 128 Program Address breakpoints can be configured on the link AMEL AT89LP Developer Studio User Guide ay O 5 11 3711B MICRO 04 10 Section 6 Build Tools in AT89LP Developer Studio 6 1 Assembler and Compiler LP Studio comes with Atmel s C51ASM assembler and SDCC C compiler When creating a new project
38. s of this document and reserves the right to make changes to specifications and product descriptions at any time without notice Atmel does not make any commitment to update the information contained herein Unless specifically provided otherwise Atmel products are not suitable for and shall not be used in automotive applications Atmel s products are not intended authorized or warranted for use as components in applications intended to support or sustain life 2010 Atmel Corporation All rights reserved Atmel Atmel logo and combinations thereof and others are registered trademarks or trade marks of Atmel Corporation or its subsidiaries Windows and others are registered trademarks or trademakrs of Microsoft Corporation in U S and or other countries Other terms and product names may be trademarks of others 3711B MICRO 04 10 xM
39. umber 0 IO Register View lt nRandonNumber rand Li Ready in 2 Col 6 OVR 2 NNA AAS AEAEE AMEL AT89LP Developer Studio User Guide Debugging Your First LP Application 4 6 Targeting the Simulator In this demo we target the simulator instead of the chip Select Simulate in the debug toolbar circled in Figure 4 1 4 7 Assemble the Program Assemble the program by clicking the Build button on the left of the Debug toolbar Next view the Build tab in the Output View to see whether or not the build succeeded along with any errors and warnings The build should be successful for the unmodified version of ProgramBar provided by LP Studio 4 8 Entering Debug Session To start the debug session click the Start Debug button in the Debug toolbar LP Studio displays the debug window containing the disassembled file dsm It then places the target into debug mode and halts on the very first instruction of the program indicated by the yellow marker in the disassembled file window display 4 8 1 Inspect the Internal State of the Microcontroller Inspect the internal state of the microcontroller by observing the values of the device registers used by the program accumulator ACC or A general purposes register R4 and port registers PO POMO POM1 m Register R4 is used to store the shift pattern m PO is a copy of R4 and is used to output the shift pattern for driving the LEDs on the Hardware
Download Pdf Manuals
Related Search