Top of MFM project information
If you have any questions, improvements, or corrections email me at the address at the bottom of the page or use the forum.
Issue tracker is here.
Forum for discussing this project is here,
If you recently got a prebuilt board with BeagleBone you can skip this step since the latest software at time of shipping was installed. You can check your software against the website version to see when updated or subscribe to the forum announcements. I only announce major changes. Minor changes such as adding a new format are not announced.
If using your own BeagleBone you may wish to follow the Getting started instructions to first power up and log into the BeagleBone without attaching it to the MFM board to verify you know how to access it before changing its configuration. Note that after updating with MFM image you will no longer be able to use the HDMI output.
The easiest way to get stuff setup is to copy one of my images
to a micro SD card and
flash your BeagleBone
from windows or Mac. Note old page so hopefully still correct. Flashing
only takes 5-10 minutes, not the 45 they say. From Linux use
xzcat imagefile.xz | dd of=/dev/sdx where
sdx is the device your microSD card was detected at (sda, sdb etc). May also
as mmcblkx. Make sure you get the device right or you may wipe out your
eMMC flasher images overwrite the on board flash memory. Backup anything you want before using image since everything will be erased. The bootable images can be used to try the new OS without changing your eMMC but backups always a good idea. Note that if you have a board you got before end of September they have an old boot loader that will fail to boot the OS-11 images unless you hold boot button on power on. Since the button is difficult to get to with the emulator board mounted if you flash the OS-7.11 image it will install the new bootloader without needing to hold down the boot button. You can then boot the OS-11 images without using the boot button.
The v4.04 OS-11.7 fixes issue in previous image of ssh not functioning.
New OS eMMC flasher image
BBB-mfm-emu-v4.04-OS-11.7-r71-flasher.xz (last modified Wednesday, 08-Nov-2023 15:55:33 EST )
New OS bootable image BBB-mfm-emu-v4.04-OS-11.7-r71.xz (last modified Wednesday, 08-Nov-2023 15:55:40 EST )
Old OS eMMC flasher image BBB-mfm-emu-v4.00-OS-7.11-flasher.xz (last modified Sunday, 01-Oct-2023 12:56:51 EDT )
Old OS bootable image BBB-mfm-emu-v4.00-OS-7.11.xz (last modified Sunday, 01-Oct-2023 13:13:04 EDT )
Original eMMC flasher image before recent changes BBB-mfm-emu_v3.01.img.xz (last modified Sunday, 04-Jun-2023 11:19:18 EDT )
Note that BBB-mfm-emu_v3.01.img.xz is not securely configured so don't use it if it will be accessible from untrusted machine or the Internet. These images are based on the console/minimal version so most of the flash storage is free but don't have graphical tools installed. If you wish to do it manually see new software installation For historical reference the procedure used to build the original image old software installation
Install the microSD card in the BeagleBone and power it on. For flasher or old 3.01 iamge the lights should switch to one LED on running back and forth after a minute if programming is working. If it doesn't power off the board and power it on while holding down the boot button. The LEDs go out when flashing is done. Wait 10 seconds after lights go out to ensure it's done and then remove the microSD card and then reset the BeagleBone.
I'm not planning to update the image with each software release so you likely will need to update the software.
** Changes to instructions **
I haven't had time to update all these pages so here are summary of changes you need to know about.
For the OS 11 image you now need to log in as debian, password temppwd. Use sudo for commands that need root or sudo su - to get a root shell. For OS 7.11 login is root with no password. If in doubt which version is running try root no password first.
For v4.00 or later the executables are in debian's path for OS 11 or root's path for 7.11. You don't need to cd to the executable and you don't need ./ in front of the command. The setup* scripts and emulator executables don't need root on OS 11. The MFM code is in /opt/mfm.
It is probably easiest to connect the USB cable for installing the software. I use the Ethernet which needs a DHCP server on your network. It allows access to the Internet the way my network is configured. If the Ethernet cable isn't plugged in at boot it may take 20 seconds for the board to activate the Ethernet after the cable is plugged in.
If you have Internet access with the v4.00 images you can update code with:
cd /opt/mfm git pull --ff-only make clean makeMake clean is optional. It makes sure everything rebuilds properly if your clock was wrong on an update.
It is also possible to access the board using the USB serial port
and move files using a USB stick. The USB stick doesn't automount with
my image. Use mount /dev/sda /mnt or mount /dev/sda1 /mnt.
For the micro SD card use one of the following.
If it was installed at boot or on OS 11.7 image mount /dev/mmcblk0p1 /mnt or mount /dev/mmcblk0 /mnt
If it was inserted after boot on OS 7.11 only mount /dev/mmcblk1p1 /mnt or mount /dev/mmcblk1 /mnt
Note that after the MFM daughter card is installed the board will not power up from the USB port. You will need to power the board through the drive power connector J5.
Don't use the barrel jack when the MFM board is installed if the DC/DC converter U12 is also installed on the MFM board.
If you are using windows you will need a scp and ssh program. I use putty and pscp from here. Login to the BeagleBone is root with no password. ipaddr in the commands below is the IP address of the BeagleBone. The USB IP address is 192.168.7.2. Delete (rm) all except the latest file for the * in the following commands to work.
Make can get confused if the clock is wrong. To check use the date command. If it's wrong set with date command. Date command format is [MMDDhhmm[[CC]YY][.ss]] and my image the date is in UTC. For January 3 2021 4pm 31 minutes 30 seconds
# If your BeagleBone has Internet access you can download on BeagleBone using wget # otherwise from machine you downloaded image to. Make clean helps # prevent issues with make not rebuilding all files but shouldn't be needed. scp mfm_emu_powerfail*.tgz root@ipaddr: #On BeagleBone tar -xzf mfm_emu_powerfail_*.tgz cd mfm make clean make cd ../emu make clean make cd ../powerfail make clean make exit (or poweroff)