ADC
 
 
 Bean ADC
 
A/D converter
A/D prevodník

Preklad: jarjan 13.december 2008
Methods are user callable functions/subroutines that are means of controlling the bean functions.
Metódy sú užívateľom volatelné funkcie/podprogramy ktoré sú určené na riadenie funkcií "bean-ov".


Methods:
Metódy:

  • Enable - Enables A/D converter bean. Events may be generated (DisableEvent/EnableEvent). If possible, this method switches on A/D converter device, voltage reference, etc.
    Enable - (Povolenie) Povoľuje bean A/D prevodníka.  Events- Udalosti môžu byť generované (DisableEvent-ZakážUdalosť / EnableEvent-PovoľUdalosť).

      ANSIC prototype: byte Enable(void)
    • Return value: byte - Error code, possible codes:
      Návratová hodnota: byte - Chybový kód, možné kódy:
      ERR_OK -      OK t.j. v poriadku
      ERR_SPEED - This device does not work in the active speed mode
                     
             Toto zariadenie nepracuje v aktívnom rýchlostnom režime 

  • Disable - Disables A/D converter bean. No events will be generated. If possible, this method switches off A/D converter device, voltage reference, etc.
    Disable - (Zakázanie) Zakazuje bean A/D prevodníka. Žiadna events - udalosť nebude  generovaná. Ak je možné, táto metóda vypne zariadenie A/D prevodníka, spätnú napäťovú referenciu, atď.

      ANSIC prototype: byte Disable(void)
    • Return value:byte - Error code, possible codes:
      Návratová hodnota: byte - Chybový kód, možné kódy:
      ERR_OK - OK t.j. v poriadku
      ERR_SPEED - This device does not work in the active speed mode
                         
      Toto zariadenie nepracuje v aktívnom rýchlostnom režime 

  • EnableEvent - Enables the events.
    EnableEvent - (Povolenie udalosti) Povoľuje events- udalosti.

      ANSIC prototype: byte EnableEvent(void)
    • Return value:byte - Error code, possible codes:
      Návratová hodnota: byte
      - Chybový kód, možné kódy:
      ERR_OK - OK t.j. v poriadku
      ERR_SPEED - This device does not work in the active speed mode
                         
      Toto zariadenie nepracuje v aktívnom rýchlostnom režime 

  • DisableEvent - Disables the events.
    DisableEvent - (Zakázanie udalosti) Zakáže events- udalosti.

      ANSIC prototype: byte DisableEvent(void)
    • Return value:byte - Error code, possible codes:
      Návratová hodnota: byte - Chybový kód, možné kódy:
      ERR_OK - OK t.j. v poriadku
      ERR_SPEED - This device does not work in the active speed mode
                         
      Toto zariadenie nepracuje v aktívnom rýchlostnom režime 

  • Start - This method starts continuous conversion on all channels that are set in the bean inspector. When each measurement on all channels has finished the OnEnd event may be invoked. This method is not available if the interrupt service is disabled and the device doesn't support the continuous mode. Note: If time of measurement is too short and the instruction clock is too slow then the conversion complete interrupt and its handler may cause a system overflow.
    Start - Táto metóda štartne kontinuálnu konverziu na všetkých kanáloch ktoré sú nastavené v konfiguračnej tabuľke bean-u (pomocou bean inšpektora - modul vo vývojovej aplikácii). Keď každé meranie na všetkých kanáloch sa ukončí, môže byť vyvolaná udalosť  OnEnd. Táto metóda nie je dostupná ak zakázaná interrupt service - obsluha prerušenia a zariadenie nepodporuje kontinuálny režim. Upozornenie: Ak čas merania je príliš krátky a inštrukčné hodiny príliš pomalé potom prerušenie z dôvodu ukončenia konverzie a jeho obslužný program môžu spôsobiť pretečenie systému.  


      ANSIC prototype: byte Start(void)

    • Return value:byte - Error code, possible codes:
      Návratová hodnota: byte - Chybový kód, možné kódy:
      ERR_OK - OK t.j. v poriadku
      ERR_SPEED - This device does not work in the active speed mode
                        
      - Toto zariadenie nepracuje v aktívnom rýchlostnom režime 
      ERR_DISABLED - Device is disabled
                               - Zariadenie je zakázané
      ERR_BUSY - A conversion is already running
                       - Konverzia už beží

  • Stop - This method stops the continuous measurement, which had been started by Start method, or this method disables a trigger mode which has been enabled by EnableInt(Chan)Trigger or EnableExt(Chan)Trigger method (if these are supported by HW). This method is available if at least one of Start, EnableInt(Chan)Trigger or EnableExt(Chan)Trigger methods is supported by A/D converter device and it is enabled to be generated.
    Stop - Táto metóda zastaví kontinuálne meranie, ktoré bolo odštartované metódou Start, alebo táto metóda zakáže treiggerovací režim, ktorý bol povolený metódou  EnableInt(Chan)Trigger alebo EnableExt(Chan)Trigger (ak tieto sú podporované pomocou HW). Táto metóda je dostupná ak prinajmenšom jedna z metód  Start, EnableInt(Chan)Trigger alebo EnableExt(Chan)Trigger je podporovaná pomocou zariadenia A/D prevodníka a je povolené aby bol generovaný.

      ANSIC prototype: byte Stop(void)
    • Return value:byte - Error code, possible codes:
      Návratová hodnota: byte - Chybový kód, možné kódy:
      ERR_OK - OK t.j. v poriadku
      ERR_SPEED - This device does not work in the active speed mode 
                         - Toto zariadenie nepracuje v aktívnom rýchlostnom režime.
      ERR_BUSY - No continuous measurement is running. Neither internal trigger nor external trigger have been enabled (if these are supported by HW).
                       - Žiadne kontinuálne meranie nebeží. Nie je povolený ani interný ani externý trigger (ak sú tieto podporované HW-rom)

  • Measure - This method performs one measurement on all channels that are set in the bean inspector. (Note: If the number of conversions is more than one the conversion of A/D channels is performed specified number of times.)
    Measure - Táto metóda vykoná jedno meranie všetkých kanáloch ktoré sú nastavené v konfiguračnej tabuľke daného beanu (nastavené bean inšpektorom t.j. aplikácia vo vývojovom prostredí). (Upozornenie: Ak je v atribúte number of conversions - počet konverzií uvedené viac než jedna konverzia A/D kanálu, potom sa vykoná ním špecifikované množstvo meraní.)

      ANSIC prototype: byte Measure(bool WaitForResult)
    • WaitForResult:bool - Wait for a result of a conversion. If interrupt service is disabled, A/D peripheral doesn't support measuring all channels at once or Autoscan mode property isn't enabled and at the same time the number of channel is greater than 1, then the WaitForResult parameter is ignored and the method waits for each result every time. If the interrupt service is disabled and a number of conversions is greater than 1, the parameter is ignored and the method also waits for each result every time.
                                  - Čaká na výsledok konverzie. Ak je zakázaná  interrupt service - služba obsluhy prerušenia, A/D periféria nepodporuje meranie všetkých kanálov naraz alebo vlastnosť  Autoscan mode - Režim automatického scanovania nie je poveolená a v tom istom čase hodnota number of channel - počet kanálov je väčší než 1, potom parameter WaitForResult (ČakajNaVýsledok) je ignorovaný a metóda celý čas bude čakať na každý výsledok. Ak je interrupt service - obsluha prerušenia zakázaná a údaj  number of conversions - počet konverzií  je väčší než 1, potom bude parameter ignorovaný a metóda taktiež celý čas bude čakať na každý výsledok. 
    • Return value:byte - Error code, possible codes:
      Návratová hodnota: byte - Chybový kód, možné kódy:
      ERR_OK - OK t.j. v poriadku
      ERR_SPEED - This device does not work in the active speed mode 
      Toto zariadenie nepracuje v aktívnom rýchlostnom režime. 
      ERR_DISABLED - Device is disabled
                               - Zariadenie je zakázané
      ERR_BUSY - A conversion is already running
                       - Konverzia už beží

  • Methods for HCS12/HCS12X derivatives.
    Metódy pre rodinu procesorov HCS12/HCS12X. 

     

    • MeasureWait - This method performs one measurement on all channels that are set in the bean inspector and then waits till the end of the measurement. (Note: If the number of conversions is more than one the conversion of A/D channels is performed specified number of times.)
      MeasureWait - Táto metóda vykoná jedno meranie na všetkých kanáloch ktoré sú nastavené v konfiguračnej tabuľke daného beanu (nastavené bean inšpektorom t.j. aplikácia vo vývojovom prostredí) a potom čaká na ukončenie merania.  (Upozornenie: Ak je v atribúte number of conversions - počet konverzií uvedené viac než jedna konverzia A/D kanálu, potom sa vykoná ním špecifikované množstvo meraní.)

        ANSIC prototype: byte MeasureWait(void)
      • Return value:byte - Error code, possible codes:
        Návratová hodnota: byte - Chybový kód, možné kódy:
        ERR_OK - OK t.j. v poriadku
        ERR_SPEED - This device does not work in the active speed mode 
        Toto zariadenie nepracuje v aktívnom rýchlostnom režime. 
        ERR_DISABLED - Device is disabled
                                 - Zariadenie je zakázané
        ERR_BUSY - A conversion is already running
                         - Konverzia už beží

    • MeasureNotWait - This method performs one measurement on all channels that are set in the bean inspector and doesn't wait till the end of the measurement. (Note: If the number of conversions is more than one the conversion of A/D channels is performed specified number of times.)
      MeasureNotWait - Táto metóda vykoná meranie na všetkých kanáloch ktoré sú nastavené v konfiguračnej tabuľke daného beanu (nastavené bean inšpektorom t.j. aplikácia vo vývojovom prostredí) a  nečaká na ukončenie merania. (Upozornenie: Ak je v atribúte number of conversions - počet konverzií uvedené viac než jedna konverzia A/D kanálu, potom sa vykoná ním špecifikované množstvo meraní.)

        ANSIC prototype: byte MeasureNotWait(void)
      • Return value:byte - Error code, possible codes:
        Návratová hodnota: byte - Chybový kód, možné kódy:
        ERR_OK - OK t.j. v poriadku
        ERR_SPEED - This device does not work in the active speed mode 
        Toto zariadenie nepracuje v aktívnom rýchlostnom režime. 
        ERR_DISABLED - Device is disabled
                                 - Zariadenie je zakázané
        ERR_BUSY - A conversion is already running
                         - Konverzia už beží

  • MeasureChan - This method performs measurement on one channel. (Note: If the number of conversions is more than one the conversion of the A/D channel is performed specified number of times.)
    MeasureChan - Táto metóda vykonáva meranie na jednom kanáli.   (Upozornenie: Ak je v atribúte number of conversions - počet konverzií uvedené viac než jedna konverzia A/D kanálu, potom sa vykoná ním špecifikované množstvo meraní.)


      ANSIC prototype: byte MeasureChan(bool WaitForResult,byte Channel)

    • WaitForResult:bool - Wait for a result of conversion. If the interrupt service is disabled and at the same time a number of conversions is greater than 1, the WaitForResult parameter is ignored and the method waits for each result every time.
                                   - Čaká na výsledok merania. Ak je interrupt service- obsluha prerušenia zakázaná a v tom istom čase je atribút number of conversions - počet konverzií väčší než 1, potom je parameter WaitForResult (čakaj na výsledok) ignorovaný a metóda zakaždým čaká na každý výsledok.
    • Channel:byte - Channel number. If only one channel in the bean is set this parameter is ignored, because the parameter is set inside this method.
                           - Číslo kanála. Ak v konfiguračnej tabuľke beanu je nastavený len jeden kanál, potom je tento parameter ignorovaný, pretože tento parameter je nastavený vo vnútri metódy.
    • Return value:byte - Error code, possible codes:
      Návratová hodnota: byte - Chybový kód, možné kódy:
      ERR_OK - OK t.j. v poriadku
      ERR_SPEED - This device does not work in the active speed mode 
      Toto zariadenie nepracuje v aktívnom rýchlostnom režime. 
      ERR_DISABLED - Device is disabled
                               - Zariadenie je zakázané
      ERR_BUSY - A conversion is already running
                       - Konverzia už beží
      ERR_RANGE - Parameter "Channel" out of range 
                          - Parameter "Channel" t.j. "Kanál" je mimo rozsah

  • Methods for Freescale HCS12/HCS12X derivatives.
    Metódy pre rodinu procesorov Freescale HCS12/HCS12X

     

    • MeasureChanWait - This method performs one measurement on one channel and waits till the end of the measurement. (Note: If the number of conversions is more than one the conversion of A/D channels is performed specified number of times.)
      MeasureChanWait - Táto metóda vykoná jedno meranie na jeden kanál a čaká pokiaľ sa meranie neukončí. (Upozornenie: Ak je v atribúte number of conversions - počet konverzií uvedené viac než jedna konverzia A/D kanálu, potom sa vykoná ním špecifikované množstvo meraní.)

        ANSIC prototype: byte MeasureChanWait(byte Channel)
      • Channel:byte - Channel number. If only one channel in the bean is set then this parameter is ignored, because the parameter is set inside this method.
                             - Číslo kanála. Ak v konfiguračnej tabuľke je nastavený len jeden kanál, potom je tento parameter ignorovaný, pretože tento parameter je nastavený vo vnútri metódy.
      • Return value:byte - Error code, possible codes:
        Návratová hodnota: byte - Chybový kód, možné kódy:
        ERR_OK - OK t.j. v poriadku
        ERR_SPEED - This device does not work in the active speed mode 
        Toto zariadenie nepracuje v aktívnom rýchlostnom režime. 
        ERR_DISABLED - Device is disabled
                                 - Zariadenie je zakázané
        ERR_BUSY - A conversion is already running
                         - Konverzia už beží
        ERR_RANGE - Parameter "Channel" out of range 
                            - Parameter "Channel" t.j. "Kanál" je mimo rozsah

    • MeasureChanNotWait - This method performs one measurement from one channel and doesn't wait till the end of the measurement. (Note: If the number of conversions is more than one the conversion of A/D channels is performed specified number of times.)
      MeasureChanNotWait - Táto metóda vykoná jedno meranie z jedného kanála a nečaká na ukončenie merania. (Upozornenie: Ak je v atribúte number of conversions - počet konverzií uvedené viac než jedna konverzia A/D kanálu, potom sa vykoná ním špecifikované množstvo meraní.)

        ANSIC prototype: byte MeasureChanNotWait(byte Channel)
      • Channel:byte - Channel number. If only one channel in the bean is set then this parameter is ignored, because the parameter is set inside this method.
                              - Číslo kanála. Ak v konfiguračnej tabuľke je nastavený len jeden kanál, potom je tento parameter ignorovaný, pretože tento parameter je nastavený vo vnútri metódy.  
      • Return value:byte - Error code, possible codes:
        Návratová hodnota: byte - Chybový kód, možné kódy:
        ERR_OK - OK t.j. v poriadku
        ERR_SPEED - This device does not work in the active speed mode 
        Toto zariadenie nepracuje v aktívnom rýchlostnom režime. 
        ERR_DISABLED - Device is disabled
                                 - Zariadenie je zakázané
        ERR_BUSY - A conversion is already running
                         - Konverzia už beží
        ERR_RANGE - Parameter "Channel" out of range 
                            - Parameter "Channel" t.j. "Kanál" je mimo rozsah.


    • EnableExtTrigger - Enables the trigger mode. If an active edge or an active level (property Trigger active) is detected, conversion of all channels that are set in the bean inspector is performed. If the Number of conversions property is greater than 1, a conversion is needed to be launched more than once (by external signal) according to a specified value of Number of conversions. It's possible to disable the trigger mode by Stop method. This EnableExtTrigger method is available only when the Trigger feature property is enabled.
      EnableExtTrigger - Povoľuje triggerovací režim. Ak je detekovaná aktívna hrana alebo hladina (vlasttnosť Trigger active), vykoná sa konverzia všetkých kanálov, ktoré sú nastavené v konfiguračnej tabuľke benu (nastavovanej aplikáciou bean inšpektor). Ak je vlastnosť  Number of conversions - počet konverzií väčší než 1, konverzia bude odštartovaná viac než jeden krát (externým signálom) podľa špecifikovanej hodnoty  Number of conversions - Počet konverzií. Pomocou metódy Stop je možné zakázať triggerovací režim. Metóda EnableExtTrigger je dostupná jedine ak je povolená vlastnosť Trigger feature

        ANSIC prototype: byte EnableExtTrigger(void)
      • Return value:byte - Error code, possible codes:
        Návratová hodnota: byte - Chybový kód, možné kódy:
        ERR_OK - OK t.j. v poriadku
        ERR_BUSY - A conversion is already running
                         - Konverzia už beží

    • EnableExtChanTrigger - Enables the trigger mode. If an active edge or an active level (property Trigger active) is detected, a conversion of only one required channel will be performed. If the Number of conversions is greater than 1, a conversion will be launched more than once (by an external signal) according to Number of conversions. It's possible to disable the trigger mode by Stop method. This EnableExtChanTrigger method is available only when Trigger feature property is enabled.
      EnableExtChanTrigger - Povoľuje treiggerovací režim. Ak je detekovaná aktívna hrana alebo hladina (vlastnosť Trigger active) vykoná sa konverzia iba jedného požadovaného kanála.  Ak je Number of conversions- Počet konverzií väčší než 1, konverzia sa odštartuje viac krát než jediný raz (externým sigálom) podľa hodnoty Number of conversions - Počet konverzií.  Pomocou metódy Stop je možné zakázať triggerovací režim. Táto metóda EnableExtChanTrigger je dostupná jedine ak je nastavená t.j. povolená vlastnosť  Trigger feature.

        ANSIC prototype: byte EnableExtChanTrigger(byte Channel)
      • Channel:byte - Channel number which will be measured on an external trigger (control). If only one channel in the bean is set then this parameter is ignored.
                             - Číslo kanála ktorý bude meraný pod riadením externého triggeru. Ak je len jeden kanál nastavený v beane, potom je tento parameter ignorovaný. 
      • Return value:byte - Error code, possible codes:
        Návratová hodnota: byte - Chybový kód, možné kódy:
        ERR_OK - OK t.j. v poriadku
        ERR_BUSY - A conversion is already running
                         - Konverzia už beží
        ERR_RANGE - Parameter "Channel" out of range 
                            - Parameter "Channel" t.j. "Kanál" je mimo rozsah.

  • Methods for Freescale 56800 and HCS12X derivatives.
    Metódy pre Freescale 56800 and HCS12X rodinu procesorov.

     

    • EnableIntTrigger - Enables the internal trigger mode. A conversion of all channels that are set in the bean inspector will be launched by an internal sync pulse. If the Number of conversions is greater than 1, a conversion will be launched more than once (by an internal signal) according to Number of conversions. It's possible to disable the trigger mode by Stop method. This EnableIntTrigger method is available only when the Internal trigger property is enabled.
      EnableIntTrigger - Povoľuje interný triggerovací režim. Interný synchronizačný impulz odštartuje konverziu všetkých kanálov, ktoré sú nastavené v konfiguračnej tabuľke beanu (nastavovanej aplikáciou bean inšpektor).  Ak je atribút  Number of conversions - Počet konverzií väčší než 1, konverzia bude odštartovaná viac než jeden krát (interným signálom) podľa hodnoty  Number of conversions - Počet konverzií. Pomocou metódy Stop je možné zakázať triggerovací režim. Spomenutá metóda EnableIntTrigger je dostupná len vtedy ak je povolená vlastnosť Internal trigger - Interný trigger.

        ANSIC prototype: byte EnableIntTrigger(void)
      • Return value:byte - Error code, possible codes:
        Návratová hodnota: byte - Chybový kód, možné kódy:
        ERR_OK - OK t.j. v poriadku
        ERR_BUSY - A conversion is already running
                         - Konverzia už beží

  • Methods for Freescale 56800, HCS12X and HCS08 AW60, QG8, QG4 and RT16 derivatives.
    Metódy pre Freescale 56800, HCS12X a HCS08 AW60, QG8, QG4 a RT16 rodiny procesorov. 

     

    • EnableIntChanTrigger - Enables the internal trigger mode. A conversion of one required channel will be launched by internal sync pulse. If the Number of conversions property is greater than 1, a conversion will be launched more than once (by an internal signal) according to Number of conversions. It's possible to disable the trigger mode by Stop method. This EnableIntChanTrigger method is available only when the Internal trigger property is enabled.
      EnableIntChanTrigger - Povoľuje interný trigger-ovací režim. Konverzia jednoho požadovaného kanála bude odštartovaný interným impulzom.  Ak vlastnosť  Number of conversions - počet konverzií je väčší než 1, konverzia bude odštartovaná viac krát než len raz (interným signálom) podľa Number of conversions - počtu konverzií. Pomocou metódy Stop je možné zakázať triggerovací režim. Táto metóda - EnableIntChanTrigger - je dostupná len keď je povolená vlastnosť  Internal trigger - Interný trigger.

        ANSIC prototype: byte EnableIntChanTrigger(byte Channel)
      • Channel:byte - Channel number which will be measured at internal trigger control. If only one channel in the bean is set then this parameter is ignored.
                              - Číslo kanála ktorý bude meraný pod riadením triggeru. Ak je len jeden kanál nastavený v beane, potom je tento parameter ignorovaný. 
      • Return value:byte - Error code, possible codes:
        Návratová hodnota: byte - Chybový kód, možné kódy:
        ERR_OK - OK t.j. v poriadku
        ERR_BUSY - A conversion is already running
                         - Konverzia už beží
        ERR_RANGE - Parameter "Channel" out of range 
                            - Parameter "Channel" t.j. "Kanál" je mimo rozsah.

  • GetValue - Returns the last measured values for all channels. Format and width of the value is a native format of the A/D converter.
    GetValue - Vracia poslednú nameranú hodnotu pre všetky kanály. Formát a šírka hodnoty je daná formátom A/D prevodníka.  

      ANSIC prototype: byte GetValue(void* Values)
    • Values:void* - Pointer to the array that contains the measured data. Data type is a byte, a word or an int. It depends on the supported modes, resolution, etc. of the AD converter. See the Version specific information for the current CPU in General Info.
                          - Pointer na pole obsahujúce namerané hodnoty. Datový typ je byte, word alebo int. (byte - hodnoty 0-255, word - hodnoty 0-65535, integer - t.j. znamienkový výsledok) Závisí to od podporovaných režimoch, rozlíšení, atď. AD prevodníka. Pozrite špecifické informácie ku konkrétnemu CPU v časti General Info.
    • Return value:byte - Error code, possible codes:
      Návratová hodnota: byte - Chybový kód, možné kódy:
      ERR_OK - OK t.j. v poriadku
      ERR_SPEED - This device does not work in the active speed mode 
      Toto zariadenie nepracuje v aktívnom rýchlostnom režime. 
      ERR_NOTAVAIL - Requested value not available
      Požadovaná hodnota nie je dostupná
      ERR_OVERRUN - External trigger overrun flag was detected after the last value(s) was obtained (for example by GetValue). This error may not be supported on some CPUs (see generated code).
      Po tom ako bola obdržaná posledná (-é) hodnota (-ty) (napríklad pomocou GetValue - vezmi si hodnotu) bol detekovaný príznak pretečenia externého triggeru. Táto chyba nemusí byť podporovaná na niektorých CPU-čkach (pozrite si generovaný kód). 

  • GetChanValue - Returns the last measured value of the required channel. Format and width of the value is a native format of the A/D converter.
    GetChanValue - Vracia poslednú nameranú hodnotu požadovaného kanála. Formát a šírka hodnoty je daná formátom A/D prevodníka. 

      ANSIC prototype: byte GetChanValue(byte Channel,void* Value)
    • Channel:byte - Channel number. If only one channel in the bean is set then this parameter is ignored.
                           - Číslo kanála. Ak je v "beane" nastavený len jeden kanál, potom je tento parameter ignorovaný.
    • Value:void* - Pointer to the measured value. Data type is a byte, a word or an int. It depends on the supported modes, resolution, etc. of the AD converter. See the Version specific information for the current CPU in General Info.
                        - Pointer na nameranú hodnotu. Datový typ je byte, word alebo int. (byte - hodnoty 0-255, word - hodnoty 0-65535, integer - t.j. znamienkový výsledok) Závisí to od podporovaných režimoch rozlíšenia, atď. AD prevodníka. Pozrite špecifické informácie ku konkrétnemu CPU v časti General Info.
    • Return value:byte - Error code, possible codes:
      Návratová hodnota: byte - Chybový kód, možné kódy:
      ERR_OK - OK t.j. v poriadku
      ERR_SPEED - This device does not work in the active speed mode
                         - Toto zariadenie nepracuje v aktívnom rýchlostnom režime. 
      ERR_NOTAVAIL - Requested value not available
                               - Požadovaná hodnota nie je dostupná
      ERR_RANGE - Parameter "Channel" out of range 
                          - Parameter "Channel" t.j. "Kanál" je mimo rozsah.
      ERR_OVERRUN - External trigger overrun flag was detected after the last value(s) was obtained (for example by GetValue). This error may not be supported on some CPUs (see generated code).
                              - Po tom ako bola obdržaná posledná (-é) hodnota (-ty) (napríklad pomocou GetValue - vezmi si hodnotu) bol detekovaný príznak pretečenia externého triggeru. Táto chyba nemusí byť podporovaná na niektorých CPU-čkach (pozrite si generovaný kód). 

  • GetValue8 - This method returns the last measured values of all channels justified to the left. Compared with GetValue method this method returns more accurate result if the number of conversions is greater than 1 and AD resolution is less than 8 bits. In addition, the user code dependency on AD resolution is eliminated.
    GetValue8 -  Táto metóda vracia posledne nameranú hodnotu požadovaného kanála zarovnanú doľava. V porovnaní s metódou GetValue táto metóda vracia presnejšie hodnoty ak number of conversions - počet konverzií je väčší než 1 a AD resolution - AD rozlíšenie je menšie než 8 bitov. Naviac, závislosť užívateľovho programu od  AD resolution - AD rozlíšenie je eliminovaná.

      ANSIC prototype: byte GetValue8(byte *Values)
    • Values: Pointer to byte - Pointer to the array that contains the measured data.
                                         - Pointer do poľa ktoré obsahuje namerané dáta. 
    • Return value:byte - Error code, possible codes:
      Návratová hodnota: byte - Chybový kód, možné kódy:
      ERR_OK - OK t.j. v poriadku
      ERR_SPEED - This device does not work in the active speed mode 
      Toto zariadenie nepracuje v aktívnom rýchlostnom režime. 
      ERR_NOTAVAIL - Requested value not available
      Požadovaná hodnota nie je dostupná
      ERR_OVERRUN - External trigger overrun flag was detected after the last value(s) was obtained (for example by GetValue). This error may not be supported on some CPUs (see generated code).
      Po tom ako bola obdržaná posledná (-é) hodnota (-ty) (napríklad pomocou GetValue - vezmi si hodnotu) bol detekovaný príznak pretečenia externého triggeru. Táto chyba nemusí byť podporovaná na niektorých CPU-čkach (pozrite si generovaný kód). 

  • GetChanValue8 - This method returns the last measured value of required channel justified to the left. Compared with GetChanValue method this method returns more accurate result if the number of conversions is greater than 1 and AD resolution is less than 8 bits. In addition, the user code dependency on AD resolution is eliminated.
    GetChanValue8 - Táto metóda vracia posledne nameranú hodnotu požadovaného kanála zarovnanú doľava. V porovnaní s metódou  GetChanValue táto metóda vracia presnejšie hodnoty ak number of conversions - počet konverzií je väčší než 1 a AD resolution - AD rozlíšenie je menšie než 8 bitov. Naviac, závislosť užívateľovho programu od  AD resolution - AD rozlíšenie je eliminovaná.

      ANSIC prototype: byte GetChanValue8(byte Channel,byte *Value)
    • Channel:byte - Channel number. If only one channel in the bean is set then this parameter is ignored.
                           - Číslo kanála. Ak je v "beane" nastavený len jeden kanál, potom je tento parameter ignorovaný.
    • Value: Pointer to byte - Pointer to the measured value.
      Hodnota: Pointer na byte - Pointer na nameranú hodnotu
    • Return value:byte - Error code, possible codes:
      Návratová hodnota: byte - Chybový kód, možné kódy:
      ERR_OK - OK t.j. v poriadku
      ERR_SPEED - This device does not work in the active speed mode 
      Toto zariadenie nepracuje v aktívnom rýchlostnom režime. 
      ERR_NOTAVAIL - Requested value not available
      Požadovaná hodnota nie je dostupná
      ERR_RANGE - Parameter "Channel" out of range Parameter "Channel" t.j. "Kanál" je mimo rozsah.
      ERR_OVERRUN - External trigger overrun flag was detected after the last value(s) was obtained (for example by GetValue). This error may not be supported on some CPUs (see generated code).
      Po tom ako bola obdržaná posledná (-é) hodnota (-ty) (napríklad pomocou GetValue - vezmi si hodnotu) bol detekovaný príznak pretečenia externého triggeru. Táto chyba nemusí byť podporovaná na niektorých CPU-čkach (pozrite si generovaný kód). 

  • GetValue16 - This method returns the last measured values of all channels justified to the left. Compared with GetValue method this method returns more accurate result if the number of conversions is greater than 1 and AD resolution is less than 16 bits. In addition, the user code dependency on AD resolution is eliminated.
    GetValue16 - Táto metóda vracia posledne namerané hodnoty všetkých kanálov zarovnaných doľava. V porovnaní s GetValue metódou táto metóda vracia presnejšie výsledky ak  je number of conversions - počet konverzií je väčší ako 1 a AD resolution - AD rozlíšenie  je menšia ako 16 bitov. Naviac, závislosť užívateľského kódu od  AD resolution - AD rozlíšenia  je eliminovaná.

      ANSIC prototype: byte GetValue16(word *Values)
    • Values: Pointer to word - Pointer to the array that contains the measured data.
                  Pointer na "slovo" (word) - Pointer na poľe ktoré obsahuje namerané dáta. 
    • Return value:byte - Error code, possible codes:
      Návratová hodnota: byte - Chybový kód, možné kódy:
      ERR_OK           - OK t.j. v poriadku
      ERR_SPEED      - This device does not work in the active speed mode 
      Toto zariadenie nepracuje v aktívnom rýchlostnom režime. 
      ERR_NOTAVAIL - Requested value not available
      Požadovaná hodnota nie je dostupná
      ERR_OVERRUN  - External trigger overrun flag was detected after the last value(s) was obtained (for example by GetValue). This error may not be supported on some CPUs (see generated code).
                               - Po tom ako bola obdržaná posledná (-é) hodnota (-ty) (napríklad pomocou GetValue - vezmi si hodnotu) bol detekovaný príznak pretečenia externého triggeru. Táto chyba nemusí byť podporovaná na niektorých CPU-čkach (pozrite si generovaný kód). 

  • GetChanValue16 - This method returns the last measured value of the required channel justified to the left. Compared with GetChanValue method this method returns more accurate result if the number of conversions is greater than 1 and AD resolution is less than 16 bits. In addition, the user code dependency on AD resolution is eliminated.
    GetChanValue16 - Táto metóda vráti posledne nameranú hodnotu požadovaného kanála zarovnanú doľava. V porovnaní s metódou  GetChanValue táto metóda vracia presnejší výsledok ak number of conversions- počet konverzií je väčší ako 1 a AD resolution - AD rozlíšenie je menšie ako 16 bitov. Naviac, závislosť užívateľského programu na AD resolution - rozlíšení  je eliminovaná.

      ANSIC prototype: byte GetChanValue16(byte Channel,word *Value)
    • Channel:byte - Channel number. If only one channel in the bean is set then this parameter is ignored.
                           - Číslo kanála. Ak len jeden kanál je nastavený v "beane" potom  tento parameter je ignorovaný
    • Value: Pointer to word - Pointer to the measured value. 
                                        - Pointer na nameranú hodnotu.
    • Return value:byte - Error code, possible codes:
      Návratová hodnota: byte - Chybový kód, možné kódy:
      ERR_OK            - OK t.j. v poriadku
      ERR_SPEED      - This device does not work in the active speed mode
                             
      - Toto zariadenie nepracuje v aktívnom rýchlostnom režime. 
      ERR_NOTAVAIL - Requested value not available 
                               - Požadovaná hodnota nie je dostupná
      ERR_RANGE       - Parameter "Channel" out of range 
                               - Parameter "Channel" t.j. "Kanál" je mimo rozsah.
      ERR_OVERRUN   - External trigger overrun flag was detected after the last value(s) was obtained (for example by GetValue). This error may not be supported on some CPUs (see generated code). 
                                - Po tom ako bola obdržaná posledná (-é) hodnota (-ty) (napríklad pomocou GetValue - vezmi si hodnotu) bol detekovaný príznak pretečenia externého triggeru. Táto chyba nemusí byť podporovaná na niektorých CPU-čkach (pozrite si generovaný kód). 


Note: Some methods can be implemented as macros.
Poznámka: Niektoré metódy môžu byť implementované ako makrá. 



Processor ExpertTM and Embedded BeansTM are registered trademarks of UNIS, Ltd.
©1997-2005, UNIS, Ltd.