CosmosEx V2 Quickstart 20160404
<h1>What you should know before you start</h1>
<p>
This quickstart tutorial is aimed to help get your stock CosmosEx v2 device up and running. 
It's split in three difficulty levels: beginner, intermediate and expert.
</p>
<p>
If your CosmosEx v2 is a SCSI version, please be advised that it is configured to act as a SCSI device by factory.
You have to open up your device and remove two resistor arrays and add a jumper to switch to ACSI mode.
See http://joo.kie.sk/?page_id=668 for a walkthrough with pictures.
You can't sitch the modes just by switching cables!
</p>
<p>
The ACSI only version of CosmosEx v2 is... well, ACSI only.
</p>
</p>
Please be also advised that your CosmosEx is not working well as an internal Harrdrive in a Mega STE - this is due to Ataris ACSI/SCSI bridge card, which unfortunately only supports one SCSI ID. For full operation you need at least two.
<p>
<p>
The CosmosEx (or "CE") is easiest to operate by users that have the following basic knowledge:
</p>
<ul><li>TCP/IP Networks (e.g. IP adresses and basic DHCP usage)</li>
<li>ACSI/SCSI ID allocation
</li></ul>
<p>To complete this quickstart tutorial, you need all of the following:
<ul>
<li>an Atari ST/STe/TT or Falcon 030 system</li>
<li>a CosmosEx Device (v2 for ACSI/SCSI)</li>
<li>an ethernet cable</li>
<li>a DHCP server (e.g. router)</li>
<li>ACSI or SCSI Cable (ACSI cable is provided with your CE)</li>
</ul>
</p>
<p>
For beginners:
<ul>
<li>a HDMI cable</li>
<li>a HDMI capable monitor/TV</li>
<li>an USB keyboard</li>
</ul>
</p>
<p>
Optional:
<ul>
<li>a Raspberry PI compatible WLAN adapter</li>
</ul>
</p>

<h1>The Steps</h1>
<ol>
<li>Start your CE</li>
<li>Access the device</li>
<li>Update the device</li>
<li>Configure the device</li>
<li>Get access to the CE from your Atari</li>
<li>Bliss</li>
</ol>


<i>Optional: Prepare WIFI</i>
<p>
Insert your Raspberry Pi compatible WIFI Dongle into CEs USB port.
</p>

<h2>Start your CE (beginner)</h2>
<p>
Connect the HDMI cable to the HDMI port of your CE and to your monitor/TV. Connect the USB keyboard to the CE.
Connect the ethernet cable to your CE. Make sure the ethernet cable is connected to the internet (double check e.g via a laptop).
</p>
<p>
Turn your CE on. The CE boots and in that process, a lot of textual information will show on the connected HDMI device.
A boot screen ("Yocto") displaying a progress bar will show inbetween. Wait until the CE finished booting.
</p>
<p>
You will see the follwing at the bottom of the screen:
</p>
<p>
<strong>login as:</strong>
</p>
<h2>Start your CE and get access to the CE web interface (intermediate)</h2>
<p>
Connect the ethernet cable to your CE. Make sure the ethernet cable is connected to the internet.
</p>
<p>
Turn your CE on. Let the CE boot for about 30 seconds. The blue HD light should flicker a first time and after a few seconds a second time.
</p>
<p>
The CE should be booted now. Check on your DHCP server/router which IP has been assigned to your CE.
</p>
<p>
Open your browser and enter your CEs IP. You should see the CEs web interface. Navigate to "Config". 
</p>
</p>Skip "Access the device" and proceed with "Update the device".
<p>

<h2>Start your CE (expert)</h2>
<p>
Connect the ethernet cable to your CE. Make sure the ethernet cable is connected to the internet.
</p>
<p>
Turn your CE on. Let the CE boot for about 30 seconds. The blue HD light should flicker a first time and after a few seconds a second time.
</p>
<p>
The CE should be booted now. Check on your DHCP server/router which IP has been assigned to your CE.
</p>
<p>
Open an ssh terminal to your CEs IP.
</p>

<h2>Access the device</h2>
<p>
Login to your device using as user "root" with the password "ce". You should get a command line prompt like this:
</p>
<p>
<strong>root@ce:~#</strong>
</p>
<p>
Now enter the following:
</p>
<p>
<strong>
cd /ce</br>
./ce_conf.sh
</strong>
</p>
<p>
Now the "Main Menu" should appear on your console. This is the same configuration utility you will be able to access from your Atari later on.
</p>

<h2>Update the device</h2>
<p>
Your CE can be easily updated via Internet. Your CE checks on Jookies Website which software versions are the most current. 
Don't worry, no data is transmitted except your devices software version numbers - also it only checks the version when you tell it to do so by entering the "Software update" screen.  
</p>
<p>
Then you can decide to update or not. In most cases it is wise to update, as the software is actively being developed with bugs being fixed and feature requests being added.
</p>
<p>
The configs "Main menu" screen lets you navigate the menu options via cursor keys. Select "Update software". 
</p>
<p>
CE is build out of several components, which have different version numbers - don't worry about that, you'll just update your CE as a whole.
</p>
<p>
Select "From web". Given a working internet connection, you should see your current software status vs the newest one on Jookies website. Give it a few seconds.
</p>
<p>
Now you can decide to "Update" - this process basicly restarts your CE, so don't worry if you won't see anything on the screen for a few seconds, it will come back.    
</p>
<p>
After update the "on web" column should show "the same" on all rows. You are ready to configure your device.
</p>

<h2>Configure the device</h2>
<p>
<strong>ATTENTION: This step is essential to get your CE up and running. Your Atari can't see your CE until you have completed this step successfully!</strong>
</p>
<p>
First, press return on "ACSI IDs config" (or SCSI depending on your device). The easiest configuration here is:
</p>
<p>
<table border=1>
<tr><td>ID</td><td>off</td><td>sd</td><td>raw</td><td>ce_dd</td></tr>
<tr><td>0</td><td><center>*</center></td><td></td><td></td><td></td></tr>
<tr><td>1</td><td></td><td><center>*</center></td></td><td></td><td></tr>
<tr><td>2</td><td></td><td></td><td><center>*</center></td></td><td></tr>
<tr><td>3</td><td></td><td></td><td></td><td><center>*</center></td></tr>
<tr><td>4</td><td><center>*</center></td></td><td></td><td></td><td></tr>
<tr><td>5</td><td><center>*</center></td></td><td></td><td></td><td></tr>
</table>
etc.
</p>
<p>
You can navigate with the cursor keys to enter this configuration. Press return on "Save" when done.
</p>
<p>
This configuration means the following:
</p>
<p>
Every device connected to your Ataris ACSI/SCSI port needs an ID to be able to communicate - to be called by name, so to speak.
</p>
<p>
Every ID that is "off" in this configuration can be used by other devices other than your CE (see <a href="#remark_1">1</a>). The other IDs are used by your CE, and yes, here it emulates 3 devices in total.
</p>
<p>
Your Atari normally boots only one device - so if the SD-Card is bootable, the boot process won't check the following devices.
First is the SD card slot (the slot in front of your CE). This will be accessed first and checked for a bootable
Atari formatted SD card. Second, there is "raw" - this is used for Atari-formatted USB sticks NOT for DOS/Windows formatted ones.
</p>
<p>
The third device (ce_dd) is used to autoboot the CE_DD driver. 
You need this driver to access "translated drives", drives like Windows formatted USB sticks or Shared Folders. 
</p>
<p>
The Files on these Drivers are basically read by your CE and emulated into an Atari readable device by this driver.
</p>
<p>
Now your CE knows how to answer when your Atari tries to start a conversation. 
</p>

<h2>Optional: Configure WIFI (expert)</h2>
<p>
Go to "Network settings" and enter your Wifi-SSID in "WPA SSID" and your WPA2-Password into "WPA PSK". 
</p>
<p>
You probably should leave "DHCP" checked, but you can enter a fixed IP if necessary.
</p>
<p>
After saving, the setting should be active after a few seconds. Ping your CEs Wifi IP to check if everything is OK.
</p>


<h2>Get access to the CE from your Atari</h2>
<p>
Now power OFF your CE - you shouldn't connect any device to your ST while that device is powered on.
</p>
<p>
You can now disconnect HDMI and keyboard again - you shouldn't need these for the next step. But you might keep them nearby,
for troubleshooting purposes.
</p>
<p>
Connect the SCSI or ACSI cable between your Atari and your CE. Remove any SD card you might have inserted in the front SD slot.
Also remove any disks you might have in your foppy drives.
</p>
<p>
Make sure that only one device (that being your CE) is connected to your ACSI/SCSI port. We don't want to complicate things just now.
</p>
<p>
Turn on your CE. 
</p>
<p>
Wait for about 30 seconds for the CE to boot - the HD led should flash a first time and then, after a few seconds, a second time.
</p>
<p>
Turn on your Atari.
</p>
<p>
Now the Atari should boot the CE DD driver. This may take a while, because first your Atari might try to access the empty floppy drive.
</p>
<p>
When booted, your Atari should show you a desktop with the drives A,B and O. Open the drive O. 
</p>
<p>
This drive should contain a set of CE-specific tools. Congratulations, your CE is configured correctly!
</p>


<h2>Bliss</h2>
<p>
Now you can insert a SD card and format it from your ST. Or you can mount a network drive. Or insert an USB stick with software. Or use the
web interface. Or connect the floppy emulator. Well, you know, all that.
</p>


<h1>Troubleshooting</h1>
<ul>
<li>if, for any reason, your CE isn't booting, download the CE configuration tool from http://joo.kie.sk/?page_id=474.
Start this on your Atari and see if it does see your CE. If it doesn't, re-check your configuration.</li>
<li>if the config tool sees your CE, but doesn't boot, check your SD card</li>
<li>if your SD card seems OK, try to configure CE_DD on a lower ID. It should boot first - just to be sure any device boots at all.</li>
<li>if none of this is working, try to load a harddisk driver (e.g. ICD,HDDRIVER,PPera driver) from floppy and see if it's recognizing our CE. Make sure an SD card is inserted.</li>
<li>try to change the SD card - not all SD cards are working properly, beware of the cheap ones. Kingston proved to be very reliable so far.</li>
<li>if, for any reason, the CE can't be accessed via network, access it via USB keyboard and HDMI display. Check through ifconfig etc. if the network is up and running.</li>
<li>access the web interface and access the debug information page (via the link on the first page). Download the app log. See if anything out of the ordinary is in there. </li>
</ul>

<p>
<a name="remark_1">(1)</a> There are known incidents where CE did not work with other ACSI devices in a chain: <a href="http://atari-forum.com/viewtopic.php?f=103&t=29642">http://atari-forum.com/viewtopic.php?f=103&t=29642</a>.
</p>