infra: Adding 'Getting Started' scripts and updating README

Signed-off-by: David Shah <[email protected]>

.gitignore

@@ -6,3 +6,4 @@ ispTcl.log.*
 ispTcl.tcl
 ispTcl.tcl.*
 .ispTcl.lock
+work_*/

README.md

@@ -18,16 +18,25 @@ the bitstream format for the Xilinx Series 7 devices.
 
 # Quickstart Guide
 
+Currently Project Trellis is tested on Arch Linux and Ubuntu 17.10.
+
 Install the dependencies:
  - Lattice Diamond 3.10
  - Python 3.5 or later, including development libraries (`python3-dev` on Ubuntu)
  - A modern C++14 compiler (g++ or Clang recommended)
- - Boost
+ - CMake 3.8 or later
+ - Boost including boost-python
 
 Pull submodules:
 
     git submodule update --init --recursive
 
+For a generic environment:
+
+    source environment.sh
+
+Optionally, modify `user_environment.sh` and rerun the above command if needed.
+
 Get a head start by downloading current database:
 
     # Give the argument;
@@ -36,13 +45,11 @@ Get a head start by downloading current database:
     # - git if you want to use the git protocol
     ./download-latest-db.sh
 
-For a generic environment:
+Alternatively, if you want to start from scratch:
 
-    source environment.sh
-
-TODO: device specific environments, like X-ray
+    ./create-empty-db.sh
 
-Build libtrellis:
+Build and test libtrellis:
 
     cd libtrellis
     cmake .

create-empty-db.sh

@@ -0,0 +1,7 @@
+#!/bin/bash
+rm -rf database
+mkdir -p database
+echo '*' > database/.gitignore
+cp devices.json database/
+python3 tools/get_tilegrid_all.py
+python3 tools/create_empty_bitdbs.py

download-latest-db.sh

@@ -0,0 +1,7 @@
+#!/bin/bash
+
+GITHUB_PROTO=${1:-https}
+GITHUB_URL=$GITHUB_PROTO://github.com/SymbiFlow/prjtrellis-db.git
+rm -rf database
+git clone $GITHUB_URL database
+echo '*' > database/.gitignore