Hello Shell
Overview
See Hello Shell for the original description.
Requirements
The TiaC Magpie with already configured UART console support.
Building and Running
Build and flash Hello Shell as follows:
west build -b magpie_f777ni -p -d build/helloshell-magpie_f777ni bridle/samples/helloshell
west flash -d build/helloshell-magpie_f777ni
After flashing and the board has booted, you will be presented with a shell prompt. All shell commands are available and would looks like:
(text in bold is a command input, text in angle brackets are keys to press)
[00:00:00.050,000] <inf> phy_mii: PHY (0) ID 221560
*** Booting Zephyr OS build v4.2.0… ***
Hello World! I'm THE SHELL from magpie_f777ni
[00:00:02.651,000] <inf> phy_mii: PHY (0) Link speed 100 Mb, full duplex
uart:~$ <Tab>
adc bridle clear dac device devmem eeprom
flash gpio hello help history hwinfo i2c
kernel led log mdio net pwm regulator
rem resize retval sensor shell timer
uart:~$ help
Please press the <Tab> button to see all available commands.
You can also use the <Tab> button to prompt or auto-complete all commands or its subcommands.
You can try to call commands with <-h> or <--help> parameter for more information.
Shell supports following meta-keys:
Ctrl + (a key from: abcdefklnpuw)
Alt + (a key from: bf)
Please refer to shell documentation for more details.
Available commands:
adc : ADC commands
bridle : Bridle commands.
clear : Clear screen.
dac : DAC shell commands
device : Device commands
devmem : Read/write physical memory
Usage:
Read memory at address with optional width:
devmem address [width]
Write memory at address with mandatory width and value:
devmem address <width> <value>
eeprom : EEPROM shell commands
flash : Flash shell commands
gpio : GPIO commands
hello : say hello
help : Prints the help message.
history : Command history.
hwinfo : HWINFO commands
i2c : I2C commands
kernel : Kernel commands
led : LED commands
log : Commands for controlling logger
mdio : MDIO commands
net : Networking commands
pwm : PWM shell commands
regulator : Regulator playground
rem : Ignore lines beginning with 'rem '
resize : Console gets terminal screen size or assumes default in case the
readout fails. It must be executed after each terminal width
change to ensure correct text display.
retval : Print return value of most recent command
sensor : Sensor commands
shell : Useful, not Unix-like shell commands.
timer : Timer commands
uart:~$ hello -h
hello - say hello
uart:~$ hello
Hello from shell.
uart:~$ hwinfo devid
Length: 12
ID: 0x9e6b44aea1e2b8980c4d32a6
uart:~$ kernel version
Zephyr version 4.2.0
uart:~$ bridle version
Bridle version 4.2.0
uart:~$ bridle version long
Bridle version 4.2.0.0
uart:~$ bridle info
Zephyr: 4.2.0
Bridle: 4.2.0
uart:~$ device list
devices:
- rcc@40023800 (READY)
DT node labels: rcc
- reset-controller (READY)
DT node labels: rctl
- interrupt-controller@40013c00 (READY)
DT node labels: exti
- gpio@40022800 (READY)
DT node labels: gpiok
- gpio@40022400 (READY)
DT node labels: gpioj
- gpio@40022000 (READY)
DT node labels: gpioi
- gpio@40021C00 (READY)
DT node labels: gpioh
- gpio@40021800 (READY)
DT node labels: gpiog
- gpio@40021400 (READY)
DT node labels: gpiof
- gpio@40021000 (READY)
DT node labels: gpioe
- gpio@40020C00 (READY)
DT node labels: gpiod
- gpio@40020800 (READY)
DT node labels: gpioc
- gpio@40020400 (READY)
DT node labels: gpiob
- gpio@40020000 (READY)
DT node labels: gpioa
- rng@50060800 (READY)
DT node labels: rng
- serial@40007800 (READY)
DT node labels: uart7
- serial@40004c00 (READY)
DT node labels: uart4 tmph_serial1 tmph_serial
- rtc@40002800 (READY)
DT node labels: rtc
- adc@40012200 (READY)
DT node labels: adc3 tmph_adc
- flash-controller@40023c00 (READY)
DT node labels: flash
- i2c@40006000 (READY)
DT node labels: i2c4 tmph_i2c1 tmph_i2c
- i2c@40005800 (READY)
DT node labels: i2c2
- pwm (READY)
DT node labels: pwm8 tmph_pwms
- spi@40013400 (READY)
DT node labels: spi4 tmph_spi1 tmph_spi
- mdio (READY)
DT node labels: mdio
- ethernet-phy@0 (READY)
DT node labels: eth_phy
- ethernet (READY)
DT node labels: mac
- leds (READY)
uart:~$ history
[ 0] history
[ 1] device list
[ 2] bridle info
[ 3] bridle version long
[ 4] bridle version
[ 5] kernel version
[ 6] hwinfo devid
[ 7] hello
[ 8] hello -h
[ 9] help
Simple GPIO Operations
Switch user LED 2 on and off
uart:~$ gpio get gpiog 12
0
uart:~$ gpio conf gpiog 12 oh0
uart:~$ gpio set gpiog 12 1
uart:~$ gpio set gpiog 12 0
uart:~$ gpio blink gpiog 12
Hit any key to exit
Switch user LED 1 on and off (via LED API)
uart:~$ led on leds 0
leds: turning on LED 0
uart:~$ led off leds 0
leds: turning off LED 0
Simple ADC Acquisition
Read 12-bit from ADC3/IN9
uart:~$ adc adc@40012200 acq_time 1 tick
uart:~$ adc adc@40012200 resolution 12
uart:~$ adc adc@40012200 read 9
read: 370
uart:~$ adc adc@40012200 print
adc@40012200:
Gain: 1
Reference: INTERNAL
Acquisition Time: 0
Channel ID: 9
Differential: 0
Resolution: 12
Simple RTC Alarm
Oneshot for 1 second by alarm channel 0
uart:~$ timer oneshot rtc 0 1000
rtc: Alarm triggered
Simple Flash Access and Test
Print HEX Dump
uart:~$ flash read flash 3298e 40
0003298E: 6d 61 67 70 69 65 5f 66 37 37 37 6e 69 00 48 65 |magpie_f 777ni.He|
0003299E: 6c 6c 6f 20 57 6f 72 6c 64 21 20 49 27 6d 20 54 |llo Worl d! I'm T|
000329AE: 48 45 20 53 48 45 4c 4c 20 66 72 6f 6d 20 25 73 |HE SHELL from %s|
000329BE: 0a 00 28 75 6e 73 69 67 6e 65 64 29 20 63 68 61 |..(unsig ned) cha|
Erase, Write and Verify
uart:~$ flash read flash 40000 40
00040000: ff ff ff ff ff ff ff ff ff ff ff ff ff ff ff ff |........ ........|
00040010: ff ff ff ff ff ff ff ff ff ff ff ff ff ff ff ff |........ ........|
00040020: ff ff ff ff ff ff ff ff ff ff ff ff ff ff ff ff |........ ........|
00040030: ff ff ff ff ff ff ff ff ff ff ff ff ff ff ff ff |........ ........|
uart:~$ flash test flash 40000 1000 2
Erase OK.
Write OK.
Verified OK.
Erase OK.
Write OK.
Verified OK.
Erase-Write-Verify test done.
uart:~$ flash read flash 40000 40
00040000: 00 01 02 03 04 05 06 07 08 09 0a 0b 0c 0d 0e 0f |........ ........|
00040010: 10 11 12 13 14 15 16 17 18 19 1a 1b 1c 1d 1e 1f |........ ........|
00040020: 20 21 22 23 24 25 26 27 28 29 2a 2b 2c 2d 2e 2f | !"#$%&' ()*+,-./|
00040030: 30 31 32 33 34 35 36 37 38 39 3a 3b 3c 3d 3e 3f |01234567 89:;<=>?|
uart:~$ flash page_info 40000
Page for address 0x40000:
start offset: 0x40000
size: 262144
index: 5
uart:~$ flash erase flash 40000 1000
Erase success.
uart:~$ flash read flash 40000 40
00040000: ff ff ff ff ff ff ff ff ff ff ff ff ff ff ff ff |........ ........|
00040010: ff ff ff ff ff ff ff ff ff ff ff ff ff ff ff ff |........ ........|
00040020: ff ff ff ff ff ff ff ff ff ff ff ff ff ff ff ff |........ ........|
00040030: ff ff ff ff ff ff ff ff ff ff ff ff ff ff ff ff |........ ........|
Simple I2C Operations
Scan I2C bus 2
uart:~$ i2c scan i2c2
0 1 2 3 4 5 6 7 8 9 a b c d e f
00: -- -- -- -- -- -- -- -- -- -- -- --
10: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --
20: 20 21 -- -- -- -- -- -- -- -- -- -- -- -- -- --
30: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --
40: 40 41 42 43 44 45 46 -- -- -- -- -- -- -- -- --
50: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --
60: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --
70: -- -- -- -- -- -- -- --
9 devices found on i2c2
Configure GPIO pins on first IO expander to output
uart:~$ i2c read_byte i2c2 20 0
Output: 0xc0
uart:~$ i2c read_byte i2c2 20 3
Output: 0xff
uart:~$ i2c write_byte i2c2 20 3 0
uart:~$ i2c read_byte i2c2 20 3
Output: 0x0
Setup GPIO pins on first IO expander to output
each odd GPIO to high(1)
each even GPIO to low(0)
uart:~$ i2c read_byte i2c2 20 1
Output: 0xff
uart:~$ i2c write_byte i2c2 20 1 0x55
uart:~$ i2c read_byte i2c2 20 1
Output: 0x55
uart:~$ i2c read_byte i2c2 20 0
Output: 0x55
Ethernet Setup
IPv4 from local DHCP server
uart:~$ net dhcpv4 client start 1
uart:~$ net iface show 1
Interface eth0 (0x200215d8) (Ethernet) [1]
===================================
Link addr : 02:80:E1:4F:98:16
MTU : 1500
Flags : AUTO_START,IPv4,IPv6
Device : ethernet (0x802f1e4)
Status : oper=UP, admin=UP, carrier=ON
Ethernet capabilities supported:
10 Mbits
100 Mbits
Ethernet PHY device: ethernet-phy@0 (0x802f1c0)
Ethernet link speed: 100 Mbits full-duplex
IPv6 unicast addresses (max 2):
fe80::280:e1ff:fee1:9a39 autoconf preferred infinite
fd9c:33d7:ba99:0:280:e1ff:fee1:9a39 autoconf preferred infinite
IPv6 multicast addresses (max 3):
ff02::1
ff02::1:ffe1:9a39
IPv6 prefixes (max 2):
fd9c:33d7:ba99::/64 infinite
IPv6 hop limit : 64
IPv6 base reachable time : 30000
IPv6 reachable time : 20180
IPv6 retransmit timer : 0
DHCPv6 state : disabled
IPv4 unicast addresses (max 1):
192.168.10.197/255.255.255.0 DHCP preferred
IPv4 multicast addresses (max 2):
224.0.0.1
IPv4 gateway : 192.168.10.1
DHCPv4 lease time : 28800
DHCPv4 renew time : 14400
DHCPv4 server : 192.168.10.10
DHCPv4 requested : 192.168.10.197
DHCPv4 state : bound
DHCPv4 attempts : 1
DHCPv4 state : bound
uart:~$ net ping 192.168.10.1
PING 192.168.10.1
28 bytes from 192.168.10.1 to 192.168.10.197: icmp_seq=0 ttl=64 time=0 ms
28 bytes from 192.168.10.1 to 192.168.10.197: icmp_seq=1 ttl=64 time=0 ms
28 bytes from 192.168.10.1 to 192.168.10.197: icmp_seq=2 ttl=64 time=0 ms
uart:~$ net arp
Interface Link Address
[ 0] 1 BC:EE:7B:32:E5:D0 192.168.10.1
[ 1] 1 00:80:77:84:BF:81 192.168.10.10