Skip to content
Permalink

Comparing changes

Choose two branches to see what’s changed or to start a new pull request. If you need to, you can also or learn more about diff comparisons.

Open a pull request

Create a new pull request by comparing changes across two branches. If you need to, you can also . Learn more about diff comparisons here.
base repository: GlasgowEmbedded/glasgow
Failed to load repositories. Confirm that selected base ref is valid, then try again.
Loading
base: 543ea53f14bd
Choose a base ref
...
head repository: GlasgowEmbedded/glasgow
Failed to load repositories. Confirm that selected head ref is valid, then try again.
Loading
compare: ca37b73bce67
Choose a head ref
  • 1 commit
  • 2 files changed
  • 1 contributor

Commits on Jan 14, 2020

  1. README: add a section on factory flashing.

    @whitequark
    whitequark committed Jan 14, 2020
    Copy the full SHA
    ca37b73 View commit details
Showing with 28 additions and 0 deletions.
  1. +26 −0 README.md
  2. +2 −0 config/99-cypress.rules
26 changes: 26 additions & 0 deletions README.md
View file
Original file line number Diff line number Diff line change
@@ -113,6 +113,32 @@ To update the source code, do:

Although first-class Windows support is an important goal and Glasgow already works on Windows, the installation process is not yet ready.

## How do I factory flash Glasgow?

"Factory flashing" refers to the process of assigning a brand new Glasgow board (that you probably just assembled) a serial number, as well as writing a few critical configuration options that will let the normal Glasgow CLI pick up this device. Barring severe and unusual EEPROM corruption, this process is performed only once for each board.

As a prerequisite to factory flashing, follow all steps from the "[How do I use Glasgow?](#how-do-i-use-glasgow)" section.

Any board that is factory flashed must have a blank FX2_MEM EEPROM. If the FX2_MEM EEPROM is not completely erased (all bytes set to `FF`), the factory flashing process may fail.

### ... with Linux?

Configure your system to allow unprivileged access (for anyone in the `plugdev` group) to any hardware that enumerates as the Cypress FX2 ROM bootloader:

sudo cp config/99-cypress.rules /etc/udev/rules.d

Note that this udev rule will affect more devices than just Glasgow, since the Cypress VID:PID pair is shared.

Plug in the newly assembled device. At this point, `lsusb | grep 04b4:8613` should list one entry. Assuming you are factory flashing a board revision C1, run:

glasgow factory --rev C1

Done! At this point, `lsusb | grep 20b7:9db1` should list one entry.

### ... with Windows?

See [above](#-with-windows).

## Who made Glasgow?

* [@whitequark](https://github.com/whitequark) came up with the design, coordinates the project and implements most of gateware and software;
2 changes: 2 additions & 0 deletions config/99-cypress.rules
View file
Original file line number Diff line number Diff line change
@@ -0,0 +1,2 @@
SUBSYSTEM=="usb", ATTRS{idVendor}=="04b4", ATTRS{idProduct}=="8613", \
MODE="0660", GROUP="plugdev", TAG+="uaccess"