cleaner outputs, added README, added HW portions