PIC: Great Cow Basic Development Environment Quick Start Guide

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/pic/179-pic-k150-icsp-programmer

Pickit2 compatible programmer and debugger (HCDVBD0020)
http://hobbycomponents.com/pic/445-pickit2-compatible-programmer-and-debugger

Installing 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:

C:\GCB@Syn\K150

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\PicKit2

Configuring the IDE for your programmer:

You will need to locate the following batch file and open it in a suitable text editor:

C:\GCB@Syn\G@Stools\flashPIC.bat

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:

	Code: “PICPgm\picpgm.exe” -delay 1 -p %1

If you don’t intend to use this programmer you can comment this line out by adding a REM as follows:

	Code: REM “PICPgm\picpgm.exe” -delay 1 -p %1

If you wish to use the K150 programmer locate the following line:

	Code: REM “K150\microbrn.exe” %1 %2 /f /Q 2

And change it to:

	Code: “K150\microbrn.exe” %1 %2 /f /Q 2

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:

	Code: “K150\microbrn.exe” %1 %2 /f /Q 2

If you wish to use the Pickit2 compatible programmer then locate the following line:

	Code: REM “PicKit2\pk2cmd.exe” -b”%G@SDir%\PicKit2″ -pPIC%2 -f%1 -m

And change it to:

	Code: “PicKit2\pk2cmd.exe” -b”%G@SDir%\PicKit2″ -pPIC%2 -f%1 -m

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:

	Code: ‘   FILE:    PIC_16F877a_LED_Test.gcb ‘   DATE:    01/08/14 ‘   VERSION: 0.1a ‘   AUTHOR:  Anobium, based on the work of Andrew Davies dated 26/07/14’  This test program will flash the LEDs connected to port D on the development board. ‘  It was written using the Great Cow Basic (GCB) complier. Install GCB – you are recommended to use ‘  GCB@SYN from the Great Cow Basic website.’    This code is free software; you can redistribute it and/or ‘    modify it under the terms of the GNU Lesser General Public ‘    License as published by the Free Software Foundation; either ‘    version 2.1 of the License, or (at your option) any later version.’    This code is distributed in the hope that it will be useful, ‘    but WITHOUT ANY WARRANTY; without even the implied warranty of ‘    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU ‘    Lesser General Public License for more details.’    If you require a copy of the GNU Lesser General Public ‘    License along with this code; please write to the Free Software ‘    Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA ‘Chip settings #chip 16F877a, 4    ‘ Select the chip and the chip speed #config Osc = XT    ‘ Select the external oscillator dir portd out         ‘ Set all PORTD ports as outputs do forever            ‘ Loop for ever PORTD=0xFF      ‘Turn off LED’s on port D wait 125 ms       ‘wait PORTD=0x00      ‘ Turn on LED’s on port D wait 125 ms       ‘wait loop

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.

	Code: ‘  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 ‘ crystal #chip 16F877A,4’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’Main program Main:’Clear the LCD CLS ‘Display some text on both lines Locate 0,5 Print “HOBBY” locate 1,3 ‘ print “COMPONENTS” ‘Do nothing Do Loop Goto Main

More Great Cow Basic sketches are available on our support forum here.