Kutulu Kamera

Android Kamera Görüntü Test Paketi (ITS), Android Uyumluluk Test Paketi (CTS) Doğrulayıcı'nın bir parçasıdır ve resim içeriğini doğrulayan testleri içerir. CTS Doğrulayıcı, ITS test otomasyonunu kutulu kamera ITS ile destekler. Manuel testler için destek, tüm Android cihaz form faktörlerini kapsar.

Kutudaki ITS aşağıdaki avantajları sunar:

• Otomasyon. Test sırasında insan müdahalesi gerekmez.
• Kolay sorun giderme Test ortamının tutarlılığı, daha az kurulum hatasına yol açar ve yeniden üretilebilirliği artırır.
• Verimlilik. Her kamera/sahne için yeniden deneme yapma özelliği, test yürütme verimliliğini artırır.

Başlayın

Kutudaki ITS, bilgisayar destekli tasarım (CAD) çizimlerinden lazerle kesilmiş bir plastik kutu, bir grafik tableti ve test edilen cihazdan (DUT) oluşur. Aşağıdaki tabloda, mevcut olan farklı kutulu ITS donanımlarının özellikleri ve teknik özellikleri açıklanmaktadır.

Kamera ITS-in-a-box'ı kullanmaya başlamak için:

1. Modüler, WFoV veya RFoV kutulu ITS satın alın ya da oluşturun.
2. Camera ITS yazılımıyla bir tableti yapılandırma.
3. Testleri çalıştırın.
4. DUT'tan sonuçları alın.

Tableti yapılandırma

Bu bölümde, CameraITS dizininde bulunan Kamera ITS testleriyle kullanılmak üzere bir tableti ayarlamayla ilgili adım adım talimatlar verilmektedir. Bu talimatlarda örnek tablet olarak Pixel C kullanılmaktadır. Tablet koşulları ve önerileri hakkında bilgi edinmek için Tablet koşulları başlıklı makaleyi inceleyin.

Not: Kamera ITS Python komut dosyaları, tablette şu seçenekleri sizin için otomatik olarak ayarlar:
Ayarlar > Ekran > Uyku > 30 dakika işlem yapılmadığında
Uyarlanabilir parlaklık > KAPALI

1. Tableti şarj edip açın. Hesap oluşturmanız istenirse bunu atlayın (Kamera ITS, tabletle eşlenmiş bir hesap gerektirmez).
2. Tableti Android 7.0 veya sonraki bir sürüme güncelleyin. Android 6.x ve önceki sürümler Kamera ITS'yi desteklemez.
3. Geliştirici modunu etkinleştirin.
4. Ayarlar'a dönüp Geliştirici seçenekleri'ni seçin.

   Seçenekleri etkinleştir	Açık Uyanık kal USB hata ayıklama (Bu, ana makinenin tableti hata ayıklama modunda çalıştırmasına olanak tanır. Tableti ana makineye ilk kez bağladığınızda tablette USB üzerinden hata ayıklamaya izin verilsin mi? mesajı gösteriliyor. Tablette hata ayıklama istemi görüntülenmiyorsa bağlantıyı kestikten sonra tableti yeniden bağlayın.)
   Seçenekleri devre dışı bırakma	Otomatik sistem güncellemeleri USB'den yüklenen uygulamaları doğrula

5. Mevcut cihazları listelemek için $ adb devices komutunu çalıştırarak DUT ve grafik kimliklerini belirleyin. device_id ve chart_id'yi belirlemek için cihazları takıp çıkarın ve bağlanıp bağlantısı kesilen cihazları gözlemleyin.
6. Tablet ekranındaki grafikleri gizleyebilecek ipuçları ve kullanıcı istemlerini engellemek için üç test çalıştırması yapın.
   1. Tableti bir masaya yukarı bakacak şekilde yerleştirin (tableti kutunun arka paneline takmayın).
   2. Aşağıdaki komutu çalıştırın:

      python tools/run_all_tests.py device=$device_id camera=0 chart=$chart_id scenes=2,3
      

      2. ve 3. sahnelerde tabletin bir resim göstermesi gerektiği için tablette Drive'ın cihazınızdaki fotoğraf, medya ve dosyalara erişmesine izin verilsin mi? İzin Ver'e basarak bu istemi temizleyin (ve gelecekteki istemleri engelleyin).
   3. Komutu tekrar çalıştırın. Tablet, Bu dosyanın bir kopyasını saklamak ister misiniz? sorusunu sorar ve Google Drive'ı önerir. Drive'a, ardından Drive'a yüklemek için İptal'e basarak bu istemi temizleyin (ve gelecekteki istemleri önleyin).
   4. Son olarak tools/run_all_tests.py dosyasını çalıştırın ve komut dosyası farklı sahneler arasında geçiş yaparken sahnelerin otomatik olarak değiştiğini onaylayın. Çoğu test başarısız olsa da (kamera grafiği işaretlemediği için) tabletin ekranda herhangi bir istem veya başka pop-up göstermeden sahneler arasında doğru şekilde geçiş yaptığını doğrulayabilirsiniz.

Testler yapın

Kutudaki ITS'yi çalıştırmadan önce test kurulumunuzun aşağıdaki donanım ve yazılımları içerdiğinden emin olun:

• Bir (1) kutu içinde ITS
• Sahneleri görüntülemek için bir (1) yüksek çözünürlüklü 10 inç tablet, S/N: 5811000011
• CTS Doğrulayıcı 7.0_8+ uygulamasının yüklü olduğu bir (1) DUT. Örnek DUT:
  • Arka kamera (0) testi için bir(1) Pixel NOF26W, S/N: FA6BM0305016. CTS Doğrulayıcı uygulamasını yüklemek için android-cts-verifier.zip dosyasını açın ve

    adb -s FA6BM0305016 install -r -g android-cts-verifier/CtsVerifier.apk
    

Tablet tabanlı sahneleri çalıştırma

Arka kamerada 0 ila 4, 6 ve scene_change sahnelerini çalıştırmak için:

cd android-cts-verifier/CameraITS
. build/envsetup.sh
python tools/run_all_tests.py camera=0

Örnek:

Sahneleri yeniden deneme

Tek bir kamera için sahneleri tekrar deneyebilirsiniz:

• Tek bir kameradaki sahneleri tekrar denemek için:

  python tools/run_all_tests.py device=FA6BM0305016 camera=0 scenes=3,4
  

5. sahneyi çalıştır

5. sahne için belirli bir ışıklandırmayla özel kurulum gerekir (ayrıntılar için Compatibility Test Suite Downloads adresinden indirebileceğiniz CTS Verifier'daki CameraITS.pdf bölümüne bakın). 5. sahneyi ayrı olarak çalıştırmanız gerekir (kutunun dışında).

Tek bir cihazda ön ve arka kameralar için 5. sahneyi çalıştırmak üzere:

python tools/run_all_tests.py device=FA6BM0305016 camera=0 scenes=5
python tools/run_all_tests.py device=FA6BM0305016 camera=1 scenes=5

Sonuçları alma

Test sırasında sonuçları görüntüleyebilir ve tamamlanan sonuçları rapor olarak kaydedebilirsiniz.

• Sonuçları görüntüleyin. Kamera ITS sonuçlarını rapor olarak kaydetmek için:
  1. Geç'e basın ve raporu kaydedin.
     
     Şekil 3. Kamera ITS raporu
  2. Cihazdan raporları alma:

     adb -s FA6BM0305016 pull /sdcard/verifierReports
     

  3. Rapor dosyasını açın ve test_result.xml dosyasını görüntüleyin.
     
     Şekil 4. Kamera ITS raporları
     

Tablet gereksinimleri

Android 15 ve sonraki sürümlerde, ITS grafiği ekranı olarak kullanılan tabletler aşağıdaki tablet izin verilenler listesinde olmalıdır. Düşük ışıklı sahneler için testleri destekleyen tabletlerin listesi için Zayıf ışık sahneleri için desteklenen tabletler bölümüne bakın. Android 14 veya önceki sürümler için Android 14 ve önceki sürümler için tablet gereksinimleri başlıklı makaleyi inceleyin.

İzin verilenler listesindeki tabletler şu ölçütlere göre seçilir:

• 1920 x 1200 pikselden yüksek ekran çözünürlüğüne sahip yaklaşık 10 inç ekran boyutu.
• Darbe genişliği modülasyonu (PWM) kontrollü ekran karartma nedeniyle ölçülen titreme olmamalıdır.
• ITS testleri tarafından gönderilen adb komutlarını yürütebilir ve talimat verilen ekran parlaklığıyla grafik resimleri gösterebilir.

brightness değeri, tablet modeline göre config.yml içinde ayarlanmalıdır. Tablet modelinizin izin verilenler listesindeki bir cihaz adına karşılık gelip gelmediğini belirlemek için adb shell getprop | grep 'ro.product.device' adb komutunu çalıştırarak ro.product.device değerini yazdırın.

Düşük ışıklı sahneler için desteklenen tabletler

Android 14 ve önceki sürümler için tablet gereksinimleri

Tabletler yaklaşık 10 inç ekran boyutuna ve 1920 x 1200 pikselden yüksek ekran çözünürlüğüne sahip olmalıdır. Tablet, parlaklık düzeyini ayarlamak için darbe genişliği modülasyonu (PWM) kullanmamalıdır. brightness değeri, tablet modeline göre config.yml için ayarlanmalıdır. Aşağıdaki tabloda, ITS testi için önerilen tabletler ve bu tabletlerin çalıştığı DUT'un Android sürümleri listelenmiştir.

Sık sorulan sorular

1. S: Cihazım için hangi test ekipmanlarına ihtiyacım olduğunu nasıl belirleyebilirim?

RFoV ITS-in-a-box düzeltmesi 1, CameraITS/tests dizinindeki tablet sahne testleri için RFoV kameraları test eder. RFoV, 60° < FoV < 90° olarak tanımlanır. FoV'si daha büyük kameralarda ışıklar görüntülerde görünebilir veya grafikler FoV'de çok küçük bir alanı kaplayarak test sonuçlarını etkileyebilir.

WFoV ITS-in-a-box 2. revizyonu, WFoV kameraları CameraITS/tests dizininde tablet sahneleri testleri için test eder. WFoV, FoV >= 90° olarak tanımlanır. Düzeltme 2 test düzeneği, işlevsel olarak düzeltme 1 ile aynıdır, ancak daha büyüktür. 2. düzeltme sürümüne sahip test aparatı, Android 9 ve sonraki sürümlerde hem RFoV hem de WFoV kameraları test edebilir. Daha büyük yer kapladığı için DUT bir tabletse 2. düzeltme idealdir.

Modüler taban aparatı, CameraITS/tests dizinindeki tablet sahnesi testleri için WFoV kameraları test eder. WFoV, FoV >= 90° olarak tanımlanır. Modüler taban aparatı, Android 9 ve sonraki sürümleri çalıştıran cihazlarda hem RFoV hem de WFoV kameraları test edebilir. Ayrıca minimum odak mesafesi daha uzun olan tele kameraları test etmek için takılabilen tele uzatma düzeneği de desteklenir. Modüler temel düzeneği, işlevsel olarak kutu içinde WFoV ITS ile aynıdır ancak daha küçüktür.

Sensor fusion kutusu, scenes=sensor_fusion'deki testlerle kamera/jiroskop zamanlama ofsetini ve çok kameralı sistem kare senkronizasyonunu test eder. REALTIME özellik bayrağı için kamera/jiroskop zamanlama farkının 1 ms'den az olması gerekir.

Çok kameralı cihazlar, statik ITS testleri için tek bir donanımla ve kamerada REALTIME özellik işareti varsa sensör füzyon donanımıyla test edilebilir.

Aşağıdaki tabloda bir dizi örnek yapılandırma verilmiştir.

2. S: Hangi test düzeneğinin kullanımda olduğunu nasıl belirtebilirim?

Doğru test cihazını belirlemek için grafik mesafesi parametresinin doğru olduğundan emin olun. 1. sürüm test aparatının (RFoV) grafik mesafesi 31 cm, 2. sürüm aparatının (WFoV) grafik mesafesi ise 22 cm'dir. Grafik mesafesi varsayılan olarak 31 cm'ye ayarlanmıştır.

Android 10'dan Android 11'e

python tools/run_all_tests.py ... chart=# dist=22

Android 12 ve sonraki sürümler

edit config.yml
chart_distance: 31.0 → chart_distance: 22.0

S3: Tablet parlaklığını nasıl kontrol edebilirim?

Tablet parlaklığı varsayılan olarak 96'ya ayarlanmıştır.

Android 7.0 ile 9 arasındaki sürümleri çalıştıran tabletlerde parlaklığı değiştirmek için:

edit tools/wake_up_screen.py
DISPLAY_LEVEL=96 → DISPLAY_LEVEL=192

Android 10 ile 11 arasındaki sürümleri çalıştıran tabletlerde parlaklığı değiştirmek için brightness işareti eklenerek komut satırında parlaklık değiştirilebilir:

python tools/run_all_tests.py device=# camera=# chart=# brightness=192

Android 12 ve sonraki sürümleri çalıştıran tabletlerde parlaklığı değiştirmek için:

edit config.yml
brightness: 96 → brightness: 192

4. Soru: Tek bir testte nasıl hata ayıklama yapabilirim?

Testler, hata ayıklama amacıyla tek tek çalıştırılabilir ancak sahnenin tamamı çalıştırılmadığı sürece sonuçlar CtsVerifier.apk'e bildirilmez.

Android 11 ve önceki sürümlerde tek bir sahneyi çalıştırmak için:

1. tools/run_all_tests.py içine scenes işaretini ekleyerek bir sahne yükleyin:

   python tools/run_all_tests.py device=# camera=# chart=# scenes=#
   

2. Sahne stdout'e yüklendikten sonra testleri durdurmak için Ctrl+C tuşlarına basın.

   Doğru sahne zaten ekrandaysa ekranı uyandırın:

   python tools/wake_up_screen.py screen=#
   

3. Tek bir test çalıştırın.

   python tests/scene#/test_*.py device=# camera=#

   Ardından, yerel dizinde noktalar oluşturulur ve stdout ile stderr ekrana yazdırılır.

   Hata ayıklamayla ilgili daha fazla bilgi edinmek için komut dosyasına print ifadeleri ekleyin. Hata ayıklama için test çıkışını artırmak isterseniz debug=True işaretini ekleyin.

   python tests/scene#/test_*.py device=# camera=# debug=True

tools/run_all_tests.py çalıştırıldığında sonuçlar yerel ekrana yazdırılır ve resimler oluşturulan /tmp/tmp### dizini yerine yerel dizine kaydedilir.

Android 12 ve sonraki sürümlerde tek bir sahneyi çalıştırmak için:

1. config.yml dosyasını düzenleyin.

   edit config.yml
   camera: <camera-id> → camera:  0
   scene: <scene-name> → scene: scene1_1

2. Bireysel testi çalıştırın.

   python tools/run_all_tests.py -c config.yml --test_bed TEST_BED_TABLET_SCENES
   

Sonuçlar /tmp/logs/mobly/TEST_BED_TABLET_SCENES/ dizininde, çalışma zamanına göre sıralanmış olarak yazdırılır.

S5: Testleri tek tek yeniden çalıştırmak yerine neden sahnenin tamamı olarak çalıştırmam gerekiyor?

Testler, hata ayıklama amacıyla tek tek çalıştırılabilir ancak sahnenin tamamı çalıştırılmadan sonuçlar CtsVerifier.apk'e bildirilmez.

Kamera ITS, üçüncü taraf uygulamalarının uyumlu bir kamera arayüzüne sahip olmasını sağlar. Birim testine benzer şekilde her test, kameradaki tek bir özelliği vurgular. Güvenilir olmayan davranışı yakalamak için bu testlerin, sahnenin tamamı için grup halinde geçmesi beklenir. Örneğin, tek bir güvenilir olmayan test bir sahnenin tamamını yeniden çalıştırdığında başarılı olabilir ancak birden fazla güvenilir olmayan testin başarılı olması zordur.

Aşırı bir örnek olarak, bir sahnede her birinin PASS döndürme olasılığının% 50 olduğu 10 testin bulunduğu durumu düşünün. Her testi ayrı ayrı çalıştırarak operatörün kameranın Kamera ITS'yi geçmesini sağlama olasılığı yüksektir. Ancak testler bir sahne olarak toplu olarak çalıştırılırsa sahnenin geçme olasılığı yalnızca% 0,1'dir.

S6: Tek bir sahneyi nasıl çalıştırabilirim veya çalıştırılan sahneleri nasıl yeniden sıralayabilirim?

Varsayılan olarak tools/run_all_tests.py komut dosyası tüm sahneleri sırayla çalıştırır. Ancak sahneler tek tek veya belirli bir sırada çalıştırılabilir ve CtsVerifier.apk'e raporlanabilir.

Android 11 veya önceki sürümlerde tek bir sahneyi (ör. 2. sahne) yayınlamak ya da belirli bir sırada birden fazla sahne yayınlamak için:

python tools/run_all_tests.py device=# camera=# chart=# scenes=2

python tools/run_all_tests.py device=# camera=# chart=# scenes=3,2

Android 12 ve sonraki sürümlerde tek bir sahneyi veya birden fazla sahneyi belirli bir sırada çalıştırmak için:

python tools/run_all_tests.py scenes=2

python tools/run_all_tests.py scenes=3,2

Ek parametreler config.yml dosyasında ayarlanır.

7. soru: 1. sahne testinin bazıları tablet kurulumunda başarısız olmuştur ancak kağıt grafikle geçmektedir. Sorun nedir?

Tablet ve test ortamının aşağıdaki spesifikasyonları karşıladığından emin olun.

Tablet özellikleri

Tabletin aşağıdaki özellikleri karşıladığından emin olun:

• Ekran boyutu (inç): 10 inç
• Ekran boyutu (piksel): 1.920 x 1.200 pikselden büyük

Daha fazla bilgi için Tablet gereksinimleri başlıklı makaleyi inceleyin.

Tablet parlaklığı

Tablet ekran parlaklığı çok düşükse testler doğru sonuçlar vermeyebilir.

Daha fazla bilgi için Tablet parlaklığını nasıl kontrol edebilirim? başlıklı makaleyi inceleyin.

Kutu aydınlatma seviyesi (lüks ölçer gerekir)

Tablet açıldığında hedef lux değerinin 100 ile 300 arasında olduğundan emin olun.

Lüks seviyesi çok yüksekse scene1/test_param_flash_mode.py FAIL döndürülür. Lüks seviyesi çok düşükse birden fazla test başarısız olur.

S8: Sensör birleştirme testlerinde nasıl hata ayıklama yapabilirim?

1. dialout grubunda olduğunuzdan emin olun.

   groups | egrep ‘dialout'

2. Microchip Technology'in USB bağlantı noktasına bağlı olup olmadığını kontrol ederek sensör füzyon kontrol cihazının bağlı olduğundan emin olun.

   lsusb
   …
   Bus 003 Device 004: ID 04d8:fc73 Microchip Technology, Inc.
   …
   

3. Aşağıdaki komutları kullanarak test denemelerinin dağılımını elde etmek için testi birden çok kez çalıştırın.

   Android 11 veya önceki sürümlerde:

   python tools/run_sensor_fusion_box.py device=A camera=0 num_runs=10 rotator=default
   

   Android 12 ve sonraki sürümlerde:

   python tools/run_sensor_fusion_box.py num_runs=10
   

   Ek parametreler config.yml dosyasında ayarlanır.

   Çalıştırma çıkışları, sensor_fusion_# klasörlerinin altında oluşturulan /tmp/tmp### klasöründe bulunur. Burada #, çalıştırma numarasıdır. Başarısızlıkların yaygın nedenleri şunlardır:

   1. Telefon düzgün şekilde ortalanmamış.
   2. Resimde yeterli özellik bulunmuyor (genellikle görüş alanı veya ışıklandırma sorunu).
   3. Döndürülen FAIL geçerlidir. Ayrıca, kamera ile jiroskop arasındaki zamanlama farkı düzeltilmelidir.

S9: Test sırasında karşılaşılan hataları bildirirken hangi bilgileri eklemeliyim?

Testle ilgili bir hatayı bildirirken test için oluşturulan dosyaları ve resimleri ekleyin.

1. Testi tools/run_all_tests.py üzerinden çalıştırdıysanız hataya sıkıştırılmış bir /tmp/ dizini ekleyin.
2. Testi tek başına çalıştırdıysanız tüm ekran çıkışlarını ve oluşturulan resimleri hataya ekleyin.

Hata raporu da ekleyin. Söz konusu test başarısız olduktan sonra, hata raporu oluşturmak için aşağıdaki komutu kullanın ve oluşturulan zip dosyasını hataya ekleyin.

adb -s device_id bugreport

S10: 25 cm grafik mesafesinde bulanık görüntüler oluşturan minimum odak mesafesine sahip bir kamerayla sensor_fusion test sahnesini nasıl çalıştırırım?

Kameranız 25 cm mesafede odaklanamiyorsa sensör füzyon kutusunun grafik montaj panelini çıkarın. Grafiği, DUT'nun odaklanabileceği bir mesafeye yerleştirin ve config.yml içindeki chart_distance değerini, DUT ile grafik arasındaki ölçülen mesafeye göre değiştirin. Şekil 5'te, bu durumda grafik mesafesinin nasıl ölçüleceğine dair bir örnek gösterilmektedir.

  edit config.yml
chart_distance: 25 → chart_distance: DISTANCE_BETWEEN_DUT_AND_CHART

S11: 31 cm grafik mesafesinde bulanık görüntüler oluşturan minimum odak mesafesine sahip bir kamera için tablet test sahnelerini nasıl çalıştırırım?

Kameranız 31 cm'de (RFoV test cihazının derinliğinde) yeterince net görüntü üretemiyorsa grafik sahnesinin kamera görüş alanının (FoV) yaklaşık% 60'ını daha keskin resimlerle doldurmasını sağlamak için kameranızı belirli bir mesafeye monte edin. Bu mesafe, kameranın minimum odak mesafesinden daha kısa olabilir. chart_distance bölümünü config.yml içinde 31 cm bırakın. Tabletteki grafik ölçeği, aşağıdaki tabloda gösterildiği gibi kamera FOV'sine göre belirlenir:

S12: Mantıksal çok kameralı API ile hangi testler hangi kameralarda gerçekleştirilir?

Kameranız REQUEST_AVAILABLE_CAPABILITIES_LOGICAL_MULTI_CAMERA kullanıyorsa desteklenen tüm ITS testleri üst düzey mantıksal kamerada çalıştırılır. ITS testlerinin bir alt kümesi fiziksel alt kameralarda çalıştırılır ve bu testler tools/run_all_tests.py içinde SUB_CAMERA_TESTS sabitinin altında listelenir.