Changes between Version 19 and Version 20 of FSA

Timestamp:

04/29/2025 04:57:46 PM (6 days ago)

Author:

Tim Harvey

Comment:

added FSA eeprom and GPIO details

FSA

@@ -18 +18 @@
  * GW16FP0 - FSA to Mini-PCIe (!WiFi / Cellular / Etc)
 
-These adapters and various radios are detailed below.
+These adapters and various card configurations are detailed below.
+
+
+== FSA Identification EEPROM
+The FSA adapters have an identification EEPROM programmed during manufacturing test that provide:
+ * model string
+ * mac addresses (for FSA's that have networking interfaces)
+ * serial number
+ * manufacturer date
+ * description (user writable 32 character description string)
+  - This use modifiable description is shown during FSA detection when the board boots in the bootloader and can be used as a reminder for what card you have populated in an adapter or what purpose you have applied to an adapter 
+ * overlay (user writable 16 character overlay string)
+  - This is not currently used but in the future could be used to auto-select a device-tree overlay supporting what is in an FSA socket for example
+ * gpio descriptors (user writable) onboard GPIO's each having:
+  - name (used to identify the GPIO in U-Boot and Linux, prefixed by 'fsa<n>_' to uniquely identify what FSA socket it is in 
+  - default configuration (not connected, unconfigured, input, output-low, output-high) applied by the bootloader
+
+The Gateworks U-Boot bootloader has support for accessing the FSA socket details on a board using the 'fsa' command:
+ * show command usage:
+{{{#!bash
+u-boot=> fsa
+fsa - Flexible Socket Adapter
+
+Usage:
+fsa dev [dev] - show or set current FSA adapter
+fsa gpio - show current gpio descriptors
+fsa gpio [<offset>]|[<offset> <source>] - show a specific gpio descriptor
+fsa gpio [<offset> <name> <input|output-low|output-high> [source]] - set a gpio descriptor
+fsa description [description] - show or set the FSA user description string
+fsa overlay [overlay] - show or set the FSA overlay string
+}}}
+ * list FSA adapters on a board:
+{{{#!bash
+u-boot=> fsa dev
+detecting FSA Adapters:
+FSA1    : GW16FP0-A M.2 Mini-PCIe Adapter
+FSA2    : GW16FE0-B M.2 E-Key Adapter
+}}}
+ * select and describe FSA1:
+{{{#!bash
+u-boot=> fsa dev 1
+selected:
+FSA1: GW16FP0-A
+description: M.2 Mini-PCIe Adapter
+overlay: 
+        0 : fsa_gpio1 : wdisable# output-high
+        1 : fsa_gpio2 : sel_pci# output-high
+        2 : fsa_gpio3 : sim_det# input
+        3 : fsa_gpio4 :  NC
+}}}
+ * set the user description string for selected FSA:
+{{{#!bash
+u-boot=> fsa description mymodem
+FSA1: GW16FP0-A
+description: mymodem
+overlay: 
+        0 : fsa_gpio1 : wdisable# output-high
+        1 : fsa_gpio2 : sel_pci# output-high
+        2 : fsa_gpio3 : sim_det# input
+        3 : fsa_gpio4 :  NC
+u-boot=> fsa dev
+detecting FSA Adapters:
+FSA1    : GW16FP0-A mymodem
+FSA2    : GW16FE0-B M.2 E-Key Adapter
+selected:
+FSA1: GW16FP0-A
+description: mymodem
+overlay: 
+        0 : fsa_gpio1 : wdisable# output-high
+        1 : fsa_gpio2 : sel_pci# output-high
+        2 : fsa_gpio3 : sim_det# input
+        3 : fsa_gpio4 :  NC
+
+}}}
+ * blank the description string for selected FSA:
+{{{#!bash
+u-boot=> fsa description ""
+FSA1: GW16FP0-A
+description: 
+overlay: 
+        0 : fsa_gpio1 : wdisable# output-high
+        1 : fsa_gpio2 : sel_pci# output-high
+        2 : fsa_gpio3 : sim_det# input
+        3 : fsa_gpio4 :  NC
+}}}
+ * show GPIO configuration for selected FSA:
+{{{#!bash
+u-boot=> fsa gpio
+        0 : fsa_gpio1 : wdisable# output-high
+        1 : fsa_gpio2 : sel_pci# output-high
+        2 : fsa_gpio3 : sim_det# input
+        3 : fsa_gpio4 :  NC
+}}}
+ * show description of GPIO 2 for selected FSA:
+{{{#!bash
+u-boot=> fsa gpio 2
+FSA1 GW16FP0-A showing gpio 2
+fsa_gpio3 : sim_det# input
+}}}
+ * re-configure GPIO 2 (name and default state) for selected FSA:
+{{{#!bash
+u-boot=> fsa gpio 2 foo output-low
+FSA1 GW16FP0-A updating gpio 2
+u-boot=> fsa gpio 2               
+FSA1 GW16FP0-A showing gpio 2
+fsa_gpio3 : foo output-low
+}}}
+
+Note that the GPIO default states are not applied at board power-on but at runtime by the bootloader when detecting the board model and FSA adapters. The board power-on state of the GPIO's depends on the specific FSA adapter design.
+
+
+== FSA GPIO's
+The FSA adapters can have up to 4 GPIO's that route to the baseboard. These have a name and a default configuration dictated by the identification EEPROM on the FSA and are available in both U-Boot and Linux prefixed by the FSA slot number the FSA adapter is populated in.
+
+For example, if an FSA adapter in socket FSA2 uses gpio0 as 'wdisable1#' and gpio1 as 'wdisable2#' the following GPIO's would be available by name:
+ * fsa2_wdisable1#
+ * fsa2_wdisable2#
+
+These can be set in U-Boot or Linux.
+
+Examples:
+ * FSA2 has a MiniPCIe adapter with a 'wdisable#' GPIO we wish to drive low
+  - In U-Boot:
+{{{#!bash
+u-boot=> gpio clr fsa2_wdisable#
+}}}
+  - In Linux:
+{{{#!bash
+# gpioset --mode signal $(gpiofind "fsa2_wdisable#")=0
+}}}
+
 
 == GW82xx Baseboard