You don't have a TV?
To set up a new CHIP without a display available, you'll need to:
- Connect to it using serial communication over the micro USB port from another computer
- Configure WiFi settings so it can connect to your LAN
- (Optionally) Install a VNC server so you can log into the GUI from another computer
Connecting to CHIP by USB
If you plug your CHIP into another computer (a "host") via a cable connected to the C.H.I.P.'s microUSB port, it will appear to the host as a serial communications device (specifically, a USB-connected modem). Then you can use a terminal emulator on the host to log into a shell on CHIP. The Turn it on#Simple shell page has complete instructions.
The CHIP OS's default user account is
chip, with password
chip. This account has
sudo access, so you shouldn't need to use the
root account directly, but if you do, its password is the same.
You can use any Linux computer as a host if it has reasonably standard USB hardware and Linux software. Possible hosts include a Linux desktop or laptop or a small computer such as a Raspberry Pi or even another C.H.I.P. (If you are using a small computer, make sure it can supply sufficient power to the target C.H.I.P via its USB port.) Many standard Linux distributions pre-install the device driver for a USB-connected modem. If this driver is installed, then when you plug the C.H.I.P. into a USB port on the host, it will (eventually, after it boots all the way) appear on the host as a serial console port named /dev/ttyACM0. Note: if this driver is already supporting some peripheral on the host, then you will already have a /dev/ttyACM0, and the C.H.I.P. will appear as /dev/ttyACM1 or some higher number. After this port comes into existence, you can use any serial-port terminal emulator program on the host to connect to it. So:
- verify that you have serial tty emulator program (e.g., minicom or putty) installed on the host. If not, install one.
- on Ubuntu or Debian:
apt-get install minicom
- With C.H.I.P disconnected,
This lists all USB serial ports already supported by the ACM driver before you plug the C.H.I.P in. You probably have none at all.
- Plug the C.H.I.P into a suitable USB port on the host using a USB-A-to-microUSB cable
- Wait for the C.H.I.P to complete its boot sequence (patience, grasshopper!)
- Issue the ls command again. It should now have one additional entry, (probably the last one, and likely the only one as /dev/ttyACM0)
Now run your serial tty terminal emulator and configure to connect to the correct serial port. If you just installed minicom and don't know how to use it, then look at its documentation:
- you should now see the C.H.I.P.'s login prompt, so proceed to the section below.
Some rough instructions are available on the forum; hopefully someone can clean them up and put them here.SSH connection.
Connecting To WiFi From The Command Line
Now that you have established a command-line login session over the USB, you can configure WiFi so CHIP can connect to your wireless network. Run the following commands on CHIP, via the terminal connection you established above, not on the host PC. (Note: An alternative WiFi set-up procedure is outlined on Next Thing Co.'s website.)
/etc/network/interfaces, using nano or vi
- Add lines:
auto wlan0 iface wlan0 inet dhcp wpa-ssid YOUR_SSID wpa-psk YOUR_PASSWORD
YOUR_SSID is the WiFi network's name, and
YOUR_PASSWORD is the password.)
- Save changes and exit the editor
sudo dhclient wlan0to acquire an IP address from the DHCP server
/sbin/ifconfig wlan0, which will output CHIP's IP address — it's on the second line, after
Now you can use the IP address to log into CHIP from another computer via SSH. For example, if its IP address is 10.0.1.8, you could use the command
Note: CHIP's IP address might change periodically, especially after it's rebooted, because the DHCP server in the WiFi router hands out IP addresses dynamically. This can be a pain if you lose the IP address and can't SSH to it anymore! Two ways around this are to edit the router's configuration to reserve a fixed IP address for CHIP, or to install Avahi so the CHIP can advertise itself using an mDNS (aka Bonjour) hostname like
Once SSH is working, you can disconnect CHIP from USB.
Configuring a Remote Desktop (VNC)
If you want to use CHIP's GUI, follow the VNC setup instructions so you can log into it from another computer.