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ı olması, kurulum hatalarının azalmasına ve yeniden üretilebilirliğin artmasına neden olur.
• 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ş plastik bir 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 tablet 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 aşağıdaki seçenekleri sizin için otomatik olarak ayarlar:
Ayarlar > Ekran > Uyku > 30 dakika hareketsizlikten sonra
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. Tablet, ana makineye ilk kez bağlandığında USB üzerinden hata ayıklamaya izin verilecek mi? sorusunu sorar. Tablet hata ayıklama istemini göstermiyorsa tabletin bağlantısını kesip tekrar 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 değerlerini 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ırma gerçekleştirin.
   1. Tabletin ön yüzünü yukarı gelecek şekilde bir masaya yerleştirin (Tableti kutunun arka paneline yapıştırmayı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 gerekir. Bu nedenle tablet, Drive'ın cihazınızdaki fotoğraf, medya ve dosyalara erişmesine izin verilsin mi? sorusunu sorar. İzin ver'e basarak bu istemi temizleyin (ve gelecekte istemlerin gösterilmesini önleyin).
   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 yükleme için Drive simgesine, ardından İptal'e basarak bu istemi temizleyin (ve gelecekte istemlerin gösterilmesini önleyin).
   4. Son olarak tools/run_all_tests.py komutunu ç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.

Test çalıştırma

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
    

Tablete dayalı 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ırma

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 testi destekleyen tabletlerin listesini Düşük ışıklı sahneler için desteklenen tabletler başlıklı makalede bulabilirsiniz. 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 aşağıdaki ö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 şartları

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çinde ayarlanmalıdır. Aşağıdaki tabloda, ITS testi için önerilen tabletler ve bu tabletlerin çalıştığı DUT'un Android sürümleri listelenmektedir.

Sık sorulan sorular

S1: Cihazım için hangi test düzeneklerine ihtiyacım olduğunu nasıl anlarım?

RFoV ITS-in-a-box 1. revizyonu, CameraITS/tests dizininde tablet sahneleri 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 dizinindeki tablet sahneleri testleri için test eder. WFoV, FoV >= 90° olarak tanımlanır. 2. düzeltme sürümünün test düzeneği, işlevsel olarak 1. düzeltme sürümüyle 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, daha uzun minimum odak mesafesine sahip tele kameraları test etmek için takılabilen tele uzatma aparatını da destekler. Modüler taban aparatı, WFoV ITS-in-a-box ile işlevsel olarak aynıdır ancak daha küçüktür.

Sensör birleştirme kutusu, kamera/jiroskop zamanlama ofsetini ve çok kameralı sistemlerin kare senkronizasyonunu scenes=sensor_fusion'deki testlerle kontrol eder. REALTIME özellik bayrağı için 1 ms'den kısa bir kamera/jiroskop zamanlama ofseti gerekir.

Çok kameralı cihazlar, statik ITS testleri için tek bir düzenek ve kamerada REALTIME özellik işareti varsa bir sensör füzyon düzeneğiyle test edilebilir.

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

2. Soru: Hangi test aparatının kullanıldığını nasıl belirtirim?

Doğru test düzeneğini 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 ekleyerek komut satırında değer 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 alanına 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 grafikler 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 amacıyla 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. Testi tek tek çalıştırın.

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

Sonuçlar, çalışma süresine göre sıralanarak /tmp/logs/mobly/TEST_BED_TABLET_SCENES/ dizininde 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ışları yakalamak için bu testlerin bir sahnenin tamamı için grup olarak geçebilmesi gerekir. Ö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ığı% 50 olan 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) çalıştırmak ya da belirli bir sırada birden fazla sahneyi çalıştırmak 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.

S7: 1. sahneyle ilgili bazı testler tablet kurulumunda başarısız olur ancak kağıt grafikle geçer. Sorun nedir?

Tabletin ve test ortamının aşağıdaki özellikleri 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 şartları 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 ve kamera ile jiroskop arasındaki zamanlama ofseti 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.

Ayrıca bir hata raporu da ekleyin. Söz konusu test başarısız olduktan sonra aşağıdaki komutu kullanarak bir hata raporu oluşturun 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 sahnesi nasıl çalıştırılır?

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 düzeneğinin derinliği) test edildiğinde yeterince keskin görüntüler oluşturamıyorsa kameranızı düzeneğin önüne, grafik sahnesinin kamera görüş alanının (FoV) yaklaşık% 60'ını daha keskin görüntülerle dolduracağı bir mesafeye monte edin. Bu mesafe, kameranın minimum odak mesafesinden daha kısa olabilir. chart_distance'ü config.yml'te 31 cm mesafede 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 kameralarda hangi testler çalıştırılır?

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.