Skip to content

Commit

Permalink
Update a few doc bits.
Browse files Browse the repository at this point in the history
  • Loading branch information
tom-seddon committed Mar 2, 2024
1 parent 4be739d commit db46514
Show file tree
Hide file tree
Showing 3 changed files with 21 additions and 12 deletions.
19 changes: 10 additions & 9 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -97,20 +97,21 @@ to get `beeblink_upurs_fe60.rom` copied onto your BBC.

# Setting up the Electron (experimental!)

**Electron support is experimental**
**Electron support is experimental! DIY required**

You'll need an Electron with Plus 1 (or equivalent - I'm uing an Acorn
Plus 1) and Advanced Plus 5 (or equivalent - I'm using the Retro
Hardware New AP5).

You'll need a Tube USB serial adapter (see above). The adapter
requires modification: carefully bend up pin 9 of the PLD, so it's
clear of the socket when plugged in. Note that the modified adapter
won't work with a second processor. (A future update to the hardware
will fix all of this stuff...)
You'll need a Tube USB serial adapter (see above). The PLD needs
reprogramming with the .jed file here:
https://gist.github.com/tom-seddon/07d9f2942590899044a161edd5fe891a,
and please also note the instructions there. (The reprogrammed PLD
will be fully compatible with BBC B, B+ and Master as well.)

Connect the Tube serial board to the AP5's Tube connector, use the
jumper to select Comms mode, and connect the device to your PC.
Once set up, Connect the Tube serial board to the AP5's Tube
connector, use the jumper to select Comms mode, and connect the device
to your PC.

If using Windows, you'll need to
[tweak one of the device settings](./docs/ftdi_latency_timer.md).
Expand All @@ -119,7 +120,7 @@ There's not currently a bootstrap process for the Electron. I used my
Master to get [the appropriate ROM image](./docs/tube_serial_roms.md)
onto a cartridge, then plugged the cartridge into the Electron.

**Electron support is experimental**
**Electron support is experimental! DIY required**

# Use

Expand Down
5 changes: 5 additions & 0 deletions docs/build-server.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,11 @@ Prerequisites:

* [node.js 16.8.0 or later](https://nodejs.org/en/download/)

I only use even-numbered node.js releases, but odd-numbered releases
may work!

If you get errors with node.js 20.x, try node.js 18.x.

# Build and run on Windows

Additional rerequisites:
Expand Down
9 changes: 6 additions & 3 deletions docs/git.md
Original file line number Diff line number Diff line change
Expand Up @@ -28,9 +28,12 @@ Notes:
deleting BBC files via the shell you can end up with stale
`.gitattributes` entries. This isn't usually a problem in practice
though
* the server pays no attention to `.gitignore`, and always updates
`.gitattributes` even if the files are already covered by a
perfectly good `.gitattributes` file elsewhere
* the server pays no attention to `.gitignore`, and will update
`.gitattributes` even if the folder and/or files in question are
ignored
* the server pays no attention to existing `.gitattributes` files, and
will make the modifications even if the files would already be
covered by a perfectly `.gitattributes` in some parent folder
* the `.gitattributes` files in volume folders are owned by Beeblink,
and not designed for editing. The server will blithely add and
remove entries as it sees fit
Expand Down

0 comments on commit db46514

Please sign in to comment.