Readme version 2.4.5 Copyright (C) 2018 Klaus Zobawa

(english version scroll down please)

Mecrisp Stelaris fuer PsoC 5LP CY8C5888AXI von Cypress, 
adaptiert auf das Eva-Board sparkfun FreeSoC2 PSoC5LP Dev Board

       
Dokumentation zu dem Eva-Board:
http://www.cypress.com/documentation/application-notes/an77759-getting-started-psoc-5lp
http://www.cypress.com/file/45906/download
https://www.sparkfun.com/products/13714
http://www.cypress.com/part/cy8c5888axi-lp096
http://www.cypress.com/products/32-bit-arm-cortex-m3-psoc-5lp


Einleitung:
Die vorliegende Portierung beinhaltet Mecrisp-FORTH fuer den PsoC des FreeSoC2 out of the box. 
Der FORTH Interpreter bietet die Moeglichkeit die Hardwarefunktionen des PSoC durch Aufruf der API's interaktiv zur Ausfuehrung zu bringen und Applikationen in FORTH zu erstellen.

Fuer die Inbetriebnahme von blinky werden benoetigt:

     - Hexfile UART_RxTx01.hex
     - blinky.txt
     - Evaluation Board FreeSoC2 von sparkfun (div. Distributoren)
     - Terminal Programm z.B.  Tera Term (kostenloser Download)
     - PSoC-Programmer http://www.cypress.com/products/psoc-programming-solutions
     - Alternativ: die Installation von PSoC-Creator enthaelt den PSoC-Programmer und ist separat nutzbar (Empfehlung)
       PSoC-Creator 3.3 or higher http://www.cypress.com/products/psoc-creator-integrated-design-environment-ide
     - PC mit Windows 64Bit, 2 x USB


Fuer die Inbetriebnahme der kompletten Entwicklungsumgebung von PSoC-5LP / Mecrisp-FORTH werden benoetigt:

     - Sourcecode Mecrisp fuer cy8c5888axi
     - Projektfile: UART_RxTx01.cywrk (im Sourcecode von Mecrisp enthalten)
     - Evaluation Board FreeSoC2 von sparkfun (div. Distributoren)
     - Terminal Programm z.B.  Tera Term (kostenloser Download)
     - PSoC-Creator 3.3 or higher http://www.cypress.com/products/psoc-creator-integrated-design-environment-ide
     - PC mit Windows 64Bit, 2 x USB

	
Inbetriebnahme blinky:
 
1. mecrisp-stelaris-2.4.5 oder hoeher nach C:\FORTH\Mecrisp\ kopieren:

C:\FORTH\Mecrisp\mecrisp-stellaris-2.4.5


2. Die Projekt-Directory UART_RxTx01.cydsn aus ..\mecrisp-stellaris-2.4.5\cy8c5888axi\ nach C:\Cypress\ kopieren:
	
C:\Cypress\UART_RxTx01.cydsn


3. Eva-Board nach wie in sparkfunFreeSoC2_Start.jpg dargestellt in Betrieb nehmen. 


4. Das Terminal-Programm installieren und anpassen:

Setup Terminal Programm with the following settings
      - Baudrate       : 38400 bits
      - Data bits      : 8
      - Parity         : none
      - Stop bits      : 1
      - Flow control   : hardware

       
5. PSoC-Programmer oder PSoC-Creator (Empfehlung) installieren


6. UART_RxTx01.hex mit PSoC-Programmer ins Flash schreiben


7. Terminal-Programm starten. 

Nach dem Starten von FORTH soll folgender Text angezeigt werden:

'Mecrisp-Stellaris 2.4.5 by Matthias Koch ported at CY8C5888AXI by Klaus Zobawa 2018'     


8. blinky.txt uerber da Terminal laden


9. blinky aufrufen, mit belibiger Taste beenden

     
	
Inbetriebnahme vollstaendige Entwicklungsumgebung:

1. mecrisp-stelaris-2.4.5 oder hoeher nach C:\FORTH\Mecrisp\ kopieren:

C:\FORTH\Mecrisp\mecrisp-stellaris-2.4.5


2. Die Projekt-Directory UART_RxTx01.cydsn aus ..\mecrisp-stellaris-2.4.5\cy8c5888axi\ nach C:\Cypress\ kopieren:
	
C:\Cypress\UART_RxTx01.cydsn


3. Eva-Board nach wie in sparkfunFreeSoC2_Start.jpg dargestellt in Betrieb nehmen. 
   Die Steckverbindungen fuer die UART sind nach sparkfunFreeSoC2_UART1.jpg und sparkfunFreeSoC2_UART2.jpg herzustellen.
   Die Schiebeschalter wie in V_SEL-position.jpg zu sehen auf 5V einstellen.


4. Das Terminal-Programm installieren und anpassen:

Setup Terminal Programm with the following settings
      - Baudrate       : 38400 bits
      - Data bits      : 8
      - Parity         : none
      - Stop bits      : 1
      - Flow control   : hardware
  

5. PSoC-Creator installieren und starten. Unter Examples and Kits das Eva-Board installieren.


6. Unter Recent Projects mit Open Existing Project  UART_RxTx01.cywrk oeffnen und anklicken.


7. /!\ In der Menuezeile des PSoC-Creator von Debug auf Release umschalten /!\


8.  Unter Build mit Clean und Build UART_RxTx01 ein neues image generieren und unter Debug mit Program den
PsoC auf dem Eva-Board programmieren. Nach korrektem Abschluss leuchtet LED1.


9. Terminal-Programm starten. 

Nach dem Starten von FORTH soll folgender Text angezeigt werden:

'Mecrisp-Stellaris 2.4.5 by Matthias Koch ported at CY8C5888AXI by Klaus Zobawa 2018'

Ab hier steht das Mecrisp-Stelaris FORTH zur Verfuegung

Beispiel Eingabe:

LEDon()  \ schaltet LED1 an
LEDoff() \ schaltet LED1 aus

Beispiel-Sourcecode:

Blinky.txt


10. Software Anpassungen:

Saemtliche von PSoC-Creator zur Verfuegung gestellten API's koennen ueber HAL.s dem FORTH-System bekannt gemacht werden. Beispiele sind HAL.s zu entnehmen. 


Fragen? Klaus.Zobawa@forth-ev.de




English version:

Mecrisp Stelaris for PsoC 5LP CY8C5888LTI from Cypress,
adapted to the Eva board CY8CKIT-059

       
Documentation for the Eva board:
http://www.cypress.com/documentation/application-notes/an77759-getting-started-psoc-5lp
http://www.cypress.com/file/45906/download
https://www.sparkfun.com/products/13714
http://www.cypress.com/part/cy8c5888axi-lp096
http://www.cypress.com/products/32-bit-arm-cortex-m3-psoc-5lp



Introduction:
This porting includes Mecrisp-FORTH for the PsoC of the FreeSoC2 out of the box.
The FORTH interpreter offers the possibility to interactively execute the hardware functions of the PSoC by calling the APIs and to create applications in FORTH.

For the commissioning of blinky you need:

     - Hexfile UART_RxTx01.hex
     - blinky.txt
     - Evaluation Board FreeSoC2 by sparkfun (div. Distributors)
     - Terminal program e.g. Tera Term (free download)
     - PSoC Programmer http://www.cypress.com/products/psoc-programming-solutions
     - Alternatively: the installation of PSoC-Creator contains the PSoC-Programmer and can be used separately (recommendation)
       PSoC Creator 3.3 or higher http://www.cypress.com/products/psoc-creator-integrated-design-environment-ide
     - PC with Windows 64Bit, 2 x USB


For the commissioning of the complete development environment of PSoC-5LP / Mecrisp-FORTH you need:

     - Sourcecode mecrisp for cy8c5888axi
     - Project file: UART_RxTx01.cywrk (included in the source code of Mecrisp)
     - Evaluation Board FreeSoC2 by sparkfun (div. Distributors)
     - Terminal program e.g. Tera Term (free download)
     - PSoC Creator 3.3 or higher http://www.cypress.com/products/psoc-creator-integrated-design-environment-ide
     - PC with Windows 64Bit, 2 x USB


Commissioning blinky:
 
1. Copy mecrisp-stelaris-2.4.5 or higher to C:\FORTH \Mecrisp\:

C: \FORTH\Mecrisp\mecrisp-stellaris-2.4.5


2. Copy the project directory UART_RxTx01.cydsn from .. \mecrisp-stellaris-2.4.5\cy8c5888axi\to C:\Cypress\:

C: \Cypress\UART_RxTx01.cydsn


3. Start the Eva board as described in sparkfunFreeSoC2_Start.jpg.


4. Install and customize the terminal program:

Setup Terminal Program with the following settings
      - Baud rate: 38400 bits
      - Data bits: 8
      - Parity: none
      - Stop bits: 1
      - Flow control: hardware

       
5. Install PSoC Programmer or PSoC Creator (recommendation)


6. Write UART_RxTx01.hex to Flash with PSoC-Programmer


7. Start terminal program.

After starting FORTH the following text should be displayed:

'Mecrisp-Stellaris 2.4.5 by Matthias Koch ported at CY8C5888AXI by Klaus Zobawa 2018'


8. blinky.txt load the terminal


9. Call up blinky, end with the left key

     

Commissioning complete development environment:

1. Copy mecrisp-stelaris-2.4.5 or higher to C:\FORTH\Mecrisp\:

C: \FORTH\Mecrisp\mecrisp-stellaris-2.4.5


2. Copy the project directory UART_RxTx01.cydsn from .. \mecrisp-stellaris-2.4.5\cy8c5888axi\to C:\Cypress\:

C: \Cypress\UART_RxTx01.cydsn


3. Start the Eva board as described in sparkfunFreeSoC2_Start.jpg.
   The connectors for the UART are after sparkfunFreeSoC2_UART1.jpg and sparkfunFreeSoC2_UART2.jpg make.
   Set the slide switches to 5V as seen in V_SEL-position.jpg.


4. Install and customize the terminal program:

Setup Terminal Program with the following settings
      - Baud rate: 38400 bits
      - Data bits: 8
      - Parity: none
      - Stop bits: 1
      - Flow control: hardware
  

5. Install and start PSoC Creator. Install the Eva board under Examples and Kits.


6. Open Recent Projects with Open Existing Project UART_RxTx01.cywrk and click.


7. /!\ In the menu bar of the PSoC Creator, switch from Debug to Release /!\


8. Under Build with Clean and Build UART_RxTx01 generate a new image and under Debug with Program the
Program PsoC on the Eve board. After correct completion LED1 lights up.


9. Start terminal program.

After starting FORTH the following text should be displayed:

'Mecrisp-Stellaris 2.4.5 by Matthias Koch ported at CY8C5888AXI by Klaus Zobawa 2018'

From here the Mecrisp-Stelaris FORTH is available

Example input:

LEDon() turns on LED1
LEDoff() switches LED1 off

Example source code:

Blinky.txt


10. Software adjustments:

All of the APIs provided by PSoC Creator can be introduced to the FORTH system via HAL.s. Examples can be found in HAL.s.


Do you have any questions? Klaus.Zobawa@forth-ev.de
