FreeBee-b72776

#### Supplemental Linux® From Scratch - Version 13.0

### Chapter 20. Computer Emulators

- Prev

  XHomer-2-19-24

- Next

  s4-3b1-pc7300-efe55b

- Up
- Home

# FreeBee-b72776

## Introduction to FreeBee

The FreeBee package is an AT&T 3B1/7300 UNIX PC emulator.

- Download: https://github.com/philpem/freebee/archive/b727767d2ac48b86f984bf816dfbad9ece94776f/freebee-b727767d2ac48b86f984bf816dfbad9ece94776f.tar.gz

### Additional Downloads

- Required submodule: https://github.com/kstenerud/Musashi/archive/fc7a6fc602e2fbcd24851670a5242358765feacf/Musashi-fc7a6fc602e2fbcd24851670a5242358765feacf.tar.gz

- Required ROMs: http://bitsavers.org/pdf/att/3b1/firmware/3b1_roms.zip

- Recommended patch: https://www.linuxfromscratch.org/slfs/view/13.0/download/freebee/freebee-b72776-system-roms.patch

### FreeBee Dependencies

#### Required

libarchive (to unpack the required ROMs) and sdl2-compat

## Installation of FreeBee

Unpack the Musashi submodule into the right place:

    tar -xf ../Musashi-fc7a6fc602e2fbcd24851670a5242358765feacf.tar.gz &&
    mv -T Musashi-fc7a6fc602e2fbcd24851670a5242358765feacf \
          src/musashi

Optionally, apply a patch to search for the ROMs in a system-wide location and not the current directory:

    patch -Np1 -i ../freebee-b72776-system-roms.patch

Install FreeBee by running the following command:

    make src/musashi/m68kops.h &&
    make &&
    make -C tools

Now, as the `root` user:

    install -vDm755 freebee   tools/makehdimg   -t /usr/bin/ &&
    install -vDm644 freebee.1 tools/makehdimg.1 -t /usr/share/man/man1/

Optionally, install the documentation as the `root` user:

    install -vDm644 README{,.serial}.md \
                    sample.freebee.toml \
                    doc/3B1\ Memory\ Maps.ods \
            -t /usr/share/doc/freebee-b72776/

If you have applied the systemwide ROMs patch, install those ROMs as the `root` user:

    install -vdm755 /usr/share/freebee/roms &&
    unzip ../3b1_roms.zip -d /usr/share/freebee/roms &&
    rm -vf /usr/share/freebee/roms/*.hex &&
    rm -vf /usr/share/freebee/roms/README &&
    mv -v /usr/share/freebee/roms/14C\ 72-00616.bin /usr/share/freebee/roms/14c.bin &&
    mv -v /usr/share/freebee/roms/15C\ 72-00617.bin /usr/share/freebee/roms/15c.bin

## Command Explanations

make src/musashi/m68kops.h: This command explicitly generates a header file used during build time to avoid a race condition.

## Configuring FreeBee

### Config Files

`~/.freebee.toml`

### Configuration Information

If you have not applied the systemwide ROMs patch, you will have to put the `roms/` folder as documented in the `README` file from `3b1_roms.zip` into every folder you run FreeBee from, although it is possible to explicitly set the ROM path in the FreeBee config file if you do not want to do that.

### Note

Refer to the FreeBee documentation to learn how to configure the config file.

## Contents

Installed Programs: freebee and makehdimg
Installed Libraries: None
Installed Directories: /usr/share/doc/freebee-b72776 and /usr/share/freebee

### Short Descriptions

freebee | is the AT&T 3B1 UNIX PC emulator
makehdimg | creates hard disk images for use with freebee

- Prev

  XHomer-2-19-24

- Next

  s4-3b1-pc7300-efe55b

- Up
- Home