Fall 2014 SPO600 Weekly Schedule

It's Alive!
This SPO600 weekly schedule will be updated as the course proceeds - dates and content are subject to change. The cells in the summary table will be linked to relevant resources and labs as the course progresses.

Summary Table

This is a summary/index table. Please follow the links in each cell for additional detail -- especially for the Deliverables column.

Week	Week of...	Tuesday	Friday	Deliverables (Summary - click for details)
1	Sep 1	(Experience Seneca Orientation - No Class)	Introduction to Software Porting, Portability, Benchmarking, and Optimization / How is code accepted into an open source project?	Set up accounts and a Fedora system
2	Sep 8	Computer Architecture Overview	Compiled C Lab	Blog a commentary on code reviews in two communities (Lab 1) and on the Compiled C Code lab (Lab 2).
3	Sep 15	Linaro Connect 2014 - No classes scheduled - Prepare your presentation on assembly language code		Assembly language presentation ready for presentation next Tuesday (September 23).
4	Sept 22	Assembly language presentations & Assembly Basics	Assembly Language Lab	Blog about writing in assembly language (Lab 3)
5	Sep 29	Discuss lab 3 results / Inline assembler and compiler optimizations	Potential Project Triage – Scan the potential project list from the Linaro Performance site	Blog post about potential projects
6	Oct 6	Codebase analysis	Memory barriers and Atomics	Analyze your portion of the potential projects list and post your results on the wiki and your blog; select two projects and contact the associated communities.
7	Oct 13	Architecture-specific Code for Performance	Group hack session - Porting	Blog about your progress.
Study Week	Oct 20	Study Week FSOSS 2014 on Thursday-Friday
8	Oct 27	Architecture-specific Code for Performance	Group hack session - Porting	Blog about your progress.
9	Nov 3	Portability - Removing platform-specific code	Group hack session - Portability	Blog about your progress.
10	Nov 10	Profiling	Baseline Profiling	Post baseline stats for your software.
11	Nov 17	Optimizing Code	Group hack - Profiling and optimizing	Post a code review update.
12	Nov 24	Using complier optimizations	Project Work	Post a code review update.
13	Dec 1	Final Presentations	Final Presentations	Code accepted upstream. Blog about it!
Exam Week	Dec 8	Exam Week - No exam in this course!

Evaluation

Category	Percentage	Evaluation Dates
Communication	20%	September 30, October 31, November 21, December 10
Quizzes	10%	May be held during any class, usually at the start of class. A minimum of 5 one-page quizzes will be given. No make-up/retake option is offered if you miss a quiz. Lowest 3 scores will not be counted.
Labs	10%	See deliverables column above.
Project work	60%	October 10, November 21, December 10

Week 1

Friday (Sep 5)

Introduction to the Problem

• Most software is written in a high-level language which can be compiled into machine code for a specific architecture. However, there is a lot of existing code that contains some architecture-specific code fragments written in Assembly Language (or, in some cases, machine-specific high-level code).
• Reasons for writing code in Assembly Langauge include:
  • Performance
  • Atomic Operations
  • Direct access to hardware features, e.g., CPUID registers
• Most of the historical reasons for including assembler are no longer valid. Modern compilers can out-perform most hand-optimized assembly code, atomic operations can be handled by libraries or compiler intrinsics, and most hardware access should be performed through the operating system or appropriate libraries.
• A new architecture has appeared: Aarch64, which is part of ARMv8. This is the first new computer architecture to appear in several years (at least, the first mainstream computer architecture).
• There are over 1400 software packages/modules present in GNU Linux systems which contain architecture-specific assembly language code or have other portability issues. Most of these packages cannot be built on Aarch64 systems without modification.

Course Projects

In this course, you will:

1. Select two software packages from a list compiled by Steve Macintyre of Linaro. Each of the packages on this list contains assembly language code which is platform-specific.
2. Prepare a fix/patch for the software so that it will run on 64-bit ARM systems (aarch64). This may be done at either of two levels:
   1. Port - Add additional assembly language code for aarch64 (basic solution).
   2. Make Portable - Remove architecture-specific code, replacing it with compiler intrinsics or high-level code so that the software will successfully build on multiple platforms.
3. Benchmark - Prove that your changes do not cause a performance regression on existing platforms, and that (ideally) it improves performance.
4. Upstream your Code - Submitting your code to the upstream (originating) software project so that it can be incorporated into future versions of the software. This will involve going through a code review to ensure that your code is compatible with and acceptable to the upstream community.

General Course Information

• Course resources are linked from the CDOT wiki, starting at http://zenit.senecac.on.ca/wiki/index.php/SPO600 (Quick find: This page will usually be Google's top result for a search on "SPO600").
• Coursework is submitted by blogging.
• Quizzes will be short (1 page) and will be held without announcement at any time. Your lowest three quiz scores will not be counted, so do not worry if you miss one or two.
• Course marks (see Weekly Schedule for dates):
  • 60% - Project Deliverables
  • 20% - Communication (Blog and Wiki writing)
  • 20% - Labs and Quizzes (10% labs - completed/not completed; 10% for quizzes - lowest 3 scores not counted)
• All classes will be held in an Active Learning Classroom -- you are encouraged to bring your own laptop to class. If you do not have a laptop, consider signing one out of the Learning Commons for class, or using a smartphone with an HDMI adapter.
• For more course information, refer to the SPO600 Weekly Schedule (this page), the Course Outline, and SPO600 Course Policies.

Discussion of how open source communities work

(Background for the Code Review Lab (Lab 1) which is homework due Week 2).

Week 1 Deliverables

1. Set up your SPO600 Communication Tools - in particular, set up a blog and add it to Planet CDOT (via the Planet CDOT Feed List).
2. Add yourself to the Fall 2014 SPO600 Participants page (leave the projects columns blank).
3. Generate a pair of keys for SSH and email the public key to your professor.
4. Sign and return the Open Source Professional Option Student Agreement.
5. Set up a Fedora 20 system.

Week 2

Tuesday (Sep 9)

• Computer Architecture overview (see also the Computer Architecture Category)

Friday (Sep 12)

Bring Your Laptop
Classes are held in a Active Learning Classroom. If you have a laptop or other device with a VGA or HDMI output (such as a smartphone!) please bring it. You'll need either a local linux environment or an SSH client -- which is built-in to Linux, Mac, and Chromebook systems, and readily available for Windows, Android, and iOS devices.

• Perform the Compiled C Lab (Lab 2) in groups

Week 2 Deliverables

• Complete and blog your conclusion to the Code Review Lab (Lab 1).
• Blog your conclusion to the Compiled C Lab (Lab 2)

Week 3

This week your professor is at Linaro Connect, an engineering conference run by Linaro - a distributed not-for-profit collaborative technology company focused on Linux on ARM. You can participate remotely and may find some of the sessions interesting.

• Select and prepare to teach the class about a specific small topic related to assembly language / machine language programming.

Week 3 Deliverables

• Be prepared to give your presentation on Tuesday of next week (September 23).

Week 4

Tuesday (Sep 23)

• Give your presentation about an assembly language topic - teach your SPO600 colleagues
• Introduction to assembly language

Friday (Sep 26)

• Writing x86_64 and aarch64 code in the Assembly language lab (Lab 3)

Week 4 Deliverables

• Blog about the assembler lab (Lab 3)

Week 5

Tuesday (Sep 30)

• Assembler Lab review
• Inline Assembly Language
• Compiler Optimizations

Friday (Oct 3)

The Linaro Performance Challenge is a project initiated by Jon "Maddog" Hall and Linaro to port or make portable open source software packages which contain platform-specific code and which may not build on the new Aarch64 architecture.

The list of packages for this project was originally developed by the UK Debian developer Steve Macintyre, who works for Linaro. His focus in developing that list was to find packages that contained assembly language code for x86 (or other platforms) and which did not have assembly language code for ARM, especially Aarch64. As a result, the list includes many false-positives: there are many packages on there that can successfully build on ARM, either due to C work-arounds for the missing assembly code, or conditional compilation of the assembly code, or recent updates to the software, or other reasons.

In this class, we're going to start to triage this list by analyzing which packages exist in the Fedora package set and which have been successfully built for the aarch64 architecture.

This is the approximate plan for this class:

1. Grab the list of packages from the Linaro Performance Challenge site.
2. Find out the corresponding names of the packages in the Fedora package set. Most of these will be the same as in the list, but some may be different.
3. Find out which packages have built on x86_64
4. Find out which packages have build on aarch64
5. Come up with a short-list which consists of the packages in these groups:
   1. Packages which do not exist in Fedora -- these need further investigation
   2. Packages which exist in Fedora and build on x86_64, but which do not build on aarch64

The packages in the short-list will be divided up between the members of the class for further analysis.

Week 5 Deliverables

• Blog about the potential project list assigned to you