MyroC Installation and Comments for Windows Materials to Support a C-based Course with Scribbler 2 Robots

Getting Started with MyroC on Windows 10

Using MyroC in a Windows environment requires initial, one-time only setup. Thereafter, programming follows a traditional edit-compile-run cycle.

The main online site for the MyroC infrastructure, instructions, documentation, and commentary may be found at http://walker.cs.grinnell.edu//MyroC/.

License

All MyroC software is distributed without warranty.

MyroC software is licensed under the Creative Commons Attribution-Noncommercial-Share Alike 4.0 International License. According to this license, you are free to share (copy and redistribute) and adapt (modify or expand) the MyroC infrastructure, provided

• you give appropriate credit,
• provide a link to the Creative Commons License (as given below),
• indicate any changes, if any, that have been made,
• do not use this material for commercial purposes, and
• distribute any derivatives of this material under the same Creative Commons License.

Additional License details may be found at http://creativecommons.org/licenses/by-nc-sa/4.0/ .

Setting Up a Windows 10 Environment

Use the development MyroC release, MyroC.3.3a, when working with Windows 10.

Set up requires the installation of the following main packages:

• the eSpeak speech synthesizer, available from sourceforge.net with Jonathan Duddington (admin)
• the jpeglib library for jpeg images, available from the Independent JPEG Group
• the openGL graphics library, part of Mac OS X and also available from opengl.org
• the eSpeakPackage interface for programs written in C
• the MyroC C-based infrastructure for Scribbler 2 robots

Installation of these packages is discussed in these detailed instructions for Windows computers.

Creating and Running C Programs with MyroC

Working with C programs utilizing MyroC involves a traditional edit-compile-run cycle.

1. Open a MSYS2 Terminal window: Much work is most conveniently done within a Terminal window. When you install MSYS2 on Windows 10, an icon will appear in the menu panel at the bottom of your screen.

2. Create a project directory: Within the MSYS2 command-line enviornment, use the same approach from the eSpeakPackage installation to create the desired directory. For example, if you wish to create "MyroCProject" directory just above your main/login directory, you might type these commands in an MSYS2 window:

        cd                   # go to the MSYS2 home first
        mkdir MyroCProject   # create the desired project directory
        cd MyroCProject      # move to the project directory
     

3. Establish a Makefile: Copy the Makefile from the test-programs directory created during MyroC installation and testing.

   Be sure the Makefile is a copy of Makefile-windows-apps from test-programs, not the directory containing the MyroC code that was compiled and installed!

4. Creating and Editing a C Program: Use any editor to create and edit a file containing your C program, provided the created file is simple-text only. Do not save the program in .rtf, .pages, or other formatted format!

5. Compiling the Program: Once creating the program, save in the project directory (the one with the Makefile, and compile with the command

         make yourprogram
       

   When using make, reference the program name, without the ".c" at the end. For example, to compile prog.c, type make prog

6. Running the Program: Run the program by typing ./ and the program name (without the .c) in the Terminal window (e.g., ./prog).