xref: /nrf52832-nimble/rt-thread/components/utilities/zmodem/zdef.h (revision 104654410c56c573564690304ae786df310c91fc)
1*10465441SEvalZero #ifndef __ZDEF_H__
2*10465441SEvalZero #define __ZDEF_H__
3*10465441SEvalZero 
4*10465441SEvalZero #include <rtthread.h>
5*10465441SEvalZero #include "crc.h"
6*10465441SEvalZero #define ZPAD      '*'	/* 052 padding character begins frames */
7*10465441SEvalZero #define ZDLE      030	/* ctrl-X ZMODEM escape - `ala BISYNC DLE */
8*10465441SEvalZero #define ZDLEE     (ZDLE^0100)	/* escaped ZDLE as transmitted */
9*10465441SEvalZero #define ZBIN      'A'	/* binary frame indicator (CRC-16) */
10*10465441SEvalZero #define ZHEX      'B'	/* hex frame indicator */
11*10465441SEvalZero #define ZBIN32    'C'	/* binary frame with 32 bit FCS */
12*10465441SEvalZero #define ZBINR32   'D'	/* RLE packed Binary frame with 32 bit FCS */
13*10465441SEvalZero #define ZVBIN     'a'	/* binary frame indicator (CRC-16) */
14*10465441SEvalZero #define ZVHEX     'b'	/* hex frame indicator */
15*10465441SEvalZero #define ZVBIN32   'c'	/* binary frame with 32 bit FCS */
16*10465441SEvalZero #define ZVBINR32  'd'	/* RLE packed Binary frame with 32 bit FCS */
17*10465441SEvalZero #define ZRESC	  0176	/* RLE flag/escape character */
18*10465441SEvalZero 
19*10465441SEvalZero 
20*10465441SEvalZero /* Frame types */
21*10465441SEvalZero #define ZRQINIT	  0	    /* request receive init */
22*10465441SEvalZero #define ZRINIT    1     /* receive init */
23*10465441SEvalZero #define ZSINIT    2	    /* send init sequence (optional) */
24*10465441SEvalZero #define ZACK      3	    /* ACK to above */
25*10465441SEvalZero #define ZFILE     4	    /* file name from sender */
26*10465441SEvalZero #define ZSKIP     5	    /* ro sender: skip this file */
27*10465441SEvalZero #define ZNAK      6	    /* last packet was garbled */
28*10465441SEvalZero #define ZABORT    7	    /* abort batch transfers */
29*10465441SEvalZero #define ZFIN      8	    /* finish session */
30*10465441SEvalZero #define ZRPOS     9	    /* resume data trans at this position */
31*10465441SEvalZero #define ZDATA     10    /* data packet(s) follow */
32*10465441SEvalZero #define ZEOF      11    /* end of file */
33*10465441SEvalZero #define ZFERR     12    /* fatal Read or Write error Detected */
34*10465441SEvalZero #define ZCRC      13    /* request for file CRC and response */
35*10465441SEvalZero #define ZCHALLENGE 14   /* receiver's Challenge */
36*10465441SEvalZero #define ZCOMPL    15	/* request is complete */
37*10465441SEvalZero #define ZCAN      16	/* other end canned session with CAN*5 */
38*10465441SEvalZero #define ZFREECNT  17	/* request for free bytes on filesystem */
39*10465441SEvalZero #define ZCOMMAND  18	/* command from sending program */
40*10465441SEvalZero 
41*10465441SEvalZero /* ZDLE sequfences */
42*10465441SEvalZero #define ZCRCE     'h'	/* CRC next, frame ends, header packet follows */
43*10465441SEvalZero #define ZCRCG     'i'	/* CRC next, frame continues nonstop */
44*10465441SEvalZero #define ZCRCQ     'j'	/* CRC next, frame continues, ZACK expected */
45*10465441SEvalZero #define ZCRCW     'k'	/* CRC next, ZACK expected, end of frame */
46*10465441SEvalZero #define ZRUB0     'l'	/* translate to rubout 0177 */
47*10465441SEvalZero #define ZRUB1     'm'	/* translate to rubout 0377 */
48*10465441SEvalZero 
49*10465441SEvalZero /* zdlread return values (internal) */
50*10465441SEvalZero /* -1 is general error, -2 is timeout */
51*10465441SEvalZero #define GOTOR     0400
52*10465441SEvalZero #define GOTCRCE   (ZCRCE|GOTOR)	/* ZDLE-ZCRCE received */
53*10465441SEvalZero #define GOTCRCG   (ZCRCG|GOTOR)	/* ZDLE-ZCRCG received */
54*10465441SEvalZero #define GOTCRCQ   (ZCRCQ|GOTOR)	/* ZDLE-ZCRCQ received */
55*10465441SEvalZero #define GOTCRCW   (ZCRCW|GOTOR)	/* ZDLE-ZCRCW received */
56*10465441SEvalZero #define GOTCAN	  (GOTOR|030)	/* CAN*5 seen */
57*10465441SEvalZero 
58*10465441SEvalZero /* Byte positions within header array */
59*10465441SEvalZero #define ZF0	      3	    /* first flags byte */
60*10465441SEvalZero #define ZF1	      2
61*10465441SEvalZero #define ZF2	      1
62*10465441SEvalZero #define ZF3	      0
63*10465441SEvalZero #define ZP0	      0	    /* low order 8 bits of position */
64*10465441SEvalZero #define ZP1	      1
65*10465441SEvalZero #define ZP2	      2
66*10465441SEvalZero #define ZP3	      3	    /* high order 8 bits of file position */
67*10465441SEvalZero 
68*10465441SEvalZero /* parameters for ZRINIT header */
69*10465441SEvalZero #define ZRPXWN	  8	    /* 9th byte in header contains window size/256 */
70*10465441SEvalZero #define ZRPXQQ	  9	    /* 10th to 14th bytes contain quote mask */
71*10465441SEvalZero /* bit Masks for ZRINIT flags byte ZF0 */
72*10465441SEvalZero #define CANFDX	  0x01	/* rx can send and receive true FDX */
73*10465441SEvalZero #define CANOVIO	  0x02	/* rx can receive data during disk I/O */
74*10465441SEvalZero #define CANBRK	  0x04	/* rx can send a break signal */
75*10465441SEvalZero #define CANRLE	  0x10	/* receiver can decode RLE */
76*10465441SEvalZero #define CANLZW	  0x20	/* receiver can uncompress */
77*10465441SEvalZero #define CANFC32	  0x28	/* receiver can use 32 bit Frame Check */
78*10465441SEvalZero #define ESCCTL    0x64	/* receiver expects ctl chars to be escaped */
79*10465441SEvalZero #define ESC8      0xc8	/* receiver expects 8th bit to be escaped */
80*10465441SEvalZero 
81*10465441SEvalZero /* bit Masks for ZRINIT flags byte ZF1 */
82*10465441SEvalZero #define CANVHDR	  01	/* variable headers OK */
83*10465441SEvalZero #define ZRRQWN	  8	    /* receiver specified window size in ZRPXWN */
84*10465441SEvalZero #define ZRRQQQ	  16	/* additional control chars to quote in ZRPXQQ	*/
85*10465441SEvalZero #define ZRQNVH	  (ZRRQWN|ZRRQQQ)	/* variable len hdr reqd to access info */
86*10465441SEvalZero 
87*10465441SEvalZero /* Parameters for ZSINIT frame */
88*10465441SEvalZero #define ZATTNLEN  32	/* max length of attention string */
89*10465441SEvalZero #define ALTCOFF   ZF1	/* offset to alternate canit string, 0 if not used */
90*10465441SEvalZero 
91*10465441SEvalZero /* Parameters for ZFILE frame */
92*10465441SEvalZero /* Conversion options one of these in ZF0 */
93*10465441SEvalZero #define ZCBIN	  1	   /* binary transfer - inhibit conversion */
94*10465441SEvalZero #define ZCNL	  2	   /* convert NL to local end of line convention */
95*10465441SEvalZero #define ZCRESUM	  3	   /* resume interrupted file transfer */
96*10465441SEvalZero /* management include options, one of these ored in ZF1 */
97*10465441SEvalZero #define ZMSKNOLOC 0200 /* skip file if not present at rx */
98*10465441SEvalZero /* management options, one of these ored in ZF1 */
99*10465441SEvalZero #define ZMMASK	  037  /* mask for the choices below */
100*10465441SEvalZero #define ZMNEWL	  1	   /* transfer if source newer or longer */
101*10465441SEvalZero #define ZMCRC	  2	   /* transfer if different file CRC or length */
102*10465441SEvalZero #define ZMAPND	  3	   /* append contents to existing file (if any) */
103*10465441SEvalZero #define ZMCLOB	  4	   /* replace existing file */
104*10465441SEvalZero #define ZMNEW	  5	   /* transfer if source newer */
105*10465441SEvalZero /* number 5 is alive ... */
106*10465441SEvalZero #define ZMDIFF	  6	   /* transfer if dates or lengths different */
107*10465441SEvalZero #define ZMPROT	  7	   /* protect destination file */
108*10465441SEvalZero #define ZMCHNG	  8	   /* change filename if destination exists */
109*10465441SEvalZero /* transport options, one of these in ZF2 */
110*10465441SEvalZero #define ZTLZW	  1	   /* lempel-Ziv compression */
111*10465441SEvalZero #define ZTRLE	  3	   /* run Length encoding */
112*10465441SEvalZero /* extended options for ZF3, bit encoded */
113*10465441SEvalZero #define ZXSPARS	  64   /* encoding for sparse file operations */
114*10465441SEvalZero #define ZCANVHDR  01   /* variable headers OK */
115*10465441SEvalZero /* receiver window size override */
116*10465441SEvalZero #define ZRWOVR    4	   /* byte position for receive window override/256 */
117*10465441SEvalZero 
118*10465441SEvalZero /* parameters for ZCOMMAND frame ZF0 (otherwise 0) */
119*10465441SEvalZero #define ZCACK1	  1	   /* acknowledge, then do command */
120*10465441SEvalZero extern char Attn[ZATTNLEN+1];	/* Attention string rx sends to tx on err */
121*10465441SEvalZero 
122*10465441SEvalZero /* globals used by ZMODEM functions */
123*10465441SEvalZero extern rt_uint8_t  Rxframeind;     /* ZBIN ZBIN32, or ZHEX type of frame */
124*10465441SEvalZero extern char header_type;	       /* type of header received */
125*10465441SEvalZero extern rt_uint8_t  rx_header[4];   /* received header */
126*10465441SEvalZero extern rt_uint8_t  tx_header[4];   /* transmitted header */
127*10465441SEvalZero extern rt_uint8_t  Txfcs32;		   /* TRUE means send binary frames with 32 bit FCS */
128*10465441SEvalZero extern rt_uint16_t Rxcount;	       /* count of data bytes received */
129*10465441SEvalZero extern rt_uint16_t Rxtimeout;      /* tenths of seconds to wait for something */
130*10465441SEvalZero extern rt_uint32_t Rxpos;	       /* received file position */
131*10465441SEvalZero extern rt_uint32_t Txpos;	       /* transmitted file position */
132*10465441SEvalZero extern rt_uint8_t  Txfcs32;	       /* TURE means send binary frames with 32 bit FCS */
133*10465441SEvalZero 
134*10465441SEvalZero /* ward Christensen / CP/M parameters - Don't change these! */
135*10465441SEvalZero #define ENQ     005
136*10465441SEvalZero #define CAN     ('X'&037)
137*10465441SEvalZero #define XOFF    ('s'&037)
138*10465441SEvalZero #define XON     ('q'&037)
139*10465441SEvalZero #define SOH     1
140*10465441SEvalZero #define STX     2
141*10465441SEvalZero #define ETX     3
142*10465441SEvalZero #define SYN     026
143*10465441SEvalZero #define ESC     033
144*10465441SEvalZero #define WANTG   0107	/* send G not NAK to get nonstop batch xmsn */
145*10465441SEvalZero #define EOT     4
146*10465441SEvalZero #define ACK     6
147*10465441SEvalZero #define NAK     025
148*10465441SEvalZero #define CPMEOF  032
149*10465441SEvalZero #define WANTCRC 0103	/* send C not NAK to get crc not checksum */
150*10465441SEvalZero #define TIMEOUT (-2)
151*10465441SEvalZero #define RCDO    (-3)
152*10465441SEvalZero #define GCOUNT  (-4)
153*10465441SEvalZero #define ERRORMAX 5
154*10465441SEvalZero #define RETRYMAX 5
155*10465441SEvalZero #define WCEOT   (-10)
156*10465441SEvalZero 
157*10465441SEvalZero 
158*10465441SEvalZero 
159*10465441SEvalZero 
160*10465441SEvalZero 
161*10465441SEvalZero #define BITRATE 115200
162*10465441SEvalZero #define TX_BUFFER_SIZE  1024
163*10465441SEvalZero #define RX_BUFFER_SIZE  1024	  /* sender or receiver's max buffer size */
164*10465441SEvalZero extern char ZF0_CMD;	          /* local ZMODEM file conversion request */
165*10465441SEvalZero extern char ZF1_CMD;	          /* local ZMODEM file management request */
166*10465441SEvalZero extern char ZF2_CMD;	          /* local ZMODEM file management request */
167*10465441SEvalZero extern char ZF3_CMD;	          /* local ZMODEM file management request */
168*10465441SEvalZero extern rt_uint32_t Baudrate ;
169*10465441SEvalZero extern rt_uint32_t Left_bytes;
170*10465441SEvalZero extern rt_uint32_t Left_sizes;
171*10465441SEvalZero 
172*10465441SEvalZero 
173*10465441SEvalZero struct zmodemf
174*10465441SEvalZero {
175*10465441SEvalZero     struct rt_semaphore zsem;
176*10465441SEvalZero     rt_device_t device;
177*10465441SEvalZero };
178*10465441SEvalZero extern struct zmodemf zmodem;
179*10465441SEvalZero 
180*10465441SEvalZero struct zfile
181*10465441SEvalZero {
182*10465441SEvalZero 	char *fname;
183*10465441SEvalZero 	rt_int32_t   fd;
184*10465441SEvalZero 	rt_uint32_t  ctime;
185*10465441SEvalZero     rt_uint32_t  mode;
186*10465441SEvalZero 	rt_uint32_t  bytes_total;
187*10465441SEvalZero 	rt_uint32_t  bytes_sent;
188*10465441SEvalZero 	rt_uint32_t  bytes_received;
189*10465441SEvalZero 	rt_uint32_t  file_end;
190*10465441SEvalZero 
191*10465441SEvalZero };
192*10465441SEvalZero extern struct finsh_shell* shell;
193*10465441SEvalZero 
194*10465441SEvalZero #define ZDEBUG 0
195*10465441SEvalZero /* sz.c */
196*10465441SEvalZero extern void zs_start(char *path);
197*10465441SEvalZero /* rz.c */
198*10465441SEvalZero extern void zr_start(char *path);
199*10465441SEvalZero 
200*10465441SEvalZero /* zcore.c */
201*10465441SEvalZero extern void zinit_parameter(void);
202*10465441SEvalZero extern rt_int16_t zget_header(rt_uint8_t *hdr);
203*10465441SEvalZero extern void zsend_bin_header(rt_uint8_t type, rt_uint8_t *hdr);
204*10465441SEvalZero extern void zsend_hex_header(rt_uint8_t type, rt_uint8_t *hdr);
205*10465441SEvalZero extern rt_int16_t zget_data(rt_uint8_t *buf, rt_uint16_t len);
206*10465441SEvalZero extern void zsend_bin_data(rt_uint8_t *buf, rt_int16_t len, rt_uint8_t frameend);
207*10465441SEvalZero extern void zput_pos(rt_uint32_t pos);
208*10465441SEvalZero extern void zget_pos(rt_uint32_t pos);
209*10465441SEvalZero /* zdevice.c */
210*10465441SEvalZero extern rt_uint32_t get_device_baud(void);
211*10465441SEvalZero extern void zsend_byte(rt_uint16_t c);
212*10465441SEvalZero extern void zsend_line(rt_uint16_t c);
213*10465441SEvalZero extern rt_int16_t zread_line(rt_uint16_t timeout);
214*10465441SEvalZero extern void zsend_break(char *cmd);
215*10465441SEvalZero extern void zsend_can(void);
216*10465441SEvalZero 
217*10465441SEvalZero #endif  /* __ZDEF_H__ */
218