User Tools

Site Tools


troubleshooting_guide

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

troubleshooting_guide [2017/07/03 18:31] (current)
z00m created
Line 1: Line 1:
 +====== V6Z80P Tips / Troubleshooting Guide ======
  
 +===== General =====
 +
 +Avoid connecting or disconnecting anything to the V6Z80P whilst the power is switched on (SD cards shouldn'​t be a problem, but FLOS cannot automatically recognize card swaps so any card inserted whilst the power is on needs to be initialized with the "​MOUNT"​ command).\
 +
 +===== FLOS =====
 +
 +If you have any problems formatting an SD card to FAT16 on the PC, try doing it under FLOS with the command: \\
 +
 +''​FORMAT SD_CARD''​\\
 +
 +You can create a multi-volume SD card if you wish by using the FLOS utility //​DISKTOOL//​. This can make up to 4 partitions using the 4 slots in the Master Boot Record. Note however, that Windows (XP) will only see the first partition since it uses a different scheme for partitioning. (Linux will generally see all the FLOS partitions).\\
 +
 +//​Incompatibilies://​ Some old versions of FLOS may not work with new versions of OSCA and vice versa. If you have any problems updating the system with //EEPROM//, please use the utility //UPDATE// - it can be loaded from SD card as any other command or sent to the V6Z80P via Serial Link (Enter: ''​RX * 5000'',​ wait for it to download, then enter ''​G 5000''​)\\
 +
 +===== Serial Comms software =====
 +
 +Whilst the Windows GUI "​Serial Link" is useful for occasional file transfers, it may be more convenient to use "​SerialTX"​. This is a console / command line based utility (found in the project'​s "​PC-based Apps" folder) which can send files from other programs etc, via "open with" etc. It can also be handy to copy FileTX to Windows'​ "Send To" list so that files can be send via a right click ->Send To.\\
 +
 +===== Sound =====
 +
 +The default sound set-up of OSCA is stereo separation. If you prefer mono output (which sends all 4 channels to both side, also increasing the overall volume) add the line MONO to the BOOTRUN.SCR file in the root of the SD Card.
 +
 +===== Rebooting =====
 +
 +There are two reset jumpers on the V6Z80P. The first (in the 10-pin header group) is merely a programmable FPGA pin - in OSCA this can be used to reset the Z80 CPU. The second, "​J2"​ can be used in all configs to reconfigure the FPGA to whichever is the power-on boot slot. Therefore a button across J2 can be used to return from the
 +Spectrum Emulators to OSCA without physically powering off the board (note: for J2 to exhibit this behavior, the PIC firmware version needs to be v637+)\\
 +
 +===== Peripherals =====
 +
 +==== Serial port ====
 +If your PC does not have a 9 pin serial connector, a USB serial adapter should work fine.  The "​Prolific"​ chipset cables (about £2-£10 on eBay) are known to work well, but make sure you get the latest drivers.\\
 +
 +==== Keyboard ====
 +A modern USB keyboard can be used if it came with a PS/2 adapter but some of these keyboards have unusual / slow start up sequences. If you encounter problems, create a text file in the root of your SD card called SYSTEM.CFG containing the line RESETKB=0. (The default bootloader action is to reset the keyboard and wait for acknowledgement). The total power the V6Z80P can delivery to the keyboard and mouse in total is about 100mA, so check the power consumption of your devices (it'll normally be stated on the label).\\
 +
 +The default keymap used by FLOS is that of the UK but this can be changed with the //KEYMAP// command. Keymaps for Germany, France, Italy, Portugal and USA are supplied and an editor is provided (//​KMAPEDIT//​) to make others.\\
 +
 +==== Joystick ports ====
 +Essentially,​ these are wired as per the standard Atari 2600 style. The second fire button is connected to pin 9 (same as on the Amiga). Pin 5 is connected to 3.3volts (via a small resistor (22ohm) so can provide a little power - this should allow Megadrive pads to be used too). Pin 7 is unconnected.\\
 +
 +==== SD cards ====
 +It has been found that some ultra-cheap cards do not work in the V6Z80P (and other hobbyist project boards). Good brand MMC, SD and SDHC cards should all work. \\
 +
 +===== FPGA Start up =====
 +
 +If the FPGA does not receive a valid configuration pattern from the EEPROM upon power on, the status LED will flash slowly (around 1 flash per second). There are various ways to fix this:\\
 +
 +==== Recovery procedure for V6Z80P+ Boards ====
 +
 +=== OPTION 1 ===
 +Assuming there is a working config in Slot 1 - 7 and the problem is just that the Power-On Boot Slot selection is pointing at a bad config:\\
 +
 +  * Power off.
 +  * Install jumper J2 only (or hold down button if one is connected to J2)
 +  * Power on (status led flashes rapidly).
 +  * Remove jumper J2 again (or release button)
 +  * If the LED continues to flash rapidly, install and remove jumper (press and release button)
 +  * The status LED will now flash once, pause about 5 seconds, then flash twice, pause 5 seconds, then flash three times and so on - the number of flashes represents the power-on slot selection. During the pause following the slot selection you require, replace the jumper (or press the button) the LED will then stay on permanently signifying that the slot has been set.
 +  * Power off and remove Jumper J2 (or release the button)
 +
 +=== OPTION 2 ===
 +JTAG configuration - requires suitable Xilinx JTAG cable.\\
 +
 +  * Power off and connect JTAG cable to the V6Z80P.
 +  * Install jumpers J1 and J2.
 +  * Load the most recent OSCA project into Xilinx webpack ISE 10.1 and send the OSCA config .bit file from the PC to the V6Z80P via the Impact option.
 +  * If the bootcode is intact in the EEPROM, the system will start as normal allowing you to load //​EEPROM.EXE//​ via FLOS. If the bootcode checksum fails the screen will flash magenta, then grey, you will need to send the bootcode (.epr file from the bootcode folder) via serial link and then run EEPROM to install it.
 +  * Remove jumpers J1 and J2 next time you power off so that the system automatically configures from the EEPROM.
 +
 +==== Recovery procedure for the older, original V6Z80P Board ====
 +
 +=== OPTION 1 ===
 +
 +With Config PIC firmware v616+ the Active Slot can be changed manually. Assuming there is a working config in Slot 1, 2 or 3 and the problem is just that the power on boot slot selection is pointing at a bad config:\\
 +
 +  * Power off.
 +  * Install jumper J2 only
 +  * Power on (yellow led flashes rapidly - JTAG mode).
 +  * Remove jumper J2 again
 +  * The PIC will reset the active slot to 1 (indicated by 1 pulse of the red LED) The yellow led lights up for 4 seconds then Slot 2 is set (2 flashes of red LED), again there'​s a 4 second pause, finally slot 3 is set (3 flashes).
 +  * Power off only when the yellow LED is lit following the desired slot setting.
 +  * When you power on the active slot will correctly point to slot 1, 2 or 3.
 +
 +=== OPTION 2 ===
 +Remove and reprogram the EEPROM or config PIC externally.\\
 +
 +It is the PIC chip that actually holds the slot selection - you will only need to reprogram the PIC if you have old firmware that doesn'​t support the manual slot selection. If you do reprogram the PIC, use the latest firmware .hex file so that you wont have to do so again. If you reprogram the EEPROM, use "​default.bin"​ from the folder development_files/​v6z80p/​eeprom this also contains the bootcode for SLOT 0.\\
 +
 +=== OPTION 3 ===
 +JTAG config. If none of the first 3 slots contain OSCA:\\
 +
 +  * Power off and connect a Xilinx JTAG cable to the V6Z80P.
 +  * Install jumpers J1 and J2.
 +  * Load the most recent OSCA project into Xilinx webpack ISE and send the OSCA config .bit file from the PC to the V6Z80P via JTAG.
 +  * If the bootcode is intact in the EEPROM, the system will start as normal allowing you to load //​EEPROM.EXE//​ via FLOS. If the bootcode checksum fails the screen will flash magenta, then grey. You will need to send the bootcode (.epr file from the bootcode folder) via serial link and then run EEPROM to install it.
 +  * Remove jumpers J1 and J2 next time you power off so that the system automatically configures from the EEPROM.
 +
 +===== System Start Up =====
 +
 +Once the FPGA has sucessfully configured, its internal ROM attempts to load the system bootcode, which should be located on the onboard EEPROM. If there is a problem, the screen flashes magenta and after trying again, it turns grey. At this point a bootcode file (EG: bootcode.epr) can be downloaded via the serial link (must be 115KBPS). The grey screen condition can also be forced by holding up, right and fire on a joystick in Port 1 
 +at power up. Once FLOS is loaded, the bootcode file can be replaced on the EEPROM using the utility //​EEPROM.FLX//​\\
 +
 +===== Misc =====
 +
 +An OSCA/FLOS emulator for Windows (by Tony Friery) is available in the Contributions/​Tony. This has progressed far enough to allow simple FLOS programs to be tested on the PC. Bear in mind that timing is currently not perfect and certain elements of OSCA (EG: line draw) are not yet emulated.\\
 +\\
 +----
troubleshooting_guide.txt · Last modified: 2017/07/03 18:31 by z00m