This collection contains Ada example programs designed to teach Ada programming concepts for the uada80 compiler targeting the Z80 processor running CP/M.

• AdaCore Learn Platform - Free interactive courses covering Ada fundamentals, tasking, SPARK, and more
• Introduction to Ada (PDF) - Comprehensive PDF guide from AdaCore
• Ada Resource Association - Tutorials, courses, books, and learning materials

• Ada Programming Wikibook - Community-maintained tutorial covering all Ada topics (PDF version)
• Ada Distilled - Concise guide for experienced programmers
• Ada 95 Tutorial (Coronado) - 33 chapters covering the entire language
• Ada95 Lovelace Tutorial - Self-paced tutorial by David Wheeler
• Free Ada E-Books at AdaForge - 18 free e-books including "Ada - a crash course"
• FreeComputerBooks Ada Section - "Ada 95: The Craft of Object-Oriented Programming" and more

• Class Central Ada Courses - Curated list of free and paid courses
• edX Ada Programming - Online courses from various providers
• Udemy Ada for Beginners - Beginner-focused course

• Ada Reference Manual - Official language standard
• awesome-ada on GitHub - Curated list of Ada resources

This collection contains 90+ example programs organized by concept:

• hello_world.adb - The simplest Ada program
• hello_use.adb - Using "use" clauses
• comments.adb - Ada comment syntax
• identifiers.adb - Naming rules
• reserved_words.adb - Ada keywords
• program_structure.adb - Program organization
• semicolons.adb - Statement terminators
• blocks.adb - Declare blocks

• integer_types.adb - Integer types and literals
• range_types.adb - Custom integer ranges
• modular_types.adb - Unsigned wraparound types
• boolean_type.adb - Boolean operations
• character_type.adb - Character type
• enumeration_types.adb - User-defined enumerations
• subtypes.adb - Constrained subtypes
• type_conversions.adb - Explicit type conversion

• variables.adb - Variable declarations
• constants.adb - Named constants
• initialization.adb - Initialization patterns

• arithmetic_ops.adb - +, -, *, /, mod, rem, **
• relational_ops.adb - =, /=, <, >, <=, >=
• logical_ops.adb - and, or, xor, not
• string_ops.adb - & concatenation
• precedence.adb - Operator precedence

• if_statement.adb - If-then-else
• case_statement.adb - Case (switch)
• while_loop.adb - While loops
• for_loop.adb - For loops with ranges
• basic_loop.adb - Loop with exit
• named_loops.adb - Named loops and exit
• for_of_loop.adb - Ada 2012 iterator loops
• goto_statement.adb - Goto (use sparingly!)
• null_statement.adb - The null statement

• basic_arrays.adb - Array basics
• array_aggregates.adb - Initialization syntax
• array_attributes.adb - 'First, 'Last, 'Range, 'Length
• array_slices.adb - Array slicing
• multidim_arrays.adb - Multi-dimensional arrays
• unconstrained_arrays.adb - Dynamic bounds
• array_of_arrays.adb - Arrays vs matrices

• basic_records.adb - Record types
• record_aggregates.adb - Record initialization
• nested_records.adb - Records in records
• variant_records.adb - Discriminated records
• record_with_array.adb - Arrays in records

• procedures.adb - Procedure basics
• functions.adb - Function basics
• parameter_modes.adb - in, out, in Out
• default_parameters.adb - Default values
• overloading.adb - Name overloading
• recursion.adb - Recursive subprograms
• local_declarations.adb - Local scope
• expression_functions.adb - Ada 2012 expression functions

• package_intro.adb - Package basics
• stack_pkg.ads/.adb - Specification and body
• use_stack.adb - Using packages
• private_types.adb - Information hiding
• child_packages.adb - Hierarchical packages

• basic_exceptions.adb - Try-catch basics
• user_exceptions.adb - Custom exceptions
• exception_propagation.adb - Exception propagation
• exception_info.adb - Exception information
• predefined_exceptions.adb - Standard exceptions

• basic_access.adb - Access type basics
• linked_list.adb - Dynamic data structures
• access_parameters.adb - Access parameters

• generic_procedure.adb - Generic procedures
• generic_function.adb - Generic functions
• generic_package.adb - Generic packages
• generic_formal_params.adb - Formal parameters

• basic_task.adb - Task basics
• task_types.adb - Task types
• rendezvous.adb - Task communication
• protected_objects.adb - Shared data

• scalar_attributes.adb - Type attributes
• array_attrs.adb - Array attributes
• object_attributes.adb - Object attributes

• fixed_strings.adb - Fixed-length strings

• text_io_basics.adb - Text I/O basics
• integer_io.adb - Integer I/O formatting

• derived_types.adb - Creating new types

• pragma_examples.adb - Common pragmas

• contract_examples.adb - Pre/Post conditions

• calculator.adb - Simple calculator
• prime_numbers.adb - Prime algorithms
• sorting.adb - Sorting algorithms
• binary_search.adb - Binary search
• temperature_converter.adb - Unit conversion
• number_guessing.adb - Simple game
• morse_code.adb - Morse encoder
• todo_list.adb - Task manager

These examples are designed to work with the uada80 compiler which targets the Z80/CP/M environment:

• ~57K TPA (Transient Program Area) on 64K system
• Use small, focused examples
• Avoid large arrays when possible

• Standard Integer is 16-bit (-32768 to 32767)
• Use range types to constrain values
• No native 32/64-bit without libraries

• Software floating point available but slow
• Integer arithmetic preferred
• Use fixed-point or scaled integers when possible

• Supported via timer interrupts
• Use protected objects for shared data
• Keep task count minimal

• Console via BDOS function calls
• File I/O in 128-byte sectors
• 8.3 filename format

1. Study the examples - Each file demonstrates one concept
2. Read the comments - Explanations are in the code
3. Compile and run - Use uada80 to compile
4. Experiment - Modify examples to learn

# Compile an example
python -m uada80 hello_world.adb -o hello.com

# Run in CP/M emulator
cpmemu hello.com

Suggested order for beginners:

1. Basics (01_basics/) - Start here!
2. Types (02_types/) - Ada's strong typing
3. Variables (03_variables/) - Data storage
4. Operators (04_operators/) - Expressions
5. Control Flow (05_control_flow/) - Logic
6. Arrays (06_arrays/) - Collections
7. Records (07_records/) - Structures
8. Subprograms (08_subprograms/) - Functions
9. Packages (09_packages/) - Modularity
10. Exceptions (10_exceptions/) - Error handling
11. Access Types (11_access_types/) - Pointers
12. Generics (12_generics/) - Templates
13. Tasking (13_tasking/) - Concurrency
14. Applications (20_applications/) - Put it together!

These examples cover the core language. Additional topics that could be added:

• File I/O examples specific to CP/M
• Hardware interfacing (ports, interrupts)
• More algorithms (graph, tree operations)
• Text processing utilities
• Simple games

Feel free to add more examples! Guidelines:

• One concept per file
• Extensive comments explaining the concept
• Keep examples small (Z80 memory constraints)
• Test with uada80 before submitting

• 80un - Unpacker for CP/M compression and archive formats (LBR, ARC, squeeze, crunch, CrLZH)
• cpmdroid - Z80/CP/M emulator for Android with RomWBW HBIOS compatibility and VT100 terminal
• cpmemu - CP/M 2.2 emulator with Z80/8080 CPU emulation and BDOS/BIOS translation to Unix filesystem
• ioscpm - Z80/CP/M emulator for iOS and macOS with RomWBW HBIOS compatibility
• mbasic - Modern MBASIC 5.21 Interpreter & Compilers
• mbasic2025 - MBASIC 5.21 source code reconstruction - byte-for-byte match with original binary
• mbasicc - C++ implementation of MBASIC 5.21
• mbasicc_web - WebAssembly MBASIC 5.21
• mpm2 - MP/M II multi-user CP/M emulator with SSH terminal access and SFTP file transfer
• romwbw_emu - Hardware-level Z80 emulator for RomWBW with 512KB ROM + 512KB RAM banking and HBIOS support
• scelbal - SCELBAL BASIC interpreter - 8008 to 8080 translation
• uada80 - Ada compiler targeting Z80 processor and CP/M 2.2 operating system
• uc80 - ANSI C compiler targeting Z80 processor and CP/M 2.2 operating system
• ucow - Unix/Linux Cowgol to Z80 compiler
• um80_and_friends - Microsoft MACRO-80 compatible toolchain for Linux: assembler, linker, librarian, disassembler
• upeepz80 - Universal peephole optimizer for Z80 compilers
• uplm80 - PL/M-80 compiler targeting Intel 8080 and Zilog Z80 assembly language
• z80cpmw - Z80 CP/M emulator for Windows (RomWBW)