Atalet Sensörü#

giriiş#

inertial sınıfı, Akıllı Bağlantı Noktasına bağlı bir V5 Atalet Sensöründen gelen verileri kontrol etmek ve bunlara erişmek için kullanılır.

V5 Atalet Sensörü, robotun nasıl hareket ettiğini ve döndüğünü ölçer. Jiroskop, yön, dönüş, jiroskop hızı ve yönelim gibi dönüşü ölçer. İvmeölçer ise x, y ve z eksenleri boyunca hızlanma veya yavaşlama gibi hareket değişikliklerini ölçer.

Sınıf Oluşturucuları#

inertial(
  int32_t  index,
  turnType dir = turnType::right );

Sınıf Yıkıcısı#

inertial nesnesini yok eder ve ilgili kaynakları serbest bırakır.

~inertial();

Parametreler#

Parametre

Tip

Tanım

index

int32_t

Atalet sensörünün bağlı olduğu akıllı port, PORTxşeklinde yazılır; burada x port numarasıdır (örneğin, PORT1).

dir

turnType

İsteğe bağlı. Pozitif değer döndüren yön:

  • right (varsayılan) — Sağa dönüşler pozitif değer döndürür.
  • left — Sola dönüşler pozitif değer döndürür.

Örnekler#

// Create an inertial instance for the V5 Inertial Sensor
inertial myInertial = inertial(
    PORT1,      // Smart Port 1
    right);     // dir

Üye Fonksiyonları#

inertial sınıfı aşağıdaki üye fonksiyonlarını içerir:

  • heading — Sensörün baktığı yönü döndürür.

  • rotation — Sensörün ne kadar döndüğünü döndürür.

  • setHeading — Sensörün mevcut yönünü yeni bir yön değerine ayarlar.

  • setRotation — Sensörün mevcut dönüşünü yeni bir dönüş değerine ayarlar.

  • calibrate — Atalet Sensörünü Kalibre Eder.

  • resetHeading — Sensörün mevcut yönünü 0 dereceye sıfırlar.

  • resetRotation — Sensörün mevcut dönüşünü 0 dereceye sıfırlar.

  • isCalibrating — Atalet Sensörünün şu anda kalibre edilip edilmediğini döndürür.

  • changed — Başlık değiştiğinde çalışan bir geri çağırma fonksiyonu kaydeder.

  • installed — Atalet Sensörünün kurulu olup olmadığını döndürür.

  • acceleration — Sensörün seçilen eksende ne kadar hızlı hızlandığını veya yavaşladığını döndürür.

  • gyroRate — Sensörün seçilen eksen üzerinde ne kadar hızlı döndüğünü döndürür.

  • orientation — Atalet Sensörünün yuvarlanma, eğim veya sapma açısını döndürür.

  • collision — Çarpışma tespit edildiğinde çalışan bir geri çağırma fonksiyonu kaydeder.

  • setTurnType — Hangi dönüş yönünün pozitif değerler döndürdüğünü ayarlar.

  • getTurnType — Hangi dönüş yönünün pozitif değerler ürettiğini döndürür.

Herhangi bir inertial üye fonksiyonunu çağırmadan önce, aşağıda gösterildiği gibi bir inertial örneği oluşturulmalıdır:

/* This constructor is required when using VS Code.
Inertial Sensor configuration is generated automatically
in VEXcode using the Device Menu. Replace the values
as needed. */

// Create an inertial instance for the V5 Inertial Sensor connected to Port 1.
inertial myInertial = inertial(PORT1);

heading#

Yön, sensörün baktığı yönü ifade eder ve 0 ile 359,99 derece arasında ölçülür. Bu fonksiyon, sensörün mevcut yönünü döndürür.

Başlangıç ​​yönü 0 derecedir. Sensör 359,99 derecenin üzerine çıkarsa, yön tekrar 0 dereceye döner.

Available Functions 
double heading( rotationUnits units = degrees );
Parameters

Parametre

Tip

Tanım

units

rotationUnits

Başlık birimi:

  • deg / degrees (varsayılan) — derece
  • turns / rev — devir
Return Values

Belirtilen birimlerde sensörün mevcut yönünü temsil eden double bir double değeri döndürür.

Notes

  • Başlık değeri 0 ile 359,99 derece arasında sarılmıştır. Sürekli dönüş değerine erişmek için rotation kullanın.

Examples 
// Turn, then show the current heading
Drivetrain.turnFor(right, 450, degrees);
Brain.Screen.print("%f", myInertial.heading(degrees));

rotation#

Atalet sensörünün mevcut dönüş yönünü döndürür.

Dönme, sensörün ne kadar döndüğünü gösterir. Yönün aksine, dönme 359,99 derecenin üzerine çıkabilir veya 0 derecenin altına düşebilir. Örneğin, sağa doğru iki tam tur dönmek 720 derecelik bir dönme sağlar. 0 dereceden sola doğru bir tam tur dönmek ise -360 derecelik bir dönme sağlar.

Available Functions 
double rotation( rotationUnits units = degrees );
Parameters

Parametre

Tip

Tanım

units

rotationUnits

Dönme birimi:

  • deg / degrees (varsayılan) — derece
  • turns / rev — devir
Return Values

Belirtilen birimlerdeki mevcut dönüşü temsil eden double bir double değeri döndürür.

Notes

  • Dönme değeri süreklidir ve 0 ile 359,99 derece arasında dönmez. Dönen yön değerine erişmek için heading kullanın.

Examples 
// Turn, then show the current rotation
Drivetrain.turnFor(right, 450, degrees);
Brain.Screen.print("%f", myInertial.rotation(degrees));

setHeading#

Yön, sensörün baktığı yönü ifade eder ve 0 ile 359,99 derece arasında ölçülür. Bu fonksiyon, Atalet Sensörünün mevcut yönünü yeni bir yön değerine değiştirir.

Örneğin, sensör sağa doğru dönmüşse, yönü 0 dereceye ayarlamak, bu sağa dönük pozisyonu yeni 0 derece yapar. Ardından sensör, bu yeni yöne göre diğer yönleri takip edebilir.

Available Functions 
void setHeading( double value, rotationUnits units );
Parameters

Parametre

Tip

Tanım

value

double

Sensör için ayarlanacak yön değeri (derece cinsinden). Bu değer 0 ile 359,99 arasında olabilir.

units

rotationUnits

The heading unit:

  • deg / degrees — degrees
  • turns / rev — revolutions
Return Values

Bu fonksiyon bir değer döndürmez.

Examples 
// Turn the robot around
myInertial.setHeading(180, degrees);
Drivetrain.turnToHeading(0, degrees);

setRotation#

Dönme, sensörün ne kadar döndüğünü derece cinsinden ölçer. Yönün aksine, dönme 359,99 derecenin üzerine çıkabilir veya 0 derecenin altına düşebilir. Bir projenin başlangıcında, dönme değeri 0 dereceye ayarlanır. Bu fonksiyon, Atalet Sensörünün mevcut dönme değerini yeni bir değere değiştirir.

Örneğin, sensör sağa doğru iki tam tur atmışsa, dönüş değeri 720 derece olacaktır. Dönüşü 0 dereceye ayarlamak, bu dönüş değerini 720’den 0 dereceye sıfırlayacaktır. Ardından sensör, bu yeni değere göre dönüşleri takip edebilir.

Available Functions 
void setRotation( double value, rotationUnits units );
Parameters

Parametre

Tip

Tanım

value

double

Sensör için ayarlanacak dönüş değeri (derece cinsinden). Bu bir tamsayı veya ondalık sayı olabilir.

units

rotationUnits

The rotation unit:

  • deg / degrees — degrees
  • turns / rev — revolutions
Return Values

Bu fonksiyon bir değer döndürmez.

Examples 
// Turn the robot around
myInertial.setRotation(-180, degrees);
Drivetrain.turnToRotation(0, degrees);

calibrate#

Atalet sensörünü kalibre eder.

Kalibrasyon, sensörün dönüşleri doğru şekilde ölçmesine yardımcı olur. Kalibrasyon sırasında sensörü sabit tutun. Kalibrasyon sırasında sensör hareket ederse, yön, dönüş, jiroskop hızı ve yönelim değerleri doğru ölçülemeyebilir.

Available Functions 
void calibrate( );
Parameters

Bu fonksiyon herhangi bir parametre kabul etmez.

Return Values

Bu fonksiyon bir değer döndürmez.

Notes

  • Kalibrasyon işlemi sırasında sensör sabit kalmalıdır.

  • Kalibrasyonun ne zaman tamamlandığını belirlemek için isCalibrating kullanın.

resetHeading#

Atalet sensörünün mevcut yönünü 0 dereceye sıfırlar.

Bu fonksiyon kullanıldıktan sonra, sensörün mevcut yönü yeni 0 derece yönü olur.

Available Functions 
void resetHeading();
Parameters

Bu fonksiyon herhangi bir parametre almaz.

Return Values

Bu fonksiyon bir değer döndürmez.

resetRotation#

Atalet sensörünün mevcut dönüşünü 0 dereceye sıfırlar.

Bu fonksiyon kullanıldıktan sonra, sensör yeni 0 derece dönüş değerinden itibaren gelecekteki dönüşleri takip eder.

Available Functions 
void resetRotation();
Parameters

Bu fonksiyon herhangi bir parametre almaz.

Return Values

Bu fonksiyon bir değer döndürmez.

isCalibrating#

Atalet sensörünün şu anda kalibrasyon aşamasında olup olmadığını döndürür.

Available Functions 
bool isCalibrating();
Parameters

Bu fonksiyon herhangi bir parametre almaz.

Return Values

Atalet sensörünün kalibre edilip edilmediğini gösteren bir Boolean değer döndürür:

  • true — The sensor is currently calibrating.
  • false — The sensor is not currently calibrating.

changed#

Atalet sensörünün yön değeri değiştiğinde çalışan bir geri çağırma fonksiyonu kaydeder.

Available Functions 
void changed( void (* callback)(void) );
Parameters

Parametre

Tip

Tanım

callback

void (*)(void)

Başlık değeri değiştiğinde çağrılacak bir fonksiyona işaretçi. Fonksiyon parametre almamalı ve void.
Return Values

Bu fonksiyon bir değer döndürmez.

Examples

Geri çağırma fonksiyonunu tanımlayın ( int main() dışında)

// Display the heading when the Inertial Sensor's heading value changes.
void onHeadingChanged() {
  Brain.Screen.clearScreen();
  Brain.Screen.setCursor(1, 1);
  Brain.Screen.print("Heading: %.2f", myInertial.heading());
}

Geri çağrıyı main() fonksiyonunun içine kaydedin int main()

int main() {
  // Run onHeadingChanged when the Inertial Sensor's heading value changes.
  myInertial.changed(onHeadingChanged);
}

installed#

Atalet sensörünün takılı ve bağlı olup olmadığını döndürür.

Available Functions 
bool installed();
Parameters

Bu fonksiyon herhangi bir parametre almaz.

Return Values

Atalet sensörünün takılı ve bağlı olup olmadığını gösteren bir Boolean değeri döndürür:

  • true — The sensor is connected and responding.
  • false — The sensor is not connected or not detected.

acceleration#

İvme, sensörün ne kadar hızlı hızlandığını veya yavaşladığını gösterir. Bu fonksiyon, seçilen eksen üzerindeki Atalet Sensörünün ivmesini -4,0 G ile 4,0 G arasında döndürür.

G ivmeyi ölçmek için kullanılan bir birimdir. 1 G, hareketsiz otururken yerçekiminden hissettiğiniz ivmeye yaklaşık olarak eşittir. Değer, seçilen eksendeki ivmenin yönüne bağlı olarak pozitif veya negatif olabilir.

Available Functions 
double acceleration( axisType axis );
Parameters

Parametre

Tip

Tanım

axis

axisType

İvmenin ölçüleceği eksen:

  • xaxis
  • yaxis
  • zaxis
Return Values

Belirtilen eksen boyunca ivmeyi G (yerçekimi birimi) cinsinden temsil eden double bir double değer döndürür.

Notes

  • İvme değerleri G biriminde rapor edilir.

gyroRate#

Jiroskop hızı, atalet sensörünün ne kadar hızlı döndüğünü gösterir. Bu fonksiyon, seçilen eksen üzerindeki atalet sensörünün mevcut dönüş hızını döndürür.

Sensörün o eksen üzerindeki dönüş yönüne bağlı olarak değer pozitif veya negatif olabilir.

Available Functions 
double gyroRate( axisType axis, velocityUnits units );
Parameters

Parametre

Tip

Tanım

axis

axisType

Jiroskop hızını döndürecek eksen:

  • xaxis
  • yaxis
  • zaxis

units

velocityUnits

Jiroskop hızı birimi:

  • dps — saniyede derece
  • rpm — dakikada devir
Return Values

Belirtilen eksen boyunca mevcut dönüş hızını seçilen birimlerde temsil eden double değerini döndürür.

Examples 
// Display the rate of change of rotation while turning in dps
Drivetrain.turn(right);
wait(1, seconds);

Brain.Screen.print(myInertial.gyroRate(zaxis, dps));

Drivetrain.stop();

orientation#

Yönelim, atalet sensörünün seçilen eksen üzerindeki mevcut açısıdır. Bu fonksiyon, belirtilen eksen için atalet sensörünün mevcut yönelimini döndürür.

Seçilen x, y veya z ekseni, sensörün yönelim eksenlerinden birine karşılık gelir.

Available Functions 
double orientation(
  axisType      axis,
  rotationUnits units );
Parameters

Parametre

Tip

Tanım

axis

axisType

Yönlendirme bilgisinin döndürüldüğü eksen:

  • xaxis
  • yaxis
  • zaxis

units

rotationUnits

The orientation unit:

  • deg / degrees — degrees
  • turns / rev — revolutions
Return Values

Seçilen yönelim açısını belirtilen birimlerde temsil eden double bir çift değer döndürür.

Examples 
while (true) {
  Brain.Screen.clearScreen();
  Brain.Screen.setCursor(1,1);
  // Show the Inertial Sensor's orientation value
  // for roll in degrees
  double orient = myInertial.orientation(xaxis, deg);
  Brain.Screen.print("%f", orient);
  wait(0.1, seconds);
}

collision#

Atalet sensörü ani bir darbe veya çarpışma algıladığında çalışan bir geri çağırma fonksiyonu kaydeder.

Available Functions 
void collision( void (* callback)(axisType, double, double, double) );
Parameters

Parametre

Tip

Tanım

callback

void (*)(axisType, double, double, double)

Çarpışma algılandığında çağrılacak bir fonksiyona işaretçi. Geri çağrı fonksiyonu aşağıdaki parametreleri kabul etmelidir:

  • axisType — Çarpışmanın algılandığı eksen.
  • Çarpışma anındaki ivme değerleri, sırasıyla:
    • double — x ekseni boyunca ivme (G cinsinden).
    • double — y ekseni boyunca ivme (G cinsinden).
    • double — z ekseni boyunca ivme (G cinsinden).
Fonksiyon void döndürmelidir.
Return Values

Bu fonksiyon bir değer döndürmez.

Examples

Geri çağırma fonksiyonunu tanımlayın ( int main() dışında)

// Display a message when the Inertial Sensor detects a collision.
void onCollision(axisType axis, double x, double y, double z) {
  Brain.Screen.print("Collision detected!");
}

Geri çağrıyı main() fonksiyonunun içine kaydedin int main()

int main() {
  // Run onCollision when the Inertial Sensor detects a collision.
  myInertial.collision(onCollision);
}

setTurnType#

Yön değiştiren kümeler pozitif değerler döndürür.

Available Functions 
void setTurnType( turnType dir );
Parameters

Parametre

Tip

Tanım

dir

turnType

Pozitif değer döndüren yönler:

  • right
  • left
Return Values

Bu fonksiyon bir değer döndürmez.

Notes

getTurnType#

Yön değiştiren fonksiyonlar pozitif değerler üretir.

Available Functions 
turnType getTurnType();
Parameters

Bu fonksiyon herhangi bir parametre almaz.

Return Values

Hangi yönün pozitif değerler ürettiğini gösteren turnType değerini döndürür:

  • right — Clockwise rotation returns positive values.
  • left — Counterclockwise rotation returns positive values.
Notes
On this page