CONFIG FT800

From MCS Wiki AVR
(Difference between revisions)
Jump to: navigation, search
 
Line 19: Line 19:
 
 
 
 
 
<div style="padding: 0px; margin: 0px 0px 0px 4px;">
 
<div style="padding: 0px; margin: 0px 0px 0px 4px;">
−
&nbsp;
+
{| style="border: solid 2px #000000; border-spacing:0px; border-collapse: collapse;" cellspacing="0" cellpadding="1" border="1"
−
<div style="font-size: 13.3333330154419px; padding: 0px; margin: 0px 0px 0px 4px;">
+
−
{| cellspacing="0" cellpadding="1" border="1" style="border: 2px solid rgb(0, 0, 0); border-spacing: 0px; border-collapse: collapse;"
+
 
|- style="vertical-align: top;"
 
|- style="vertical-align: top;"
−
| valign="top" width="16%" style="width: 156px; border: 1px solid rgb(0, 0, 0);" |  
+
| style="width:16%; border: solid 1px #000000;" width="16%" valign="top" |  
 
spi
 
spi
  
−
| valign="top" width="100%" style="width: 831px; border: 1px solid rgb(0, 0, 0);" |  
+
| style="width:100%; border: solid 1px #000000;" width="100%" valign="top" |  
−
The SPI interface used for the FT800 processor. This may be :
+
The SPI interface used for the FT800/FT801/FT810 processor. This may be :
  
 
- SPI, for normal AVR processors
 
- SPI, for normal AVR processors
Line 38: Line 36:
  
 
|- style="vertical-align: top;"
 
|- style="vertical-align: top;"
−
| valign="top" width="16%" style="width: 156px; border: 1px solid rgb(0, 0, 0);" |  
+
| style="width:16%; border: solid 1px #000000;" width="16%" valign="top" |  
 
ftsave
 
ftsave
  
−
| valign="top" width="100%" style="width: 831px; border: 1px solid rgb(0, 0, 0);" |  
+
| style="width:100%; border: solid 1px #000000;" width="100%" valign="top" |  
 
This is an optional parameter with a default of 0. The possible values are 0 and 1. With this option enabled, the parameters passed to the various FT800 routines are limited in range. For example when a parameter is expected in the range from 0-31 it would not matter if you pass 32. But limiting the range increases code. It is best to make sure yourself that you pass the proper values.
 
This is an optional parameter with a default of 0. The possible values are 0 and 1. With this option enabled, the parameters passed to the various FT800 routines are limited in range. For example when a parameter is expected in the range from 0-31 it would not matter if you pass 32. But limiting the range increases code. It is best to make sure yourself that you pass the proper values.
  
 
|- style="vertical-align: top;"
 
|- style="vertical-align: top;"
−
| valign="top" width="16%" style="width: 156px; border: 1px solid rgb(0, 0, 0);" |  
+
| style="width:16%; border: solid 1px #000000;" width="16%" valign="top" |  
 
ftdebug
 
ftdebug
  
−
| valign="top" width="100%" style="width: 831px; border: 1px solid rgb(0, 0, 0);" |  
+
| style="width:100%; border: solid 1px #000000;" width="100%" valign="top" |  
−
This is an optional parameter with a default of 0. The possible values are 0 and 1. With this option enabled, the SPI communication can be monitored. A label named&nbsp;<span style="font-weight: bold;">_FTDBG</span>&nbsp;is called in your code. So when using this option you need to insert this label into your code. You also need to DIM a byte named&nbsp;<span style="font-weight: bold;">ftdebug</span>. This byte will be filled with the parameter sent to the SPI.
+
This is an optional parameter with a default of 0. The possible values are 0 and 1. With this option enabled, the SPI communication can be monitored. A label named <span style="font-weight: bold;">_FTDBG</span> is called in your code. So when using this option you need to insert this label into your code. You also need to DIM a byte named <span style="font-weight: bold;">ftdebug</span>. This byte will be filled with the parameter sent to the SPI.
  
 
Make sure you put a RETURN after the label and save registers you use:
 
Make sure you put a RETURN after the label and save registers you use:
Line 66: Line 64:
  
 
|- style="vertical-align: top;"
 
|- style="vertical-align: top;"
−
| valign="top" width="16%" style="width: 156px; border: 1px solid rgb(0, 0, 0);" |  
+
| style="width:16%; border: solid 1px #000000;" width="16%" valign="top" |  
 
FTCS
 
FTCS
  
−
| valign="top" width="100%" style="width: 831px; border: 1px solid rgb(0, 0, 0);" |  
+
| style="width:100%; border: solid 1px #000000;" width="100%" valign="top" |  
 
The name of the SPI port pin connected to the CS pin of the FT800. This would be SS in most cases. This pin is set to output and to logic level 1.
 
The name of the SPI port pin connected to the CS pin of the FT800. This would be SS in most cases. This pin is set to output and to logic level 1.
  
 
|- style="vertical-align: top;"
 
|- style="vertical-align: top;"
−
| valign="top" width="16%" style="width: 156px; border: 1px solid rgb(0, 0, 0);" |  
+
| style="width:16%; border: solid 1px #000000;" width="16%" valign="top" |  
 
FTPD
 
FTPD
  
−
| valign="top" width="100%" style="width: 831px; border: 1px solid rgb(0, 0, 0);" |  
+
| style="width:100%; border: solid 1px #000000;" width="100%" valign="top" |  
 
The name of the port pin connected to the PD pin of the FT800. This is an optional pin, it depends on your hardware. Gameduino2 does not require it. EVE demo boards do require this pin.
 
The name of the port pin connected to the PD pin of the FT800. This is an optional pin, it depends on your hardware. Gameduino2 does not require it. EVE demo boards do require this pin.
  
 
|- style="vertical-align: top;"
 
|- style="vertical-align: top;"
−
| valign="top" width="16%" style="width: 156px; border: 1px solid rgb(0, 0, 0);" |  
+
| style="width:16%; border: solid 1px #000000;" width="16%" valign="top" |  
 
FTCHIP
 
FTCHIP
  
−
| valign="top" width="100%" style="width: 831px; border: 1px solid rgb(0, 0, 0);" |  
+
| style="width:100%; border: solid 1px #000000;" width="100%" valign="top" |  
−
The kind of FT chip. FT800 is the default and when used, FTCHIP do not need to be specified. FT801 is similar to the FT800 but has a capacitive touch screen and gestures support.
+
The kind of FT chip. FT800 is the default and when used, FTCHIP does not need to be specified. FT801 is similar to the FT800 but has a capacitive touch screen and gestures support.
  
 
Possible values :
 
Possible values :
Line 91: Line 89:
  
 
- 801 : FT801
 
- 801 : FT801
 +
 +
- 810, 811,812, 813 : FT81x
  
 
|- style="vertical-align: top;"
 
|- style="vertical-align: top;"
−
| valign="top" width="16%" style="width: 156px; border: 1px solid rgb(0, 0, 0);" |  
+
| style="width:16%; border: solid 1px #000000;" width="16%" valign="top" |  
 
PLATFORM
 
PLATFORM
  
−
| valign="top" width="100%" style="width: 831px; border: 1px solid rgb(0, 0, 0);" |  
+
| style="width:100%; border: solid 1px #000000;" width="100%" valign="top" |  
 
The used hardware platform. Default is EVE from FTDI. Possible values :
 
The used hardware platform. Default is EVE from FTDI. Possible values :
  
Line 104: Line 104:
  
 
|- style="vertical-align: top;"
 
|- style="vertical-align: top;"
−
| valign="top" width="16%" style="width: 156px; border: 1px solid rgb(0, 0, 0);" |  
+
| style="width:16%; border: solid 1px #000000;" width="16%" valign="top" |  
 
LCD_SCREEN
 
LCD_SCREEN
  
−
| valign="top" width="100%" style="width: 831px; border: 1px solid rgb(0, 0, 0);" |  
+
| style="width:100%; border: solid 1px #000000;" width="100%" valign="top" |  
 
The kind of LCD screen. Possible values :
 
The kind of LCD screen. Possible values :
 +
 +
&nbsp;
  
 
480272 : 480x272 pixels LCD (default)
 
480272 : 480x272 pixels LCD (default)
  
 
320240 : 320x240 pixels LCD
 
320240 : 320x240 pixels LCD
 +
 +
800480 : 800x480 pixels LCD
 +
 +
800600 : 800x600 pixels LCD
 +
 +
&nbsp;
  
 
As you might have noticed, the value is the same as the screen size without the x.
 
As you might have noticed, the value is the same as the screen size without the x.
  
 
|- style="vertical-align: top;"
 
|- style="vertical-align: top;"
−
| valign="top" width="16%" style="width: 156px; border: 1px solid rgb(0, 0, 0);" |  
+
| style="width:16%; border: solid 1px #000000;" width="16%" valign="top" |  
 
LCD_ROTATE
 
LCD_ROTATE
  
−
| valign="top" width="100%" style="width: 831px; border: 1px solid rgb(0, 0, 0);" |  
+
| style="width:100%; border: solid 1px #000000;" width="100%" valign="top" |  
 
The LCD can be used in normal horizontal mode or upside down 180 degrees.
 
The LCD can be used in normal horizontal mode or upside down 180 degrees.
  
Line 130: Line 138:
  
 
|- style="vertical-align: top;"
 
|- style="vertical-align: top;"
−
| valign="top" width="16%" style="width: 156px; border: 1px solid rgb(0, 0, 0);" |  
+
| style="width:16%; border: solid 1px #000000;" width="16%" valign="top" |  
 
LCD_CALIBRATION
 
LCD_CALIBRATION
  
−
| valign="top" width="100%" style="width: 831px; border: 1px solid rgb(0, 0, 0);" |  
+
| style="width:100%; border: solid 1px #000000;" width="100%" valign="top" |  
 
The LCD requires calibration. This need to be done once but you can force calibration using LCD_CALIBRATION parameter.
 
The LCD requires calibration. This need to be done once but you can force calibration using LCD_CALIBRATION parameter.
  
Line 149: Line 157:
  
 
<span style="font-family: Arial;">The FT800 is controlled by the SPI interface. This means that you need to configure the SPI the usual way.</span>
 
<span style="font-family: Arial;">The FT800 is controlled by the SPI interface. This means that you need to configure the SPI the usual way.</span>
 +
<div style="padding: 0px; margin: 0px 0px 0px 4px;">
 +
  
 
<span style="font-family: Arial;">&nbsp;</span>
 
<span style="font-family: Arial;">&nbsp;</span>
Line 160: Line 170:
 
<span style="font-family: Arial;">- BASCOM high level commands such as CMD32, RD8(), RD16(), etc.</span>
 
<span style="font-family: Arial;">- BASCOM high level commands such as CMD32, RD8(), RD16(), etc.</span>
  
−
<span style="font-family: Arial;">- FT80x include files : an include file with the declarations (FT80x.INC) and an include file with the actual code (FT80x_FUNCTIONS.INC).</span>
+
<span style="font-family: Arial;">- FT80x include files&nbsp;: an include file with the declarations (FT80x.INC) and an include file with the actual code (FT80x_FUNCTIONS.INC).</span>
  
 
<span style="font-family: Arial;">&nbsp;</span>
 
<span style="font-family: Arial;">&nbsp;</span>
Line 166: Line 176:
 
<span style="font-family: Arial;">You may modify the code from the include files. The code will reveal some new options. It is important to understand these new options.</span>
 
<span style="font-family: Arial;">You may modify the code from the include files. The code will reveal some new options. It is important to understand these new options.</span>
  
−
<span style="font-family: Arial;">- Passing values using&nbsp;[[DECLARE_SUB|BYREG]]</span>
+
<span style="font-family: Arial;">- Passing values using&nbsp;[[DECLARE SUB|BYREG]]</span>
  
−
<span style="font-family: Arial;">- Passing values using&nbsp;[[DECLARE_SUB|BYSTACK]]</span>
+
<span style="font-family: Arial;">- Passing values using&nbsp;[[DECLARE SUB|BYSTACK]]</span>
  
 
<span style="font-family: Arial;">-&nbsp;[[CMDFTSTACK]]</span>
 
<span style="font-family: Arial;">-&nbsp;[[CMDFTSTACK]]</span>
Line 176: Line 186:
 
<span style="font-family: Arial;">&nbsp;</span>
 
<span style="font-family: Arial;">&nbsp;</span>
  
−
In version 2079, FT801 support is included. A number of constants are removed from the include file and are now a parameter of CONFIG FT800. These constants are : FT_PlatForm , FT_LCDscreen , FT_LcdCal , &nbsp;FT_RotateDisplay and FT_CHIP. These constants are remarked for reference.
+
In version 2079, FT801 support is included. A number of constants are removed from the include file and are now a parameter of CONFIG FT800. These constants are&nbsp;: FT_PlatForm , FT_LCDscreen , FT_LcdCal , &nbsp;FT_RotateDisplay and FT_CHIP. These constants are remarked for reference.
  
 
&nbsp;
 
&nbsp;

Latest revision as of 20:08, 17 January 2017

Contents

Action

This compiler option is required to setup the FT800 SPI interface.

 

 

Syntax

CONFIG FT800 = spi [, FTSAVE=ftsave , FTDEBUG=ftdebug] , FTCS=ftcs [, FTPD = ftpd] [,FTCHIP=800|801] [,PLATFORM=platform] [,LCD_SCREEN-lcdscr] [,LCD_ROTATE=lcdrotate] [,LCD_CALIBRATION=calib]

 

 

Remarks

 

spi

The SPI interface used for the FT800/FT801/FT810 processor. This may be :

- SPI, for normal AVR processors

- SPI*, SPIC, SPID, SPIE, SPIF, for XMEGA processors.

 

  • When you use SPI on an XMEGA processor, the compiler will use SPIC, the default SPI.

ftsave

This is an optional parameter with a default of 0. The possible values are 0 and 1. With this option enabled, the parameters passed to the various FT800 routines are limited in range. For example when a parameter is expected in the range from 0-31 it would not matter if you pass 32. But limiting the range increases code. It is best to make sure yourself that you pass the proper values.

ftdebug

This is an optional parameter with a default of 0. The possible values are 0 and 1. With this option enabled, the SPI communication can be monitored. A label named _FTDBG is called in your code. So when using this option you need to insert this label into your code. You also need to DIM a byte named ftdebug. This byte will be filled with the parameter sent to the SPI.

Make sure you put a RETURN after the label and save registers you use:

 

_FTDBG

Pushall

print hex(ftdebug)

Popall

RETURN

FTCS

The name of the SPI port pin connected to the CS pin of the FT800. This would be SS in most cases. This pin is set to output and to logic level 1.

FTPD

The name of the port pin connected to the PD pin of the FT800. This is an optional pin, it depends on your hardware. Gameduino2 does not require it. EVE demo boards do require this pin.

FTCHIP

The kind of FT chip. FT800 is the default and when used, FTCHIP does not need to be specified. FT801 is similar to the FT800 but has a capacitive touch screen and gestures support.

Possible values :

- 800 : FT800 (default)

- 801 : FT801

- 810, 811,812, 813 : FT81x

PLATFORM

The used hardware platform. Default is EVE from FTDI. Possible values :

- EVE (default)

- GAMEDUINO2 : popular alternative FTDI hardware

LCD_SCREEN

The kind of LCD screen. Possible values :

 

480272 : 480x272 pixels LCD (default)

320240 : 320x240 pixels LCD

800480 : 800x480 pixels LCD

800600 : 800x600 pixels LCD

 

As you might have noticed, the value is the same as the screen size without the x.

LCD_ROTATE

The LCD can be used in normal horizontal mode or upside down 180 degrees.

Possible values :

- 0 : horizontal (default)

- 1 : 180 degrees rotated

LCD_CALIBRATION

The LCD requires calibration. This need to be done once but you can force calibration using LCD_CALIBRATION parameter.

Possible values :

- 0 : No calibration

- 1 : Force Calibration (default)

 

The CONFIG FT800 statement will inform the compiler to use the FT800.LIB. It will also create an ALIAS for the CS and PD pins you specify.

The FT800 is controlled by the SPI interface. This means that you need to configure the SPI the usual way.


 

BASCOM FT80x support is implemented in the following way:

- a low level communication library FT800.LIB

- ASM include macros which are located in the FT800.LIB. Unlike sub routines, the code is included and not called.

- BASCOM high level commands such as CMD32, RD8(), RD16(), etc.

- FT80x include files : an include file with the declarations (FT80x.INC) and an include file with the actual code (FT80x_FUNCTIONS.INC).

 

You may modify the code from the include files. The code will reveal some new options. It is important to understand these new options.

- Passing values using BYREG

- Passing values using BYSTACK

- CMDFTSTACK

 

 

In version 2079, FT801 support is included. A number of constants are removed from the include file and are now a parameter of CONFIG FT800. These constants are : FT_PlatForm , FT_LCDscreen , FT_LcdCal ,  FT_RotateDisplay and FT_CHIP. These constants are remarked for reference.

 

Here are some sample configurations

 

AdamShield:

Config FT800 = Spi , Ftsave = 0 , Ftdebug = 0 , Ftcs = Portd.4 , Ftpd = Portd.3, ftChip=800, LcdScreen=480272, PlatForm=Eve

 

GAMEDUINO2:

Config FT800=spi , ftsave=0, ftdebug=0 , ftcs=portb.0, ftChip=800, LcdScreen=480272, PlatForm=Gameduino2

 

VM801P - FTDI:

Config FT800 = Spi , ftsave = 0, ftdebug = 0 , Ftcs = Portb.1 , Ftpd = Portd.4, ftChip=801, LcdScreen=480272, PlatForm=Eve, Lcd_Rotate=1, Lcd_Calibration=0

 

See also

 , CMDFTSTACK , CMD32 , RD8, RD16, RD32 , WR32

 

 

 

Partial Example 

' FT800 Gauges Application demonstrating interactive Gauges using Lines & Custom Font
' FT800 platform.
' Original code from http://www.ftdichip.com/Support/SoftwareExamples/EVE/FT_App_Gauges.zip
' Requires Bascom 2.0.7.8 or greater
 
$Regfile = "M328pdef.dat"
$Crystal = 8000000
$Baud = 19200
$HwStack = 90
$SwStack = 90
$FrameSize = 300
$NOTYPECHECK
 
Config ft800=spi , ftsave=0, ftdebug=0 , ftcs=portb.2, ftpd=portb.1
 
Config Base = 0
Config Submode = New
Config Spi = Hard , Interrupt = Off , Data_Order = Msb , Master = Yes , Polarity = Low , Phase = 0 , Clockrate = 4, Noss = 1
SPSR = 1 ' Makes SPI run at 8Mhz instead of 4Mhz
 
 
' Swaps Scales
' 1 = Resitive - Random
' 0 = Random - Resistive
Const Resistive = 0
 
#If Resistive = 0
 Const First = 1
 Const Second = 0
#Else
 Const First = 0
 Const Second = 1
#EndIf
 
$Include "FT800.inc"
$Include "FT800_Functions.inc"
 
Declare Sub cs(Byval i As Byte)
Declare Function da (Byval i As Long) As Word
Declare Sub Polar(byval R As Long , Byval Th As Word)
Declare Sub Polarxy(byval R As Long , Byval Th As Word , Byref X As Long , Byref Y As Long)
Declare Sub IntroFTDI
Declare Sub Gauges
Declare Function Read_Keys() As Byte
 
' General Program Variables and Declarations
Dim temp_tag As Byte
Dim ox As Long
 
 
Spiinit
 
if FT800_Init()=1 then end ' Initialise the FT800
 
Gauges
 
Do
 
Loop

Remark

In the samples, Noss = 1 is used for CONFIG SPI. This means that the SS pin must be set by the user. In case of CONFIG FT800, the compiler always set the specified pin for FTCS to output and to logic 1. When possible you should use NOSS=0 and use the dedicated SPI SS pin. But for multiple SPI devices on the bus that is not possible since you will have multiple CS pins, and in these cases you should use NOSS=1, so you can control the SS logic level.


Languages   English  
Retrieved from "http://wiki.mcselec.com/bavr/index.php?title=CONFIG_FT800&oldid=5410"
Personal tools
Namespaces
Variants
Actions
Navigation
Language