Logo

Retro computing with a touch of modern and the home for all things, retroCombs (aka Steven Combs).

Disclosure Statement: When you click on links to various merchants on this site and make a purchase, this can result in this site earning a commission. Affiliate programs and affiliations include, but are not limited to Amazon, the eBay Partner Network, and/or others.

28 June 2016

Things to know about your new Pocket C.H.I.P.

by Steven B. Combs, Ph.D.

I’ve had fun playing with the Pocket C.H.I.P. since it landed on my door. While I do plan to write a full review at some point, for now, I have ten things to share that might be of interest to new users of the geekiest gadget I have ever owned.

Pocket C.H.I.P.

New updates and additions on: December 18, 2016

Table of contents below so you can jump to a specific section.

A browser is built in

The Pocket C.H.I.P. has a built in browser called surf.

Try this: in the Terminal type:

surf google.com

The Google search page will load. You will most likely have to scroll up/down and left/right to see the page. This is a very rudimentary browser with no user interface save for the scroll bars and some keystroke combinations (see below). In a pinch though, it is useful. To exit the browser, use the ctrl + q keyboard combination.

Try This: Reader buergi provided the surf keystrokes below:

ctrl + g: goto URL (opens URL bar) ctrl + h: back ctrl + l: forward ctrl + r: reload ↑ or ↓ or → or ←: select Link ctrl + u or i or j or k: scroll ctrl + ↑ or ↓ or → or ←: scroll ctrl + b: scroll pagewise ctrl + o: switch between page/source ctrl + f or ctrl + /: search in page ctrl + n: next result ctrl + shift + n: previous result ctrl + q: quit

Use a Terminal browser

Download a terminal text-based browser to provide quick access to information (sans graphics). A couple of my favorites include w3m, lynx and elinks.

Try this: Install elinks using the following terminal commands:

sudo apt-get update
sudo apt-get install elinks

When the installation is complete try this:

elinks stevencombs.com

The Terminal will display this site in all its text-based glory. Use the tab and arrow keys to navigate.

Help is available

There is an excellent online bulletin board system (BBS) full of users and Next Computing staff to provide assistance and support. It is located at https://bbs.nextthing.co/. The community is quick to answer questions. Be sure to search the BBS before you post a question. You will most likely find an answer immediately. Before heading to the BBS though, review the documentation at:

http://docs.getchip.com/pocketchip.html

The BBS community has been instrumental into the quality and accuracy of this post. Be sure to see the bonus “things to know” at the bottom of this post. Many “things to know” were provided by this group and I update this post frequently based on their suggestions. You may want to return in a day or two to see what I add.

Use the app switcher

Do not hit the home button to get back to other apps or the Terminal. The included task switcher will cycle through running applications. Use the following keyboard combination to switch applications:

ctrl + tab

Tiny screen

Not all software will display properly on the small LCD screen and you may not be able to access all UI elements. There is no pinch and zoom currently and this is likely not an option. One option would be to have a utility that will scale the screen in some way so as to access all controls. Keeping my fingers crossed that some enterprising developer will find a way to take care of this.

Calibrate the touch screen

If your resistive touch screen (not capacitance like screens found on tablets and phones) is giving you fits, you can calibrate it using these instructions:

http://www.chip-community.org/index.php/Troubleshooting#Calibrating_Touchscreen_on_PocketChip

Play retro style games and learn to program

Pico 8 is a fabulous app that not only let’s you play retro style games, but also learn/teach basic programming skills using the Lua programming language. Check out these excellent resources to get started:

https://github.com/felipebueno/awesome-PICO-8

Use as a calculator

Use the included Python programming language as a built in calculator.

Try This: in the Terminal type:

python

The python prompt will appear. Type:

2+2 followed by the return (↩) key

Python will display the sum. To exit the Python interpreter, type:

ctrl + d

or

ctrl + q to exit the Terminal back to the home screen. {Thanks to Adam Higerd for the details and correction!}

Check out the resource below for additional calculator functions:

https://docs.python.org/3/tutorial/introduction.html

For a more traditional calculator, try this:

In the Terminal type:

xcalc

Your Pocket C.H.I.P. is now an old school basic functions calculator as shown in the image below. This application makes great use of the Pocket C.H.I.P.’s touch screen. Thanks to midheaventech.

xCalc on Pocket C.H.I.P.

Use a full-size keyboard

The Logitech K400 keyboard is an awesome external keyboard not only for a Raspberry Pi, but also the Pocket C.H.I.P. Plug the dongle into the USB port to make Pico 8 programming easier with the tiny little screen.

Control from a computer

Don’t purchase an external keyboard. Control your Pocket C.H.I.P. using your computer keyboard and trackpad/mouse. Follow my Raspberry Pi x11vnc instructions. They work just as well on the C.H.I.P.

Controlling the Pocket C.H.I.P. via x11vnc

Play Minecraft

(Added December 18, 2016) Minecraft is what all the kids are playing. Since the original release of the Pocket C.H.I.P., users have been asking, how do I play Minecraft on the Pocket C.H.I.P.? Next Thing Co. heard the pleas of the masses and created step-by-step instructions on their blog. Both individual and multiplayer options are available. Grab that pickaxe folks!

Learn Linux Terminal commands

(Added: August 21, 2016) You will want to learn how to use Terminal commands. One of the best features of the PocketC.H.I.P. is the ability to carry a full fledge Linux Terminal in your pocket. For students in computer science or information security courses, this can be a huge advantage to learning.

Below are my two favorite resources to learn Linux Terminal commands:

I’ve been pouring through this book for days. I can easily throw the book and my PocketC.H.I.P. in my bag. When I have some free time, I take both out to learn more about Terminal commands. It’s a very geeky combination. To this day, I cannot believe I didn’t know about the simple cal command. As an educator, I also plan to recommend this package to students.

This is a free resource. The site loads quickly and you can browse the site on your PocketC.H.I.P.

Watch Star Wars

Watch the original Star Wars story unfold on your Pocket C.H.I.P. Try this: in the Terminal type: sudo apt-get update, followed by sudo apt-get install telnet followed by telnet towel.blinkenlights.nl. Use ctrl + ‘j’ to close the telnet session and ctrl + ‘l’ to clear the Terminal.

Star Wars on the C.H.I.P.

Replace the bash

(Added: August 13, 2016): The PocketC.H.I.P. includes the standard bash shell; however, you can replace this with another shell called fish for more features. Below is an image of the changes available with this new shell environment.

Intrigued? Visit my fish on C.H.I.P.s blog post to learn more.

Bonus tips from the community

WARNING TIPS

Thanks to senkun for these tips.

Don’t peel off the plastic film off the super clicky buttons. The film holds the buttons in place.

and

When charging, be careful when plugging and unplugging the micro USB plug. On some units the connector on the CHIP isn’t soldered properly and may just get ripped off.

I felt it important to add these two warnings so new owners have a good first experience and realize that these devices can be a bit fragile if not handled correctly.

When my Pocket C.H.I.P. first arrived, I too wondered if I should peel off the keyboard plastic covering, but quickly decided against. New owners might consider doing this and this would not be good!

Customize the home screen

(Updated: August 13, 2016): (marshmallow from the BBS): The PocketC.H.I.P. includes a home screen; however, you can replace it with an outstanding, and in continual development, replacement called Pocket Home. It’s an easy install and the home screen replacement provides some great features such as adding and deleting items and changing the background color or image.

Learn more on the Next Thing Co. BBS post from marshmallow

Add a speaker

(bmjohnsn from the BBS) It would appear at first blush that the Pocket C.H.I.P. requires headphones for sound; however, with this clever little soldering hack, you can add a small 3 watt amp and speaker (or two for stereo) to the inside of the Pocket C.H.I.P. case. This is another hack and it requires some soldering skill; however, it is way cool and a project on my list of things to do (or possibly a variation).

Emulate games

(bmjohnsn from the BBS) bmjohnsn recommends this Nintendo-centric retro gaming link:

https://bbs.nextthing.co/t/mednafen-emulator-configuration-gbc-gba-snes-nes/5027

However, I’m more of an 80s gaming retro fan and am anxiously awaiting VICE support for Commodore computing. How awesome would that be?

UPDATE: The Rift Conspiracy provides instructions to download and configure the VICE emulator for the Pocket C.H.I.P. I’ve installed (see image below), but have not tried any games or applications yet. I hope to do so soon.

VICE on Pocket C.H.I.P.

Install Doom and a launch Icon

The official Next Thing Co. blog now provides instruction to install Doom and include a launch icon to the home screen. It’s a bit of a hack, but does show active development and is a fun way to learn more about your little hand held Linux box.

Install Doom & give it an icon on the home screen

Join the discussion

Have something else I should add to the list that other Pocket C.H.I.P. owners should know? Drop in the comments below. I would love to read your suggestions.