FULL-C: SD card - Historie editací

Adamn v 29. 12. 2022, 10:52

2022-12-29T10:52:30Z

Adamn v 29. 12. 2022, 10:48

2022-12-29T10:48:22Z

Adamn v 29. 12. 2022, 10:34

2022-12-29T10:34:22Z

Adamn v 29. 12. 2022, 09:35

2022-12-29T09:35:00Z

Adamn v 28. 12. 2022, 19:14

2022-12-28T19:14:11Z

Adamn v 28. 12. 2022, 18:56

2022-12-28T18:56:26Z

Adamn v 23. 11. 2022, 17:28

2022-11-23T17:28:42Z

Adamn v 13. 11. 2022, 09:17

2022-11-13T09:17:11Z

Adamn v 12. 11. 2022, 18:56

2022-11-12T18:56:21Z

Adamn v 12. 11. 2022, 18:51

2022-11-12T18:51:28Z

@@ Řádek 579: / Řádek 579: @@
     struct filinfo_t finfo;
-    // otevreme soubor pro zapis
+    // ziskej informace o souboru
     err = file_stat("soubor1.txt", (void *)&finfo);
     if (0 != err) { ... zpracuj_chybu ... };
@@ Řádek 666: / Řádek 666: @@
 Postupně předává obsah otevřené složky (viz file_opendir), tedy postupně předává položky ze seznamu prvků (souborů, podsložek), tedy provádí výpis obsahu složky.
 <syntaxhighlight lang="c">
@@ Řádek 691: / Řádek 693: @@
     struct filinfo_t finfo;
-    // otevreme soubor pro zapis
+    // dej dalsi polozku ze seznamu v ramci otevrene slozky
     err = file_readdir((void *)&DP, (void *)&finfo);
     if (0 != err) { ... zpracuj_chybu ... };

@@ Řádek 88: / Řádek 88: @@
 Typ SD karty je uveden v indexu 3853. Jednotlivé možné hodnoty jsou (pozor na rozlišení dle typu SDS):
-  SDS BIG/STSW varianty 64 a 128 :
+  Pro všechny SDS BIG/STSW varianty 64 a 128 :
   hodnota | význam
@@ Řádek 101: / Řádek 101: @@
 | High Capacity MMC Card
-  SDS BIG/STSW varianty 512 :
+  Jinak tomu je pro všechny SDS BIG/STSW varianty '''512''' :
   hodnota | význam
@@ Řádek 110: / Řádek 110: @@
-Pokud náhodou nebude vaše SD karta v modulu SDS pracovat, zkontrolujte, je-li její typ správný (údaj je uveden i na webové administraci).
+Pokud náhodou nebude vaše SD karta v modulu SDS pracovat, nejprve zkontrolujte, je-li její typ správný (potřebné údaje jsou uvedeny i ve webové administraci SDS).
 === Doporučená SD karta ===
-Doporučujeme použít Micro SD kartu výrobce Kingston, typ SHDC INDUSTRIAL velikost 16 GB, typ SDCIT2/15GB (EAN 740617321104).
+Doporučujeme použít Micro SD kartu výrobce Kingston, typ SHDC INDUSTRIAL velikost 16 GB, typ SDCIT2/15GB (EAN 740617321104). Lze použít i větší nebo menší velikosti.
@@ Řádek 631: / Řádek 631: @@
 '''Parametry funkce:'''
 * ''file_path'' - textová cesta s názvem nové složky; cesta se dává vždy celá a od rootu (kořenová složka) SD karty

@@ Řádek 566: / Řádek 566: @@
 <syntaxhighlight lang="c">
-typedef struct {
+struct filinfo_t {
     uint64_t fsize;      // File size
-    uint16_t fdate;      // Modified date
+    unsigned short fdate;      // Modified date
-    uint16_t ftime;      // Modified time
+    unsigned short ftime;      // Modified time
-    uint8_t  fattrib;	// File attribute
+    unsigned char  fattrib;	// File attribute
     char     altname[12 + 1]; // Altenative file name
     char     fname[255 + 1];  // Primary file name
-} filinfo_t;
+};
+{
     int err;
-    filinfo_t finfo;
+    struct filinfo_t finfo;
     // otevreme soubor pro zapis
@@ Řádek 714: / Řádek 714: @@
 <syntaxhighlight lang="c">
-typedef struct {
+struct filinfo_t {
     uint64_t fsize;      // File size
-    uint16_t fdate;      // Modified date
+    unsigned short fdate;      // Modified date
-    uint16_t ftime;      // Modified time
+    unsigned short ftime;      // Modified time
-    uint8_t  fattrib;	// File attribute
+    unsigned char  fattrib;	// File attribute
     char     altname[12 + 1]; // Altenative file name
     char     fname[255 + 1];  // Primary file name
-} filinfo_t;
+};
+{
     int err;
-    filinfo_t finfo; // obsahuje informace o polozce v seznamu
+    filinfo_t file_info; // obsahuje informace o polozce v seznamu
     unsigned int dir[25]; // pracovni pametovy prostor 100B
@@ Řádek 735: / Řádek 735: @@
     for (;;)
+    {
-      // dej dalsi polozku do "fno" (v ramci seznamu "dir")
+      // dej dalsi polozku do "file_info" (v ramci seznamu "dir")
-      err = file_readdir((void *)&dir, (void *)&fno);
+      err = file_readdir((void *)&dir, (void *)&file_info);
       // hotovo ?
-      if ( (0 != err) || (0 == fno.fname[0])) break;
+      if ( (0 != err) || (0 == file_info.fname[0])) break;
-      // jeste neni hotovo, takze fno obsahuje dalsi nalezenou polozku na seznamu v prohledavane slozce
+      // jeste neni hotovo, takze "file_info" obsahuje dalsi nalezenou polozku na seznamu v prohledavane slozce
-      printf("FOUND: %s [attr:%hhu]\n", fno.fname, fno.fattrib);
+      printf("FOUND: %s [attr:%hhu]\n", file_info.fname, file_info.fattrib);
+    }
@@ Řádek 750: / Řádek 750: @@
 </syntaxhighlight>
-Pomocí fno.attr můžete rozlišit, o jaký typ souboru se jedná. Je to standardní význam pro běžný FAT systém:
+Pomocí file_info.attr můžete rozlišit, o jaký typ souboru se jedná. Je to standardní význam pro běžný FAT systém (bity lze kombinovat):
-  fno.attr bit | význam
+  attr: bit    | význam
-  -------------+-----------
+  -------------+------------------------
 x01        | read-only
 x02        | hidden

@@ Řádek 729: / Řádek 729: @@
     // otevreme slozku pro prohledani - zde v prikladu je to "/" coz je korenova (root) slozka
-    err = file_opendir("/", (void *)&dir);
+    err = file_opendir((void *)&dir, "/");
     if (0 != err) { ... zpracuj_chybu ... };
@@ Řádek 735: / Řádek 735: @@
     for (;;)
+    {
-      // dej dalsi polozku
+      // dej dalsi polozku do "fno" (v ramci seznamu "dir")
       err = file_readdir((void *)&dir, (void *)&fno);
       // hotovo ?

@@ Řádek 707: / Řádek 707: @@
 Základní princip:
-. složka, kterou prohledáváme, se "otevře" funkcí file_opendir()
+. složka, kterou prohledáváme, se "otevře" funkcí file_opendir()<br>
-. provede se postupné čtení obsahu (všechny soubory a pod-složky), postupným volání file_readdir() - ta vrací vždy jednu položku (nebo informaci o konci seznamu)
+. provede se postupné čtení obsahu (všechny soubory a pod-složky), postupným volání file_readdir() - ta vrací vždy jednu položku (nebo informaci o konci seznamu)<br>
 . po prohledání celé původní složky, se musí složka "uzavřít" funkcí file_closedir()
 Použití opendir/closedir je nezbytné a nesmí se vynechat (zejména closedir), protože tyto funkce interně alokují pracovní paměť uvnitř SDS. Pokud otevřenou složku neuzavřete, postupně může dojít k tomu, že volná paměť dojde, a váš FC program nebude moct dále pracovat. Toto je typická chyba (zapomenutí volání file_closedir() funkce).
-TODO příklad
+<syntaxhighlight lang="c">

@@ Řádek 174: / Řádek 174: @@
            int file_mkdir(char * file_path);
           void SDS_disable_sdc(unsigned int key);
@@ Řádek 691: / Řádek 695: @@
 </syntaxhighlight>

@@ Řádek 213: / Řádek 213: @@
      -18      | TOO_MANY_FILES | soubor nelze otevřít, protože už jste dosáhli maximálního počtu současně otevřených souborů
      -19      | INVALID_PARAM  | obecná chyba - byl zadán neplatný parametr
      -21      | NO_CONT_SPACE  | (teprve od FW 11/2022) nenalezeno požadované souvislé místo na disku
      -99      | NO_SD_CARD     | SD karta není připravena k použití (např. není fyzicky vložena do držáku)
   ------------+----------------+---------------------------------------------------------------------------------------------------
@@ Řádek 483: / Řádek 483: @@
 * -7  ... nepodporovaný typ alokační tabulky
 * -7  ... špatné parametry (file_handle, new_size, op_mode)
 * -21 (původně také -7) ... (teprve od FW 11/2022) nenalezeno požadované souvislé místo na disku - file_expand neprovedeno

← Starší verze		Verze z 13. 11. 2022, 09:17
Řádek 115:		Řádek 115:
	=== Doporučená SD karta ===		=== Doporučená SD karta ===

−	Doporučujeme použít Micro SD kartu výrobce Kingston, typ INDUSTRIAL velikost 16 GB.	+	Doporučujeme použít Micro SD kartu výrobce Kingston, typ SHDC INDUSTRIAL velikost 16 GB, typ SDCIT2/15GB (EAN 740617321104).

@@ Řádek 21: / Řádek 21: @@
 FULL-C přistupuje k SD kartě prostřednictvím funkcí a některých get-indexů.
-SD karta má v rámci výrobku SDS více možných a sdílených využití, [[SDS_user_web|informace jsou zde]]. Nejzajímavější je možnost kombinace FULL-C programu a webového serveru SDS, kdy SDS zobrazuje webové stránky ze SD karty, přičemž FULL-C program má možnost tyto soubory změnit dle potřeby (např. postupné doplňování změřených hodnot).
+SD karta má v rámci výrobku SDS více možných a sdílených využití, [[User_Web_Page|informace jsou zde]]. Nejzajímavější je možnost kombinace FULL-C programu a webového serveru SDS, kdy SDS zobrazuje webové stránky ze SD karty, přičemž FULL-C program má možnost tyto soubory změnit dle potřeby (např. postupné doplňování změřených hodnot).
@@ Řádek 86: / Řádek 86: @@
 Každá SD karta interně pracuje s bloky o velikost sektoru, a takový sektor může mít různou velikost. Typicky je to 512 bajtů. Aktuální velikost sektoru lze zjistit z indexu 3852. V současné době SDS podporuje jenom a pouze SD karty, které mají své sektory právě o pevné velikosti 512 bajtů, jiné typy karet nejsou podporovány.
-Typ SD karty je uveden v indexu 3853. Jednotlivé možné hodnoty jsou:
+Typ SD karty je uveden v indexu 3853. Jednotlivé možné hodnoty jsou (pozor na rozlišení dle typu SDS):
   hodnota | význam
   --------+----------------------------
@@ Řádek 99: / Řádek 101: @@
 | High Capacity MMC Card
-Pokud náhodou nebude vaše SD karta v modulu SDS pracovat, zkontrolujte, je-li její typ správný (údaj je uveden i na webové administraci)
+ SDS BIG/STSW varianty 512 :

@@ Řádek 197: / Řádek 197: @@
      -18      | TOO_MANY_FILES | soubor nelze otevřít, protože už jste dosáhli maximálního počtu současně otevřených souborů
      -19      | INVALID_PARAM  | obecná chyba - byl zadán neplatný parametr
      -99      | NO_SD_CARD     | SD karta není připravena k použití (např. není fyzicky vložena do držáku)
   ------------+----------------+---------------------------------------------------------------------------------------------------
@@ Řádek 444: / Řádek 446: @@
 </syntaxhighlight>
-Funkci lze použít při založení nového souboru, nebo pro změnu existujícího souboru.
+Funkci lze použít POUZE při založení nového (prázdného) souboru.
 Typické použití je pro optimalizaci - tedy zajištění neztracení rychlosti - při zápisu většího množství dat do souboru.
@@ Řádek 458: / Řádek 462: @@
 * ''new_size'' - nová velikost souboru v bajtech
 * ''op_mode'' - (op_mode == 1): alokovat FAT záznamy ihned, nebo (op_mode == 0): až později