Holarch
فصول الدورة

التدريب · المسار 9. أساسيات SysML v2 · الفصل 9.4 من 8

9.4 الحالات والانتقالات 3:51

اكتب آلة حالة بمُشغِّلات وشروط حارسة وإجراءات حالة، وارسم انتقالًا موقوتًا.

يعرض Holarch 2.22.

→ 9.3 الإجراءات والتدفقات · كل الفصول · 9.5 المتطلبات ←

ما ستتعلمه

  • عرّف الإشارات وتعريف حالة بحالة ابتدائية
  • اكتب انتقالات بمُشغِّل وشرط حارس وهدف، بالصيغة المختصرة وكانتقالات مسمّاة
  • أعطِ حالةً إجراءات entry وdo وexit
  • ارسم انتقالًا في «عرض انتقالات الحالة» واضبط اسمه ومُشغِّله
  • اجعل جزءًا يُظهر تعريف حالة

اكتب آلة حالة SysML v2 في Holarch، باتباع البرنامج التعليمي States and Transitions الخاص بـ SysML v2 على مشروع Hybrid Car صغير: الإشارات كتعريفات، وتعريف حالة بحالة ابتدائية، وانتقالات بمُشغِّلات وشروط حارسة، وإجراءات entry وdo وexit، وانتقالات مسمّاة، و«عرض انتقالات الحالة» مع انتقال موقوت مرسوم عليه، وسيارة تُظهر الحالات. SysML علامة تجارية مسجلة لشركة Object Management Group, Inc.

ملفات المشاريع

  • المشروع المكتمل (.holarch.json؛ إدارة المشاريع ← ملفات المشروع ▾ ← استيراد مشروع (.json)…)

يُشغَّل الفيديو من holarch.app؛ راجع سياسة الخصوصية.

التطبيق العملي

نفّذ هذا بنفسك في Holarch، على مشروع Hybrid Car التوضيحي (SysML v2).

  1. افتح مشروع Hybrid Car التوضيحي (أنشئه إذا لزم الأمر: إدارة المشاريع ← ملفات المشروع ▾ ← مشروع توضيحي جديد ← Hybrid Car (SysML v2))، وافتح النموذج ← المحرر والحزمة VehicleBehavior.
  2. بعد attribute def Unplug;، أضف attribute def FaultDetected;.
  3. قبل القوس الختامي لـ state def PowertrainStates، أضف state limpHome { entry action warnDriver; do action driveLimited; } وtransition limpStop first limpHome accept StopRequest then off;.
  4. افتح السلوك ← آلات الحالة، وانقر + مخطط جديد، واختر PowertrainStates تحت يعرض ثم انقر إنشاء.
  5. حدد electric واسحب من مقبضه إلى limpHome؛ وأفلت على Transition. في لوحة الانتقال، أدخل الاسم electricFault والمُشغِّل FaultDetected، ثم انقر إظهار في النص.

تكون قد انتهيت عندما يحتوي PowertrainStates على limpHome وlimpStop والانتقال electricFault الذي يقبل FaultDetected، وتُبلغ الحالة تحت المحرر بعدم وجود مشكلات.

اختبر نفسك

  1. ما الذي يجعل off الحالة الابتدائية لـ PowertrainStates؟
  2. بعد state off; يأتي accept StartRequest if charge > 20 then electric;. سمِّ المُشغِّل والشرط الحارس والمصدر والهدف.
  3. متى تعمل إجراءات entry وdo وexit لحالة؟
  4. ماذا يقول exhibit state powertrainStates : PowertrainStates; في DrivenCar؟
إظهار الإجابات
  1. ما الذي يجعل off الحالة الابتدائية لـ PowertrainStates؟

    entry; then off;: يلي entry انتقالٌ تعاقبي (succession) إلى off، فتبدأ آلة الحالة هناك. ويرسمه العرض كنقطة.

  2. بعد state off; يأتي accept StartRequest if charge > 20 then electric;. سمِّ المُشغِّل والشرط الحارس والمصدر والهدف.

    المُشغِّل: الإشارة StartRequest. الشرط الحارس: charge > 20. الهدف: electric. والصيغة المختصرة تبدأ من الحالة التي تليها، off.

  3. متى تعمل إجراءات entry وdo وexit لحالة؟

    يعمل إجراء entry عند الدخول إلى الحالة، وإجراء do أثناء نشاط الحالة، وإجراء exit عند مغادرة الحالة.

  4. ماذا يقول exhibit state powertrainStates : PowertrainStates; في DrivenCar؟

    أن السيارة تُظهر آلة الحالة هذه: تملك السيارة استخدامًا لـ PowertrainStates، فتكون حالاته حالات السيارة.

قراءة المزيد

النص المكتوب

إظهار النص المكتوب (التعليق الصوتي وما يظهر على الشاشة)

Introduction

Chapter four: states and transitions. A state machine says how a system reacts to events, and what it does in each state.

In this chapter you write signals and a state machine with triggers, guards and state actions, draw a timed transition in a view, and let the car exhibit the states.

Start the tutorial

Start the tutorial States and Transitions from Project Files, Start a Tutorial. Its starter project holds the powertrain package with the car, and nothing else yet.

On screen: Project Files ▾ → Start a Tutorial… → SysML v2: States and Transitions → Start; Model → Editor.

The state machine

A state machine reacts to signals, and in SysML v2 they are plain definitions. After the imports, define four: start request, stop request, plug in and unplug.

On screen: After the imports: four attribute defs.

Below the signals, write the state definition. Charge is an input that the transitions read. Entry, then off, makes off the initial state.

On screen: Below Unplug: state def PowertrainStates with three states.

Transitions and state actions

A transition has a trigger, a guard and a target. After the off state, a start request goes to electric when the charge is above twenty, and to hybrid otherwise. This short form starts at the state it follows.

On screen: After state off;: accept StartRequest if charge > 20 then electric; accept StartRequest then hybrid;

Now give the electric state its actions. Replace its line with a body: the entry action runs when the state is entered, the do action while it is active, and the exit action when it is left.

On screen: Select state electric; and type its body.

After the electric state, the powertrain switches to hybrid when the charge drops below fifteen, and turns off on a stop request. The hybrid state turns off on a stop request too.

On screen: After electric's closing brace: if charge < 15 then hybrid; accept StopRequest then off; after state hybrid;: accept StopRequest then off;

Before the closing brace of the state definition, add the charging state and two named transitions. A named transition says where it starts, with first.

On screen: After hybrid's stop transition: state charging; transition plugIn; transition unplugged.

The State Transition View

Open Behavior, then State Machines, and click New Diagram. Keep State Transition View, choose the powertrain states under Shows, and click Create.

On screen: Behavior → State Machines → + New Diagram; Shows: PowertrainBehavior::PowertrainStates; Create.

States show their entry, do and exit actions, and the dot marks the initial state. Each transition reads its trigger, the guard in square brackets, then a slash and the effect.

On screen: The view.

Draw a timed transition

A full charge takes half an hour, then the car switches off. Select the charging state, and drag from its handle to the off state. The drop makes a transition.

On screen: Select charging; drag its handle onto off.

In the transition panel, name it charged, and set its trigger to after thirty minutes.

On screen: Transition panel: Name charged; Trigger after 30 [min].

Open the Editor. The new transition is in the state definition: named charged, it accepts after thirty minutes, and goes to off.

On screen: Model → Editor: the transition charged.

Exhibit

Last, let the car exhibit the states. Inside the car, after its doc line, add an exhibit state usage. The state machine now belongs to the car.

On screen: In part def Car after doc: exhibit state powertrainStates : PowertrainStates;

Recap

Every step is ticked off. Click Mark as Done.

On screen: Step panel → Mark as Done.

Let's recap. You defined signals, wrote a state definition with an initial state, transitions with triggers and guards, and state actions, drew a timed transition that Holarch wrote into the text, and let the car exhibit the states.

Next, requirements say what the car must do, in a form the model can check.