Difference between revisions of "X630-Software"

From Geekworm Wiki
Jump to navigation Jump to search
 
(59 intermediate revisions by 3 users not shown)
Line 1: Line 1:
 
{{GD Template Impl}}
 
{{GD Template Impl}}
This wiki describes how to use x630 on the Raspberry Pi OS, it is just a demo.
+
This wiki describes how to use x630 on the Raspberry Pi OS.  <span style="color:red;">Note: The software can currently be used directly on Raspberry Pi 4B, 3B+/3B/Zero series. Software support for Raspberry Pi 5 software is not available which need to be tested.
  
==For Raspberry Pi OS==
+
The Raspberry Pi Foundation has updated several versions recently;
X630 has two reset mode: '''Hardware reset''' and '''Software reset''' modes, we strongly recommend you use software reset mode if you use it on raspberry pi hardware or raspberry pi os, software reset uses GPIO 509 to reset operation through GPIO, which can prevent you from restarting the Raspberry Pi repeatedly, which is very convenient. And on other hardware platforms, X630 actually reserves pins to facilitate you to use custom GPIO pin to implement software reset operations or use directly hardware reset mode.
 
  
First, please choose your reset mode based on your hardware and OS (default is software reset mode), you can skip this step if you use software reset, it should be noted that disconnect power supply to the Raspberry Pi before changing dip switch positions.
+
The use guide of X630 depends on the official Raspberry Pi OS version you are using. Different versions have different usage methods. If you have some questions, please contact us and attach the os version you are using.(<span style="color:red;">Email: support@geekworm.com</span>)
  
[[File:Dip-switches.jpg|none|dip switch]]
+
==For Raspberry Pi OS==
{| class="wikitable"
+
'''NOTE:'''
! SELECTION !! SWITCH SETTINGS !!
 
|-
 
| Hardware reset || HW = 1 || SW = 0
 
|-
 
| Software reset || HW = 0 || SW = 1
 
|}
 
 
 
Explain:
 
* Hardware reset: After starting RASPISTILL or RASPIVID <span style="color:red;">once</span> then you will need to reboot Raspberry Pi to restart it again
 
* Software reset: Starting RASPISTILL or RASPIVID <span style="color:red;">multiple times</span> and don't need to reboot Raspberry Pi ('''Recommend''')
 
* Default setting is 'Software reset';
 
* Please remove the yellow protective film before change dip switch.
 
<hr/>
 
'''Preparations:'''
 
1. Once booted, update your Raspberry Pi by running the following commands in a terminal window:
 
sudo apt-get update
 
sudo apt-get upgrade
 
  
2. Run the following command to go into the Raspberry Pi configuration tool
+
Since the X630 V1.5 version removes the software reset&hardware reset DIP switch, for the V1.5 version, please ignore the use of software reset or directly visit to [[X630-Hardware-Reset]]
sudo raspi-config
 
  
[[File:Raspi-config-1.jpg]]
+
X630 v1.3 has two reset mode: '''Hardware reset''' and '''Software reset''' modes;
  
3. Navigate to ''''Interfacing Options'''' and hit Enter. Now select the ''''Camera'''' option, and hit the Enter key to enable it. Select “Finish” and select to '''reboot''' your Raspberry Pi.
 
[[File:Raspi-config-2.jpg]]
 
sudo reboot
 
4. Once rebooted, you need to make sure that the ‘/dev/video0’ device is available. Use this command to check in a terminal window:
 
ls /dev/video0
 
[[File:Raspi-config-3.jpg]]
 
  
If you see anything other than ‘file not found‘, then it’s available.  
+
You can use hardware reset mode if you use it on raspberry pi hardware or raspberry pi os, software reset uses GPIO 509 to reset operation through GPIO, which can prevent you from restarting the Raspberry Pi repeatedly, which is very convenient.
  
<hr/>
 
'''For Software Reset''' - Starting RASPISTILL or RASPIVID multiple times and no need to reboot Raspberry Pi
 
  
You can skip to step 12 if you use hardware reset mode;
+
The user guide of X630 is similar to [[HDMI TO CSI-2|C779]] when X630 is in hardware mode, but X630 supports audio when used with X630-A2, and  [[HDMI TO CSI-2|C779]] does not support audio
  
5. Execute CAM GPIO initialization at startup, need to add scripts in /etc/rc.local file.
 
Run the following two commends;
 
sudo sed -i '$ i echo "509" > /sys/class/gpio/export'  /etc/rc.local
 
sudo sed -i '$ i echo "out" > /sys/class/gpio/gpio509/direction'  /etc/rc.local
 
sudo sed -i '$ i echo "1" > /sys/class/gpio/gpio509/value'  /etc/rc.local
 
Or
 
sudo nano /etc/rc.local
 
Scroll down, and just before the 'exit 0' line, enter the following comment:
 
echo "509" > /sys/class/gpio/export
 
echo "out" > /sys/class/gpio/gpio509/direction
 
echo "1" > /sys/class/gpio/gpio509/value
 
[[File:Raspi-config-4-1.jpg]]
 
  
Save and exit with ctrl + x, followed by y when prompted to save, and then enter.
+
First, please confirm & select X630 work mode according the picture; After November 2021, the default factory mode is hardware mode;
  
6. Create a script to reset the X630 module
+
We found that some users prefer hardware mode, so our factory default settings have been changed to hardware mode
cd ~
 
sudo nano reset.sh
 
Enter the following:
 
echo "0" > /sys/class/gpio/gpio509/value
 
sleep 1
 
echo "1" > /sys/class/gpio/gpio509/value
 
Save and exit with ctrl + x, followed by y when prompted to save, and then enter.
 
  
NOTE:Don't forget the folder where the reset.sh file is located
+
[[File:Dip-switches.jpg|none|dip switch]]
  
7. Reboot your Raspberry Pi
+
<span style="color:red;">Disconnect power to the Raspberry Pi before changing dip switch positions!!!</span>
sudo reboot
 
  
8.To take first '''photo''' with the X630 Module
+
{| class="wikitable"
 +
! SELECTION !! SWITCH SETTINGS !!
 +
|-
 +
| Hardware reset(Default) || HW = 1 || SW = 0
 +
|-
 +
| Software reset || HW = 0 || SW = 1
 +
|}
  
Return the fold of reset.sh file after restart
+
[[File:X630-Reset-01.jpg|none|800px|X630 dip switch setting]]
cd ~
 
sudo bash reset.sh
 
raspistill -o image1.jpg
 
Here, "image1.jpg" is the name of your image that will be saved to your Raspberry Pi
 
  
9. To take second '''photo''' with the X630 Module
+
Explain:
sudo bash reset.sh
+
* Hardware reset: After starting RASPISTILL or RASPIVID <span style="color:red;">once</span> then you will need to reboot Raspberry Pi to restart it again (Please use when operating system cannot control the X630 module via GPIO509)
raspistill -o image2.jpg
+
* Software reset: Starting RASPISTILL or RASPIVID <span style="color:red;">multiple times</span> and don't need to reboot Raspberry Pi.
Here, "image2.jpg" is the name of your image that will be saved to your Raspberry Pi
+
* Default setting is 'Hardware reset'.
+
* Please remove the yellow protective film before change dip switch.
10. Record first '''video''' with the X630 module
+
<hr/>
sudo bash reset.sh
 
raspivid -o video1.h264 -t 10000
 
Here, "video1" is the name of your video and "10000" is the number of milliseconds.
 
 
11. Record second '''video''' with the X630 module
 
sudo bash reset.sh
 
raspivid -o video2.h264 -t 10000
 
Here, "video2" is the name of your video and "10000" is the number of milliseconds.
 
 
 
'''Note''': "sudo bash reset.sh" is always required to execute before starting RASPISTILL or RASPIVID. the CAM LED will go off for 1 second then turn on.
 
<hr>
 
'''For Hardware Reset''' - Starting RASPISTILL or RASPIVID once then reboot your Raspberry Pi
 
 
 
Please use the following guide if your dip switch is changed to 'Hardware reset' position.
 
  
12. To take a photo with the X630 Module
 
raspistill -o image.jpg
 
Here, "image.jpg" is the name of your image that will be saved to your Raspberry Pi
 
  
13. If you need to take second image, then you will need to reboot the Raspberry Pi and execute the "raspistill" again.
+
'''For Hardware Reset'''  refer to [[X630-Hardware-Reset]]
sudo reboot
 
  
14. To record a video with the X630 module
+
'''For Software Reset''' refer to [[X630-Software-Reset]]
raspivid -o video.h264 -t 10000
 
Here, "video" is the name of your video and "10000" is the number of milliseconds.
 
  
15. If you need to record second video, then you will need to reboot the Raspberry Pi and execute the "raspivid" again.
 
sudo reboot
 
  
==How to check kernel version==
+
Return to [[X630]]
Please run the following command to get the linux kernel version
 
uname -a
 
[[File:Raspi-kernel-version.jpg]]
 
  
 
<!--Add review function! -->
 
<!--Add review function! -->

Latest revision as of 09:59, 12 March 2024

This wiki describes how to use x630 on the Raspberry Pi OS. Note: The software can currently be used directly on Raspberry Pi 4B, 3B+/3B/Zero series. Software support for Raspberry Pi 5 software is not available which need to be tested.

The Raspberry Pi Foundation has updated several versions recently;

The use guide of X630 depends on the official Raspberry Pi OS version you are using. Different versions have different usage methods. If you have some questions, please contact us and attach the os version you are using.(Email: support@geekworm.com)

For Raspberry Pi OS

NOTE:

Since the X630 V1.5 version removes the software reset&hardware reset DIP switch, for the V1.5 version, please ignore the use of software reset or directly visit to X630-Hardware-Reset

X630 v1.3 has two reset mode: Hardware reset and Software reset modes;


You can use hardware reset mode if you use it on raspberry pi hardware or raspberry pi os, software reset uses GPIO 509 to reset operation through GPIO, which can prevent you from restarting the Raspberry Pi repeatedly, which is very convenient.


The user guide of X630 is similar to C779 when X630 is in hardware mode, but X630 supports audio when used with X630-A2, and C779 does not support audio


First, please confirm & select X630 work mode according the picture; After November 2021, the default factory mode is hardware mode;

We found that some users prefer hardware mode, so our factory default settings have been changed to hardware mode

dip switch

Disconnect power to the Raspberry Pi before changing dip switch positions!!!

SELECTION SWITCH SETTINGS
Hardware reset(Default) HW = 1 SW = 0
Software reset HW = 0 SW = 1
X630 dip switch setting

Explain:

  • Hardware reset: After starting RASPISTILL or RASPIVID once then you will need to reboot Raspberry Pi to restart it again (Please use when operating system cannot control the X630 module via GPIO509)
  • Software reset: Starting RASPISTILL or RASPIVID multiple times and don't need to reboot Raspberry Pi.
  • Default setting is 'Hardware reset'.
  • Please remove the yellow protective film before change dip switch.


For Hardware Reset refer to X630-Hardware-Reset

For Software Reset refer to X630-Software-Reset


Return to X630

Add your comment
Geekworm Wiki welcomes all comments. If you do not want to be anonymous, register or log in. It is free.