Great Cow Basic Development Environment Quick Start Guide
To help our customers who are new to the PIC microcontroller, or programming in general, and need a quick and way to get started we have created this thread which describes how to install and use the excellent Great Cow Basic programming language and the development environment. Great Cow BASIC is an open-source BASIC compiler released under the Creative Commons Attribution-NonCommercial-ShareAlike 3.0 License and is freely available for download. It provides one of the easiest ways to develop code for the 8 Bit Microchip PIC microcontrollers. We have tailored this quick start guide towards installing the software and using it with our development board and programmers.Disclaimer: We are not affiliated with this project any any reports of bugs or other issues with this software should not be directed to Hobby Components. Use of this software is at your own risk and we cannot accept any responsibility for loss or damaged caused by its use.Installation:
First of all you will need to download the the software or development environment to allow you to create your own programs. The downloads section for the main project homepage can be found on sourceforge here:http://gcbasic.sourceforge.net/download.html
For this guide we recommend downloading the GCB@Syn development environment created and maintained by Frank Steinberg here:http://sourceforge.net/projects/gcbasic ... p/download
This will download a zip file to your computer. Once downloaded, unzip the folder and copy it to a convenient place on your computer. For this guide we will assume this is to the top level of your C: drive.
Do not copy the folder to your windows program files folder as it may not run properly from there. You should now have a folder on your C: drive called GCB@Syn which contains a number of files including one called IDE.exe. This is the main executable for the IDE, but before we run it we need to configure the software to work with a programmer. At the time of writing this guide we currently stock two types of PIC programmers that are compatible with this IDE:
K150 Pic programmer (HCDVBD0002)http://hobbycomponents.com/index.php/pi ... ammer.html
Pickit2 compatible programmer and debugger (HCDVBD0020)http://hobbycomponents.com/index.php/pi ... ugger.htmlInstalling the correct software for your programmer:
The IDE you have just downloaded doesn't contain software for your programmer but it does contain place holder folders for you to download the appropriate software and copy the programmer software to.For the K150 programmer:
This can be downloaded from our support forum at the following location:viewtopic.php?f=44&t=1344
You will need to be logged into the forum to be able to download the files. First of all download the 'PIC Program Software English Version.zip' file. Unzip this to anywhere on your computer and copy all the files within this folder to the following location:
Next download the prolific drivers from the following location:http://www.prolific.com.tw/US/ShowProdu ... 25&pcid=41
Unzip and install, then plug your K150 programmer into a USB port on your computer. Once the drivers have installed you will need to determine what COM port has been associated with your K150 programmer. This can be found by opening up device manager in windows.
Make a note of the COM port number as you will require this later.For the Pickit2 compatible programmer:
A command line version of the programming software can be downloaded from the Microchip website here:http://www.microchip.com/DevelopmentToo ... O=pg164120
On this page locate the PK2CMD vX.XX PICkit 2 Command Line Interface zip file and download it.
Unzip this anywhere on your computer and copy the contents to the following folder:
C:\GCB@Syn\PicKit2Configuring the IDE for your programmer:
You will need to locate the following batch file and open it in a suitable text editor:
This file contains default settings for various types of PIC programmers. Most of these setting are 'commented out' with the word REM at the beginning of the line which means the line is ignored, but by default there will be an uncommented line enabling the PICpgm programmer:
If you don't intend to use this programmer you can comment this line out by adding a REM as follows:If you wish to use the K150 programmer locate the following line:
And change it to:
For the K150 programmer it is also important to set the correct com port. As previously instructed you should have made a note of the current com port. You will need to change the value and the end of this line to match the com port associated with your K150 programmer. For instance if your programmer is currently associated with com port 2 (COM2) then change the number at the end of the line to:If you wish to use the Pickit2 compatible programmer then locate the following line:
And change it to:
You can have more that one programmer uncommented at the same time and the software will try and detect which programmer is connected, but if you only plan to use one programmer, then it is best to comment out the rest with REM statements. Save this batch file and then close it. The IDE can now be loaded by double clicking the IDE.exe file in the main folder.Example Programs:
If you have followed the above instructions correctly you should now have a working GCB environment and can now start writing programs for your development board. Below are a couple of example programs which you can just cut and past to the main window in the GCB IDE. To compile and flash the program to your development board just hit the yellow/green button on the tool bar labeled 'Hex Flash'. Blink Example Programs:
Forum user Anobium has very kindly contributed an example program that will make all the LED's connected to PORTD on the 16F8777A development board blink:LCD Example Program:
The following program can be used together with the 16F877A development board and one of our 1602 parallel LCD modules to demonstrate the ease of displaying text using GCB.
' FILE: PIC_GCB_16F877a_LCD_Example
' DATE: 07/08/14
' VERSION: 0.1
' AUTHOR: Andrew Davies
'This program was written using the Great Cow Basic IDE for use with our PIC
'16F8777A development board (HCDVBD0003) and our 1602 parallel LCD module
'(HCMODU0013 or HCMODU0038) to display some example text.
'You may copy, alter and reuse this code in any way you like, but please leave
'reference to HobbyComponents.com in your comments if you redistribute this code.
'This software may not be used directly for the purpose of selling products that
'directly compete with Hobby Components Ltd's own range of products.
'THIS SOFTWARE IS PROVIDED "AS IS". HOBBY COMPONENTS MAKES NO WARRANTIES,
'WHETHER EXPRESS, IMPLIED OR STATUTORY, INCLUDING, BUT NOT LIMITED TO, IMPLIED
'WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE, ACCURACY OR
'LACK OF NEGLIGENCE. HOBBY COMPONENTS SHALL NOT, IN ANY CIRCUMSTANCES, BE LIABLE
'FOR ANY DAMAGES INCLUDING, BUT NOT LIMITED TO, SPECIAL, INCIDENTAL OR
'CONSEQUENTIAL DAMAGES FOR ANY REASON WHATSOEVER.
'Chip Settings. Assumes our 16F877A development board with with external 4MHz
'Use LCD in 4 pin mode and define LCD pins
#define LCD_IO 4
#define LCD_RW PORTE.1
#define LCD_RS PORTE.0
#define LCD_Enable PORTE.2
#define LCD_DB4 PORTD.4
#define LCD_DB5 PORTD.5
#define LCD_DB6 PORTD.6
#define LCD_DB7 PORTD.7
'Clear the LCD
'Display some text on both lines
locate 1,3 '