• Abstract and Figures
• Public Full-text

Portable Intellivision Development Environment for Phones December 27, 2019 Setting up a Portable Intellivision Development Environment on Your Android Phone Written by Michael Hayes [email protected] Date of Last Modification: December 27, 2019 (Note: don’t let the length of this document intimidate you. It’s designed to be easy-to- follow, not concise. Also, this is something you will only have to do once.) Introduction You have a portable Android phone and a physical keyboard connected to it. You now have some experience developing in IntyBASIC. You would like to do future development using only your phone and keyboard, so you can develop anywhere you’re at in the cracks of time in your busy schedule. You may not know a darn thing about Linux and can’t be bothered to “root” your phone. This document is for you. Disclaimer I feel it is imperative to put this on the first page: Neither I nor Midnight Blue International, LLC are responsible for anything bad that happens to you or your phone for the use of any of the information in this text. Neither I nor Midnight Blue International, LLC are responsible if you get fired from your job because you got caught writing games on company time. Neither I nor Midnight Blue International, LLC are responsible if your Life Partner walks out on you because you’re too busy making games anymore. Standard data rates apply with your mobile carrier, blah blah blah. You will need: • A phone with Android 7 or higher and about 550M internal storage space. • A physical keyboard for your phone. • A MicroSD card is not required, but recommended. Page 1 of 54 Portable Intellivision Development Environment for Phones December 27, 2019 Table of Contents Revision List ......................................................................................................................... 3 Additional Notes .................................................................................................................. 4 Step 1: Install some apps onto your device. ........................................................................ 5 Step 2: Install the text editor of your choice. ...................................................................... 6 Step 3: Enable Android API calls. ......................................................................................... 7 Step 4: Establish contact with the outside world. ............................................................... 8 Step 5: Download IntyBASIC. ............................................................................................... 9 Step 6: Install IntyBASIC..................................................................................................... 10 Step 7: Download and Install jzintv/as1600. ..................................................................... 11 Step 8: Get the rest of the files you need. ......................................................................... 12 Step 9: Create a keyboard mapping for jzintv. .................................................................. 14 Step 10: Create your first script: Edit. ............................................................................... 16 Step 11: Create your second script: Make. ....................................................................... 20 Step 12: Create your third script: Backup.......................................................................... 24 Step 13: Additional steps ................................................................................................... 26 Paths .............................................................................................................................. 26 Symbolic Links ............................................................................................................... 27 File Permissions ............................................................................................................. 27 Manuals ......................................................................................................................... 28 Step 14: Try it all out so far ............................................................................................... 29 Step 15: Setting up the graphical environment ................................................................. 31 Step 16: Configure the Linux environment for graphics .................................................... 32 Step 17: Create two more scripts: X and Run. ................................................................... 33 Step 18: Try it all out again. ............................................................................................... 38 Step 19: Final actions ........................................................................................................ 39 Adjusting the jzintv resolution ....................................................................................... 39 Automating the jzintv debugger .................................................................................... 39 Replacing the Debug options with IntelliVoice in the Run script ................................... 40 Altering the palette ....................................................................................................... 40 Using actual line-drawing characters ............................................................................ 41 Appendix A: Future Startup and Shutdown Steps ............................................................. 42 Appendix B: Another Script: Play ....................................................................................... 43 Musings ............................................................................................................................. 50 Glossary ............................................................................................................................. 51 Acknowledgments ............................................................................................................. 54 Page 2 of 54 Portable Intellivision Development Environment for Phones December 27, 2019 Revision List December 27, 2019 • I split the original document into two documents, one for phones and one for tablets. As this is the “phones” document, I deleted all material that was relevant only for tablets, and replaced the generic term “device” with “phone”. o On phones, I greatly reduce the functionality of the graphical display: no Window Manager, no graphical text editor, and no separate window for overlay images. We just run jzintv full-screen on half of the phone display. o The calls to feh in the Run and Play scripts are different now. As there is no Window Manager, the overlays are drawn right on the Root Window, and then wallpaper is drawn again after jzintv is finished running. o The original Appendix B is gone now. • I fixed the folder name “Projects” to “Archive” in the Make and Backup scripts. • I corrected the scripts to show amber coloring where it was missing before. • I modified and removed extra steps pertaining to using the Debugger. • Complete rewrite of the Run and Play scripts. o There is now a section in Extra Steps to define your own color palette. o I added a section to replace the Debug options with IntelliVoice. September 10, 2019 • Several corrections: o After installing IntyBASIC, copy the prologue and epilogue files to the Home folder, in addition to the intybasic_termux binary. o The package x11-repo has to be installed before sdl can be installed. o Text in one of the scripts showed a dash instead of two hyphens. o I added Symbolic links for the Run and X scripts, and “chmod 755”. • I removed “./” and “~/” in places where it was not necessary. August 1, 2019 • I added an entry in Step 19 for using actual line-drawing characters in the scripts. • I added several new Glossary entries. I also added the tip: “echo $LANG”. • I made a correction to the Make script where I had forgotten the line “;;”. May 31, 2019 • I created this new section for Revisions. • I expanded the “Outside World” notes to include connections to External Storage as well as Internal Storage. • I added a note about “hackfile.cfg” to toggle between standard controls and an emulated ECS keyboard. • I created an Appendix to create a script for playing games in this environment. Page 3 of 54 Portable Intellivision Development Environment for Phones December 27, 2019 Additional Notes • Words that are underlined have a Glossary entry. Use the Glossary if you’re having trouble understanding the context. Use of words you’re probably not familiar with is unavoidable. • Whenever there is text to enter, either within a text file or as a command, … it will look like this. Be sure to enter it exactly as it appears, including capitalization. Pay careful attention to spacing as well. o I added spacing between these lines so you know where the line breaks are, because some lines are too long to fit into a single line on the page. o If a single line of text is too long to fit into a single line, it wraps around onto the next line without a space. o Sometimes, you will have to make substitutions appropriate for your project or environment. Substitutions are colored in amber … like this Page 4 of 54 Portable Intellivision Development Environment for Phones December 27, 2019 Step 1: Install some apps onto your phone. You should at least be familiar enough with Android to be able to install apps onto your phone, all the more so if you could figure out IntyBASIC development. Option 1: Using F-Droid A. Go to https://www.f-droid.org

Load more

  54

Copy Link