Before You Start:
Keep your documentation close. The MyMENSCH Datasheet provides further details about the board while the W65C816i1M16SA Datasheet is for the Programmable Microcontroller built into the FPGA.
Step 1: Plug in your MyMENSCH via USB
Use a micro USB cable (not included) to plug your MyMENSCH Development Board into your computer. This will both power the board and provide a WDCTools development interface. The MyMENSCH has a built-in simple operating system called a Monitor which is located in the CFM. The Monitor is always there and is the built-in interface that is all you need to get started with the WDCTools and your first project.
Step 2: Setting Up Your Coding Environment
-
-
Download the WDC Programming Manual
-
Download WDCTools
Install WDCTools and set update preferences with installer. WDCTools is NOT for resale or reverse engineering of our technology in any form and is NOT provided for development of commercial products that use non–WDC 65xx processors in Core or Chip form. If you have email or other issues downloading the tools, click here (you will need to unzip before installing).
* Find WDCTools Support videos on YouTube -
Download WDC/ECNX Uploader utility
This is an uploader tool from our partner, ECNX, that makes uploading code to MyMENSCH boards simple. There are options to upload to SRAM or User FLASH.
-
Install CH340 Driver
-
Step 3: Running a Demo Program
-
-
- Text Editor-Select a text editor that works best for your needs is very important to ensure that your code generation works as expected. There are many options that include both commercial and free versions. We suggest if you are looking for a free editor Notepad ++.
- Batch Files – WDC provides sample batch files within WDCTools to get you started. You can find these by going into your Start Menu, scroll to MyMENSCH WDCTools and identifying the file you want to use. The batch file calls the assembler, linker, and uploader tools. If you are using Linux, you will want to create a make file with similar commands.
- Python Uploader– Once the batch file runs, the demo will assemble, link and the Uploader will launch.
- Writing your Program– You can use the included demo folder to write your own projects. Launch File Explorer and navigate to the project you want to change. The projects are within C:\WDC\MyMENSCH\. Edit the *.ASM file
- Upload Program– Once your changes to the ASM file are made, save your changes, then rerun the BAT file.
-
Next, we will get started with MyMENSCH Rev-C using a simple program to change the 8 LEDs on the board.
DOWNLOAD THE MyMENSCH GETTING STARTED PROGRAM HERE
Extract the zip into the C:\WDC\MyMENSCH\GettingStarted\ASM\ folder. This project has a batch file that will assemble and link the project. It will also call the uploader.
Double click the “mk_GettingStarted.bat” batch file. MyMENSCH Rev-C has reset circuitry so you will not have to manually reset when uploading (as with Rev-A/B).
The uploader will automatically detect your port number. If you only have 1 serial device plugged in, just type 1 and press Enter to start the uploader.
Your command prompt should be similar to below if everything ran correctly. The wdc_uploader_term.exe is the Uploader program that loads your program into FLASH or RAM. In this example, the -m write -k option is used to store the program in FLASH. The -x option will execute the code after loading, and the -v option is for verbose, which will give you more details such as a memory dump of what was written. If you run wdc_uploader_term.exe -h, you will see all of the options for the program.
Since we used the -x option to eXecute the code, the program runs after loading. This is a simple program that sets the lights to a certain value ($AA). Therefore, LEDs 7, 5, 3, and 1 will be lit. You can change the code to make the LEDs change differently.
After this simple example, you are ready to explore the other features of MyMENSCH Rev-C and the W65C165i1M08SA FPGA Microcontroller.
Advanced Development for Commercial Products
We at The Western Design Center pride ourselves in our private and confidential relationship development. In order to best support Commercial Product Developers, we have created a private GitHub and Wiki to support your product development. Access to this resource will provide you with Documentation, Design Files, and Code Examples for the W65Cx65MMC “MyMENSCH” development platform while also creating a supported relationship with the WDC business and technology development teams.
To start your Commercial Product Developer access request please download the WDC NDA below, review and sign the NDA and email it to [email protected].
Advance Development Items Needed:
Hardware:
FPGA Development Tools:
Download and install Quartus Prime Lite Edition available from Intel here.
- Quartus Tools are only available for Windows and Linux.
- See the following Quartus OS and hardware requirements.
- This should include ModelSim-Intel FPGA Edition and Max 10 FPGA device support.