docs / src /index.qmd
asamasach's picture
Update src/index.qmd
dda1156 verified
---
title: Monitait Complete User Guide
subtitle: WatcherJET 3.0 Hardware โ€ข AI Training Platform
author: Monitait.com
date: "2025-11-23"
format:
html:
grid:
sidebar-width: 300px
body-width: 900px
---
::: {.callout-note}
**Version:** 1.0 โ€ข **Date:** October 13, 2025
**Powered by Monitait** โ€“ [monitait.com](https://monitait.com)
:::
## Download Full Illustrated PDFs
| Document | Pages | Download |
|---------------------------------------------|-------|----------|
| Chapter 1 โ€“ Hardware & WatcherJET 3.0 | 27 | [CHAP-1-AI-HARDWARE.pdf](CHAP-1-AI-HARDWARE.pdf) |
| Chapter 2 โ€“ AI Training | 15 | [CHAP-2-AI-TRAINING.pdf](CHAP-2-AI-TRAINING.pdf) |
*All diagrams, wiring schematics, and screenshots are inside the PDFs.*
# Chapter 1 โ€“ Hardware & WatcherJET 3.0
### Quick Setup (4 Steps)
1. Connect the sensors
2. Connect the power supply (12โ€“24 V DC)
3. Provide an access point
4. Register at console.monitait.com/factory/watchers
### Step 1: Connect the Sensors
#### External Machine Signal
- **Production Count**: Any 12โ€“24 V signal โ†’ OK inputs (3 & 4)
- **Defect Count**: Ejector/NG signal โ†’ NG inputs (5 & 6)
โ†’ Bidirectional, opto-isolated
#### Push Button
Production: Button โ†’ OK(4) + GND(1), bridge OK(3) โ†’ +V(2)
Defects: Same using NG(5 & 6)
#### Obstacle Sensor
Black โ†’ OK/NG input | Brown โ†’ +V(2) | Blue โ†’ GND(1) | Bridge remaining โ†’ +V(2)
#### Encoder
White โ†’ NG(6) | Black โ†’ OK(4) | Brown โ†’ +V | Blue โ†’ GND
Bridge (3) & (5) โ†’ +V(2)
#### RS485
A โ†’ terminal 8 | B โ†’ terminal 7
### Step 2: Power Supply
12โ€“24 V DC, max 2 A โ†’ terminals (1 & 2) โ†’ green power LED on
### Step 3: Network
**Best:** Wired LAN (allow `*.monitait.com`)
**Temporary:** Hotspot โ†’ SSID: `Monitait`, Password: `p@ssword`
### Step 4: Register Watcher
1. console.monitait.com โ†’ Watchers โ†’ Add Watcher
2. Enter Registration ID
3. Test: trigger sensor โ†’ red heart LED blinks
### High-Current PSU, Emitters & Actuators
- High-current โ‰ค48 V โ†’ terminals (9 & 10)
- Emitters: Positive โ†’ PSU, Negative โ†’ U(12) or B(11)
- Ejector (15), Warning (16) โ†’ PLC (opto-isolated NPN)
### Keys & Indicators
- Key-1: Buzzer on/off
- Key-3: Camera enable
- Key-4: Scanner enable
- Green = power, Red heart = data, Checkmark = OK, Rejection = NG
# Chapter 2 โ€“ AI Training
### Step 1: AI Training Platform โ€“ Annotation
1. Confirm task
2. Choose category
3. Draw bounding box
4. Save โ†’ next image
**Keyboard shortcuts** (very fast):
`1 2 3 4 Q W E R T Y U I` โ†’ instant category selection
**Tips**
- Overlapping objects โ†’ draw elsewhere โ†’ drag
- No images visible โ†’ all done, use < > buttons
- Metadata โ†’ click โ€œ+โ€ in right panel
### Step 2: Administration โ€“ Create Task
1. Tasks โ†’ **+ NEW TASK**
- Name, quantity, type, dates
- Define labels/categories with colors
2. โ‹ฎ โ†’ **Upload Images** (.jpg/.png/.jpeg)
**Best Practices**
- Visually distinct categories
- Always label main object (e.g., โ€œbottleโ€)
- Use descriptive IDs (bottle-pk-100)
- Monitait team handles training & augmentation
### Step 3: Evaluation
| Term | Meaning | Formula |
|-------|-----------------------------|-----------------------------|
| TP | Correct detection | โ€” |
| FP | False alarm | โ€” |
| FN | Missed defect | โ€” |
| Precision | TP/(TP+FP) | Accuracy of detections |
| Recall | TP/(TP+FN) | % of real defects found |
| F1-Score | 2ร—(Pร—R)/(P+R) | Balanced score |
| mAP | Mean Average Precision | Overall quality (higher = better) |
**How to improve**
- Diverse lighting/angles/backgrounds
- Tight, consistent bounding boxes
- Multiple reviewers
- Avoid similar categories
- Let Monitait team choose best augmentations
### Step 4: Deploy Model
Successful training produces:
- `best.pt` (weights)
- Unique **Training ID** (record it!)
**On production machine:**
```bash
cp best.pt /home/projects/inference/best.pt
# restart inference service โ†’ new model live