zerkman / zest

Implementation of an Atari ST in VHDL for Xilinx-based FPGAs

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

[Not an issue] my howto

shazz opened this issue · comments

@zerkman, if it can help... I will update it :)

HOWTO

How to connect to the board

Windows, using Putty / Kitty

  1. Connect the board to the UART usb-c port

  2. open a serial communication

    • COM8 (check with Device Manager)
    • 921600 bauds
  3. Type space then login as root (no password)

Using Minicom over WSL2

  1. Connect the board to the UART usb-c port
sudo apt-get install minicom
sudo minicom -s

Configure:

  • port to ttyUSB0
  • speed to 921600

MISSING: over params to avoid weird characters

How to restart / stop / start zest from the board

Connect to the board then:

/root/zestboot restart
/root/zestboot start
/root/zestboot stop

How to create an ASCI HD image using linux and Hatari tools

wget https://launchpad.net/ubuntu/+archive/primary/+sourcefiles/hatari/2.4.1+dfsg-2/hatari_2.4.1+dfsg.orig.tar.xz
tar -xvf hatari_2.4.1+dfsg.orig.tar.xz
cd hatari-2.4.1/tools
./atari-hd-image.sh 40

1) Create DOS Master Boot Record / partition table...
CHS:   0,  0,  2 @ $1bf
CHS: 159, 15, 32 @ $1c3
CHS: 160,  0,  1 @ $1cf
CHS: 160,  0,  1 @ $1d3
CHS: 160,  0,  1 @ $1df
CHS: 160,  0,  1 @ $1e3
CHS: 160,  0,  1 @ $1ef
CHS: 160,  0,  1 @ $1f3
0000000 00 00 00 00 00 00 00 00 00 00 00 00 02 02 01 00
0000020 00 00 00 00 00 f8 00 00 20 00 10 00 00 00 00 00
0000040 01 40 01 00 80 00 00 00 00 00 00 00 00 00 00 00
0000060 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
*
0000660 00 00 00 00 00 00 00 00 00 00 00 00 00 00 80 00
0000700 02 00 06 0f 20 9f 01 00 00 00 ff 3f 01 00 00 00
0000720 01 a0 00 00 01 a0 00 40 01 00 00 00 00 00 00 00
*
0000760 01 a0 00 00 01 a0 00 40 01 00 00 00 00 00 55 aa
0001000

2) Create an Atari TOS compatible DOS partition...
Sectors: 81920, sectors/track: 32, clusters: 40960
Doubling sector size as >32765 clusters -> 20480 clusters
mkdosfs -A -F 16 -n DOS -C hd.img.part 40960
mkfs.fat 4.2 (2021-01-31)
Warning: More than 32765 sector need TOS 1.04 or higher.

3) Copy the partition to disk image...
dd if=hd.img.part of=hd.img bs=512 seek=1 count=81920
81920+0 records in
81920+0 records out
41943040 bytes (42 MB, 40 MiB) copied, 0.102019 s, 411 MB/s

4) Cleaning up...
rm -f hd.img.part
Done.

How to transfer a file to the sdcard

Using WSL2 and usbipd

In an admin powershell

winget install usbipd
usbipd list

Connected:
BUSID  VID:PID    DEVICE                                                        STATE
1-1    1a86:7523  USB-SERIAL CH340 (COM8)                                       Not shared

usbipd bind -b 1-1
usbipd attach --wsl --busid=1-1

In WSL2

Note: minicon should be installed and configured.

sudo apt install linux-tools-generic hwdata
sudo update-alternatives --install /usr/local/bin/usbip usbip $(command -v ls /usr/lib/linux-tools/*/usbip | tail -n1) 20

sudo usbip port
Imported USB devices
====================
Port 00: <Port in Use> at Full Speed(12Mbps)
       QinHeng Electronics : CH340 serial converter (1a86:7523)
       1-1 -> usbip://172.25.144.1:3240/1-1
           -> remote bus/dev 001/001

sudo minicom 

Send file over z-modem

open the minicom session, go to /sdcard/
type CTRL+a S then select file to send

If you need to connect from Windows, unbind the device from wsl2:

usbipd unbind -b 1-1

How to mount the HD image on /mnt/C

cd /sdcard
/root/zestboot stop
mkdir /mnt/C
mount -oloop,offset=1024 -tmsdos hd40.img /mnt/C

Then do whatever you like in /mnt/C

Unmount the hard drive:

umount /mnt/C
/root/zestboot start