V4L/DVB (4056): Cx88: Add basic support for Leadtek Winfast DTV2000H card
[deliverable/linux.git] / drivers / media / video / cx88 / cx88.h
CommitLineData
1da177e4 1/*
1da177e4
LT
2 *
3 * v4l2 device driver for cx2388x based TV cards
4 *
5 * (c) 2003,04 Gerd Knorr <kraxel@bytesex.org> [SUSE Labs]
6 *
7 * This program is free software; you can redistribute it and/or modify
8 * it under the terms of the GNU General Public License as published by
9 * the Free Software Foundation; either version 2 of the License, or
10 * (at your option) any later version.
11 *
12 * This program is distributed in the hope that it will be useful,
13 * but WITHOUT ANY WARRANTY; without even the implied warranty of
14 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 * GNU General Public License for more details.
16 *
17 * You should have received a copy of the GNU General Public License
18 * along with this program; if not, write to the Free Software
19 * Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
20 */
21
22#include <linux/pci.h>
23#include <linux/i2c.h>
24#include <linux/i2c-algo-bit.h>
98f30ed0 25#include <linux/videodev2.h>
1da177e4
LT
26#include <linux/kdev_t.h>
27
28#include <media/tuner.h>
29#include <media/tveeprom.h>
1da177e4
LT
30#include <media/video-buf.h>
31#include <media/video-buf-dvb.h>
32
33#include "btcx-risc.h"
34#include "cx88-reg.h"
35
10b89ee3 36#include <linux/version.h>
3593cab5 37#include <linux/mutex.h>
419ac5d4 38#define CX88_VERSION_CODE KERNEL_VERSION(0,0,6)
1da177e4
LT
39
40#ifndef TRUE
41# define TRUE (1==1)
42#endif
43#ifndef FALSE
44# define FALSE (1==0)
45#endif
46#define UNSET (-1U)
47
48#define CX88_MAXBOARDS 8
49
e52e98a7
MCC
50/* Max number of inputs by card */
51#define MAX_CX88_INPUT 8
52
1da177e4
LT
53/* ----------------------------------------------------------- */
54/* defines and enums */
55
1da177e4
LT
56#define FORMAT_FLAGS_PACKED 0x01
57#define FORMAT_FLAGS_PLANAR 0x02
58
59#define VBI_LINE_COUNT 17
60#define VBI_LINE_LENGTH 2048
61
62/* need "shadow" registers for some write-only ones ... */
63#define SHADOW_AUD_VOL_CTL 1
64#define SHADOW_AUD_BAL_CTL 2
cef4e7af 65#define SHADOW_MAX 3
1da177e4 66
b45009b0
MCC
67/* FM Radio deemphasis type */
68enum cx88_deemph_type {
69 FM_NO_DEEMPH = 0,
70 FM_DEEMPH_50,
71 FM_DEEMPH_75
72};
73
1da177e4
LT
74/* ----------------------------------------------------------- */
75/* tv norms */
76
77struct cx88_tvnorm {
78 char *name;
79 v4l2_std_id id;
80 u32 cxiformat;
81 u32 cxoformat;
82};
83
84static unsigned int inline norm_maxw(struct cx88_tvnorm *norm)
85{
86 return (norm->id & V4L2_STD_625_50) ? 768 : 640;
1da177e4
LT
87}
88
41ef7c1e 89
1da177e4
LT
90static unsigned int inline norm_maxh(struct cx88_tvnorm *norm)
91{
92 return (norm->id & V4L2_STD_625_50) ? 576 : 480;
93}
94
95/* ----------------------------------------------------------- */
96/* static data */
97
98struct cx8800_fmt {
99 char *name;
100 u32 fourcc; /* v4l2 format id */
101 int depth;
102 int flags;
103 u32 cxformat;
104};
105
106struct cx88_ctrl {
107 struct v4l2_queryctrl v;
108 u32 off;
109 u32 reg;
110 u32 sreg;
111 u32 mask;
112 u32 shift;
113};
114
115/* ----------------------------------------------------------- */
116/* SRAM memory management data (see cx88-core.c) */
117
118#define SRAM_CH21 0 /* video */
119#define SRAM_CH22 1
120#define SRAM_CH23 2
121#define SRAM_CH24 3 /* vbi */
122#define SRAM_CH25 4 /* audio */
123#define SRAM_CH26 5
124#define SRAM_CH28 6 /* mpeg */
125/* more */
126
127struct sram_channel {
128 char *name;
129 u32 cmds_start;
130 u32 ctrl_start;
131 u32 cdt;
132 u32 fifo_start;
133 u32 fifo_size;
134 u32 ptr1_reg;
135 u32 ptr2_reg;
136 u32 cnt1_reg;
137 u32 cnt2_reg;
138};
139extern struct sram_channel cx88_sram_channels[];
140
141/* ----------------------------------------------------------- */
142/* card configuration */
143
144#define CX88_BOARD_NOAUTO UNSET
145#define CX88_BOARD_UNKNOWN 0
146#define CX88_BOARD_HAUPPAUGE 1
147#define CX88_BOARD_GDI 2
148#define CX88_BOARD_PIXELVIEW 3
149#define CX88_BOARD_ATI_WONDER_PRO 4
150#define CX88_BOARD_WINFAST2000XP_EXPERT 5
7418f346 151#define CX88_BOARD_AVERTV_STUDIO_303 6
1da177e4
LT
152#define CX88_BOARD_MSI_TVANYWHERE_MASTER 7
153#define CX88_BOARD_WINFAST_DV2000 8
154#define CX88_BOARD_LEADTEK_PVR2000 9
155#define CX88_BOARD_IODATA_GVVCP3PCI 10
156#define CX88_BOARD_PROLINK_PLAYTVPVR 11
157#define CX88_BOARD_ASUS_PVR_416 12
158#define CX88_BOARD_MSI_TVANYWHERE 13
159#define CX88_BOARD_KWORLD_DVB_T 14
160#define CX88_BOARD_DVICO_FUSIONHDTV_DVB_T1 15
161#define CX88_BOARD_KWORLD_LTV883 16
a82decf6 162#define CX88_BOARD_DVICO_FUSIONHDTV_3_GOLD_Q 17
1da177e4
LT
163#define CX88_BOARD_HAUPPAUGE_DVB_T1 18
164#define CX88_BOARD_CONEXANT_DVB_T1 19
165#define CX88_BOARD_PROVIDEO_PV259 20
166#define CX88_BOARD_DVICO_FUSIONHDTV_DVB_T_PLUS 21
167#define CX88_BOARD_PCHDTV_HD3000 22
168#define CX88_BOARD_DNTV_LIVE_DVB_T 23
169#define CX88_BOARD_HAUPPAUGE_ROSLYN 24
a82decf6 170#define CX88_BOARD_DIGITALLOGIC_MEC 25
1da177e4 171#define CX88_BOARD_IODATA_GVBCTV7E 26
239df2e2 172#define CX88_BOARD_PIXELVIEW_PLAYTV_ULTRA_PRO 27
b45009b0 173#define CX88_BOARD_DVICO_FUSIONHDTV_3_GOLD_T 28
a82decf6 174#define CX88_BOARD_ADSTECH_DVB_T_PCI 29
e057ee11 175#define CX88_BOARD_TERRATEC_CINERGY_1400_DVB_T1 30
9fef07ca 176#define CX88_BOARD_DVICO_FUSIONHDTV_5_GOLD 31
d45170ed 177#define CX88_BOARD_AVERMEDIA_ULTRATV_MC_550 32
0bcc37c3 178#define CX88_BOARD_KWORLD_VSTREAM_EXPERT_DVD 33
e976f937 179#define CX88_BOARD_ATI_HDTVWONDER 34
2b5200a7 180#define CX88_BOARD_WINFAST_DTV1000 35
7418f346 181#define CX88_BOARD_AVERTV_303 36
0fa14aa6
ST
182#define CX88_BOARD_HAUPPAUGE_NOVASPLUS_S1 37
183#define CX88_BOARD_HAUPPAUGE_NOVASE2_S1 38
0e0351e3 184#define CX88_BOARD_KWORLD_DVBS_100 39
611900c1
ST
185#define CX88_BOARD_HAUPPAUGE_HVR1100 40
186#define CX88_BOARD_HAUPPAUGE_HVR1100LP 41
fc40b261 187#define CX88_BOARD_DNTV_LIVE_DVB_T_PRO 42
f39624fd 188#define CX88_BOARD_KWORLD_DVB_T_CX22702 43
43eabb4e 189#define CX88_BOARD_DVICO_FUSIONHDTV_DVB_T_DUAL 44
44256de1 190#define CX88_BOARD_KWORLD_HARDWARE_MPEG_TV_XPERT 45
780dfef3 191#define CX88_BOARD_DVICO_FUSIONHDTV_DVB_T_HYBRID 46
da215d22 192#define CX88_BOARD_PCHDTV_HD5500 47
b3038304 193#define CX88_BOARD_KWORLD_MCE200_DELUXE 48
a3124622 194#define CX88_BOARD_PIXELVIEW_PLAYTV_P7000 49
4bd6e9d9
MV
195#define CX88_BOARD_NPGTECH_REALTV 50
196#define CX88_BOARD_WINFAST_DTV2000H 51
1da177e4
LT
197
198enum cx88_itype {
199 CX88_VMUX_COMPOSITE1 = 1,
200 CX88_VMUX_COMPOSITE2,
201 CX88_VMUX_COMPOSITE3,
202 CX88_VMUX_COMPOSITE4,
203 CX88_VMUX_SVIDEO,
204 CX88_VMUX_TELEVISION,
205 CX88_VMUX_CABLE,
206 CX88_VMUX_DVB,
207 CX88_VMUX_DEBUG,
208 CX88_RADIO,
209};
210
211struct cx88_input {
212 enum cx88_itype type;
213 unsigned int vmux;
214 u32 gpio0, gpio1, gpio2, gpio3;
215};
216
217struct cx88_board {
218 char *name;
219 unsigned int tuner_type;
b45009b0
MCC
220 unsigned int radio_type;
221 unsigned char tuner_addr;
222 unsigned char radio_addr;
1da177e4 223 int tda9887_conf;
e52e98a7 224 struct cx88_input input[MAX_CX88_INPUT];
1da177e4 225 struct cx88_input radio;
f9e7a020
PH
226 unsigned int blackbird:1;
227 unsigned int dvb:1;
1da177e4
LT
228};
229
230struct cx88_subid {
231 u16 subvendor;
232 u16 subdevice;
233 u32 card;
234};
235
236#define INPUT(nr) (&cx88_boards[core->board].input[nr])
237
238/* ----------------------------------------------------------- */
239/* device / file handle status */
240
241#define RESOURCE_OVERLAY 1
242#define RESOURCE_VIDEO 2
243#define RESOURCE_VBI 4
244
245#define BUFFER_TIMEOUT (HZ/2) /* 0.5 seconds */
1da177e4
LT
246
247/* buffer for one video frame */
248struct cx88_buffer {
249 /* common v4l buffer stuff -- must be first */
250 struct videobuf_buffer vb;
251
252 /* cx88 specific */
253 unsigned int bpl;
254 struct btcx_riscmem risc;
255 struct cx8800_fmt *fmt;
256 u32 count;
257};
258
259struct cx88_dmaqueue {
260 struct list_head active;
261 struct list_head queued;
262 struct timer_list timeout;
263 struct btcx_riscmem stopper;
264 u32 count;
265};
266
267struct cx88_core {
268 struct list_head devlist;
269 atomic_t refcount;
270
271 /* board name */
272 int nr;
273 char name[32];
274
275 /* pci stuff */
276 int pci_bus;
277 int pci_slot;
4ac97914
MCC
278 u32 __iomem *lmmio;
279 u8 __iomem *bmmio;
1da177e4
LT
280 u32 shadow[SHADOW_MAX];
281 int pci_irqmask;
282
283 /* i2c i/o */
284 struct i2c_adapter i2c_adap;
285 struct i2c_algo_bit_data i2c_algo;
286 struct i2c_client i2c_client;
287 u32 i2c_state, i2c_rc;
288
289 /* config info -- analog */
290 unsigned int board;
291 unsigned int tuner_type;
b45009b0
MCC
292 unsigned int radio_type;
293 unsigned char tuner_addr;
294 unsigned char radio_addr;
1da177e4
LT
295 unsigned int tda9887_conf;
296 unsigned int has_radio;
297
0345c387
ST
298 /* Supported V4L _STD_ tuner formats */
299 unsigned int tuner_formats;
300
1da177e4
LT
301 /* config info -- dvb */
302 struct dvb_pll_desc *pll_desc;
303 unsigned int pll_addr;
cd20ca9f 304 int (*prev_set_voltage)(struct dvb_frontend* fe, fe_sec_voltage_t voltage);
1da177e4
LT
305
306 /* state info */
307 struct task_struct *kthread;
308 struct cx88_tvnorm *tvnorm;
309 u32 tvaudio;
310 u32 audiomode_manual;
311 u32 audiomode_current;
312 u32 input;
313 u32 astat;
b1706b91 314 u32 use_nicam;
1da177e4
LT
315
316 /* IR remote control state */
317 struct cx88_IR *ir;
e52e98a7 318
3593cab5 319 struct mutex lock;
e52e98a7
MCC
320 /* various v4l controls */
321 u32 freq;
611900c1
ST
322
323 /* cx88-video needs to access cx8802 for hybrid tuner pll access. */
324 struct cx8802_dev *dvbdev;
1da177e4
LT
325};
326
327struct cx8800_dev;
328struct cx8802_dev;
329
330/* ----------------------------------------------------------- */
331/* function 0: video stuff */
332
333struct cx8800_fh {
334 struct cx8800_dev *dev;
335 enum v4l2_buf_type type;
336 int radio;
337 unsigned int resources;
338
339 /* video overlay */
340 struct v4l2_window win;
341 struct v4l2_clip *clips;
342 unsigned int nclips;
343
344 /* video capture */
345 struct cx8800_fmt *fmt;
346 unsigned int width,height;
347 struct videobuf_queue vidq;
348
349 /* vbi capture */
350 struct videobuf_queue vbiq;
351};
352
353struct cx8800_suspend_state {
354 int disabled;
355};
356
357struct cx8800_dev {
358 struct cx88_core *core;
359 struct list_head devlist;
e52e98a7 360 spinlock_t slock;
1da177e4
LT
361
362 /* various device info */
363 unsigned int resources;
364 struct video_device *video_dev;
365 struct video_device *vbi_dev;
366 struct video_device *radio_dev;
367
368 /* pci i/o */
369 struct pci_dev *pci;
370 unsigned char pci_rev,pci_lat;
371
1da177e4
LT
372
373 /* capture queues */
374 struct cx88_dmaqueue vidq;
375 struct cx88_dmaqueue vbiq;
376
377 /* various v4l controls */
1da177e4
LT
378
379 /* other global state info */
380 struct cx8800_suspend_state state;
381};
382
383/* ----------------------------------------------------------- */
384/* function 1: audio/alsa stuff */
e52e98a7 385/* =============> moved to cx88-alsa.c <====================== */
1da177e4 386
1da177e4
LT
387
388/* ----------------------------------------------------------- */
389/* function 2: mpeg stuff */
390
391struct cx8802_fh {
392 struct cx8802_dev *dev;
393 struct videobuf_queue mpegq;
394};
395
396struct cx8802_suspend_state {
397 int disabled;
398};
399
31629424
CC
400/* TODO: move this to struct v4l2_mpeg_compression ? */
401struct blackbird_dnr {
402 u32 mode;
403 u32 type;
404 u32 spatial;
405 u32 temporal;
406};
407
1da177e4
LT
408struct cx8802_dev {
409 struct cx88_core *core;
e52e98a7 410 spinlock_t slock;
1da177e4
LT
411
412 /* pci i/o */
413 struct pci_dev *pci;
414 unsigned char pci_rev,pci_lat;
415
416 /* dma queues */
417 struct cx88_dmaqueue mpegq;
418 u32 ts_packet_size;
419 u32 ts_packet_count;
420
421 /* other global state info */
422 struct cx8802_suspend_state state;
423
424 /* for blackbird only */
425 struct list_head devlist;
426 struct video_device *mpeg_dev;
427 u32 mailbox;
428 int width;
429 int height;
430
431 /* for dvb only */
432 struct videobuf_dvb dvb;
433 void* fe_handle;
434 int (*fe_release)(void *handle);
fc40b261
CP
435
436 void *card_priv;
1da177e4
LT
437 /* for switching modulation types */
438 unsigned char ts_gen_cntrl;
31629424
CC
439
440 /* mpeg params */
441 struct v4l2_mpeg_compression params;
442 struct blackbird_dnr dnr_params;
1da177e4
LT
443};
444
445/* ----------------------------------------------------------- */
446
447#define cx_read(reg) readl(core->lmmio + ((reg)>>2))
448#define cx_write(reg,value) writel((value), core->lmmio + ((reg)>>2))
449#define cx_writeb(reg,value) writeb((value), core->bmmio + (reg))
450
451#define cx_andor(reg,mask,value) \
452 writel((readl(core->lmmio+((reg)>>2)) & ~(mask)) |\
453 ((value) & (mask)), core->lmmio+((reg)>>2))
454#define cx_set(reg,bit) cx_andor((reg),(bit),(bit))
455#define cx_clear(reg,bit) cx_andor((reg),(bit),0)
456
457#define cx_wait(d) { if (need_resched()) schedule(); else udelay(d); }
458
459/* shadow registers */
460#define cx_sread(sreg) (core->shadow[sreg])
461#define cx_swrite(sreg,reg,value) \
462 (core->shadow[sreg] = value, \
463 writel(core->shadow[sreg], core->lmmio + ((reg)>>2)))
464#define cx_sandor(sreg,reg,mask,value) \
465 (core->shadow[sreg] = (core->shadow[sreg] & ~(mask)) | ((value) & (mask)), \
466 writel(core->shadow[sreg], core->lmmio + ((reg)>>2)))
467
468/* ----------------------------------------------------------- */
469/* cx88-core.c */
470
1da177e4
LT
471extern void cx88_print_irqbits(char *name, char *tag, char **strings,
472 u32 bits, u32 mask);
1da177e4
LT
473
474extern int cx88_core_irq(struct cx88_core *core, u32 status);
475extern void cx88_wakeup(struct cx88_core *core,
476 struct cx88_dmaqueue *q, u32 count);
477extern void cx88_shutdown(struct cx88_core *core);
478extern int cx88_reset(struct cx88_core *core);
479
480extern int
481cx88_risc_buffer(struct pci_dev *pci, struct btcx_riscmem *risc,
482 struct scatterlist *sglist,
483 unsigned int top_offset, unsigned int bottom_offset,
484 unsigned int bpl, unsigned int padding, unsigned int lines);
485extern int
486cx88_risc_databuffer(struct pci_dev *pci, struct btcx_riscmem *risc,
487 struct scatterlist *sglist, unsigned int bpl,
488 unsigned int lines);
489extern int
490cx88_risc_stopper(struct pci_dev *pci, struct btcx_riscmem *risc,
491 u32 reg, u32 mask, u32 value);
492extern void
c7b0ac05 493cx88_free_buffer(struct videobuf_queue *q, struct cx88_buffer *buf);
1da177e4
LT
494
495extern void cx88_risc_disasm(struct cx88_core *core,
496 struct btcx_riscmem *risc);
497extern int cx88_sram_channel_setup(struct cx88_core *core,
498 struct sram_channel *ch,
499 unsigned int bpl, u32 risc);
500extern void cx88_sram_channel_dump(struct cx88_core *core,
501 struct sram_channel *ch);
502
503extern int cx88_set_scale(struct cx88_core *core, unsigned int width,
504 unsigned int height, enum v4l2_field field);
505extern int cx88_set_tvnorm(struct cx88_core *core, struct cx88_tvnorm *norm);
506
507extern struct video_device *cx88_vdev_init(struct cx88_core *core,
508 struct pci_dev *pci,
509 struct video_device *template,
510 char *type);
511extern struct cx88_core* cx88_core_get(struct pci_dev *pci);
512extern void cx88_core_put(struct cx88_core *core,
513 struct pci_dev *pci);
514
6f502b8a
MCC
515extern int cx88_start_audio_dma(struct cx88_core *core);
516extern int cx88_stop_audio_dma(struct cx88_core *core);
517
518
1da177e4
LT
519/* ----------------------------------------------------------- */
520/* cx88-vbi.c */
521
522void cx8800_vbi_fmt(struct cx8800_dev *dev, struct v4l2_format *f);
b45009b0
MCC
523/*
524int cx8800_start_vbi_dma(struct cx8800_dev *dev,
525 struct cx88_dmaqueue *q,
526 struct cx88_buffer *buf);
527*/
1da177e4
LT
528int cx8800_stop_vbi_dma(struct cx8800_dev *dev);
529int cx8800_restart_vbi_queue(struct cx8800_dev *dev,
530 struct cx88_dmaqueue *q);
531void cx8800_vbi_timeout(unsigned long data);
532
533extern struct videobuf_queue_ops cx8800_vbi_qops;
534
535/* ----------------------------------------------------------- */
536/* cx88-i2c.c */
537
538extern int cx88_i2c_init(struct cx88_core *core, struct pci_dev *pci);
539extern void cx88_call_i2c_clients(struct cx88_core *core,
540 unsigned int cmd, void *arg);
541
542
543/* ----------------------------------------------------------- */
544/* cx88-cards.c */
545
546extern struct cx88_board cx88_boards[];
547extern const unsigned int cx88_bcount;
548
549extern struct cx88_subid cx88_subids[];
550extern const unsigned int cx88_idcount;
551
552extern void cx88_card_list(struct cx88_core *core, struct pci_dev *pci);
553extern void cx88_card_setup(struct cx88_core *core);
554
555/* ----------------------------------------------------------- */
556/* cx88-tvaudio.c */
557
558#define WW_NONE 1
559#define WW_BTSC 2
b1706b91
TS
560#define WW_BG 3
561#define WW_DK 4
562#define WW_I 5
563#define WW_L 6
564#define WW_EIAJ 7
565#define WW_I2SPT 8
566#define WW_FM 9
1da177e4
LT
567
568void cx88_set_tvaudio(struct cx88_core *core);
569void cx88_newstation(struct cx88_core *core);
570void cx88_get_stereo(struct cx88_core *core, struct v4l2_tuner *t);
571void cx88_set_stereo(struct cx88_core *core, u32 mode, int manual);
572int cx88_audio_thread(void *data);
b1706b91 573int cx88_detect_nicam(struct cx88_core *core);
1da177e4
LT
574
575/* ----------------------------------------------------------- */
576/* cx88-input.c */
577
578int cx88_ir_init(struct cx88_core *core, struct pci_dev *pci);
579int cx88_ir_fini(struct cx88_core *core);
580void cx88_ir_irq(struct cx88_core *core);
581
582/* ----------------------------------------------------------- */
583/* cx88-mpeg.c */
584
c7b0ac05
MCC
585int cx8802_buf_prepare(struct videobuf_queue *q,struct cx8802_dev *dev,
586 struct cx88_buffer *buf, enum v4l2_field field);
1da177e4
LT
587void cx8802_buf_queue(struct cx8802_dev *dev, struct cx88_buffer *buf);
588void cx8802_cancel_buffers(struct cx8802_dev *dev);
589
590int cx8802_init_common(struct cx8802_dev *dev);
591void cx8802_fini_common(struct cx8802_dev *dev);
592
593int cx8802_suspend_common(struct pci_dev *pci_dev, pm_message_t state);
594int cx8802_resume_common(struct pci_dev *pci_dev);
595
e52e98a7
MCC
596/* ----------------------------------------------------------- */
597/* cx88-video.c */
598extern int cx88_do_ioctl(struct inode *inode, struct file *file, int radio,
599 struct cx88_core *core, unsigned int cmd,
600 void *arg, v4l2_kioctl driver_ioctl);
601
602/* ----------------------------------------------------------- */
603/* cx88-blackbird.c */
604extern int (*cx88_ioctl_hook)(struct inode *inode, struct file *file,
605 unsigned int cmd, void *arg);
606extern unsigned int (*cx88_ioctl_translator)(unsigned int cmd);
31629424
CC
607void blackbird_set_params(struct cx8802_dev *dev,
608 struct v4l2_mpeg_compression *params);
609void blackbird_set_dnr_params(struct cx8802_dev *dev,
610 struct blackbird_dnr* dnr_params);
e52e98a7 611
1da177e4
LT
612/*
613 * Local variables:
614 * c-basic-offset: 8
615 * End:
e52e98a7 616 * kate: eol "unix"; indent-width 3; remove-trailing-space on; replace-trailing-space-save on; tab-width 8; replace-tabs off; space-indent off; mixed-indent off
1da177e4 617 */
This page took 0.163603 seconds and 5 git commands to generate.