Ceibo EC++ for 8051 Microcontrollers (Demo) - Installation Notes
=========================================================
1. To work correctly Ceibo EC++ needs Keil uVision2 (evaluation kit).
Download the evaluation version from http://www.keil.com/demo/evaldl.asp?p=C51
Then activate it to setup Keil uVision2. The default installation folder is "C:\KEIL". 

2. Run "ECPP51.EXE" to setup Ceibo EC++. The default installation folder is "C:\CEIBOC++".

3. Run Ceibo EC++ either using the shortcut on your desktop or through Start->Programs->Ceibo EC++.
Open project. Try one of the sample projects located in the folder "Examples".
Since there is a 2K code size limitation for the source files, the only sample projects which can be built are "Overloading", "DynAlloc" and "ASM".



Debuggers and Simulators 
========================
You can run the demo files with a simulator or debugger.Among the possibilities: use Keil uVision2 or Ceibo Free Debugger/Simulator. 
The output files have OMF format, so they are also accepted by most of the
available software tools and emulators. 



Using Keil uVision2 Demo Version as an IDE/Debugger for Ceibo EC++
==================================================================
1. Activate Keil uVision2. Open one of the sample projects located in the folder %KEIL%\C51\EXAMPLES\ECPP.
%KEIL% is an installation folder of Keil uVision2 (by default it is C:\KEIL). 
Try first with the project "DynAlloc".

2. Build a sample project you have opened.

3. Select Debug->Start Debug Session.



To build your own C++ project from within Keil uVision2 follow these steps:
===========================================================================
1. Select Project->New Project from the main menu.
In the dialog "Select Device for Target" mark the checkbox "Use Extended Linker (LX51) instead of BL51" and
choose some device for your target.

2. Enter Project->File Extensions, Books and Environment->File Extensions. 
The textbox "C Source File" should contain the value  *.c;*.cpp (by default it contains only *.c).

3. Add the non-existing file "project_lnk.obj" to your project. It will be generated further during the compilation stage.
   If your target file is not an absolute but a library, add the non-existing file LIBRARYNAME_lnk.obj instead of the
   "project_lnk.obj". LIBRARYNAME is your real library name.
   
4. Add any amount of C++, C and assembly files to your project. Each C++ file should have the extension ".cpp".

5. If you are going to use any standard include file(s) from one or more of your source C++ files:
   Enter Project->File Extensions, Books and Environment->Environment Setup. In the opened dialog unmark the checkbox 
   "Use Settings from TOOLS.INI". In the textbox "INC Folder" choose the folder %CEIBOC++%\INC.

6. If you have included any standard C++ library to your project:
   Enter Project->File Extensions, Books and Environment->Environment Setup. In the opened dialog unmark the checkbox 
   "Use Settings from TOOLS.INI". In the textbox "LIB Folder" choose the folder %KEIL%\C51\LIB\ECPP.
   These libraries are designated for the linker LX51, while the libraries located in %CEIBOC++%\LIB should be used 
   by the linker BL51.   
   
7. Save the project.

8. Build the project and start a debug session.



Using Ceibo Free Debugger/Simulator
===================================
1. Download the file "simulator.exe" using the link http://www.ceibo.com/ftp-site/update/Simulator.exe

2. Invoke the file "simulator.exe" to install Ceibo Debugger/Simulator.

3. Run Ceibo Free Debugger/Simulator.

4. Invoke the debugger and from File, Load, download either "Overloading" or "DynAlloc".

5. Now you are ready to add watches with C++ variables, source level debug, etc.



Ceibo EC++ Troubleshooting
==========================
1. If you persistently get the warning "THE SIGNATURE OF 'C51.EXE' IS MISSING OR INVALID." 
while working with the IDE or the error "INVALID C51 COMPILER." while working with the 
command-line version, do the following:

1.1 Enter the registry editor("regedit.exe").

1.2 Make sure the variable "Path" located in HKEY_CURRENT_USER\Software\Keil\礦ision2 
contains the correct path to the folder where Keil uVision2 was installed. 
If it does not, specify the correct path.

1.3 The file "c51_err.log" should be generated in the root directory (by default it is "C:\CEIBOC++").
Open it. You can find there one of the following error descriptions:

A. Keil uVision2 either is not installed or badly installed on your PC.
Solution: Download the evaluation version of Keil uVision2 from http://www.keil.com/demo/evaldl.asp?p=C51 
Then install it.	 

B. Information about 'c51.exe' could not be obtained. This file either does not exist or corrupted.
Solution: Make sure the file "C51.EXE" is present in the directory "Keil\C51\BIN". If it does not, 
reinstall the evaluation version.

C. The specified 'c51.exe' could not be used by Ceibo EC++. Make sure you have Keil uVision2 evaluation whose version is 6.22 or later.
Solution: try the solution of A.

D. Reading of 'c51.exe' failed due to unknown reason.
Solution: try the solution of A or B.

2. If you see that Keil uVision2 treats C++ files as C files, it means you have installed it 
after the installation of Ceibo EC++. In this case you should reinstall Ceibo EC++.

Thank you for using this demo software. If you have any questions or comments, please send your message to support@ceibo.com.