Azure Sphere'de depolamayı kullanma

Bu konu başlığında Azure Sphere cihazında depolamanın nasıl kullanılacağı açıklanmaktadır. Azure Sphere, salt okunur flash depolama ve değiştirilebilir depolama olmak üzere iki tür depolama alanı sağlar.

Uygulama görüntüsü paketlerini bir cihazda depolamak için salt okunur depolama kullanılır, bu nedenle içerik, uygulamayı güncelleştirmeden değiştirilemez. Bu, kullanıcı arabirimi varlıkları, statik yapılandırma verileri, dış MCU'ları güncelleştirmek için kullanılan üretici yazılımı görüntüleri dahil olmak üzere ikili kaynaklar veya değiştirilebilir depolama için başlatma verileri gibi tüm verileri içerebilir. Uygulamalar için kullanılabilir bellek , kullanılabilir depolama alanı miktarı hakkında ek ayrıntılar sağlar.

Mutable storage, cihaz yeniden başlatıldığında kalıcı olan verileri depolar. Örneğin, yerel saat dilimini kullanarak sistem saatini yönetmek istiyorsanız, saat dilimi ayarlarını değiştirilebilir depolama alanında depolayabilirsiniz. Diğer örneklerden bazıları, kullanıcının değiştirebileceği veya indirebileceği yapılandırma verileridir. Değiştirilebilir depolama örneği, bir uygulamada değiştirilebilir depolamanın nasıl kullanılacağını gösterir.

Salt okunur depolama kullanma

Salt okunur depolamayı yönetmek için bu Applibs işlevlerini kullanabilirsiniz. Bu işlevleri kullanan bir örnek için bkz. Curl kullanarak web hizmetlerine bağlanma.

• Storage_OpenFileInImagePackage

• Storage_GetAbsolutePathInImagePackage

Salt okunur depolama gereksinimleri

Salt okunur depolama kullanan uygulamalar uygun üst bilgi dosyalarını içermelidir.

Depolama alanını ve kaydedilmemiş üst bilgileri projenize ekleyin:

#include <unistd.h>
#include <applibs/storage.h>

Görüntü paketine dosya ekleme

Azure Sphere cihazında salt okunur depolama alanına dosya eklemek için dosyayı projenize kaynak olarak ekleyebilir ve uygulamanın görüntü paketine ekleyebilirsiniz:

• Azsphere_target_add_image_package kullanarak görüntü paketi dosyasını ve oluştururken eklenecek tüm kaynak dosyalarını belirtin. Örneğin:

  azsphere_target_add_image_package(${PROJECT_NAME} RESOURCE_FILES "file1.dat" "file2.dat")

"file1.dat" ve "file2.dat" dosyaları artık görüntü paketinde görünmelidir. Bu işlevler hakkında daha fazla bilgi için bkz . CMake işlevlerini kullanma .

Değiştirilebilir depolama kullanma

Uygulamanız için değiştirilebilir depolamayı yapılandırdığınızda, uygulamanın bileşen kimliğine atanır ve farklı bir bileşen kimliğine sahip bir uygulama tarafından erişilemez. Uygulamanın bileşen kimliği değişirse, yeni uygulamanın önceki uygulamanın değiştirilebilir depolama alanına erişimi olmaz.

Bir uygulamayı bir cihazdan silerseniz, uygulamaya atanan değiştirilebilir depolama alanı da silinir. Aynı uygulama daha sonra cihaza yeniden yüklenirse, değiştirilebilir depolama alanı boş olur. Ancak, uygulamayı silmeden güncelleştirirseniz, değiştirilebilir depolama içeriği korunur.

az sphere device app show-quota komutu şu anda kullanılmakta olan değiştirilebilir depolama miktarını görüntüler.

Azure Sphere işletim sistemi, kritik yapılandırma durumu ve dosya sistemi meta verilerinin bozulmasını önlemek için güç kaybı koruma mekanizmalarına sahiptir. Değiştirilebilir depolama API'sinin avantajları bu özelliklerdir. Ancak, değiştirilebilir depolamanın gerçek içeriği arabelleklerin boşaltılıp boşaltılmadığına ve hangi sırayla boşaltılacağına bağlıdır, bu nedenle güç kaybı sırasında bekleyen tüm değişikliklerin kurtarmadan sonra dosyanın kendisine yansıtılacağı garanti edilemez.

Bu Applibs işlevlerini, değiştirilebilir depolama verilerini yönetmek için kullanabilirsiniz:

• Storage_OpenMutableFile

• Storage_DeleteMutableFile

Değiştirilebilir depolama gereksinimleri

Değiştirilebilir depolama kullanan uygulamaların uygun üst bilgi dosyalarını içermesi ve uygulama bildirimine değiştirilebilir depolama ayarları eklemesi gerekir.

Değiştirilebilir depolama için üst bilgi dosyaları

Depolama alanını ve kaydedilmemiş üst bilgileri projenize ekleyin:

#include <unistd.h>
#include <applibs/storage.h>

Uygulama bildirimi

Bu konudaki API'leri kullanmak için, özelliği uygulama bildirimine eklemeniz MutableStorage ve ardından alanı ayarlamanız SizeKB gerekir. SizeKB alanı, değiştirilebilir depolama alanınızın boyutunu kibibayt cinsinden belirten bir tamsayıdır. Maksimum değer 64'tür ve depolama alanı cihazın silme bloğu boyutuna göre ayrılır. Ayırma işlemi, cihazın blok boyutunun tam katı değilse SizeKB değerini bir sonraki blok boyutuna yuvarlayarak yapılır.

Aşağıdaki örnekte, MutableStorage depolama özelliği uygulama bildirimine 8 KB boyutunda eklenmiştir.

{
  "SchemaVersion": 1,
  "Name" : "Mt3620App_Mutable_Storage",
  "ComponentId" : "9f4fee77-0c2c-4433-827b-e778024a04c3",
  "EntryPoint": "/bin/app",
  "CmdArgs": [],
   "Capabilities": {
    "AllowedConnections": [],
    "AllowedTcpServerPorts": [],
    "AllowedUdpServerPorts": [],
    "MutableStorage": { "SizeKB": 8 },
    "Gpio": [],
    "Uart": [],
    "WifiConfig": false,
    "NetworkConfig": false,
    "SystemTime": false
  }
}

Kalıcı veri yazma

Kalıcı depolamaya veri yazmak için applibs işlevini çağırarak başlayın Storage_OpenMutableFile kalıcı bir veri dosyası için dosya tanımlayıcısı alın. Ardından, verileri kalıcı veri dosyasına yazmak için işlevini çağırın write . Yazmaya çalıştığınız veri miktarı, değiştirilebilir depolama ayırmanızı aşarsa, yazma işlevi başarılı olabilir; ancak, yazılan tek veri depolama ayırmasını aşmayan kısım olacaktır. Tüm verilerin yazılmasını sağlamak için işlev çağrısının dönüş değerini write denetlemeniz gerekir.

Kalıcı verileri okuma

Kalıcı depolama çağrısından verileri okumak için , kalıcı veri dosyası için bir dosya tanımlayıcısı almak üzere Storage_OpenMutableFile ve ardından verileri okumak için işlevini çağırın read .

Kalıcı verileri silme

Kalıcı depolama çağrısından verileri silmek için Storage_DeleteMutableFile.