Create a physical and interactive object or experience.

SKILLS

This project is a culmination of all of the skillbuilding you’ve done this semester. As such, we expect you to incorporate as much of the things you’ve learned as is possible/feasible/desirable for your project. That being said, don’t shoehorn things in that don’t fit, just to check off boxes.

DATES

Tuesday, April 18th — Final Project Proposals Due
Thursday, April 20th — CMU Holiday, No Class
Thursday, May 4th — Final Project Critique
Tuesday, May 9th — Final Project Documentation Review (In Class Viewing)

DETAILS

Requirements:

• At least one physical I/O component
  • Sensor or Actuator
• Computation
  • This project requires some analysis of input data: filtering, deciphering, projecting, predicting, etc.
• Physical form
  • The physical characteristics of your project must be considered and intentional.
• Documentation
  • High fidelity video explaining and demonstrating the project
    • Must be shot on a DSLR or better
    • Intentional lighting (outside, near window, in a studio, in a gallery, etc)
    • Tripod. Stability. No shaky cams.
  • At least one high resolution photograph of your project.
  • Brief written description of your project, explaining the purpose and components.

PROMPT

Create a virtual world that affects and is affected by the physical one.

DATES

3/21: Kickoff & Three.js Workshop
3/23: Three.js VR Workshop
3/28: Socket.io & Johnny-Five Workshop
3/30: Work Day
4/4: Crit

DETAILS

This project has three main components:
* Create a custom Google Cardboard that fits your personal phone, and potentially incorporates sensors, actuators, an Arduino, and/or a Raspberry Pi.
* Create a Node.js server capable of reading sensors/writing to actuators on an Arduino/Raspberry Pi.
* Create a Three.js Virtual Reality world capable of conversing with the server.

CODE

Github Repo

Node.js Documentation
Express Documentation
Pug Documentation
Socket.io Documentation
Johnny Five Documentation

1. Download three.js from three.js website.

2. Follow the Getting Started tutorial. We’ll go over this together.

3. Import an external model into your project:

Save the file from here into a file called OBJMTLLoader.js, within your three.js folder.

Include this code to import an OBJ with materials:

var objMtlLoader = new THREE.OBJMTLLoader(); // create the OBJ loader

objMtlLoader.load("filename.obj", "filename.mtl", function(object, url) { // load the OBJ and companion MTL
    scene.add(object); // add it to the scene
});

Burning Raspbian to an (micro)SD Card

For Mac:

brew cask install etcher

For Windows:

Download and install Etcher: https://etcher.io/

Flash the image

1. Open Etcher
2. Select the Raspbian image
3. Select the drive to which you want to burn
4. Double check your selections
   • This is critical, as you run the risk of overwriting the wrong drive (including your primary hard drive)
5. Click “Flash!” and wait until Etcher writes and validates the image. This can take around 10 minutes.
6. Once finished, eject your SD card

Ports

Plugging in your peripherals

1. HDMI
2. Keyboard and Mouse
3. MicroUSB Power Supply (5V/2.1A)

Boot for the First Time

Get your MAC Address

1. In the Raspberry Pi GUI, click the Terminal icon in the top left toolbar
2. Run the command ifconfig
3. Locate the wlan0 section and find and write down the HWaddr; it should look something like: b8:27:eb:00:00:00
4. This is the MAC Address for your wireless adapter on the Raspberry Pi; you will use it to register the Pi on the network

Register with the CMU Legacy Network

1. Go to https://netreg.net.cmu.edu/
2. Enter and select the link to “Register New Machine”

Select the “Legacy Wireless Network” and click the in-line “Continue” button.

Enter a name for your Raspberry Pi

Enter the wlan0 MAC address from the raspberry pi

Now we wait…

Changing the Default Settings

1. Open Raspberry Pi Menu > Preferences > Raspberry Pi Configuration
   

System

1. Change Password
2. Change Hostname
3. Boot to CLI
   

Interfaces

1. Set everything to enabled, except VNC
   

Reboot

Open Terminal and type

sudo reboot

CRON

1. Cron is a task scheduler
2. You can add tasks to cron using the crontab

The command

sudo crontab -e

will take you to the root crontab, meaning your tasks will run regardless of which user is logged in

You can also use special signifiers

A common example is to start a program a few seconds after startup:

@reboot sleep 10 && /usr/bin/nodejs /path/to/nodescript.js

Connecting to WiFi

1. This is easiest to do in the GUI
2. To enter the GUI from commandline mode, run the command startx
3. Find the WiFi icon and select CMU

We are going to test to see if our connection has propagated by running the command

ping google.com

If it returns with a list similar to this:

PING google.com (68.65.124.44): 56 data bytes
64 bytes from 68.65.124.44: icmp_seq=0 ttl=60 time=12.702 ms
64 bytes from 68.65.124.44: icmp_seq=1 ttl=60 time=13.478 ms
64 bytes from 68.65.124.44: icmp_seq=2 ttl=60 time=13.880 ms
64 bytes from 68.65.124.44: icmp_seq=3 ttl=60 time=12.818 ms

then you are connected. If not, keep waiting.

SSH

1. Once your pi is on the CMU network, you should be able to SSH into the device from your laptop
2. Run the command (but fill in your own info)

   ssh $USER@$URL

for example ssh pi@hostname.wv.cc.cmu.edu

It will ask if you want to add this to the list of known hosts, type Yes

Updating Packages

Linux has a built-in package manager called apt-get

We need to update the list of package repositories:

sudo apt-get update

Next, we want to get the newest versions of all our packages:

sudo apt-get upgrade

(this may take a while and require some user confirmation)

Installing Packages

Raspbian comes with Node.js installed, but the version is very old.

We need to add a new repository to our package manager:

curl -sL https://deb.nodesource.com/setup_7.x | sudo -E bash -

Now, install Node.js:

sudo apt-get install nodejs

Install and Configure Samba

Install Samba with:

sudo apt-get install samba

Go to the Samba configuration folder:

cd /etc/samba/

Rename the configuration file (so we have a backup):

sudo mv smb.conf smb.conf.original

Make and edit a new one:

sudo nano smb.conf

1. Copy this into new file:

[global]
    workgroup = WORKGROUP
    netbios name = SAMBA
    server string = Samba Server %v
    map to guest = Bad User
    log file = /var/log/samba/log.%m
    max log size = 50
    socket options = TCP_NODELAY SO_RCVBUF=819SO_SNDBUF=8192
    preferred master = No
    local master = No
    dns proxy = No
    security = User

    # Share
    [Data]
        path = /
        valid users = pi
        read only = No
        create ma19 = 0755
        directory mask = 0755

Set up a new password:

sudo smbpasswd -a pi

Restart the Samba service:

sudo service smbd restart

1. On your Mac laptop, you can now mount the Raspberry Pi filesystem on your computer by going to Finder and typing ⌘+k
2. Enter smb://pi@$yourIPAddress
   

Getting the example code

1. Clone the repo to your Pi by running

   git clone https://github.com/Making-Things-Interactive/button-twitter.git

Raspberry Pi 3 Pinout

JavaScript Object Notation is a data format used extensively on the web. It was developed for easy parsing within JavaScipt.

JSON is written in key|value pairs "first_name" : "John"

• Array:

{
  "employees" : [ "John", "Cody", "Olivia"]
}

• Objects can have several sub-object:

{
  "employee" : { 
    "name" : "John", 
    "age" : 82,
    "city" : "Canada"
  }
}

• An object with objects and an array:

{
  "name" : "Stephano",
  "age" : 34,
  "friends" : ["Susan", "Eric", "Katie"],
  "datetime" : "20170215T123719"
}

Example JSON from the Twitter API

{ 
  created_at: 'Wed Feb 08 21:37:22 +0000 2017',
  id: 829444033101586400,
  id_str: '829444033101586440',
  text: 'In a Rare Zoo Escape, Sunny the Red Panda Is Still at Large https://t.co/mhOT4z8NIu https://t.co/8vHtTlqbmQ',
  display_text_range: [ 0, 83 ],
  source: '<a href="http://publicize.wp.com/" rel="nofollow">WordPress.com</a>',
  user: { 
    id: 972385555,
    id_str: '972385555',
    name: 'Walkileaks',
    screen_name: 'walkileaks',
    location: 'United States',
    url: 'http://www.walkileaks.com',
    protected: false,
    utc_offset: -28800,
    is_translator: false,
    notifications: null 
  },
  geo: null,
  coordinates: null,
  place: null,
  contributors: null,
  is_quote_status: false,
  retweet_count: 0,
  favorite_count: 0,
  entities: { 
    hashtags: [],
    urls: [ [Object] ],
    user_mentions: [],
    symbols: [],
    media: [ [Object] ] 
  },
  extended_entities: { media: [ [Object] ] },
  timestamp_ms: '1486589842473'
}

PROMPT

Turn an ordinary device into something connected to the Internet of Things.

DETAILS

You will augment a physical device with a Raspberry Pi to connect it to the internet, and allow it to perform a function it couldn’t perform before. You will work on your own to complete the project. As with Project 1, your main focus should be on ideation, but you should also begin to think about how well crafted your project is.

Feel free to use one of the below possibilities, or create your own.

This project hones some of the skills you learned in Project 1 (basic electronics and rapid prototyping), and also introduces some new ideas: embedded computing and networking.

POSSIBILITIES

• A physical Alarm Clock that syncs with your calendar
• An Umbrella that lights up when it is going to rain
• Headphones that mute themselves when someone is trying to get your attention
• A Water Bowl for a pet that alerts your phone when it is empty
• A power strip that doesn’t turn on until your To-Do list is cleared

SKILLS

• IFTTT (Maker Service)
• API Integration
• Sending an email

PARTS

• Raspberry Pi
• Any additional parts you may have leftover from Project 01

(How to control two motors with one H-Bridge)[http://blog.whatgeek.com.pt/2015/03/arduino-l293d-dc-motors-control/]

I can never remember which side of an acrylic sheet I’m supposed to peel the paper from to get the best quality cut. This article from Ponoko recommends leaving the paper on the bottom of the sheet (to reduce damage from flareups in the bed), and to remove the paper from the top UNLESS you’re doing heavy/a lot of engraving on the sheet.