Guide to adding PIC micro-controllers to Flowcode - Matrix ...

Guide to adding PIC micro-controllers to Flowcode. 

Contents 

1. Introduction 

2. Description of the FCD Sections 

a. [Device] 

b. [Config] 

c. [Pins] 

d. [Ports] 

e. [PortMasks] 

f. [ADCPins] 

g. [Code] 

h. [Defines] 

i. [Interrupts] 

3. Example FCD conversion 16F84 to a 16C711 

1. Introduction 

Flowcode collects its list of micro-controllers from the FCD files located inside the Flowcode V3/FCD/ 

directory. 

FCD stands for Flowcode definition file. 

Therefore adding a new PIC micro-controller to Flowcode is simply a case of creating a FCD file for 

the microcontroller. 

The easiest way to get started is to find a micro-controller that is as similar as possible to the device 

you wish to implement. You can then copy the similar device’s FCD file and then edit any parts that 

are not similar. 

The definition file is broken down into the following sections. 

[Device] 

[Config] (optional) 

[Pins] 

[Ports] 

[PortMasks] 

[ADCPins] 

[Code] 

[Defines] 

[Interrupts] 

2. Description of the FCD Sections 

a. [Device] 

Contains information about the micro-controller such as the number of pins, the number of ports, ADC 

inputs, Maximum clock speed settings etc. 

Optional extras that can be added to the device section 

ChipName=16C711 – Specifies the target name of the micro-controller if the FCD name is different to 

the target name. 

ConfigOverride=1 – Specifies a fixed configuration word 

Specifying a fixed configuration requires the configuration data to be given in a Config section.

. [Config] 

This optional section forces the chip to compile with a certain set of configuration data. All 14 entries 

(0 to 13) need to be entered, even if the chip has only 1 or 2 configuration words. 

16F Example: 

[Config] 

0=0x3F2A 

1=0xFFFF 

2=0xFFFF 

3=0xFFFF 

4=0xFFFF 

5=0xFFFF 

6=0xFFFF 

7=0xFFFF 

8=0xFFFF 

9=0xFFFF 

10=0xFFFF 

11=0xFFFF 

12=0xFFFF 

13=0xFFFF 

18F Example: 

[Config] 

0=0x20 

1=0x0E 

2=0x3E 

3=0x1E 

4=0x00 

5=0x81 

6=0x81 

7=0x00 

8=0x0F 

9=0xC0 

10=0x0F 

11=0xA0 

12=0x0F 

13=0x40 

c. [Pins] 

Used by the real time “Chip” diagram in Flowcode, Assigns string names to the pins. 

Pin1="RA2/AN2" 

Pin2="RA3/AN3" 

d. [Ports] 

Used to configure where the I/O is on the real time “Chip” diagram. Pins that are assigned to I/O 

should be listed with their port and pin information. 

Examples 

PortPin1=0x0002 – Means that pin 1 of the micro-controller is RA2 

PortPin5=0x0007 – Means that pin 5 of the micro-controller is RA7 

PortPin8=0x0102 – Means that pin 8 of the micro-controller is RB2 

PortPin21=0x0107 – Means that pin 21 of the micro-controller is RB7 

PortPin25=0x0302 – Means that pin 25 of the micro-controller is RD2

e. [PortMasks] 

Used to configure which I/O lines are available on a port. 

Example of an incomplete port 

PortMask0=0x1F – Means that PortA has only 5 pins 

PortMask4=0x07 – Means that PortE has only 3 pins 

Example of a complete port 

PortMask1=0xFF – Means that PortB has all 8 pins 

f. [ADCPins] 

Configures which pins have analogue capabilities. The ADC# is the (AN) channel of the pin and the 

number being assigned to it is the pin number itself. 

ADC0=17 

ADC1=18 

ADC2=1 

ADC3=2 

g. [Code] 

Most of the code section can be copied as is. A few things to look out for are. 

Initialise – Used to configure the PICmicro to use all I/O as digital 

ADCCapture – Used to capture an analogue signal from channel %a 

h. [Defines] 

This section details the peripherals of the micro-controller. The easiest way to complete this section is 

to find other devices with the same hardware configuration and use their peripheral list. You must 

make sure that the ports and pins of the devices match correctly. 

i. [Interrupts] 

This section details the common interrupts that are available to the micro-controller. This section can 

be left as is. If there are interrupts you wish to use that are not the typical common ones then you can 

simply use the custom Interrupt function that is available within Flowcode. 

Implementing your own Interrupt – This will perform an interrupt when the ADC has finished 

sampling. Note that register names are lower case where as bit names are upper case.

3. Example FCD conversion 16F84 to a 16C711 

Creating a FCD file for a PIC16C711. 

The PIC16C711 is very similar to the PIC16F84. The only major differences being that the 16C711 has 

four analogue input pins and a larger EEPROM memory. 

So to begin we can take a copy of the 16F84.FCD and rename it 16C711.FCD. 

Remember that all of the information you require is contained in the PICmicro datasheet. It may take a 

while to track down exactly what you are looking for but everything you require will be there. 

Below is a copy of the 16F84 FCD file with items that need removing highlighted in red. The 16C711 

modifications are highlighted in green. 

[Device] 

Pins=18 

Ports=2 

ADCPins=0 ADCPins=4 

ADCBits=0ADCBits=8 

MaxClock=10000000MaxClock=10000000 

PrescalerBits=3 

ClockDivider=4 

TimerOverflow=256 

ConfigAddress=0x2007 

ConfigCount=1 

PWMCount=0 

EepromSize=64EepromSize=1024 

HasAltPWM=0 

Pwm2IsD4=0 

ChipName=16C711 

[Pins] 

Pin1="RA2"Pin1="RA2/AN2" 

Pin2="RA3"Pin2="RA3/AN3/Vref" 

Pin3="RA4/T0CKI" 

Pin4="MCLR" 

Pin5="Vss" 

Pin6="RB0/INT" 

Pin7="RB1" 

Pin8="RB2" 

Pin9="RB3" 

Pin10="RB4" 

Pin11="RB5" 

Pin12="RB6" 

Pin13="RB7" 

Pin14="Vdd" 

Pin15="OSC2/CLKOUT" 

Pin16="OSC1/CLKIN" 



[Ports] 

PortPin1=0x0002 













[PortMasks] 

PortMask0=0x1F 

PortMask1=0xFF

[ADCPins] 

ADC0=17 

ADC1=18 

ADC2=1 

ADC3=2 

[Code] 

;Substitute macros 

;%c Clock Speed 

;%o Operand 

;%s Prescaler 

;%p PortID 

;%m MaskBits 

;%i Inverse Mask 

;%a ADC channel 

;%a Config Address 

;%v Config Value 

;%r Interrupt Flag Register 

;%b Interrupt Flag Bit 

;%n Interrupt Macro Name 

Directives="#include \n#pragma CLOCK_FREQ %c\n" 

MainStart="void main()\n{\n" 

MainEnd="\tmainendloop: goto mainendloop;\n}\n\n" 

IntStart="void interrupt(void)\n{\n" 

IntEnd="}\n\n" 

Initialise=""Initialise="adcon1 = 0x03;\n" 

IntInit="option_reg = 0xC0;\n\n" 

InputCmdFull="tris%p = tris%p | %m;\n%o = port%p;\n" 

InputCmdOneBit="tris%p = tris%p | %m;\n%o = ((port%p & %m) == %m);\n" 

InputCmdMask="tris%p = tris%p | %m;\n%o = port%p & %m;\n" 

OutputCmdFull="tris%p = 0x00;\nport%p = %o;\n" 

OutputCmdOneBit="tris%p = tris%p & %i;\nif (%o)\n\tport%p = (port%p & %i) | %m;\nelse\n\tport%p = port%p & %i;\n" 

OutputCmdMask="tris%p = tris%p & %i;\nport%p = (port%p & %i) | (%o & %m);\n" 

DelayCmdS="delay_s(%o);\n" 

DelayCmdMs="delay_ms(%o);\n" 

ADCCapture="char ta, cnt;\nadcon1 = 0x00;\nta = trisa;\ntrisa = trisa | 0x2F;\nadcon0 = 0xC1 | (%a

Guide to adding PIC micro-controllers to Flowcode - Matrix ...

Create successful ePaper yourself

Delete template?

Save as template?