vs-cupl README

Features

VS Project veiwer with functionality to automate build, convert, and deploy cupl code to CPLDs.

Project Management
- Create a project
- Edit PLD file
- Import Cupl (.PLD files) into projects
- Configure project - define chip to program
- Open multiple Projects
- View Pin Layout and signals for CPLD
Code assistance
- Double click pins on chip viewer to insert snippet
- Snippet support for all keywords
- Intellisense for logical signal type
Deployment
- Output window to show all ineractions with third party software
- Pre-requisite check to ensure all tools are installed and configured
- Supports deployment paths to TL886+ for DIP and other 24 and 28 pin CPLDs and homebrew programmer for QFP chips.
- Compile PLD to jed format
- For ATF15xx family:
  - ATMISP to convert jed to svf format
  - Program svf file to an ISP homebrew ATF1500 family chip programmer
- For ATF22/G16/G20/G22/V750 families:
  
  -Use minipro to deploy jed file to device

TESTED ON A LIMITED SET OF CPLDs (ATF1504AS, g20v10)

Workspace folders

Use VS Code workspace feature to keep your projects organized. Structure should be

/workspace folder - when creating a project, use this folder as your root folder.
/workspace/PROJECT1 - creating a project named PROJECT1 would create the folder
/workspace/PROJECT1\PROJECT1.pld - creating a project named PROJECT1 would create the default cupl file

For multiple projects, the same root folder wiil have several project folders

/workspace
/workspace/PROJECT1
/workspace/PROJECT1\PROJECT1.pld
/workspace/PROJECT2
/workspace/PROJECT2\PROJECT2.pld

Save your Code Workspace file to the workspace folder. This folder can represent one product that has seceral chips or projects.

/workspace/my-widget-project.code-workspace

Installation (Linux)

Requirements

Wine

sudo apt update

sudo apt install wine64

Updated winetricks

sudo winetricks --self-update

Wine must have MFC42.DLL installed

./winetricks mfc40

./winetricks mfc42

Download and copy to wine windows folder

Dwsbc32.ocx to ~/.wine/drive_c/windows/system32

ftd2xx.dll to ~/.wine/drive_c/windows/syswow64

Prochip 5.0.1

Need to have Atmel ProChip (5.0.1) installed Download ProChip 5.0.1

ATMISP

Need to have Atmel ATMISP (v7.3) Download ATMISP Need to have FTD2xx.dll file in ATMISP folder

WinCUPL

Download WinCUPL

Minipro

Used for programming jed files using TL866II programmer

sudo apt-get install build-essential pkg-config git libusb-1.0-0-dev fakeroot debhelper dpkg-dev

git clone https://gitlab.com/DavidGriffith/minipro.git

cd minipro

fakeroot dpkg-buildpackage -b -us -uc

sudo dpkg -i ../minipro_0.4-1_amd64.deb

Installtion (Windows)

Prochip 5.0.1

Need to have Atmel ProChip (5.0.1) installed Download ProChip 5.0.1

ATMISP

Need to have Atmel ATMISP (v7.3) Download ATMISP Need to have FTD2xx.dll file in ATMISP folder

WinCUPL

Download WinCUPL

Additional considerations for cupl

Register directory with fitters (in administrative command prompt)

 @"%SystemRoot%\System32\WindowsPowerShell\v1.0\powershell.exe" -NoProfile -ExecutionPolicy Bypass -Command "[Environment]::SetEnvironmentVariable('path',\"c:\Wincupl\WinCupl\Fitters;$([Environment]::GetEnvironmentVariable('path','Machine'))\",'Machine');"

OpenOCD

Download OpenOCD

Download and extract to path (C:\Programs\openocd)
Execute in Administrative command window

@"%SystemRoot%\System32\WindowsPowerShell\v1.0\powershell.exe" -NoProfile -ExecutionPolicy Bypass -Command "[Environment]::SetEnvironmentVariable('path',\"C:\Programs\openocd\bin;$([Environment]::GetEnvironmentVariable('path','Machine'))\",'Machine');"

minipro

Download minipro

Install MSYS2 from here: MSYS2

In msys2 terminal

pacman -S mingw-w64-ucrt-x86_64-gcc
pacman -S make
pacman -S pkg-config
pacman -S git
pacman -S gcc

git clone https://gitlab.com/DavidGriffith/minipro.git
cd minipro



make

IF make fails

#fix errors preventing compilation
echo -e '#include "minipro.h" \n#include "version.h"' > version.c
echo -e '#define VERSION "0.6"\n#ifndef GIT_DATE\n\t#define GIT_DATE "01/01/2001"\n#endif\n#ifndef GIT_BRANCH\n\t#define GIT_BRANCH "main"\n#endif\n#ifndef  GIT_HASH\n\t#define GIT_HASH "blahblahblah"\n#endif' > version.h

cd c:\msys64\home\%USERNAME%\minipro SETX PATH=%PATH%;%cd%;

**In an elevated command prompt(NOT MSYS2)**

cd [path of where minipro build saved minipro.exe]

e.g.


cd c:\\msys64\\home\\%USERNAME%\\minipro

SETX PATH=%PATH%;%cd%;C:\\msys64\\usr\\bin

or

@"%SystemRoot%\System32\WindowsPowerShell\v1.0\powershell.exe" -NoProfile -ExecutionPolicy Bypass -Command "[Environment]::SetEnvironmentVariable('path',\""C:\msys64\usr\bin;C:\msys64\home\\minipro;$([Environment]::GetEnvironmentVariable('path','Machine'))\",'Machine');"

VS Code must be restarted after updating these paths

Extension Settings

This extension contributes the following settings:

Can be configured in File > Preferences > Settings | Extensions > VS Cupl

vs-cupl.WinePath: Set wine binary path (default: /usr/bin/wine).
vs-cupl.OpenOCDPath: Set OpenOCD binary path (default: /usr/bin/openocd).
vs-cupl.MiniproPath: Set minipro binary path (default: /usr/bin/minipro).
vs-cupl.WinCPath: Set Windows C:\ path (default: /home/user1/.wine/drive_c).
vs-cupl.CuplBinPath: Cupl executable path relative to WinePath (default: Wincupl/Shared/ for c:\Wincupl\Shared\cupl.exe)
vs-cupl.AtmIspBinPath: ATMISP executable path (default: ATMEL_PLS_Tools/ATMISP/ATMISP.exe)
vs-cupl.WinTempPath: Temp path on C:\ drive (default: temp)
vs-cupl.DebugLevel: Show Debug Level Messages
vs-cupl.CuplDefinitions: Chose CUPL definition file (.dl) to use
vs-cupl.RunInIntegratedTerminal: Chose if commands are executed in integrated terminal. *This option may cause unexpected behavior. Useful for debugging

depricated

vs-cupl.SetFolder: Set working folder each time you execute a command in a terminal session.

CUPL Language and toolchain

Read more about Cupl

Known Issues

required additional testing on windows
would be good to have a guide step thrugh prerequisites
would be good to launch prerequisite check once on first start up automatically

Homebrew programmer for ATF15xx CPLDs

https://github.com/hackup/ATF2FT232HQ

Release Notes

v0.2.8

Ignore T48 unsupported hardware detection
Conditional tee for minipro programmer PROGRAM command

v0.2.7

Fix file access issue in some linux distros

v0.2.5

Fixed asynchronous bug when creating project
Full end to end testing of ATF22V10C using g22v10 programming (lattice-> dip-> 24 pin)

v0.2.4

clean up devices
minipro commands to dump and erase

See Change Log for changes in each version.

For developers

Requirements

You may need to install resolve-cwd npm package npm install resolve-cwd

To start developing

git clone https://github.com/levvayner/ATF15xx-cupl.git
cd ATF15xx-cupl
npm install
code .

This will open up the project in visual studio. You can press F5 to start debugging.

Following extension guidelines

Ensure that you've read through the extensions guidelines and follow the best practices for creating your extension.

Extension Guidelines

Name		Name	Last commit message	Last commit date
Latest commit History 61 Commits
.vscode		.vscode
assets		assets
languages		languages
minipro		minipro
releases		releases
snippets		snippets
src		src
syntaxes		syntaxes
.eslintrc.json		.eslintrc.json
.gitignore		.gitignore
.vscodeignore		.vscodeignore
CHANGELOG.md		CHANGELOG.md
LICENSE.txt		LICENSE.txt
README.md		README.md
atf15xx-cupl.code-workspace		atf15xx-cupl.code-workspace
package-lock.json		package-lock.json
package.json		package.json
tsconfig.json		tsconfig.json
vsc-extension-quickstart.md		vsc-extension-quickstart.md
webpack.config.js		webpack.config.js

License

levvayner/ATF15xx-cupl

Folders and files

Latest commit

History

Repository files navigation

vs-cupl README

Features

For ATF15xx family:

For ATF22/G16/G20/G22/V750 families:

TESTED ON A LIMITED SET OF CPLDs (ATF1504AS, g20v10)

Workspace folders

Installation (Linux)

Requirements

Wine

Updated winetricks

Wine must have MFC42.DLL installed

Download and copy to wine windows folder

Prochip 5.0.1

ATMISP

WinCUPL

Minipro

Installtion (Windows)

Prochip 5.0.1

ATMISP

WinCUPL

OpenOCD

minipro

In msys2 terminal

IF make fails

In an elevated command prompt(NOT MSYS2)

VS Code must be restarted after updating these paths

Extension Settings

CUPL Language and toolchain

Known Issues

Homebrew programmer for ATF15xx CPLDs

Release Notes

v0.2.8

v0.2.7

v0.2.5

v0.2.4

For developers

Requirements

To start developing

Following extension guidelines

For more information

About

Resources

License

Stars

Watchers

Forks

Releases

Packages 0

Contributors 2

Languages

**In an elevated command prompt(NOT MSYS2)**

Packages