EclaireXL

h1. Introduction

For now please see the general core manual on the main page.

http://www.64kib.com/

h1. Power requirements

USB B 5V input. 500mA is enough but I'd go with 1-2A to give some extra for any connected devices.

h1. Core location

h2. v1 prototype (initial run on 5)

http://www.64kib.com/autobuild/private/prototype_v1/

(changes: http://www.64kib.com/autobuild/private/prototype_v1/changes)

h2. v3 (aka v2!) prototype (run on 10 and subsequent run of 20, with fixes)

http://www.64kib.com/autobuild/private/prototype_v2/

(changes: http://www.64kib.com/autobuild/private/prototype_v2/changes)

h2. v3.1 (aka v3!) prototype (only Panos has one)

http://www.64kib.com/autobuild/private/prototype_v3/

See the file changes for what I've changed.

h1. Issues to solve for final board (solved in v2 fix)

* Remove video DAC and audio ADC power supplies.

* Verify footprint of main board IO area vs standard. Power switch does not fit?

* Adjust paddle voltage level potential divider.

* Fix black 'éclaireXL' 

* Widen cutout next to pbi from 3.7 to 4.75mm (or more)

* Change REF_N pull up from 4k7 to about 2k.

h2. Potential improvements

* Think again on the sub-board vs external board?

* Header to connect SIO LED to case

* Support hardware to allow main case switch to turn board on/off. Not sure how to go about this...

* Power on switch invert up/down on/off to match 800XL!

* Use 5V boost/buck regulator to give stable 5V

h1. Board setup videos

I put together some basic videos for the v2 boards:

https://www.youtube.com/playlist?list=PLYGeDt6lv-p5R4DwdcHtmYUbfL6lOcYLb

h1. SD card setup

The OS and basic rom are loaded from the flash chip in the new cores, this can still be overridden by the sd card as discussed here:

http://www.64kib.com/redmine/boards/1/topics/22?r=26#message-26

h1. Flashing

Its possible to flash the .sof using the USB blaster, but this only lasts until the board is restarted.

To do this:

#Connect power to the board

#Connect the jtag

#In quartus go to tools->programmer

#In the programmer select 'add file' and choose the .sof file

#Tell it to start

To store on the flash chip you need to make a .jic file. The v1 board has a chip compatible with the EPCQ128. The v3 board has a chip compatible with the EPCS128.

h2. Making a jic file from a sof

I now tend to always make and post .jic files with each release, so this is really just a FYI.

# In quartus go to file->convert programming files

# Select programming file type 'jtag indirect programming file'

# Select configuration device (v1:EPCQ128, v3:EPCS128, v3.1:??)

# Select mode: Active serial

# Set appropriate file name

# In 'input files to convert' select 'flash loader' and click 'add device' on the right

# Select 'Cyclone V' on left and the correct FPGA on the right (v1: 5CEBA2, v3: 5CEBA4)

# In 'input files to convert' select 'sof data' and click 'add file'

# Select the .sof file to convert 

# Select properties on the new line and enable 'compression'

# All done, click ok to save .jic file

# Then flash using the programmer as you would with a .sof - it takes longer but it will last over a reboot

Alternatively I'll post .jics from time to time...

h2. Flashing a core from the SD card

In recent cores (v21 and up) its possible to update from the SD card.

This is done by:

* Copy vxx.rpd file to your SD card

* Press F11

* Select program RPD

* In file selector choose the core version to upgrade to

* Wait a few minutes while it flashes. If you turn it off, there is a power cut or it fails for another reason then you will need a USB blaster to recover.

h1. Svideo/composite on v2

On the v2 board svideo and composite are output via the vga connector:

For svideo luma is on the green output and chroma on the blue output.

For composite luma is on the green output. 

h1. Board information

[[Pinouts]]

h1. Keyboard mapping

The keyboard is mapped to match the standard Atari keyboard layout. It assumes you are using either an ISO or ANSI keyboard. I highly recommend buying stickers from here: https://www.4keyboard.com/commodore/591-2840-commodore-atari-non-transparent-keyboard-stickers.html

For an ISO keyboard:

!http://www.64kib.com/autobuild/keyboard.JPG!