User Tools

Site Tools


Action disabled: index
arduino:wio-canprot-fr

WIOCAN

Configuration

Protocole RCAN

Le WIO-02 et le WIO-PROG2 utilisent des trames CAN étendues, alimenté par le protocole Rocrail RCAN.
La vitesse de transmission utilisée est de 125k, qui est assez rapide pour autoriser de longs fils.
En utilisant l'ensemble des 29 bits d'identification, cela autorise les instructions entre zéro et huit octets de données.
Ce protocole peut être utilisé en parallèle avec d'autres protocoles utilisant des trames standard et la même vitesse de transmission.
Certaines interfaces CAN ne peuvent pas être utilisées pour des trames étendues parce que l'identifiant sera mutilé. Utilisez un autre Type d'interface disponible.

Trame étendue

Trame CAN étendue
EID Cnt Donnée[Cnt]
PRIO TYPE SID IC RID DLC DATA CAN usage
3 2 8 8 8 4 (0…8) x 8 Nr of bits
Identifiant 29bit étendu: <PRIO 3bit> <TYPE 2bit> <SID 8bit>  <IC 8bit>   <RID 8bit>
             Masque: <0x1C000000><0x03000000><0x00FF0000><0x0000FF00><0x000000FF>


Utilisation CAN Description Plage Remarque
PRIO Priorité d'identifiant 0…7
TYPE Type d'instruction 0…3 cmd, evt, rsp, inf
SID Identifiant de l'expéditeur 1…255 1=Rocrail
IC Code d'instruction 0x00…0xFF Group 0xFn + Opcode 0xnF
RID Identifiant de recepteur 0…255 0=broadcast
DLC Nombre d'octets de données suivants 0…8
DATA 8 octets de données (0…8) x 0…255


Diffusion

Une exception sur cet en-tête est la diffusion:
Le PRIO et le SID sont utilisés comme compteur décroissant 11 bits. Cela autorise des tailles du fichier d'un maximum de 16kB.
La fin de la diffusion se déclenche si le décompte atteint zéro.
Le premier paquet de données contient le nom du fichier avec une longueur maximale de 8 caractères incluant l'extension.


PRIO_SENSOR  0x00
PRIO_HIGH    0x01
PRIO_MEDIUM  0x02
PRIO_CONFIG  0x03
PRIO_LOW     0x05
PRIO_INFO    0x07
 
TYPE_CMD 0x00
TYPE_EVT 0x01
TYPE_RSP 0x02
TYPE_ACK 0x03


Code d'Instruction

/*
IC = GRP | OPC
 
GRP = (IC & 0xF0)
OPC = (IC & 0x0F)
*/
 
#define GRP_SYS 0x00 // System
  #define SYS_NOTUSED   0x00 // See "Bootloader"
  #define SYS_STATE     0x01
  #define SYS_SOD       0x02
  #define SYS_CLOCK     0x03
  #define SYS_EBREAK    0x04
  #define SYS_POWER     0x05
  #define SYS_SHUTDOWN  0x06
  #define SYS_REBOOT    0x07
 
#define GRP_CNF 0x10 // Configuration
  #define CNF_QUERY     0x10
  #define CNF_GET       0x11
  #define CNF_SET       0x12
  #define CNF_NAME      0x13
  #define CNF_ID        0x14
  #define CNF_IDENTIFY  0x15
  #define CNF_REBOOT    0x1F
 
#define GRP_PRG 0x20 // Programming
  #define PRG_GETCV 0x20
  #define PRG_SETCV 0x21
  #define PRG_PT    0x22
 
#define GRP_STR 0x30 // Streaming
  #define STR_TEXT_START 0x30 // datat[0] = display number
  #define STR_TEXT       0x31
  #define STR_FILE_START 0x32 // data = filename
  #define STR_FILE       0x33
  #define STR_PLAY       0x34 // data = filename
  #define STR_LIST       0x35 // SPIFFS directory listing
  #define STR_SSID       0x36
  #define STR_PWD        0x37
 
#define GRP_PRT 0x40 // Port I/O
  #define PRT_PORT      0x40
  #define PRT_SIGNAL    0x41
  #define PRT_MULTIPLEX 0x42
 
#define GRP_DCC 0x50 // DCC Command Station
  #define DCC_DIRV     0x50
  #define DCC_FUN      0x51
  #define DCC_BINSTATE 0x52
  #define DCC_ACC      0x53
  #define DCC_BIND     0x54
 
#define GRP_INF 0x60 // Unsolicited events like Sensors, RailCom, RFID scanner, ...
  #define INF_PORT 0x60
  #define INF_RFID 0x61
  #define INF_BIDI 0x62
  #define INF_ENV  0x63 // temperature, humidity, pressure, light 
  #define INF_IO      0x64 // Max. 64 I/O status which is mostly used for SoD.
  #define INF_GOODBYE 0x65
 
// type for streaming text
#define TEXT_TYPE_TEXT          0
#define TEXT_TYPE_SSID          1
#define TEXT_TYPE_FILE          2
#define TEXT_TYPE_FILE_DEL      3
#define TEXT_TYPE_FILE_DOWNLOAD 4
#define TEXT_TYPE_BIN           5
 
 
 
// Config indexes
#define WIO_CNF_OPTIONS     0
#define WIO_CNF_PORTGROUP_0 1
#define WIO_CNF_PORTGROUP_1 2
#define WIO_CNF_PORTGROUP_2 3
#define WIO_CNF_PORTGROUP_3 4
#define WIO_CNF_REBOOT      0xFF
 
// Prio values
#define PRIO_SENSOR  0x00
#define PRIO_HIGH    0x01
#define PRIO_CONFIG  0x03
#define PRIO_LOW     0x05
#define PRIO_INFO    0x07
 
// Instruction types
#define TYPE_CMD 0x00
#define TYPE_EVT 0x01
#define TYPE_RSP 0x02
#define TYPE_ACK 0x03
 
// EID masks
#define MASK_PRIO 0x1C000000 // >> 26
#define MASK_MODE 0x03000000 // >> 24
#define MASK_SID  0x00FF0000 // >> 16
#define MASK_IC   0x0000FF00 // >>  8
#define MASK_RID  0x000000FF // >>  0
 
#define SHIFT_PRIO 26
#define SHIFT_MODE 24
#define SHIFT_SID  16
#define SHIFT_IC    8
#define SHIFT_RID   0
 
// State bits
#define SYS_STATE_POWER 0x01
#define SYS_STATE_SC    0x02
#define SYS_STATE_PT    0x04
#define SYS_STATE_SLAVE 0x08

Bootloader

Groupe GRP_SYS et commande zéro, Code d'instruction 0x00, ne sont pas utilisé pour éviter les conflits EID bootloader CBUS.
Cela peut arriver au cas ou le SID est 8 et le RID est 4 ou 5.

:X00080004N -> Bootloader command
:X00080005N -> Bootloader data


GRP_CNF

CNF_IDX_OPTIONS     0
CNF_IDX_PORTGROUP_0 1 //  0... 7
CNF_IDX_PORTGROUP_1 2 //  8...15
CNF_IDX_PORTGROUP_2 3 // 16...23
CNF_IDX_PORTGROUP_3 4 // 24...31

Commande d'interrogation

<PRIO_CONFIG><TYPE_CMD><SID><CNF_QUERY><RID><DLC=0>:

Query Rsp

<PRIO_CONFIG><TYPE_CMD><SID><CNF_QUERY><RID><DLC=8>:<MANU><PRODUCT><TYPE><OPT1><OPT2><OPT3><VER_MAJ><VER_MIN>

Commande d’obtention

<PRIO_CONFIG><TYPE_CMD><SID><CNF_GET><RID><DLC=1>:<CNF_OPTIONS>
<PRIO_CONFIG><TYPE_CMD><SID><CNF_GET><RID><DLC=1>:<CNF_PORTGROUP_n>

Obtention Rsp

<PRIO_CONFIG><TYPE_RSP><SID><CNF_GET><RID><DLC=7>:<CNF_PORTGROUP_n><options1><options2><options3><pulselength><canid><subtype>
<PRIO_CONFIG><TYPE_RSP><SID><CNF_GET><RID><DLC=5>:<CNF_PORTGROUP_n><nib0+nib1><nib2+nib3><nib4+nib5><nib6+nib7>
Un nible représente un type de port, 0…15.

Définir la commande

<PRIO_CONFIG><TYPE_CMD><SID><CNF_SET><RID><DLC=7>:<CNF_PORTGROUP_n><options1><options2><options3><pulselength><canid><subtype>
<PRIO_CONFIG><TYPE_CMD><SID><CNF_SET><RID><DLC=5>:<CNF_PORTGROUP_n><nib0+nib1><nib2+nib3><nib4+nib5><nib6+nib7>

arduino/wio-canprot-fr.txt · Last modified: 2024/04/17 10:18 by phil45