Changes between Version 5 and Version 6 of gsc


Ignore:
Timestamp:
12/14/2017 01:06:14 AM (2 years ago)
Author:
Tim Harvey
Comment:

added newport GSC v3 details

Legend:

Unmodified
Added
Removed
Modified
  • gsc

    v5 v6  
    1414 * [wiki:gsc#GPSActiveAntennashort-circuitauto-detectandrecover GPS Active Antenna short-circuit auto-detect and recover]
    1515 * [wiki:gsc#HardwareWatchdog Hardware Watchdog]
     16 * [wiki:gsc#resetmonitor Reset Monitor]
    1617 * [wiki:gsc#GSCUpdates Software field-upgradable firmware]
    1718
     
    2930
    3031[[Image(gateworksgsc.png,400px)]]
     32
     33[=#versions]
     34== GSC versions ==
     35The latest Gateworks products use a third generation GSC. The following generations exist:
     36||= Family =||= Board =||= GSC version =||
     37|| Newport  || all     || v3 ||
     38|| Ventana  || all     || v2 ||
     39|| Laguna   || GW2388/GW2391/GW2387 || v2 ||
     40|| Laguna   || GW2380/82/83         || v1 ||
     41|| Rincon   || all                  || v1 ||
     42
     43The various generations of GSC versions are:
     44 * v1: MSP430F2132
     45 * v2: MSP430F2252
     46  - additional RAM/FLASH space (additional user eeprom regions)
     47  - additional ADC
     48  - added FAN controller
     49  - added Alternate boot device support
     50 * v3: MSP430FR58471
     51  - additional RAM/FLASH space
     52  - additional ADC
     53  - improved I2C interface eliminates occasional I2C NAK's
     54  - reduced power consumption resulting in longer battery life (3.8Y -> 5Y)
     55  - resolves 'high power draw state' when inserting a battery while board powered off
    3156
    3257
     
    458483[=#powercontrol]
    459484== Hardware Sleep and Wake ==
    460 The GSC has the ability (on the Laguna & Ventana product family) has the ability to put the board into a 'Hardware Sleep' mode by disabling the primary power supply. This is very useful in many applications that do not require 24 hour operation and need to save power. In this mode the only item drawing power is the GSC itself (powered by a coin-cell battery). The GSC will 'wake' the board again by enabling the primary power supply when the RTC reaches the time defined in the GSC_SLEEP_WAKE register. The wakeup time can be set to an absolute RTC time by writing to GSC_SLEEP_WAKE or be set relative to the current RTC value by setting the GSC_SLEEP_ADD register and latching it via setting R1.2.
     485The GSC has the ability (on the Laguna, Ventana, and Newport product family) has the ability to put the board into a 'Hardware Sleep' mode by disabling the primary power supply. This is very useful in many applications that do not require 24 hour operation and need to save power. In this mode the only item drawing power is the GSC itself (powered by a coin-cell battery). The GSC will 'wake' the board again by enabling the primary power supply when the RTC reaches the time defined in the GSC_SLEEP_WAKE register. The wakeup time can be set to an absolute RTC time by writing to GSC_SLEEP_WAKE or be set relative to the current RTC value by setting the GSC_SLEEP_ADD register and latching it via setting R1.2.
    461486
    462487A pushbutton press will also wake the board unless the SLEEP_NOWAKEPB (R1.3) is enabled.
     
    533558Products with GPS antenna protection (GPS is not loaded on all model variants, contact sales@gateworks.com for details):
    534559||= Family =||= Board =||= Overcurrent Protection =||= Recovery =||
     560|| Newport  || GW630X  || Current Limit            || No         ||
     561||          || GW640X  || Current Limit            || No         ||
     562|| ||
    535563|| Ventana  || GW51XX  || Current Limit            || No         ||
    536 || Ventana  || GW52XX  || Current Limit            || No         ||
    537 || Ventana  || GW53XX  || Yes                      || Yes        ||
    538 || Ventana  || GW54XX  || Yes                      || Yes        ||
     564||          || GW52XX  || Current Limit            || No         ||
     565||          || GW53XX  || Yes                      || Yes        ||
     566||          || GW54XX  || Yes                      || Yes        ||
     567||          || GW553X  || Yes                      || No         ||
     568||          || GW560X  || Yes                      || Yes        ||
     569|| ||
    539570|| Laguna   || GW2387  || Yes                      || Yes        ||
    540 || Laguna   || GW2391  || Yes                      || Yes        ||
     571||          || GW2388  || Yes                      || No         ||
     572||          || GW2391  || Yes                      || Yes        ||
    541573
    542574[=#gsc-interrupts]
     
    615647[=#watchdog]
    616648== Hardware Watchdog ==
    617 * ''' NOTE: REQUIRES V44 or later of GSC FIRMWARE '''
     649Ventana and Laguna boards with GSC v2 can benefit from a GSC Watchdog (requires v44 or later of GSC firmware). Note that Newport boards with a GSC v3 do not benefit from a GSC Watchdog as the external reset on the CN80XX/CN81XX is asserted when the CPU watchdog expires and is monitored by the GSC. The GSC on these boards will cause a primary board power supply reset when this occurs.
     650
    618651A watchdog is a common feature which allows a timer to be configured such that a reset occurs if that timer expires. A software component will typically enable the watchdog timer and restart it periodically before the timer expires based on some conditions. Usually there is no specific condition so the timer gets restarted (avoiding a system reset) unless the CPU running that software hangs.
    619652
     
    825858[=#i2c]
    826859= I2C communication with the GSC =
    827 The GSC communicates with the SoC via i2c at a maximum clock rate of 100KHz. The GSC may occasionally be busy and fail to ACK an i2c master transaction within the bit timing. This is because every second the GSC performs a round of ADC conversions for its hardware monitoring function. At worst, you should never fail an ACK more than 2 times in a row based on the amount of time needed for the ADC conversions.
     860The GSC communicates with the SoC via i2c at a maximum clock rate of 100KHz.
     861
     862The v1 and v2 GSC (see [#versions above]) may occasionally be busy and fail to ACK an i2c master transaction within the bit timing. The v3 GSC used in the Newport and newer product families is not susceptible to this.
     863
     864[=#nak]
     865=== Occasional I2C NAK's ===
     866I2C NAK's can occur on v1 and v2 GSC's. This is because every second the GSC performs a round of ADC conversions for its hardware monitoring function. At worst, you should never fail an ACK more than 2 times in a row based on the amount of time needed for the ADC conversions.
    828867
    829868For this reason, you should retry and i2c read/write calls up to 3 times if the failure is a NAK (failure to ACK).
     
    865904sync && echo 2 > /sys/bus/i2c/devices/0-0020/powerdown
    866905}}}
    867   * power-down for 30 seconds:
     906 * power-down for 30 seconds:
    868907{{{
    869908#!bash
     
    874913[=#wdtdriver]
    875914== GSC Watchdog kernel driver ==
     915Note that Newport boards do not need or use the GSC Watchdog (see [#watchdog above]).
     916
    876917The gsc-wdt driver implements the Linux watchdog API for the hardware watchdog inside the GSC. When using this watchdog as opposed to the in-chip watchdog (ie mpcore for Laguna or imx for Ventana) the board will be fully power-cycled when/if the watchdog expires. This can be more reliable that SoC level resets which are done by the SoC watchdogs.
    877918
     
    10681109 * If you need more flexibility in monitoring the GSC pushbutton (ie you want to determine if the button has been pressed and held down for 10 seconds) you need to monitor its GPIO manually. See [#pushbutton pushbutton] for more details on how to do this.
    10691110
     1111
     1112[=#resetmonitor]
     1113= Reset Monitor =
     1114The third generation GSC used on the Newport product family acts as a hardware reset monitor for the board. For this feature the GSC monitors board-specific voltage rails before letting the CPU come out of reset.
     1115
     1116
    10701117[=#firmware]
    10711118= GSC Updates =
     
    10931140
    10941141GSC Firmware Downloads:
     1142 * [https://github.com/Gateworks/images-newport Newport Product Family]
    10951143 * [http://svn.gateworks.com/ventana/images Ventana Product Family]
    10961144 * [http://svn.gateworks.com/laguna/images Laguna Product Family]
     
    11091157  - fix temperature accuracy between -40C and 0C
    11101158  - added Ventana GW553X support
     1159  - added Newport GW630X support
    11111160 * v48:
    11121161  - fix Ventana wake by pushbutton for GW5400
     
    11411190Latest GSC revisions per baseboard:
    11421191||= family =||= board =||= revision                                                     =||
     1192|| Newport  || GW630x  || [https://github.com/Gateworks/images-newport/gsc_630x_v49.txt v49] ||
     1193||||
    11431194|| Ventana  || GW553x  || [http://svn.gateworks.com/ventana/images/gsc_553x_v50.txt v50] ||
    1144 || Ventana  || GW552x  || [http://svn.gateworks.com/ventana/images/gsc_552x_v50.txt v50] ||
    1145 || Ventana  || GW551x  || [http://svn.gateworks.com/ventana/images/gsc_551x_v50.txt v50] ||
    1146 || Ventana  || GW54xx  || [http://svn.gateworks.com/ventana/images/gsc_54xx_v50.txt v50] ||
    1147 || Ventana  || GW53xx  || [http://svn.gateworks.com/ventana/images/gsc_53xx_v50.txt v50] ||
    1148 || Ventana  || GW52xx  || [http://svn.gateworks.com/ventana/images/gsc_52xx_v50.txt v50] ||
    1149 || Ventana  || GW51xx  || [http://svn.gateworks.com/ventana/images/gsc_51xx_v50.txt v50] ||
     1195||          || GW552x  || [http://svn.gateworks.com/ventana/images/gsc_552x_v50.txt v50] ||
     1196||          || GW551x  || [http://svn.gateworks.com/ventana/images/gsc_551x_v50.txt v50] ||
     1197||          || GW54xx  || [http://svn.gateworks.com/ventana/images/gsc_54xx_v50.txt v50] ||
     1198||          || GW53xx  || [http://svn.gateworks.com/ventana/images/gsc_53xx_v50.txt v50] ||
     1199||          || GW52xx  || [http://svn.gateworks.com/ventana/images/gsc_52xx_v50.txt v50] ||
     1200||          || GW51xx  || [http://svn.gateworks.com/ventana/images/gsc_51xx_v50.txt v50] ||
    11501201||||
    11511202|| Laguna   || GW2391  || [http://svn.gateworks.com/laguna/images/gsc_2391_v50.txt v50]  ||
    1152 || Laguna   || GW2388  || [http://svn.gateworks.com/laguna/images/gsc_2388_v50.txt v50]  ||
    1153 || Laguna   || GW2387  || [http://svn.gateworks.com/laguna/images/gsc_2387_v50.txt v50]  ||
    1154 || Laguna   || GW2383  || [http://svn.gateworks.com/laguna/images/gsc_2383_v50.txt v50]  ||
    1155 || Laguna   || GW2382  || [http://svn.gateworks.com/laguna/images/gsc_2382_v50.txt v50]  ||
    1156 || Laguna   || GW2380  || [http://svn.gateworks.com/laguna/images/gsc_2380_v50.txt v50]  ||
     1203||          || GW2388  || [http://svn.gateworks.com/laguna/images/gsc_2388_v50.txt v50]  ||
     1204||          || GW2387  || [http://svn.gateworks.com/laguna/images/gsc_2387_v50.txt v50]  ||
     1205||          || GW2383  || [http://svn.gateworks.com/laguna/images/gsc_2383_v50.txt v50]  ||
     1206||          || GW2382  || [http://svn.gateworks.com/laguna/images/gsc_2382_v50.txt v50]  ||
     1207||          || GW2380  || [http://svn.gateworks.com/laguna/images/gsc_2380_v50.txt v50]  ||
    11571208
    11581209=== GSC Version ===
     
    11711222 * A BR1225 coin cell battery is used.
    11721223 * While primary board power is removed, the GSC battery can be removed for about 10 seconds before power is lost to the GSC.  This gives you a small window of time to replace the battery without losing data such as RTC values. If longer then 10 seconds then the GSC will be reset.
    1173  * If battery is replaced while board power is off, '''you must apply board power momentarily afterwards to reset the GSC into the proper operational state. If power is not applied the drain on the battery will be fairly large and will deplete the battery within about 3-4 weeks.'''
     1224 * !Laguna/Ventana ('''does not apply to Newport boards'''): If battery is replaced while board power is off, '''you must apply board power momentarily afterwards to reset the GSC into the proper operational state. If power is not applied the drain on the battery will be fairly large and will deplete the battery within about 3-4 weeks.'''.
    11741225  * To verify the GSC current consumption, you can measure the voltage across a diode (+ probe on anode, - probe on cathode). The voltage across the diode with no power applied to the board should be approximately 300mV. If you see something in the 400mV range that means the GSC is not reset properly or there is some type of contamination causing excessive current draw. Contact support with your serial number for specifics on which diode ( support@gateworks.com ).
    11751226 * Note that bat rail voltage cannot be measured via Linux software as shown above until board power is turned off for one second or more (a second time when battery is replaced/GSC reset). When power is off, we monitor the bat voltage every 9 hours. When the board is fully powered on and booted into Linux, the bat reading cannot be continually updated and reports the last read voltage when the board was last powered off.
    11761227 * The GSC can operate down to a battery voltage of 2.2V. If the battery goes below this erratic behavior can result and the battery should be either removed (operate without battery) or replaced.
    11771228 * A fresh battery typically has a voltage ranging from 2.8 to 3.1V (also depends on temperature). The battery discharge rate is fairly flat but once it is discharged it can decay rapidly. Note that when the board is powered, the 3.3V power supply supplies power to the GSC and the battery will not be drained. This should be factored in when determining battery lifetime.
    1178  * The BR1225 coin cell is rated at 50mA/hours. The GSC's typical drain when in low power mode is 1.5uA. Battery lifetime can be calculated by taking the battery rating divided by the current drain. Example: (50mA/hour)/(1.5uA) = 33.33K hours.
     1229 * The BR1225 coin cell is rated at 50mA/hours. Battery lifetime can be calculated by taking the battery rating divided by the current drain. The GSC's typical drain depends on the version:
     1230  - v1/v2 (!Laguna/Ventana): ~1.5uA: (50mA/hour)/(1.5uA) = 33.33K hours = 1388 days = 3.8 years
     1231  - v3 (Newport): ~1.2uA: (50mA/hour)/(1.1uA) = 45.45K hours = 1893 days = 5 years
     1232
    11791233
    11801234[=#firmware-reset]
     
    11971251  * All dedicated inputs are configured as inputs*
    11981252
     1253
    11991254[=#battstorage]
    12001255== Board Storage with respect to Battery ==